Claude Codeで複数AIエージェントを並列実行する方法｜tmux・Agent Teams・ファイル連携の実践

Claude Codeは単体でも強力ですが、複数インスタンスを並列実行することで生産性が桁違いに跳ね上がります。Agent Teams（公式機能）、tmux/ターミナル分割、smux/amux（サードパーティ）、SDK（ヘッドレス）——この4つの方法を目的に応じて使い分けることで、10記事の同時生成や複数PRの並列開発といった実務シナリオを1人で回せるようになります。

この記事でわかること

Claude Codeの並列実行で開発・コンテンツ制作を加速させたい開発リーダー・PM・CDOに向けた記事です。

• Agent Teams（公式機能）によるチームリード+チームメイト構成の並列実行 — Claude Code内蔵のAgent Teamsで、メインエージェントがサブエージェントを自動生成し、worktree隔離でブランチ分離しながら並行処理を実現します
• tmux/ターミナル分割で複数セッションを独立稼働させる手法 — tmuxのペイン・ウィンドウ機能を活用し、各セッションに異なるタスクを割り当てて並列実行する方法を解説します
• smux・amux・dmuxなどサードパーティツールによるエージェント並列化 — macOS向けのsmuxやエージェント向けマルチプレクサamuxなど、専用ツールの特徴と選び方を比較します
• Claude Code SDKを使ったヘッドレス並列実行とCI/CD統合 — Python/TypeScriptから複数のClaude Codeプロセスをプログラムで起動し、自動化パイプラインに組み込む方法を紹介します
• ファイルベースの同期プロトコルで並列エージェント間の競合を防ぐ方法 — AGENT_SYNC.mdや共有ディレクトリを使った指示書の受け渡しで、複数エージェント間の整合性を維持する実践パターンを解説します

なぜ並列実行が必要なのか

Claude Code単体で1タスクずつ処理する運用は、小規模なプロジェクトでは十分に機能します。しかし、事業が成長し、コンテンツ量の拡大・複数リポジトリの保守・リリーススプリントの高速化が求められるようになると、直列処理では時間が足りなくなります。

StartLinkでは、CRMコンサルティング業務と並行して自社ブログの運営、HubSpotアプリの開発、顧客向け提案資料の制作を同時に進めています。これを1つのClaude Codeセッションで順番に処理していたら、1日24時間では到底足りません。

並列実行の効果は単純な「N倍速」ではありません。タスク間の待ち時間がなくなることで、体感的には3〜5エージェント並列で10倍以上の生産性向上を実感できます。Anthropicの公式ドキュメントでも、Agent Teamsによる並列実行で大規模なコードベース変更が劇的に高速化されることが示されています。

方法1: Agent Teams（公式機能）

Agent Teamsの仕組み

Agent Teamsは、Claude Code内蔵の公式並列実行機能です。1つのメインセッション（チームリード）から複数のサブエージェント（チームメイト）を自動生成し、それぞれが独立したGit worktreeで作業を進めます。

# Agent Teamsの起動（チームメイト3体構成）
claude --team --teammates 3

# 特定の設定ファイルを使って起動
claude --team --teammates 4 --config .claude/team-config.md

起動すると、tmuxセッションが自動生成され、チームリードが上部ペイン、各チームメイトが下部ペインに配置されます。チームリードにタスクを伝えるだけで、タスク分割・分配・進捗管理・成果統合まで自動で処理されます。

Agent Teamsの動作フロー

Agent Teamsが適するケース

Agent Teamsの最大の強みは、開発者がオーケストレーションを手動で行う必要がない点です。「何を達成したいか」を伝えるだけで、タスク分割から統合までをチームリードが自動判断します。

ただし、Agent Teamsはあくまで同一リポジトリ内のタスク分割に特化しています。異なるリポジトリ間の作業や、コード以外のタスク（コンテンツ制作、データ分析、API連携など）を混在させたい場合は、次のtmux方式が適しています。

方法2: tmux/ターミナル分割

tmuxで複数セッションを独立稼働させる

tmuxを使えば、複数のClaude Codeセッションを完全に独立した状態で同時に動かせます。Agent Teamsとは異なり、各セッションが別々のリポジトリやプロジェクトを対象にできるため、柔軟性が格段に高くなります。

# セッション1: ブログ記事の制作
tmux new-session -d -s blog
tmux send-keys -t blog 'cd ~/projects/marketing && claude' Enter
tmux send-keys -t blog '10本の記事をレビューしてください' Enter

# セッション2: APIの開発
tmux new-session -d -s api
tmux send-keys -t api 'cd ~/projects/api-server && claude' Enter
tmux send-keys -t api 'テストカバレッジを80%まで上げてください' Enter

# セッション3: インフラ設定
tmux new-session -d -s infra
tmux send-keys -t infra 'cd ~/projects/infrastructure && claude' Enter
tmux send-keys -t infra 'Terraformの設定をレビューしてください' Enter

# 全セッションを一覧表示
tmux list-sessions

ペイン分割で全体を俯瞰する

個別セッションの代わりに、1つのウィンドウをペイン分割して全エージェントの動きを一覧する方法もあります。

# 4分割レイアウトの作成
tmux new-session -d -s agents
tmux split-window -h -t agents
tmux split-window -v -t agents:0.0
tmux split-window -v -t agents:0.2

# 各ペインでClaude Codeを起動
tmux send-keys -t agents:0.0 'claude' Enter
tmux send-keys -t agents:0.1 'claude' Enter
tmux send-keys -t agents:0.2 'claude' Enter
tmux send-keys -t agents:0.3 'claude' Enter

# セッションにアタッチ
tmux attach -t agents

ファイルベースの連携

tmux方式では、エージェント間の連携をファイル経由で行います。StartLinkでは AGENT_SYNC.md を共有ファイルとして使い、各エージェントが自分の作業状態を記録する運用を確立しています。

<!-- AGENT_SYNC.md の例 -->
# エージェント同期ファイル

## 現在の作業状況

| エージェント | セッション | 作業内容 | ステータス |
|-------------|-----------|---------|-----------|
| Agent-1 | blog | DD-46記事制作 | 執筆中 |
| Agent-2 | api | Sync for freee テスト | テスト実行中 |
| Agent-3 | review | ブログ品質レビュー | 完了 |

## 競合注意ファイル

- article_to_post_map.json: Agent-1が更新予定。他エージェントは書き込み禁止
- master_keyword_map.md: Agent-1の作業完了後にAgent-3が更新

ファイルベース連携のポイント: 同じファイルへの同時書き込みを防ぐことが最優先です。AGENT_SYNC.mdに「誰がどのファイルを使っているか」を明記し、ロック管理を行うことで競合を回避できます。共有ディレクトリに指示書を置いて受け渡すパターンも有効です。

方法3: smux・amux・dmux（サードパーティツール）

専用ツールの登場

Claude Codeの並列実行ニーズの高まりに伴い、サードパーティの専用ツールが登場しています。素のtmuxよりもセットアップが簡単で、AIエージェントの並列管理に特化した機能を備えています。

smuxの基本操作

smuxはmacOS向けに設計された、AIエージェント並列実行に特化したターミナルアプリケーションです。

# smuxのインストール
brew install smux

# 3つのClaude Codeエージェントを並列起動
smux launch --agents 3 --tool claude

# タスクファイルを指定して一括実行
smux run --tasks tasks.yaml --agents 5

smuxの tasks.yaml には各エージェントに割り当てるタスクを定義できます。

# tasks.yaml の例
agents:
  - name: content-writer
    directory: ./01_marketing
    prompt: "DD-46の記事を制作してください"
  - name: code-reviewer
    directory: ./02_product
    prompt: "Sync for freeeのコードレビューを実施してください"
  - name: data-analyst
    directory: ./00_strategy
    prompt: "今月の売上データを分析してください"

どのツールを選ぶか

同一マシンで3〜5エージェントを並列実行する程度であれば、smux（macOS）またはamux（Linux）で十分です。複数マシンにまたがる大規模な並列実行が必要な場合はdmuxが選択肢に入りますが、セットアップの複雑さとのトレードオフがあります。

スモールスタートで始めるなら、まずtmuxの手動セットアップから試し、頻度が高くなってきた段階でsmuxやamuxに移行するのが現実的です。

方法4: Claude Code SDK（ヘッドレス実行）

プログラムからの並列起動

Claude Code SDKを使えば、Python/TypeScriptから複数のClaude Codeプロセスをプログラムで起動し、並列実行できます。ターミナルのUIを介さない「ヘッドレス」な実行方式のため、CI/CDパイプラインやバッチ処理への組み込みに適しています。

// TypeScript SDKでの並列実行
import { ClaudeCode } from '@anthropic-ai/claude-code';

const tasks = [
  { dir: './service-a', prompt: 'テストを追加してください' },
  { dir: './service-b', prompt: 'TypeScript 5.x対応を実施してください' },
  { dir: './service-c', prompt: 'セキュリティ監査を実施してください' },
];

// 全タスクを並列実行
const results = await Promise.all(
  tasks.map(task =>
    ClaudeCode.run({
      workingDirectory: task.dir,
      prompt: task.prompt,
      model: 'claude-sonnet-4-20250514',
    })
  )
);

// 結果の集約
results.forEach((result, i) => {
  console.log(`Task ${tasks[i].dir}: ${result.status}`);
});

Python SDKでの並列実行

# Python SDKでの並列実行
import asyncio
from claude_code import ClaudeCode

async def run_parallel_agents():
    tasks = [
        {"dir": "./repo-1", "prompt": "READMEを更新してください"},
        {"dir": "./repo-2", "prompt": "依存パッケージを最新化してください"},
        {"dir": "./repo-3", "prompt": "Lintエラーを修正してください"},
    ]

    results = await asyncio.gather(*[
        ClaudeCode.run(
            working_directory=task["dir"],
            prompt=task["prompt"],
        )
        for task in tasks
    ])

    for task, result in zip(tasks, results):
        print(f"{task['dir']}: {result.status}")

asyncio.run(run_parallel_agents())

CI/CDへの統合例

# GitHub Actions での並列Claude Code実行
name: Parallel Claude Code Review
on: pull_request

jobs:
  parallel-review:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        service: [service-a, service-b, service-c]
    steps:
      - uses: actions/checkout@v4
      - name: Run Claude Code Review
        run: |
          npx claude-code --headless \
            --dir ./$ \
            --prompt "変更内容をレビューし、問題があれば報告してください"
        env:
          ANTHROPIC_API_KEY: $

4つの方法の比較と使い分け

どの方法を選ぶかは、チームの規模・タスクの性質・自動化の度合いによって決まります。

StartLinkの使い分け: 日常的なコード変更にはAgent Teams、ブログ制作とコンサル業務の並行処理にはtmux、リリース前の一括品質チェックにはSDKのヘッドレス実行という組み合わせで運用しています。最初から全方法を導入する必要はなく、まずAgent Teamsから始めて、必要に応じてtmuxやSDKに拡張していくのがスモールスタートの原則に合致します。

実務シナリオ: 10記事の同時生成

並列エージェントの威力を最も実感できるのが、コンテンツマーケティングにおける大量記事の同時制作です。

tmuxを使った10記事並列制作

#!/bin/bash
# 10記事を5エージェントで並列制作するスクリプト

ARTICLES=(
  "DD-41:Claude Code Hooks活用法"
  "DD-42:Claude Code MCP統合ガイド"
  "DD-43:Claude Code Git Worktree実践"
  "DD-44:Claude Code プロンプト最適化"
  "DD-45:Claude Code コスト管理術"
  "DD-46:Claude Code 並列エージェント"
  "DD-47:Claude Code セキュリティ設定"
  "DD-48:Claude Code リモート実行"
  "DD-49:Claude Code デバッグ手法"
  "DD-50:Claude Code チーム運用"
)

SESSION="blog-batch"
tmux new-session -d -s $SESSION

for i in $(seq 0 4); do
  if [ $i -gt 0 ]; then
    tmux split-window -t $SESSION
  fi
  ARTICLE_ID=$(echo ${ARTICLES[$i]} | cut -d: -f1)
  tmux send-keys -t $SESSION "claude --prompt '${ARTICLES[$i]}の記事を制作してください'" Enter
done

tmux select-layout -t $SESSION tiled
tmux attach -t $SESSION

並列制作時の品質管理

複数エージェントが同時に記事を制作する場合、品質のばらつきが最大のリスクです。StartLinkでは以下のルールで品質を担保しています。

1. AGENT_SYNC.mdで作業割り当てを明確化: 各エージェントの担当記事IDを記録し、重複作業を防止
2. 共有ファイルへの同時書き込み禁止: article_to_post_map.json や master_keyword_map.md は1エージェントずつ順次更新
3. 完了後にレビューエージェントが一括品質チェック: 全記事が揃ってから、別のClaude Codeセッションで品質レビューを実行

実務シナリオ: 複数PRの並列開発

リリーススプリントの後半で、複数の機能ブランチを同時に仕上げたい場面にも並列実行が有効です。

Agent Teamsでの複数PR並列作業

# Agent Teamsを起動（4チームメイト）
claude --team --teammates 4

# チームリードへの指示例
> 以下の4つのPRをそれぞれチームメイトに割り当てて、
> コードレビュー指摘事項の修正を並列で進めてください:
> - PR #142: ユーザー認証フローの改善
> - PR #145: ダッシュボードのパフォーマンス最適化
> - PR #147: API v2エンドポイントの追加
> - PR #149: E2Eテストの追加

Agent Teamsでは各チームメイトが独立したworktreeで作業するため、ブランチ間の競合を気にせず並列で修正を進められます。

よくある質問（FAQ）

Q1: 並列実行するとAPIコストは単純にN倍になりますか？

並列エージェント数に比例してAPIコール数は増えますが、直列実行時の「待ち時間」がなくなるため、同じ成果物を得るための総コストはほぼ変わりません。むしろ、コンテキストウィンドウの効率が上がる（各エージェントが専門タスクに集中できる）ため、1タスクあたりのトークン消費が減る傾向があります。

Q2: 並列エージェント間でファイルの競合が起きた場合、どう対処しますか？

Agent Teamsの場合はGit worktreeで物理的にファイルが隔離されるため、競合はマージ時にのみ発生します。tmux方式の場合は、AGENT_SYNC.mdによるファイルロック管理が有効です。同じファイルを複数エージェントが同時に編集する設計自体を避けるのが最善策です。

Q3: smuxやamuxは無料で使えますか？

smux、amux、dmuxはいずれもオープンソースプロジェクトとして公開されています。ただし、内部で利用するClaude Code自体のAPIコストは別途発生します。ツール自体の利用料は無料です。

Q4: 並列実行に必要なマシンスペックの目安はどのくらいですか？

Claude Code自体はクラウドAPI呼び出しが主体のため、ローカルマシンへの負荷は軽微です。tmuxで5セッション並列でも、メモリ8GB・CPU 4コア程度で問題なく動作します。ボトルネックはローカルスペックではなく、APIのレートリミットです。

Q5: 非エンジニアのチームメンバーでも並列実行を使えますか？

Agent Teamsは「チームリードに自然言語で指示するだけ」なので、非エンジニアでも利用可能です。tmuxやSDK方式はコマンドライン操作が前提のため、エンジニア向けです。非エンジニアがコンテンツ制作を並列化したい場合は、エンジニアがsmuxのタスクファイル（YAML）を事前に用意しておき、ワンコマンドで実行できる仕組みを作るのが実用的です。

まとめ

Claude Codeの並列実行は、1人の開発者・PM・CDOが複数のAIエージェントを同時に動かし、チーム規模の生産性を実現するための実践手法です。

Agent Teams（公式機能）は同一リポジトリ内のコード変更に最適で、セットアップ不要で始められます。tmux/ターミナル分割はリポジトリを横断した柔軟な並列実行に向いており、ファイルベースのAGENT_SYNC.mdで同期を取ります。smux/amuxはtmuxの運用コストを下げるサードパーティツールとして、頻繁に並列実行する現場で威力を発揮します。SDKヘッドレス実行はCI/CDパイプラインへの統合に不可欠で、リリース前の自動品質チェックなどに活用できます。

重要なのは、最初から全方法を導入しようとしないことです。まずAgent Teamsで並列実行の感覚をつかみ、タスクの種類や頻度に応じてtmuxやSDKへ段階的に拡張していく——このスモールスタートのアプローチが、少数精鋭チームにとって最も確実な並列化の道筋です。

関連記事

並列実行を実務に組み込む際に合わせて読みたい記事をまとめました。

• Claude Code Agent Teams 実践ガイド：公式Agent Teams機能のセットアップと活用パターン
• Claude Code × git worktreeで並行開発する：リポジトリを分けずに複数ブランチを並列で動かす実装
• Claude Codeでバッチ処理を並列化する：大量タスクを一括で並列実行する実践手法