クラウドナビ
← 記事一覧に戻る
【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方
AIツール·1分で読了
#Claude Code#Codex#並列開発

この記事のまとめ

Claudeが「指揮者」になり、複数のCodex CLIワーカーを同時に動かしてプロジェクトを一気に進める — これが「A Fable of Codexes」だ。

【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方

Claudeが「指揮者」になり、複数のCodex CLIワーカーを同時に動かしてプロジェクトを一気に進める — これが「A Fable of Codexes」だ。

Fable Advisor(前回の記事)が「賢いモデルが設計、安いモデルが実装」というレーン分けだとすれば、こちらは 「1人の指揮者が10人の職人を同時に動かす」 イメージ。並列処理・git worktreeによる衝突防止・キャンペーン管理まで含んだ本格的なオーケストレーションスキルだ。



この記事でわかること

  • A Fable of Codexesとは何か(Fable Advisorとの違い)
  • インストール手順(初心者向けに詳しく)
  • 実際の使い方とワークフロー
  • キャンペーンの進行管理方法
  • 並列ワーカー・スクワッド・レビューの全容


A Fable of Codexesとは

「A Fable of Codexes」はjvoganが開発したClaude Code用スキル。コンセプトはシンプルだ:

Claude(FableまたはOpus)を「指揮者」にし、複数のCodex CLIワーカーを同時に動かしてプロジェクトを並列開発する。

Fable Advisorとの違い

比較項目Fable AdvisorA Fable of Codexes
アーキテクチャClaude Codeのサブエージェント機能Codex CLIを外部ワーカーとして起動
並列度1タスクずつ委譲同時に多数のワーカーを並列稼働
衝突防止サブエージェントの自動分離git worktree(独立作業ディレクトリ)
状態管理セッションのコンテキスト内リポジトリ内のファイルで永続化
適した規模日常的な開発タスク大規模プロジェクト・機能開発キャンペーン
Codex必須かオプション(なくても動作)基本(なければClaudeワーカーで代替)

要するに: Fable Advisorが日々の開発効率化なら、A Fable of Codexesはプロジェクト単位の大規模並列開発オーケストレーションだ。



インストール手順(初心者向け)

ステップ1: Claude Codeが使えることを確認

ターミナルを開いて以下を実行:

claude --version

バージョンが表示されればOK。Claude CodeがまだならAnthropicの公式ドキュメントを参照。

ステップ2: スキルをインストール

一番簡単な方法(推奨):

npx skills add jvogan/a-fable-of-codexes --skill campaign-conductor

または手動で:

git clone --depth 1 https://github.com/jvogan/a-fable-of-codexes.git /tmp/afoc
cp -r /tmp/afoc/skills/campaign-conductor ~/.claude/skills/

ステップ3: Codex CLIをインストール(重要)

このスキルはCodex CLIをワーカーとして使う。まだなら以下を実行:

npm install -g @openai/codex
codex login

Homebrewでも可:

brew install codex
codex login

ステップ4: Codexの設定を整える(おすすめ)

~/.codex/config.toml を作成してデフォルト設定を書いておく:

model = "gpt-5.5"
model_reasoning_effort = "xhigh"

注意: ChatGPTプランの認証だと利用制限がある。APIキー認証ならトークン課金。キャンペーン規模に応じて適切な方を選ぼう。

ステップ5: Codexプラグイン(オプション)

より高度な連携のために、Claude Code用のCodexプラグインも入れられる:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex

これで /codex:review/codex:adversarial-review といったスラッシュコマンドが使えるようになる。



使い方 — これだけで始められる

最初の一歩

任意のプロジェクトでClaude Codeを起動し、以下の一言を言う:

start a campaign

たったこれだけで、Claudeが以下のことを自動で行う:

1. プロジェクトを分析(コードベースの規模を調査)
2. docs/campaign-hq/ ディレクトリを作成
3. CAMPAIGN.md(計画書)を生成
4. ワーカーの派遣を開始

その後の操作は日本語でOK

キャンペーンが始まったら、あとは普通に指示を出すだけ:

「請求機能の移行を新しいフェーズとして追加して」
「テストはSonnetを使って。この設定を保存して」
「今の状況を教えて」

指示はpreferences.mdに自動保存されるので、次回のセッションでも設定が引き継がれる。



キャンペーンの仕組み

キャンペーンHQ(司令部)

キャンペーンを開始すると、プロジェクト内に docs/campaign-hq/ という司令部が作られる:

docs/campaign-hq/
├── CAMPAIGN.md        計画書・フェーズ・ワーカー一覧
├── LEARNINGS.md       学んだ教訓と行動ログ
├── preferences.md     ワーカーのルーティング設定
├── briefs/            各ワーカーへの指示書
├── out/               ワーカーからの報告書
└── schemas/           報告書のフォーマット定義

この状態はリポジトリに保存されるので、セッションを閉じても翌日再開すれば続きから再開できる。これが最大の強みだ。

キャンペーンの流れ(3パターン)

小規模プロジェクト — 直接計画を書いて進行:

指揮者(Claude)が計画を書き、Codexワーカーに直接タスクを割り振る

大規模・未知のプロジェクト — まず調査から:

1. 複数の調査ワーカーを並列派遣
2. 調査結果をもとに計画を作成
3. 承認を得てから本実装を開始

超大規模プロジェクト — 波(Wave)で進行:

Wave 1: 派遣 → 収集 → 統合 → 検証
Wave 2: 派遣 → 収集 → 統合 → 検証
Wave 3: ...


並列ワーカーの仕組み

git worktreeで衝突を防止

複数のワーカーが同時に同じリポジトリを編集するとコードが衝突する。 そこで「A Fable of Codexes」は git worktree を使う:

通常の開発:
  1つのフォルダで1人ずつ作業

git worktree:
  ワーカーごとに独立したフォルダ + ブランチを作成
  それぞれが別々の場所で同時に編集しても衝突しない

フリート(艦隊)の管理

指揮者は「フリートテーブル」で全ワーカーを管理する:

worker-01 | ユーザー認証 | feat/auth | 作業中
worker-02 | 決済API | feat/payment | 完了・レビュー待ち
worker-03 | 管理画面 | feat/admin | 作業中

スクワッド(分隊)機能

関連する複数のタスクは「スクワッド」としてグループ化できる:

指揮者(Fable) → スクワッドリーダー(Opus または Codex)
                     ├── Codexワーカー #1
                     ├── Codexワーカー #2
                     └── Codexワーカー #3
               → スクワッドリーダーが統合して1つのブランチに
               → 指揮者が検証してマージ

スクワッドリーダーが自分のCodexワーカーを指揮し、結果を1つにまとめて指揮者に返す。指揮者の負荷を減らす階層構造だ。



レビューの仕組み(相互レビュー)

「A Fable of Codexes」の特徴的な点は 相互レビュー だ:

誰が誰のコードをなぜ
ClaudeCodexのコードClaudeの視点で品質チェック
CodexClaudeのコード別系統の視点でバグ発見

異なるモデル系統で相互レビューすることで、同じ系統の盲点をカバーする。人間のコードレビューと同じ考え方だ。

ハイステークスなタスクには「ベイクオフ」

特に重要なタスクは、同じ指示でClaudeとCodexの両方に実装させ、出来の良い方を採用する

同一指示 → Claude実装
         → Codex実装
比較 → 良い方を採用(または両方の良いところをマージ)


詳しいワークフロー例

小規模な機能追加

あなた: 「ログイン機能に2要素認証を追加して」

Claudeの動き:
  1. キャンペーン計画を更新
  2. 仕様書(brief)を作成
  3. Codexワーカー1台を派遣
  4. ワーカーが実装 → 報告
  5. Claudeがdiffを確認 → 問題なければマージ

フル機能の追加(複数ワーカー並列)

あなた: 「ユーザー管理画面を新規作成して」

Claudeの動き:
  1. プロジェクトを調査 → 計画作成
  2. 3つのワーカーを同時派遣:
     worker-1: バックエンドAPI
     worker-2: フロントエンド一覧画面
     worker-3: フロントエンド詳細・編集画面
  3. 3つのworktreeで並列実装
  4. 順次レビュー → 統合ブランチにマージ
  5. 全体テスト → mainにマージ

大規模リファクタリング(スクワッド活用)

あなた: 「認証システムをJWTからセッションベースに移行して」

Claudeの動き:
  1. アーキテクチャ調査 → fable-advisorに相談(あれば)
  2. スクワッドリーダー(Opus)を指名
  3. スクワッドリーダーが3〜5人のCodexワーカーを指揮
  4. 各ワーカーが並列実装 → スクワッドリーダーが統合
  5. 統合ブランチをClaudeが検証 → マージ


Codex CLIがない場合でも動作する

Codex CLIがインストールされていない環境でも、Claudeワーカーだけで同様のフリートを構成できる

CodexありCodexなし
CodexワーカーSonnet ワーカー(Claude Codeのサブエージェント)
ベンダー多様性のあるレビューClaude同士のレビュー
最大限の並列度制限付きの並列度

指示書(brief)のフォーマットもgit worktreeの仕組みも同じなので、Codexが後で使えるようになってもシームレスに切り替えられる。



「A Fable of Codexes」を選ぶべき人

こんな人におすすめ理由
大規模なプロジェクトを抱えている複数機能を同時並行で開発可能
チーム開発の自動化をしたいスクワッド構造で疑似的なチーム開発を再現
Codex CLIを活用したいCodexを最大限使いこなす設計
開発の状態管理を徹底したいキャンペーンHQで全状態をファイル管理
レビュー品質を高めたい相互レビュー(Claude × Codex)で盲点を防止
こんな人にはFable Advisorがおすすめ理由
日常的な開発タスクが中心シンプルなレーン分けで十分
セットアップを最小限にしたいインストールが2コマンドで完了
Codex CLIを使っていないSonnet/Opusのみで完結
小〜中規模プロジェクトキャンペーン管理はオーバーキル


よくある質問(FAQ)

Codex CLIって何? OpenAIが開発したターミナルベースのAIコーディングエージェントです。GPT-5.5を搭載し、コードの実装・テスト・リファクタリングを自動で行います。npm install -g @openai/codex でインストールできます。

Codex CLIなしでも使えますか? はい。Codexがない場合はClaude Sonnetがワーカーとして動作します。完全に機能しますが、並列度とモデル多様性は低下します。

Fable Advisorと一緒に使えますか? はい。Fable Advisorの「コミットメント境界」の概念はそのまま使えます。設計判断はFable Advisorに相談し、実装はA Fable of Codexesで並列実行する、という組み合わせが理想的です。

キャンペーンを途中で止められますか? はい。セッションを閉じても次回開いた時に docs/campaign-hq/ から自動復帰します。セッションIDを使ってCodexワーカーも復帰可能です。

git worktreeって何? 同じリポジトリから独立した作業ディレクトリを複数作るGitの機能です。git worktree add で別フォルダにブランチをチェックアウトでき、並列作業でもファイルの衝突が起きません。

ワーカーにネットワークアクセスは必要ですか? キャンペーン開始時に許可範囲を設定します。デフォルトはCodex sandboxの workspace-write レベル(プロジェクト内のみ書き込み可)。必要に応じてネットワークアクセスを追加できます。

APIのコストが心配です。 キャンペーン開始時に制限を設定できます。CodexはChatGPTプラン認証ならプラン内の制限、APIキー認証なら従量課金です。ワーカーの同時起動数を制限することでコストをコントロールできます。



参考リンク



導入チェックリスト

  • [ ] Claude Codeが使えることを確認(claude --version
  • [ ] Codex CLIをインストール(npm install -g @openai/codex && codex login
  • [ ] npx skills add jvogan/a-fable-of-codexes --skill campaign-conductor
  • [ ] Codexの設定(~/.codex/config.toml)を整える
  • [ ] (オプション)Codexプラグインをインストール
  • [ ] プロジェクトで start a campaign を実行
  • [ ] 最初のタスクを依頼して動作確認

公開日: 2026-07-07 | カテゴリ: AIツール 元リポジトリ: jvogan/a-fable-of-codexes (MIT License)


合わせて読みたい