nyldn/claude-octopus

Claude Octopus – 为 Claude Code 提供的多 LLM 编排层

是什么 – Claude Octopus 是 Claude Code（Anthropic 的 IDE 风格编程助手）的插件。它在你显式调用 /octo:* 命令前保持待机状态，之后可并行或以结构化“议会”形式调用最多 12 个外部 LLM 提供商（例如 Codex、Antigravity CLI、GitHub Copilot、Qwen、Ollama、Perplexity、OpenRouter、OrcaRouter、OpenCode、Grok、Kimi Code），执行共识门控审查、对抗性评议或完整的“规格到软件”流水线。内置的 Claude 模型保持默认；Octopus 仅在你需要多个意见、对抗性审查或更严格的质量门控时作为 升级 使用。

核心功能

• 共识门控 – 75% 的一致阈值可在代码发布前标记分歧。
• 持久化记忆 – 与 claude‑mem 和 agentmemory 集成，使决策和研究结果在会话间持续保留。
• “暗工厂”模式 – 提供规格后，Octopus 可自动运行完整流水线（研究 → 定义 → 开发 → 交付）；你只需审查最终输出。
• 方法感知工作流 – 预置的架构、TDD、调试等流程，每种自动选择合适的角色组合。
• 多 LLM 议会 – /octo:council 可召集 3–7 个来自不同提供商的角色，目标（建议、决策、计划、实现、审查）和风格（平衡、对抗、红队、高管）可配置。
• 丰富的角色库 – 31 个专业 AI 角色（安全审计员、后端架构师等）和 53 个斜杠命令，映射到 63 个可复用的工作流模块。
• 零提供者启动 – 你可安装 Octopus 并立即使用 Claude 单独工作；外部提供者逐个添加，仅在显式工作流中可用。
• 成本意识 – 5 个提供者（Codex、Antigravity CLI、Copilot、Cursor CLI、Ollama）若你已有订阅或本地运行，则无需额外费用。

使用方式

1. 安装 通过 Claude Code 的插件市场（/plugin → marketplace → install octo）。
2. 在 Claude 会话中运行 /octo:setup —— 该命令会检测已安装的外部提供者，并引导你完成必要配置。
3. 调用工作流，例如：

   /octo:embrace   # 完整的 Discover → Define → Develop → Deliver 流水线
   /octo:council --goal decision --style adversarial "我们应该拆分这个单体应用吗？"
   /octo:review   # 由第二个模型独立进行代码审查
   

4. 可选 自动路由 模式可建议或自动调用 Octopus 处理普通提示（OCTOPUS_AUTO_ROUTER_MODE=suggest|invoke）。

支持环境 – 原生支持 Claude Code，但仓库还包含：

• 一个 Codex CLI 插件（codex plugin add claude‑octopus）。
• 一个 MCP 服务器（用于 Cursor IDE；Node.js 服务器，公开 octopus_discover 等工具）。
• OpenCode 及其他 Claude 兼容主机的简易安装脚本。

版本 11.2.0 亮点

• 基于 Matt Pocock 技能集衍生的新工程方法。
• 默认模型阵容：Claude Opus 5（架构与安全）、GPT‑5.6 Sol（实现/审查）、Claude Sonnet 5（标准席位），可选 Claude Fable 5.1。
• 环境变量支持细粒度控制（如 OCTOPUS_OPUS5_AUTO_XHIGH、OCTOPUS_CONTEXT_AWARENESS）。

安全与更新

• 所有 Octopus 命令均需显式斜杠命令触发；模型无法在你未指示时自动调用 Octopus。
• 内置诊断工具（octopus doctor config、octopus doctor skills、octopus doctor updates）。
• 自动更新默认关闭；你可通过 Claude UI 启用，或运行提供的 orchestrate.sh 脚本。

适用人群 – 已使用 Claude Code 并希望为高风险代码、架构决策或自主“规格到代码”流水线提供 受控的多模型审查层，而无需手动在不同 AI 服务间切换的开发者。

---

总结 – Claude Octopus 是一个开源编排插件，使 Claude Code 能调用多达 12 个其他 LLM 提供商，执行共识检查，并在显式用户命令下自动化端到端开发工作流。