claude-army

🪖 ClaudeArmy

Claude が複数のプロジェクトで自律的に作業する Claude Code エージェントを統括できる MCP サーバーです。

できること

ClaudeArmy を使うと、Claude（チャットインターフェース）から、コーディングタスクに独立して取り組む Claude Code のバックグラウンドプロセスを起動できます。指揮系統にたとえると、次のようになります。

• あなた → 戦略的な方針を指示します
• Claude（チャット） → タスクを分割し、エージェントを派遣します
• Claude Code エージェント → 自律的に実行し、必要に応じて独自のサブエージェントを起動します

これにより、複数のプロジェクトで同時に作業を開始し、通常どおりチャットを続けながら、いつでも進捗を確認できます。

ツール

ツール	説明
dispatch_task	Claude Code エージェントをプロジェクトディレクトリに派遣します。複数エージェントの連携に対応する mode: "team" をサポートしています
check_tasks	実行中または完了したすべてのエージェントの状態を監視します
get_task_output	エージェントの作業内容と完全な出力を取得します
get_agent_team	リードエージェントとすべてのサブエージェントの詳細を表示します
cancel_task	実行中のエージェントを正常に停止します
purge_tasks	完了または失敗したタスクをクリーンアップします

セットアップ

1. このリポジトリをクローンします

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 をよりモジュール化し、Reporting Tool に 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 の Task ツール経由で起動したサブエージェントを追跡
• 新しい get_agent_team ツール：リードエージェントとすべてのサブエージェントのツリー表示
• check_tasks がチームの処理におけるサブエージェントの概要を表示するように変更
• dispatch_task に mode パラメーターを追加：solo（デフォルト）または team
• クロスプラットフォーム対応：Windows バイナリ（claude.cmd）とシグナル処理を修正
• エラーメッセージに、プラットフォームに応じた診断コマンドを表示
• README に Linux、macOS、Windows のセットアップパスを追加

v0.3.0

• assistant のメッセージコンテンツ配列を正しく処理できるよう、stream-json の解析を修正しました
• 古さの表示：check_tasks にエージェントが最後にアクティブだった時刻からの経過時間が表示されるようになりました
• エラーの明確化：CLI が見つからない場合、権限が拒否された場合、実行中に失敗した場合に、対処方法がわかるメッセージを表示するようになりました
• get_task_output の出力の重複を修正しました
• README にデモ GIF を追加しました

v0.2.0

• Claude Code の stream-json 出力を利用したリアルタイムの進捗追跡
• check_tasks に実行時間だけでなく、エージェントの最近のアクティビティ（ファイルの読み取り、編集、bash コマンド）が表示されるようになりました
• get_task_output にタイムスタンプ付きの進捗タイムライン全体が含まれるようになりました
• ツールの使用、assistant メッセージ、結果を構造化して解析

v0.1.0

• 初回リリース
• コアツール：dispatch_task、check_tasks、get_task_output、cancel_task、purge_tasks
• バックグラウンドプロセス管理を備えた、結果を待たずに実行するアーキテクチャ
• 同時実行できるエージェントは最大 5 つ
• MCP 通信に stdio トランスポートを使用

ライセンス

MIT