ガイド2026年8月31日

複数の Codex エージェントを並列実行する方法

タスクごとに実際の Codex CLI を分離し、main に入る前に各結果を検証します。

複数の Codex エージェントを安全に実行するには、独立したタスクごとに Git worktree を分けます。公式 Codex アプリは Codex 専用フローの worktree を管理できます。Agentastic は同じ Codex CLI を Claude Code、Gemini、Cursor などと並べて実行し、コンテナ、リモートホスト、ブラウザ検証、複数 provider によるレビューを追加します。

開発者が個別の Git worktree で 4 つの OpenAI Codex エージェントを実行している図

方法を選ぶ

方法適しているケース
Codex アプリの worktree公式体験を使い、worker が Codex だけ
手動 worktree + CLI別アプリなしで完全に管理したい
Agentastic複数 provider、コンテナ、ブラウザ、リモート実行が必要

OpenAI の公式 worktree ドキュメントでは、並列 chat、managed worktree、.worktreeinclude、handoff、cleanup が説明されています。

タスクごとに checkout が必要な理由#

Codex の会話は独立していますが、同じ checkout のファイルは共有されます。2 セッションが未コミット変更、生成物、依存関係、Git index を同時に扱うと、互いの途中状態をテストしてしまいます。

worktree を分ければ、各結果は独立した diff になります。採用、修正、破棄を個別に判断できます。

手動 worktree#

bash
git fetch origin git worktree add -b agent/auth-tests \ ../app-auth-tests origin/main git worktree add -b agent/cache-fix \ ../app-cache-fix origin/main cd ../app-auth-tests && codex cd ../app-cache-fix && codex

どこでも使える方法ですが、命名、セットアップ、承認待ち、ポート、テスト、レビュー、削除を自分で管理します。

Agentastic で Codex を並列実行する#

1. Codex をインストールして確認する#

bash
npm install -g @openai/codex which codex codex --version

Agentastic から起動する前に Codex へサインインします。provider の認証、設定、skills、MCP servers はそのまま利用されます。

2. 分離 workspace を作る#

Agent Home で repository、base branch、Codex、Worktree mode を選びます。タスク名を付け、検証を明示します。

text
authentication module の不安定な refresh token test を修正してください。 公開 session API と retry limit は変更しないでください。 最初に authentication target を実行し、成功したら全 unit suite を実行してください。 race condition と変更ファイルを最後に要約してください。

独立した pull request にできるタスクごとに、この操作を繰り返します。

3. AGENTS.md に共通ルールを書く#

markdown
# Repository instructions - Authentication 変更では `npm test -- auth` を実行する。 - `src/generated` の generated client を直接編集しない。 - 公開 API の backward compatibility を維持する。 - production migration は実行しない。

タスク固有の制約は prompt、永続的なリポジトリルールは version control に置きます。

4. 環境を自動準備する#

bash
#!/usr/bin/env bash set -euo pipefail for file in .env .env.local; do if [ -f "$AGENTASTIC_MAIN_REPO_PATH/$file" ] && [ ! -f "$file" ]; then cp "$AGENTASTIC_MAIN_REPO_PATH/$file" "$file" fi done npm ci

.agentastic/setup.sh として保存し、実行可能にします。Codex がプロジェクトの起動方法を推測する前に、checkout を実行可能にしてください。

5. 新しいコンテキストで検証する#

Codex が完了したら:

  1. テストの証拠を読む。
  2. diff 全体を確認する。
  3. worktree でアプリを起動する。
  4. UI 変更は内蔵ブラウザで検証する。
  5. 新しい Codex、Claude、CodeRabbit、Greptile にレビューさせる。

実装者は、その実装を生んだ前提を共有しています。新しいレビューコンテキストは、実装中に見えなくなった問題を発見しやすくします。

Worktree、container、remote#

  • Worktree: 通常のローカル変更。
  • Container: package、service、mount、network にも境界が必要。
  • Remote SSH: 自分の開発マシンやサーバーで実行。
  • Cloud: 接続済み provider で長時間実行。

最初は worktree を使い、具体的な理由がある場合だけ分離を強めます。

よくある失敗

  • 曖昧な大機能を 5 エージェントへ送っても仕様は明確になりません。
  • 共有の可変 database はファイル分離の効果を弱めます。
  • レビュー能力を超えるタスク開始は速度ではなく負債です。
  • 依存 branch が merge されたら、残りの worktree を更新して再検証します。

macOS 版 Agentastic をダウンロードするか、Codex integrationを確認してください。

公式資料