{"id":39494880,"url":"https://github.com/guyskk/claude-code-supervisor","last_synced_at":"2026-04-02T13:56:03.053Z","repository":{"id":331458748,"uuid":"1123749281","full_name":"guyskk/claude-code-supervisor","owner":"guyskk","description":"Auto-review and iterate until quality work is delivered - a better alternative to ralph-claude-code. Switch between multiple Claude Code providers (Kimi, GLM, MiniMax, etc.) with a single command.","archived":false,"fork":false,"pushed_at":"2026-03-26T04:03:10.000Z","size":704,"stargazers_count":55,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-27T00:38:05.919Z","etag":null,"topics":["ai","ai-agents","ai-development-tools","ai-tools","claude-code","claude-code-cli","claude-code-plugin","codex","developer-tools","glm","kimi-k2","minimax","opencode","provider-management","zhipuai"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guyskk.png","metadata":{"files":{"readme":"README-CN.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T14:38:47.000Z","updated_at":"2026-03-26T03:56:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/guyskk/claude-code-supervisor","commit_stats":null,"previous_names":["guyskk/claude-code-config-switcher","guyskk/claude-code-supervisor"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/guyskk/claude-code-supervisor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyskk%2Fclaude-code-supervisor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyskk%2Fclaude-code-supervisor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyskk%2Fclaude-code-supervisor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyskk%2Fclaude-code-supervisor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guyskk","download_url":"https://codeload.github.com/guyskk/claude-code-supervisor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyskk%2Fclaude-code-supervisor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307373,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-development-tools","ai-tools","claude-code","claude-code-cli","claude-code-plugin","codex","developer-tools","glm","kimi-k2","minimax","opencode","provider-management","zhipuai"],"created_at":"2026-01-18T05:41:15.353Z","updated_at":"2026-04-02T13:56:03.045Z","avatar_url":"https://github.com/guyskk.png","language":"Go","readme":"# ccc - Claude Code 监督器\n\n[English](README.md) | [中文文档](README-CN.md)\n\n## 为什么选择 ccc？\n\n`ccc` 是一个增强 Claude Code 的命令行工具，提供两大核心功能：\n\n1. **Supervisor 模式**: ⭐ 自动任务审查，确保高质量、可交付的成果\n2. **无缝提供商切换**: 一条命令在 Kimi、GLM、MiniMax 等提供商之间切换\n\n**优于 `ralph-claude-code`**：\n\n- Supervisor 模式使用 Stop Hook 触发的审查机制配合严格的六步框架，显著提高任务完成度和质量。\n- 与 ralph 基于信号的退出检测不同，ccc 的 Supervisor 会 Fork 完整的会话上下文来评估实际工作质量。\n- 这有效防止了 AI 声称\"完成\"但结果质量差、仍有很多问题的虚假完成情况。\n\n## 快速开始\n\n### 1. 安装\n\n#### 选项 A：一键安装（Linux / macOS）\n\n```bash\nOS=$(uname -s | tr '[:upper:]' '[:lower:]'); ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/'); curl -LO \"https://github.com/guyskk/claude-code-supervisor/releases/latest/download/ccc-${OS}-${ARCH}\" \u0026\u0026 sudo install -m 755 \"ccc-${OS}-${ARCH}\" /usr/local/bin/ccc \u0026\u0026 rm \"ccc-${OS}-${ARCH}\" \u0026\u0026 ccc --version\n```\n\n#### 选项 B：从 [Releases](https://github.com/guyskk/claude-code-supervisor/releases) 下载\n\n下载适合你平台的二进制文件（`ccc-darwin-arm64`、`ccc-linux-amd64` 等）并安装到 `/usr/local/bin/`。\n\n### 2. 配置\n\n如果你已有 `~/.claude/settings.json`，首次运行 `ccc` 时会提示迁移并自动生成 ccc 配置 `~/.claude/ccc.json`。\n\n你也可以自行创建配置文件，示例如下：\n\n```json\n{\n  \"settings\": {\n    \"permissions\": {\n      \"defaultMode\": \"bypassPermissions\"\n    }\n  },\n  \"providers\": {\n    \"glm\": {\n      \"env\": {\n        \"ANTHROPIC_BASE_URL\": \"https://open.bigmodel.cn/api/anthropic\",\n        \"ANTHROPIC_AUTH_TOKEN\": \"YOUR_API_KEY_HERE\",\n        \"ANTHROPIC_MODEL\": \"glm-4.7\"\n      }\n    },\n    \"kimi\": {\n      \"env\": {\n        \"ANTHROPIC_BASE_URL\": \"https://api.moonshot.cn/anthropic\",\n        \"ANTHROPIC_AUTH_TOKEN\": \"YOUR_API_KEY_HERE\",\n        \"ANTHROPIC_MODEL\": \"kimi-k2-thinking\"\n      }\n    }\n  }\n}\n```\n\n\u003e **安全警告**：`bypassPermissions` 允许 Claude Code 无需确认即可执行工具。仅在受信任的环境中使用。\n\n### 3. 使用\n\n```bash\n# 查看帮助信息\nccc --help\n\n# 切换到指定提供商并运行 Claude Code\nccc glm\n\n# 使用当前提供商\nccc\n\n# 传递任何 Claude Code 参数\nccc glm -p\n```\n\n### 4. 验证（可选）\n\n验证提供商配置：\n\n```bash\n# 验证当前提供商\nccc validate\n\n# 验证所有提供商\nccc validate --all\n```\n\n## 配置合并策略\n\n**你的配置永远不会丢失！** ccc 遵循以下原则合并配置：\n\n- **优先级**：用户的 `settings.json` 配置具有最高优先级\n- **提供商配置**：ccc.json 中的提供商特定配置覆盖基础设置\n- **基础设置**：ccc.json 中的 `settings` 字段作为共享模板\n\n#### 保留的内容\n\n- ✅ 用户安装的插件（`enabledPlugins`）- 不会被覆盖\n- ✅ 手动编辑的 `settings.json`（权限、沙箱等）- 完全保留\n- ✅ 用户配置的其他 hooks（PreToolUse、SessionStart 等）- 被尊重\n- ✅ 用户在 `settings.json` 中手动设置的环境变量 - 不会被删除（除了冲突，见下文）\n\n#### 管理的内容\n\n- 🤖 Supervisor Stop hook - 自动添加/确保\n- 🧹 环境变量冲突 - `ANTHROPIC_*`、`CLAUDE_*` 和提供商 env 键从 `settings.json` 中移除以避免歧义\n- ⚙️ Hook 执行标志 - `disableAllHooks` 和 `allowManagedHooksOnly` 设置为 `false` 以确保 hooks 能正常工作\n\n#### 工作原理\n\n当你运行 `ccc` 时：\n1. 读取现有的 `settings.json`（如果存在）\n2. 按优先级合并配置：`用户 \u003e 提供商 \u003e 基础`\n3. 提供商的环境变量通过命令行传递（不写入 `settings.json`）\n4. 添加 Supervisor Stop hook（如果需要）同时保留用户的其他 hooks\n\n这样可以确保你的手动配置永远不会丢失！\n\n## Supervisor 模式（推荐）\n\nSupervisor 模式是 `ccc` 最有价值的特性。它会在 Agent 每次停止后自动审查工作质量，如果未完成则提供反馈让 Agent 继续执行。\n\n### 如何使用\n\n1. 启动 `ccc`，与 Agent 沟通确认需求和方案：\n\n   ```bash\n   ccc\n   ```\n\n2. 使用斜杠命令启用 Supervisor 模式：\n\n   ```text\n   /supervisor 好，开始执行\n   ```\n\n3. Agent 会执行任务，Supervisor 会在每次停止后自动审查\n   - 如果工作未完成，Supervisor 会提供反馈，Agent 继续执行\n   - 重复直到 Supervisor 确认工作完成\n\n### 工作原理\n\n1. Agent 完成任务并停止，触发 Claude Code 的 Stop Hook\n2. Supervisor（一个 Claude 实例）执行严格的审查工作\n3. 如果工作未完成或质量不佳，Supervisor 提供反馈\n4. Agent 根据反馈继续工作\n5. 重复直到 Supervisor 确认工作完成\n\n### Statusline显示\n\n可以在Claude code里输入以下指令，帮你配置好Statusline显示。\n\n```text\n/statusline 帮我配置statusline脚本，里面调用 `ccc supervisor-mode` 命令，这个命令会输出 on 或者 off，我希望显示成类似 ... | supervisor on 这样的效果。\n```\n\n## Patch 命令：用 ccc 替代 `claude` 命令\n\n通过替换系统中的 `claude` 命令，让任何调用 `claude` 的工具都使用配置了提供商的 `ccc` 命令。\n\n```bash\n# 用 ccc 替换 claude 命令（需要 sudo 权限）\nsudo ccc patch\n\n# 替换后，`claude` 命令现在会调用 ccc\nclaude --help    # 显示 ccc 的帮助信息\n\n# 恢复原始 claude 命令\nsudo ccc patch --reset\n```\n\n## 配置说明\n\n配置文件位置，默认为：`~/.claude/ccc.json`\n\n### 完整配置示例\n\n```json\n{\n  \"settings\": {\n    \"permissions\": {\n      \"defaultMode\": \"bypassPermissions\"\n    },\n    \"alwaysThinkingEnabled\": true\n  },\n  \"supervisor\": {\n    \"max_iterations\": 20,\n    \"timeout_seconds\": 600\n  },\n  \"claude_args\": [\"--verbose\"],\n  \"current_provider\": \"glm\",\n  \"providers\": {\n    \"glm\": {\n      \"env\": {\n        \"ANTHROPIC_BASE_URL\": \"https://open.bigmodel.cn/api/anthropic\",\n        \"ANTHROPIC_AUTH_TOKEN\": \"YOUR_API_KEY_HERE\",\n        \"ANTHROPIC_MODEL\": \"glm-4.7\"\n      }\n    },\n    \"kimi\": {\n      \"env\": {\n        \"ANTHROPIC_BASE_URL\": \"https://api.moonshot.cn/anthropic\",\n        \"ANTHROPIC_AUTH_TOKEN\": \"YOUR_API_KEY_HERE\",\n        \"ANTHROPIC_MODEL\": \"kimi-k2-thinking\",\n        \"ANTHROPIC_SMALL_FAST_MODEL\": \"kimi-k2-0905-preview\"\n      }\n    }\n  }\n}\n```\n\n### 配置字段说明\n\n| 字段               | 说明                                  |\n| ------------------ | ------------------------------------- |\n| `settings`         | 所有提供商共享的 Claude Code 配置模板 |\n| `supervisor`       | Supervisor 模式配置（可选）           |\n| `claude_args`      | 固定传递给 Claude Code 的参数（可选） |\n| `current_provider` | 当前使用的提供商（由 ccc 自动管理）   |\n| `providers.{name}` | 提供商特定的 Claude Code 配置         |\n\n### 提供商配置\n\n每个提供商只需指定要覆盖的字段。常用字段：\n\n| 字段                             | 说明               |\n| -------------------------------- | ------------------ |\n| `env.ANTHROPIC_BASE_URL`         | API 端点 URL       |\n| `env.ANTHROPIC_AUTH_TOKEN`       | API 密钥/令牌      |\n| `env.ANTHROPIC_MODEL`            | 使用的主模型       |\n| `env.ANTHROPIC_SMALL_FAST_MODEL` | 快速任务使用的模型 |\n\n**合并方式**：提供商设置与基础模板深度合并。提供商的 `env` 优先于 `settings.env`。\n\n### Supervisor 配置\n\n| 字段              | 说明                             | 默认值  |\n| ----------------- | -------------------------------- | ------- |\n| `max_iterations`  | 当前会话强制停止前的最大迭代次数 | `20`    |\n| `timeout_seconds` | 每次 supervisor 调用的超时时间   | `600`   |\n\n### 自定义 Supervisor 提示词\n\n创建 `~/.claude/SUPERVISOR.md` 来自定义 Supervisor 提示词。此文件会使用你自己的指令覆盖默认的审查行为。\n\n### 环境变量\n\n| 变量             | 说明                                       |\n| ---------------- | ------------------------------------------ |\n| `CCC_CONFIG_DIR` | 覆盖配置目录（默认：`~/.claude/`）         |\n\n```bash\n# 使用自定义配置目录调试\nCCC_CONFIG_DIR=./tmp ccc glm\n```\n\n## 从源码构建\n\n```bash\n# 构建所有平台\n./build.sh --all\n\n# 构建指定平台\n./build.sh -p darwin-arm64,linux-amd64\n\n# 自定义输出目录\n./build.sh -o ./bin\n```\n\n**支持的平台：** `darwin-amd64`、`darwin-arm64`、`linux-amd64`、`linux-arm64`\n\n## 开源许可证\n\nMIT License - 详见 LICENSE 文件。\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguyskk%2Fclaude-code-supervisor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguyskk%2Fclaude-code-supervisor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguyskk%2Fclaude-code-supervisor/lists"}