Claude Army

🚀 🪖 ClaudeArmy

ClaudeArmy 是一个 MCP 服务器，它能让 Claude 协调多个 Claude Code 代理，在不同项目中自主开展工作。

🚀 快速开始

ClaudeArmy 赋予了 Claude（在聊天界面中）生成后台 Claude Code 进程的能力，这些进程可以独立处理编码任务。可以将其想象成一个指挥链：

• 你 → 给出战略方向
• Claude（聊天） → 分解任务并派遣代理
• Claude Code 代理 → 自主执行任务，并在需要时生成自己的子代理

这意味着你可以同时在多个项目中启动工作，正常进行聊天，并随时查看进度。

✨ 主要特性

ClaudeArmy 提供了一系列工具，用于管理和监控 Claude Code 代理的运行：

📦 安装指南

1. 克隆此仓库：

git clone [仓库地址]

2. 安装依赖：

npm install

3. 将以下配置添加到你的 Claude Desktop 配置文件中：
   • Linux：~/.config/Claude/claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%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"）。

4. 重启 Claude Desktop。

💻 使用示例

基础用法

单项目任务

"将 GarbageFire 的 app.py 重构为模块化组件"

多项目并行工作

"将 GarbageFire 重构为更模块化的结构，并为我的报告工具添加一个 Salesforce 适配器"

Claude 将为每个项目目录派遣独立的代理，并让它们自主工作。

检查进度

"代理们的工作进展如何？"

高级用法

使用 dispatch_task 时设置 mode: "team"，主代理将自动分解工作并生成并行运行的专业子代理。

工作原理

• 主代理分析任务并将其分解为专注的子任务。
• 每个子任务通过 Claude Code 的 Task 工具委派给一个子代理。
• 子代理并行工作，每个子代理都有明确的工作范围。
• 所有子代理完成工作后，主代理将综合结果。

监控团队

• check_tasks 显示子代理摘要（例如 "3 个子代理：1 个正在运行，2 个已完成"）。
• get_agent_team 提供主代理和每个子代理的详细树状视图，包括状态、运行时间和输出预览。

🔧 技术细节

配置

你可以编辑 src/index.js 文件顶部的常量：

• CLAUDE_BINARY - Claude Code 二进制文件的路径
• MAX_CONCURRENT_TASKS - 最大并发代理数（默认值：5）

要求

• 已安装并认证 Claude Code
• Node.js 18 或更高版本
• Claude Desktop 或任何兼容 MCP 的客户端

📚 详细文档

变更日志

v0.4.1

• 将 @modelcontextprotocol/sdk 升级到 ^1.26.0，解决了 3 个高严重性的供应链漏洞。
• 在 package.json 中添加 repository 字段。

v0.4.0

• 支持代理团队：跟踪通过 Claude Code 任务工具生成的子代理。
• 新增 get_agent_team 工具：显示主代理和所有子代理的树状视图。
• check_tasks 现在显示团队操作的子代理摘要。
• dispatch_task 增加 mode 参数：solo（默认）或 team。
• 跨平台：修复了 Windows 二进制文件（claude.cmd）和信号处理。
• 错误消息现在显示适合平台的诊断命令。
• README：添加了 Linux、macOS 和 Windows 的安装路径。

v0.3.0

• 修复了 stream-json 解析，以正确处理助手消息内容数组。
• 增加陈旧性指示器：check_tasks 现在显示自上次代理活动以来的时间。
• 更好的错误显示：针对 CLI 未找到、权限被拒绝和运行中失败等情况提供可操作的消息。
• 修复了 get_task_output 中的输出重复问题。
• 在 README 中添加了演示 GIF。

v0.2.0

• 通过 Claude Code 的 stream-json 输出实现实时进度跟踪。
• check_tasks 现在显示最近的代理活动（文件读取、编辑、bash 命令），而不仅仅是运行时间。
• get_task_output 包含带有时间戳的完整进度时间线。
• 对工具使用、助手消息和结果进行结构化事件解析。

v0.1.0

• 初始版本
• 核心工具：dispatch_task、check_tasks、get_task_output、cancel_task、purge_tasks
• 支持后台进程管理的即发即忘架构
• 最大并发代理数为 5
• 使用 stdio 传输进行 MCP 通信

📄 许可证

本项目采用 MIT 许可证。