複数の Claude Code エージェントを同時に動かす方法

Claude Code のエージェントを並列で動かす 4 つの方法

サブエージェント：1 つのセッションの中の並列ヘルパー

サブエージェントは、独自のコンテキストウィンドウ、システムプロンプト、ツールを持ちます。あなたの会話は見えず、戻ってくるのは要約だけなので、メインのセッションのコンテキストを小さく保てます。Claude Code には Explore（読み取り専用）や Plan といった組み込みのサブエージェントがあり、自分で追加することもできます。

1. サブエージェントを定義する

   .claude/agents/（プロジェクトで共有）または ~/.claude/agents/（自分だけ）に Markdown ファイルを作ります。必須なのは name と description だけです。tools で使えるツールを制限し、model でモデルを選びます。

   ---
   name: code-reviewer
   description: Reviews code for quality and best practices
   tools: Read, Glob, Grep
   model: sonnet
   ---
   
   You are a code reviewer. When invoked, analyze the code and give
   specific, actionable feedback on quality, security and best practices.

2. Claude に複数を同時に動かしてもらう

   「auth、billing、search の各モジュールを並列でレビューして」のように、並列で頼みます。Claude が起動するサブエージェントはデフォルトでバックグラウンドで始まり、同時に最大 20 個まで動き、終わると報告してきます。/tasks と入力すると一覧を確認できます。

3. ファイルを編集するサブエージェントには専用の worktree を

   サブエージェントのフロントマターに isolation: worktree を追加するか、エージェントに worktree を使うよう Claude に頼みます。そうすると、各サブエージェントはリポジトリの一時的なコピーを編集し、変更がなければそのコピーは削除されます。

git worktree で Claude Code のセッションを並列に動かす

1. worktree のフォルダーを無視する

   Claude Code は、リポジトリのルートの .claude/worktrees/ に worktree を作ります。リポジトリには少なくとも 1 つのコミットが必要です。

   echo ".claude/worktrees/" >> .gitignore

2. タスクごとにセッションを 1 つ始める

   各ターミナルで、別々の名前を付けて claude --worktree（または -w）を実行します。それぞれに専用のフォルダーと、デフォルトブランチをもとにした worktree-<name> という名前のブランチが作られます。

   # ターミナル 1
   claude --worktree feature-auth
   
   # ターミナル 2
   claude --worktree bugfix-login

3. 必要な未追跡ファイルをコピーする

   新しい worktree には追跡されているファイルしかありません。.env のようなファイルを .worktreeinclude ファイル（gitignore と同じ書式）に書いておくと、Claude Code がコピーしてくれます。

   .env
   .env.local

4. マージして片付ける

   セッションが終わると、変更のない worktree はブランチごと削除され、変更のある worktree は残すかどうかを聞かれます。ブランチはほかのブランチと同じようにマージします。ヘッドレスの -p 実行では確認が出ないので、git worktree remove で削除してください。

5. デスクトップアプリを使う方法も

   Cmd+N（Windows では Ctrl+N）で新しいセッションを開き、始める前に Worktree をオンにします（デフォルトはオフです）。セッションは分割ビューで並べて表示できます。

出典：Anthropic の worktree のドキュメント

--bg と agent view によるバックグラウンドセッション

claude --bg "<prompt>" はバックグラウンドでセッションを始めてすぐに戻るので、続けていくつも始められます。各セッションは、何かを編集する前に専用の worktree に移ります。claude agents で一覧を表示し、claude logs <id>、claude attach <id>、claude stop <id> で個々のセッションを管理します。

ターミナルを閉じても動き続けますが、パソコンをシャットダウンすると止まります。Agent view はリサーチプレビューです。無人での実行について詳しくは、Claude Code のバックグラウンドエージェントを動かす方法をご覧ください。

Agent teams：互いに会話するエージェント

Agent teams は実験的な機能で、デフォルトではオフです。シェルまたは settings.json の env ブロックで CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定してオンにし、タスクについて Claude に「チームメイトを 3 人起動して」と頼みます。チームメイトはタスクリストを共有し、互いにメッセージを送り合います。ターミナルに表示されるほか、tmux や iTerm2 では分割ペインに表示されます。

• 対話型セッション専用です。-p と Agent SDK ではチームメイトを起動できません。
• 1 つのセッションにつきチームは 1 つで、入れ子のチームは作れません。また、インプロセスのチームメイトは /resume で復元されません。
• チームメイトは 1 つのチェックアウトを共有するので、それぞれに別のファイル群を担当させましょう。
• コストははるかに高くなります。Anthropic のドキュメントによると、チームメイトがプランモードで動く場合、チームは単一のセッションのおよそ 7 倍のトークンを使います。

並列のエージェントが互いの仕事を上書きしないようにする

• 2 つのエージェントが同じファイルに触れる可能性があるなら、それぞれに専用の worktree を与えましょう。worktree 内のセッションはメインのチェックアウトを編集できず、そのサブエージェントも同様です。
• Agent teams では、ファイル単位で仕事を分けます。2 人のチームメイトが 1 つのファイルを編集すると、互いに上書きしてしまいます。
• すべてのサブエージェントとセッションは同じ利用上限を消費するので、複数動かすと使用量も何倍にもなります。簡単なサブエージェントには model: haiku を使いましょう。
• 同じテストや開発サーバーを動かすエージェント同士はポートが衝突することがあるので、それぞれに別のポートを割り当てましょう。

並列のエージェントを、仕事を持つチームに

worktree や agent teams は、あなたが見守っている 1 つのタスクを分担するものです。Crewmark は、複数の Claude Code や Codex のセッションを、それぞれの職種・目標・勤務時間を持つ社員として動かし、1 つのボードで仕事を渡します。

1. 職種ごとに社員を 1 人

   SEO スペシャリスト、ソフトウェアエンジニア、UI デザイナーが、それぞれ自分の指示と目標を持って、自分の会話の中で働きます。

2. 全員で 1 つのボード

   タスクは適任の社員に割り当てます。各社員はハートビートで起動して次のタスクを取り、作業しながらコメントするので、誰が何をしているかがわかります。

3. 相談先は互いではなく、あなた

   レビューや権限が必要になると、社員はあなたにメッセージを送り、次の仕事に移ります。AI 社員とは何かもご覧ください。

複数の Claude Code エージェントに関するよくある質問