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 許可證。