🪖 克劳德军队
一个MCP服务器,允许Claude编排多个在不同项目中自主工作的Claude Code代理。
它的作用
ClaudeArm使Claude(在聊天界面中)能够生成独立处理编码任务的后台Claude Code进程。把它想象成一个指挥链:
- 你 → 提供战略方向
- 克劳德(ChAT) → 将其分解并派遣特工
- 克劳德代码代理 → 自主执行,根据需要生成自己的子代理
这意味着您可以同时启动多个项目的工作,保持正常聊天,并随时查看进度。
工具
| 工具 | 说明 |
|---|---|
dispatch_task | 将Claude Code代理部署到项目目录。支持 mode: "team" 用于多智能体协调 |
check_tasks | 监控所有正在运行/已完成的代理的状态 |
get_task_output | 检索代理的操作及其完整输出 |
get_agent_team | 主代理及其所有子代理的详细视图 |
cancel_task | 优雅地停止正在运行的代理 |
purge_tasks | 清理已完成/失败的任务 |
设置
- 克隆此仓库
npm install
- 添加到您的Claude Desktop配置中:
- Linux: ~/.config/Claude/claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户: %APPDATA%\Claude\claude_desktop_config.json
"claude-army": {
"command": "node",
"args": ["/path/to/claude-army/src/index.js"]
}Windows注意事项: 在路径值中使用正斜杠(例如。 "C:/Users/you/claude-army/src/index.js").- 重新启动克劳德桌面
用法示例
单个项目任务:
“将GarbageFire的app.py重构为模块化组件”
多项目并行工作:
“重构GarbageFire使其更加模块化,并在我的报告工具中添加Salesforce适配器”
Claude将向每个项目目录派遣单独的代理,让他们自主工作。
检查进度:
“特工们怎么样了?”
代理团队
使用 mode: "team" 上 dispatch_task 让主代理自动分解工作并生成并行运行的专用子代理。
它是如何工作的:
- 首席代理分析任务并将其分解为重点子任务
- 每个子任务都通过Claude Code委托给一个子代理
Task工具 - 子代理并行工作,每个子代理都有明确的范围
- 所有子代理完成后,主代理将合成结果
监测小组:
check_tasks显示子代理摘要(例如“3个子代理:1个正在运行,2个已完成”)get_agent_team提供主代理和每个子代理的详细树视图,包括状态、运行时和输出预览
配置
编辑顶部的常量 src/index.js:
CLAUDE_BINARY-克劳德代码二进制文件的路径MAX_CONCURRENT_TASKS-最大并发代理数(默认值:5)
需求
- Claude Code已安装并通过身份验证
- Node.js 18+
- Claude Desktop或任何兼容MCP的客户端
更新日志
v0.4.1
- 碰撞
@modelcontextprotocol/sdk升级到^1.26.0,解决了3个严重的供应链漏洞 - 添加
repository字段到package.json
v0.4.0
- 代理团队支持:跟踪通过Claude Code Task工具生成的子代理
- 新
get_agent_team工具:潜在客户树视图+所有子代理 check_tasks现在显示团队操作的子代理摘要dispatch_task收益mode参数:solo(默认)或team- 跨平台:固定Windows二进制文件(
claude.cmd)信号处理 - 错误消息现在显示适用于平台的诊断命令
- README:添加了Linux、macOS和Windows的安装路径
v0.3.0
- 修复了流json解析以正确处理助理消息内容数组的问题
- 稳定性指示器:
check_tasks现在显示自上次代理活动以来的时间 - 更好的错误显示:未找到CLI的可操作消息、权限被拒绝和运行中失败
- 修复了中的输出重复
get_task_output - 演示GIF已添加到README中
v0.2.0版本
- 通过Claude Code的流json输出实时跟踪进度
check_tasks现在显示最近的代理活动(文件读取、编辑、bash命令),而不仅仅是运行时get_task_output包括带有时间戳的完整进度时间表- 用于工具使用、辅助消息和结果的结构化事件解析
v0.1.0
- 初始版本
- 核心工具:调度任务、检查任务、获取任务输出、取消任务、清除任务
- 即发即弃架构,具有后台流程管理
- 最多5个并发代理
- MCP通信的stdio传输
许可证
麻省理工学院
