1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | claude-octopus | GitHub 仓库名 |
| 作者/维护者 | Chris S(GitHub:nyldn) | GitHub API |
| 来源链接 | https://github.com/nyldn/claude-octopus | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 3,861 | GitHub API |
| Forks | 362 | GitHub API |
| 最新版本 | v9.54.1(2026-07-20 发布) | GitHub Releases |
| 安装方式 | Claude Code 插件市场一条命令;另提供 Codex CLI、Cursor、OpenClaw 的专门安装步骤 | 官方 README |
仓库创建于 2026-01-15,半年内积累 3,861 星、362 次 Fork,26 位贡献者、1,414 次提交、192 条 Issue,最近提交距今 2 天,属高频活跃维护项目。
2. 功能介绍与亮点
claude-octopus 让 Claude Code 按需调用多个外部 AI 模型交叉核验,而非只依赖单一模型判断:
- 多模型协同:可选接入 Codex、Gemini、Copilot、Qwen、Ollama、Perplexity、Grok 等十家外部服务,仅 Claude 必需,其余按需自动探测
- 共识把关:多模型辩论(
/octo:debate)与人格议会(/octo:council)内置 75% 一致性门槛,分歧未达标不放行结论 - 四阶段方法论:借鉴 Double Diamond 模型分为 Discover/Define/Develop/Deliver 四阶段,可单独运行或串联,支持监督/半自主/全自主三档
- 32 个专家人格:按工程、开发、文档、研究、合规、设计六类自动激活,如提到“审计 API 漏洞”会切换到安全审计人格
- 成本透明:
/octo:costs执行前给出预估花费,超 1 美元预先提示;仅用内置 Claude 不产生额外费用 - 反应引擎:agent 提交 PR 后自动监控 CI 失败、评审意见等并按配置重试或升级通知
3. 适用场景
固定分类:元技能与 Agent 增强
适用于已在用 Claude Code 处理研究、代码评审、架构决策,希望关键结论获多模型交叉验证而非只信单一模型判断的中高级开发者与技术团队。零外部服务配置即可用全部 32 个人格与工作流,外部模型只是锦上添花而非必需依赖。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方主平台,插件市场一条命令安装,要求 Claude Code v2.1.50 及以上版本 |
| Codex | 支持 | README 提供专门安装步骤:克隆仓库后软链接至 ~/.agents/skills,重启 Codex 后技能自动被发现 |
| OpenClaw | 支持 | 官方提供独立兼容层(MCP Server + OpenClaw Extension),默认不启动,需手动在 .mcp.json 中开启 |
| Hermes Agent | 未验证 | 已抓取材料中未提及 Hermes Agent 支持 |
5. 推荐理由
单一模型审查代码或做架构决策时,容易把自己的思维盲区当成“已充分考虑”。claude-octopus 把 Claude Code 变成可按需升级的多模型协作现场:需要更高把握时调用 Codex、Gemini 等外部模型交叉复核,用 75% 一致性门槛卡住有分歧的结论。不接入外部服务时,32 个专家人格与四阶段工作流已是一套完整可用的结构化开发方法论;接入外部模型后,辩论、共识议会等进阶能力才会解锁。半年内 192 条 Issue、26 位贡献者的真实社区反馈,说明它已在被日常使用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,861 星、362 Fork,创建仅半年即达到该规模,增速显著;192 条 Issue、26 位贡献者构成的社区互动量在同规模项目中偏高 |
| 可用性 | 7 | 插件市场一条命令安装,零外部服务即可用全部人格与工作流;但完整体验涉及 10 个外部服务商的可选配置与版本要求(Claude Code v2.1.50+),学习成本高于单一功能类技能 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 7.7 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 有代码执行:仓库自带正式 SECURITY.md 威胁模型,明确列出用户输入、环境变量、任务文件、CI/CD 等信任边界及对应缓解措施(参数化执行、路径校验、allowlist 校验) |
| ② 运行时联网外发 | 按需联网:仅在用户显式启用某外部模型服务时才会调用对应 API;每次调用均有可见的服务商图标提示,结果统一存放在 ~/.claude-octopus/results/,官方文档明确“没有隐藏行为” |
| ③ API Key/凭据 | 全部可选,经环境变量传入;官方文档说明密钥在日志与详细输出中会被掩码处理,不写入日志文件 |
| ④ 可疑指令排查 | 已抓取核心技能文件,未发现可疑指令;仓库同时提供面向 CI/CD 场景的输入消毒与命令白名单机制 |
| ⑤ 作者/组织信誉 | 个人开发者(非机构出品),身份公开可查;星标增长与 Fork 数、贡献者数、Issue 讨论量整体匹配,未见异常刷量迹象 |
| ⑥ License | MIT,权利义务明确 |
| ⑦ 最近维护 | 最新版本 v9.54.1 于 2026-07-20 发布,近半年保持每周甚至更高频率的版本迭代,无弃置风险 |
综合看,本技能代码执行边界明确、联网按需且行为透明、无强制凭据、无可疑指令,且有正式威胁模型与缓解措施记录,达到“范围明确可审计”档;因非机构出品未给满分。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| council-of-high-intelligence(GitHub 3,629★) | 召集 18 位历史人物原型分析人格,专注对单个重大决策做多角度辩论并出具裁决书 | 聚焦“一次性决策审查”这一单点场景;claude-octopus 覆盖调研、开发、评审、交付的完整生命周期,人格议会只是其中一个命令,另有代码实现、TDD、安全扫描等工作流 |
| Superpowers(obra/superpowers) | 为单个 Claude Code agent 提供“规格→计划→子代理开发”的结构化方法论,长任务专注度强 | 全程只用 Claude 一个模型,不引入外部模型交叉验证;claude-octopus 在此基础上叠加最多 10 个外部模型的共识把关,两者可以互补而非互斥 |
| wshobson/agents(多平台 Agent 插件市场) | 面向 Claude Code、Codex 等多个宿主的技能与人格插件集合,以数量和覆盖面见长 | 更像一个技能超市,各插件相对独立;claude-octopus 是围绕“多模型互相校验”这一单一设计理念构建的一体化系统,各命令共享同一套共识门槛与人格路由逻辑 |
核心差异化:多数同类项目要么专注单一场景,要么靠单一模型把方法论做深;claude-octopus 把“多模型互相挑错”作为贯穿调研、开发、评审、交付全流程的默认能力,未配置外部模型时也是独立可用的开发工具。
8. 用户评价
该项目在 GitHub Issues 中有持续的具名用户互动:用户 pmdci 在 Issue #220 提出希望集成 mcp-memory-service 作为 claude-mem 的替代记忆后端;用户 oojacoboo 在 Issue #17 报告插件更新失败,获作者多轮跟进修复。累计 192 条 Issue、多位独立用户参与讨论,但尚未在第三方评价平台发现独立于开发者的正式评测文章。
9. 其他补充
项目同时提供 Cursor IDE 的 MCP Server 集成(Cursor 无 Claude Code 的插件系统,故以 MCP 工具形式提供 octopus_review 等能力);README 附带与 Superpowers、纯 Claude Code 的对比表,说明三者定位差异而非相互替代。
10. 安装使用方式
Claude Code(推荐):
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins
安装后运行 /octo:setup,向导自动检测已装的外部模型服务商并引导配置;无需任何外部服务即可用全部 32 个人格与四阶段工作流。
Codex CLI:
git clone --depth 1 https://github.com/nyldn/claude-octopus.git ~/.codex/claude-octopus
mkdir -p ~/.agents/skills
ln -sf ~/.codex/claude-octopus/skills ~/.agents/skills/claude-octopus
重启 Codex 后技能自动出现,可用 $skill-doctor 等方式调用。
OpenClaw: 默认不启动,需在项目或全局 .mcp.json 中显式添加 MCP Server 配置(OCTO_CLAW_ENABLED=true)后启用,随附独立的 OpenClaw Extension 包。
安装后注意事项: 首次安装建议先运行 /octo:setup 完成向导配置;如需接入外部模型,按需补充对应 API Key 或完成 OAuth 登录,未配置的服务商会被自动跳过而不影响核心功能;大规模多模型任务前可用 /octo:costs 查看预估花费。
11. 注意事项
- 完整体验需要 Claude Code v2.1.50 及以上版本,过旧版本可能无法使用部分兼容层功能
- 除 Claude 外其余服务商多数按 token 计费(OAuth 订阅账号除外),四阶段全流程等大任务花费可达数美元级,建议先用
/octo:costs预估 - 命令与人格数量较多(50+ 命令、58 个技能、32 个人格),初期熟悉需一定学习成本;不熟悉时可用
/octo:auto自然语言路由降低记忆负担 - Hermes Agent 兼容性目前无可验证的官方材料,如需在该环境使用建议自行小范围测试