Agent 插件 · 社区项目

Claude Octopus

让 Claude Code 或 Codex 调度多个可选模型提供商,对研究、设计、实现与审查任务进行分工、辩论和共识检查的本地插件;默认不主动调用外部提供商。

4.1k StarsMITShell今天更新
01

项目介绍

Claude Octopus 是一个面向本地编码 Agent 的多模型编排插件。它把研究、需求定义、实现、审查和交付组织成显式工作流,并可让 Codex、Copilot、Qwen、Ollama、Perplexity、OpenRouter 等已配置提供商承担不同席位,再由宿主模型综合结果。插件在没有外部提供商时仍可使用 Persona、Skill 和单宿主流程,默认也不会从普通 Prompt 自动发起付费调用。它的收益来自独立意见和可见的失败状态,代价则是更宽的数据边界、更多工具权限、额外延迟与费用,因此首次采用应在测试仓库固定版本、审查钩子并限制提供商范围。

Claude Octopus 在终端中运行 debate 与 research 工作流的演示
仓库演示展示了通过 /octo:* 命令启动多模型辩论与研究工作流的终端交互。查看仓库原图
02

核心功能

01

多提供商研究与共识

research、debate 与 council 可为不同模型分配独立席位,汇总贡献、分歧和失败状态,并在需要时应用 75% 共识门禁。

02

四阶段工程工作流

Discover、Define、Develop、Deliver 分别覆盖探索、需求收敛、实现与交付审查,embrace 可把四阶段串成完整路径。

03

角色化工程方法

31 个 Persona 与 63 个 Skill 覆盖架构、TDD、调试、安全、文档、设计、研究和项目交付;普通请求不会仅因关键词自动委派敏感角色。

04

提供商与成本控制

能力检查、模型路由、上下文预算、熔断、会话禁用、成本预估和用量报告帮助用户控制可用席位与费用,但不能证明账户权益或最终账单。

05

安装诊断与离线审计

Doctor、capabilities、cache-check、repair dry-run 与 security-audit 可检查安装、提供商静态就绪状态和高风险 Shell 模式,其中修复应用需要单独授权。

03

安装与使用

先在测试仓库选择 Claude Code 或 Codex 原生插件路径,固定 v11.9.4 并审查清单与钩子。完成安装后先运行只读 Doctor,再只配置一个提供商,用低风险研究或只读审查验证路由、外发范围和成本提示;确认策略前不要启用 invoke 自动路由。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我在隔离测试仓库安装并最小验证 Claude Octopus。项目地址:https://github.com/nyldn/claude-octopus。先阅读 README、docs/PLUGIN-COMPATIBILITY.md、docs/INSTALLATION-HEALTH.md、docs/PRIVACY.md、SECURITY.md 和 v11.9.4 Release,展示拟安装版本、提交、插件清单、钩子、用户目录与项目目录写入范围。按我当前的 Claude Code 或 Codex 宿主使用官方 Marketplace 命令,重启后先运行只读 Doctor。只配置我指定的一个提供商,并用不含秘密的公开文本任务验证一次只读 research 或 review。不要启用 OCTOPUS_AUTO_ROUTER_MODE=invoke,不要写生产代码、创建 PR、扩大凭据权限或自动修复。最后报告参与提供商、外发内容、成本提示、生成文件、卸载与保留数据位置,以及仍未验证的能力。
01开始前准备
  • Linux、macOS 或 WSL 环境
  • Claude Code v2.1.14+ 或支持 Plugin Marketplace 的 Codex CLI
  • 如使用 MCP 路径,需要 Node.js 18+ 和支持 stdio MCP 的客户端
  • 多模型功能需要至少一个外部提供商 CLI、登录会话或 API 密钥
  • 允许插件在用户目录与测试项目写入状态、日志和配置
02复制安装命令或配置
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins
# 重启 Claude Code 后运行:/octo:setup
03按步骤完成安装
  1. 1
    固定版本并审查权限

    确认 v11.9.4 与提交 9cc6bcc,阅读对应宿主清单、钩子、隐私和安全文档,记录将写入的用户与项目目录。

  2. 2
    安装到一个测试宿主

    按 README 的 Marketplace 命令安装到 Claude Code 或 Codex,重启宿主,不要同时配置多个入口。

  3. 3
    先运行只读健康检查

    运行 Doctor、capabilities 和 cache-check,区分插件发现、提供商安装、认证、模型权益与配额状态。

  4. 4
    验证一个只读工作流

    只配置一个提供商,对公开文本执行 research 或 review,检查激活指示、贡献表、成本提示和本地结果。

  5. 5
    再决定自动化边界

    根据数据外发、费用和失败行为设置白名单与成本上限;确认前保持普通 Prompt 路由为 suggest 或 off。

如何确认安装成功

重启宿主后先运行 octopus doctor installation 或显式调用 skill-doctor,确认插件根目录和缓存检查通过。随后用一个不含秘密的公开文本任务运行只读 research 或 review,核对激活指示、参与提供商、成本提示、结果文件和 agent-summary;首次验证不要启用自动 invoke、写代码、创建 PR 或使用生产凭据。

使用前注意
  • 安装成功只证明插件被发现,不证明提供商已登录、模型可用、配额充足或计费方式正确。
  • Codex 的 careful 模式对匹配命令执行拒绝而非交互询问,行为不同于 Claude Code。
  • uninstall 不会自动删除 ~/.claude-octopus/ 或项目 .octo/ 中保留的结果与状态。
  • Cursor 通过 MCP 工具使用工作流,不提供 /octo:* 命令、Claude Code 钩子或 HUD。
  • 启用 invoke 自动路由前应设置提供商允许列表和 OCTOPUS_MAX_COST_USD。
04

使用场景

SCENARIO 01

架构方案辩论

让不同提供商独立分析单体与微服务等选择,再由 Council 展示分歧、风险和决策依据。

SCENARIO 02

跨模型代码审查

由实现模型之外的席位检查边界条件、安全问题和测试缺口,降低同一模型自审的盲区。

SCENARIO 03

带出处的技术研究

让多个研究席位并行收集资料,并在综合时保留来源、贡献状态和不确定性。

SCENARIO 04

分阶段复杂交付

用 Discover、Define、Develop、Deliver 把长任务分段,并在阶段间应用人工或共识门禁。

05

使用评价

Claude Octopus 的优势是把多模型意见、工程阶段、提供商状态和成本边界放进同一套显式工作流,而不是只增加一个聊天入口。对于高价值研究、架构抉择和独立审查,这能暴露单模型容易忽略的分歧。代价也很直接:插件包含大量 Shell、钩子和宿主适配层,外部席位会扩大代码与 Prompt 的接收方,并增加费用与故障组合。它适合愿意管理版本、权限、提供商和证据的团队,不适合作为无需监督的质量保证器。

值得一试的地方

  • Claude Code 与 Codex 都有原生插件清单和明确安装入口
  • 外部提供商可选,普通 Prompt 路由默认不自动发起付费调用
  • 研究、辩论、Council、审查与四阶段交付覆盖面完整
  • 公开隐私、安全、兼容性、安装诊断和提供商接线文档较细
  • Doctor、成本预估、贡献台账和失败降级提高运行可见性
  • v11.9.4 于 2026-09-28 发布,仓库仍在活跃维护

使用前要知道

  • 多提供商共识仍可能共享同类训练偏差或同时得出错误结论
  • 不同 CLI 的认证、沙箱、模型和计费语义使调试复杂
  • 生命周期钩子和 Shell 调度扩大了安装前需要审查的代码面
  • 外部模型可能接收代码、Prompt 与工作流上下文,需逐个评估保留政策
  • MCP、Cursor、Codex 与 Claude Code 的能力并不完全一致
  • 本次评估没有执行安装或真实多模型工作流
06

README

Claude Octopus


Overview

让 Claude Code 或 Codex 调度多个可选模型提供商,对研究、设计、实现与审查任务进行分工、辩论和共识检查的本地插件;默认不主动调用外部提供商。 Run multiple AI models against the same research, design, or coding task. Surface disagreements before you ship.

Getting started

  • 先在测试仓库选择 Claude Code 或 Codex 原生插件路径,固定 v11.9.4 并审查清单与钩子。完成安装后先运行只读 Doctor,再只配置一个提供商,用低风险研究或只读审查验证路由、外发范围和成本提示;确认策略前不要启用 invoke 自动路由。
  • Claude Octopus 提供研究、辩论、Council、审查、安全、TDD、调试和端到端构建等显式工作流。
  • 四阶段主流程采用 Discover、Define、Develop、Deliver,也可用 embrace 串联运行。
  • 重启宿主后先运行 octopus doctor installation 或显式调用 skill-doctor,确认插件根目录和缓存检查通过。随后用一个不含秘密的公开文本任务运行只读 research 或 review,核对激活指示、参与提供商、成本提示、结果文件和 agent-summary;首次验证不要启用自动 invoke、写代码、创建 PR 或使用生产凭据。

Configuration

claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins
# 重启 Claude Code 后运行:/octo:setup
在 GitHub 阅读完整 README →