
claude-octopus
让8个AI同时干活,交叉验证,提前发现盲区。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4417
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Claude Code CLI(需支持 plugin 子命令)
- Node.js 与 npm(用于安装 mcp-server 依赖)
- 至少一个外部提供商的凭据(如 Codex、Copilot、Antigravity 走 OAuth 订阅,或 Qwen、Perplexity、OpenRouter
- 可选:Anthropic 兼容网关地址
安装与启动步骤
-
1添加插件市场
先把 nyldn-plugins 市场加入 Claude Code,Octopus 通过该市场分发安装。
claude plugin marketplace add https://github.com/nyldn/plugins.git -
2安装 Octopus 插件
从市场安装 octo 插件,装好后才能使用 /octo 系列命令。
claude plugin install octo@nyldn-plugins -
3安装 MCP 依赖
进入插件的 mcp-server 目录执行 npm install,路径以你本机实际安装位置为准。
cd ~/.cursor/claude-octopus/mcp-server && npm install -
4运行诊断命令
检查安装路径、版本、清单、技能加载与自动更新状态,确认环境正常。
octopus doctor config octopus doctor skills octopus doctor updates -
5配置兼容网关
使用 Anthropic 兼容网关时需显式开启模型发现,否则 /model 无法发现网关模型。
export ANTHROPIC_BASE_URL=https://your-gateway.example/v1 export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 -
6查看运行成本
跑昂贵任务前用 /octo:costs 看会话预估,跑完用 /octo:usage 看各提供商实际花费。
/octo:costs /octo:usage
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ANTHROPIC_BASE_URL | 否 | Anthropic 兼容网关地址,仅在走网关时设置。 | https://your-gateway.example/v1 |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVE | 否 | Claude Code v2.1.129+ 开启 /v1/models 模型发现。 | 1 |
skillOverrides | 否 | Claude 设置项,可把冷门技能设为 name-only 以降低上下文占用。 | name-only |
如何确认成功
执行 octopus doctor config 能正常打印安装路径、版本与清单,且 /octo 系列命令可调用。
常见问题
Q:插件更新失败怎么办?
A:按 README 的干净重装流程:先 claude plugin uninstall claude-octopus 和 octo,删除 ~/.claude/plugins/cache/nyldn-plugins/octo,移除并重新添加市场,再安装 octo@nyldn-plugins。
Q:设置网关后 /model 看不到模型?
A:Claude Code v2.1.129+ 需要显式 opt-in,请先 export ANTHROPIC_BASE_URL 与 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1。
Q:怎么预估一次运行要花多少钱?
A:运行前用 /octo:costs 查看会话成本预估,项目超 1 美元会在派发前提示;运行后用 /octo:usage 查看实际花费明细。
Q:技能太多导致上下文占用高?
A:可用 Claude 设置里的 skillOverrides,把不常用技能设为 name-only 或 user-invocable-only,保持可安装但减少上下文加载。
注意事项
- README 中 Quickstart 的第 1 步被截断,本教程的安装路径取自 README 给出的干净重装命令,请以实际仓库最新说明为准。
- Claude Octopus 是独立开源项目,与 Anthropic 无关联、未获其背书或赞助。
- README 中的成本表为示例性 Token 估算(费率核对于 2026-09-04),不含提供商工具费用,大额支出前请核对官方价目表。
- 诊断机制无法让过旧的安装自行修复,早于该机制的版本需要手动更新一次。
核心亮点
- 同时调用8个主流AI模型,覆盖Claude、Gemini、Codex等,交叉验证结果,减少单一模型偏见
- 基于双钻模型设计,系统化覆盖研究、设计、编码全流程,提升任务完成质量
- Shell实现轻量易集成,可快速接入现有开发工具链,无需复杂配置
不足之处
- 多模型并行调用可能带来较高API成本,对预算敏感用户不友好
- 文档/社区待观察
适用场景
- 关键代码审查,用多模型交叉验证逻辑漏洞
- 产品设计方案多角度评估,避免思维定式
- 复杂研究任务,聚合不同AI的调研结果
替代项目
ChatDev、AutoGen、MetaGPT
下一篇:PraisonAI
同类项目推荐
claude-forge
开源
给 Claude Code 装上 11 个代理和 36 个命令,5 分钟搞定扩展。
oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in o···
eve-software-factory-template
开源
用智能体流水线自动把需求变成代码
Meet Foreman, an eve Software Factory.
openai-cua-sample-app
开源
官方示例带你跑通 AI 操作电脑全流程
Learn how to use CUA (our Computer Using Agent) via the API on multiple computer env···
agent-playground
开源
在浏览器里快速搭一个 AI Agent 原型,跑通对话和工具调用。
swarm-foraging-qlearn
开源
用Q学习让一群智能体在动态网格里学会找吃的
Q-Learning Swarm Foraging 2026: Multi-Agent RL in Dynamic Grid Environments
nanocoder
开源
代码不出自己电脑,社区版 AI 也能独当一面。
An open coding agent for your terminal, built by a community collective rather than ···
ghostclaw
开源
让 AI 住在你电脑里,动嘴就能干活
an AI that lives on your computer and does stuff for you. Public beta.
embodied-agents
开源
把大模型塞进机器人,几行代码搞定智能体
Seamlessly integrate state-of-the-art transformer models into robotics stacks
zexus
开源
用自然语言驱动 Revit,AI 自动写代码完成 BIM 自动化。
In-process Revit AI agent with dynamic C# code execution, multi-provider LLM support···