AI Hub

Codex

Codexで複数タスクを並列実行する方法|クラウド活用

公開: / 更新: 読了目安8分

#並列実行 #使い方

Codexで複数タスクを並列実行する方法|クラウド活用

先に結論: Codexの並列実行には、クラウドへの複数タスク委任、git worktreeを使ったローカル並列、IDE拡張とCLIの併用という3つの選択肢があります。同じファイルを触るタスクや依存関係のあるタスクは並列化に向きません。

Codexで一つのタスクが終わるのを待ってから次に着手していると、時間がいくらあっても足りません。実は複数のタスクを同時に走らせる方法はいくつも用意されており、うまく組み合わせれば調査・実装・テスト追加といった作業をまとめて進められます。

この記事では、クラウドへのタスク委任、ローカルでのgit worktree活用、IDE拡張との併用という3つの並列化の選択肢と、それぞれの具体的な手順、向き不向きのあるタスクの見分け方までを解説します。

この記事の要点

  • Codexの並列実行には、クラウド委任・git worktree・IDE拡張併用の3つの選択肢があります。
  • クラウド版はChatGPTのCodex画面から複数タスクを立て続けに依頼でき、手元のリソースを消費しません。
  • ローカルではgit worktree add ../project-feature-a -b feature-aのようにフォルダを分けて並列セッションを走らせます。
  • worktreeは新規チェックアウト扱いのため、依存パッケージのインストールをやり直す必要があります。
  • 同じファイルを触るタスクや依存関係のあるタスクは競合しやすく、並列化には向きません。

前提・動作環境

この記事で扱う内容は、Codex CLI(ターミナル版)とCodexクラウド(ChatGPTから利用する版)の両方にまたがります。クラウド版の利用にはChatGPTアカウントとGitHub連携が、ローカルでのworktree活用にはGitリポジトリとCodex CLIのインストールが前提です。

Codexの基本操作がまだの方は、先に「Codexの使い方完全ガイド」に目を通しておくと、ここからの内容が理解しやすくなります。

並列実行の3つの選択肢

Codexで複数タスクを同時に進める方法は、大きく3つに整理できます。

並列実行の3つの選択肢: クラウドへの複数タスク委任、git worktreeによるローカル並列、IDE拡張とCLIの併用を比較する図解

どれか一つに絞る必要はなく、依頼するタスクの性質に応じて組み合わせるのが現実的です。

クラウドでの並列タスクの実践手順

もっとも手軽な並列化がクラウドへのタスク委任です。ChatGPTのCodex画面から、対象リポジトリを選んだ状態で、やりたいことをそれぞれ自然言語で入力して送信します。

1つ目のタスクの実行を待たずに、続けて2つ目、3つ目のタスクを入力欄から依頼できるため、「バグ調査」「テスト追加」「ドキュメント更新」のような独立した作業を同時に流しておく使い方がしやすくなります。

進捗管理は、タスク一覧の画面でそれぞれの状態(実行中・完了・要確認)を確認する形になります。完了したタスクから順に差分を確認し、問題なければPRを作成、意図と違えば追加の指示を出して修正させる、という流れです。待ち時間中に別のタスクを追加投入していけば、手が空く時間を減らせます。

クラウド版のセットアップや差分確認からPR作成までの流れは「Codexクラウドの使い方」で詳しく解説していますので、初めて使う方はあわせて確認してください。

ローカルでworktreeを使った並列実行の手順

ネットワーク環境に依存せず、手元のマシンでCodex CLIを複数並走させたい場合は、git worktreeが有効です。同じリポジトリの履歴を共有したまま、別ブランチを別フォルダにチェックアウトできるため、複数のCodex CLIセッションが互いのファイルを上書きし合う心配がありません。

git worktree add ../project-feature-a -b feature-a
git worktree add ../project-fix-bug fix-issue-789

作成したそれぞれのフォルダに移動し、Codex CLIを起動します。

cd ../project-feature-a
codex
cd ../project-fix-bug
codex

ターミナルを2枚(あるいはtmuxなどのマルチプレクサで分割)開き、それぞれのworktreeでCodexを起動すれば、機能開発とバグ修正を同時に進められます。作業が終わったworktreeはgit worktree removeで片付けましょう。

git worktree remove ../project-feature-a

worktreeは新規のチェックアウト扱いになるため、依存パッケージのインストールをやり直す必要がある点には注意してください。Codex CLI自体の起動方法や承認モードの基本操作は「Codex CLIの使い方」でまとめているので、初めてCLIを使う方は先にそちらを確認しておくとスムーズです。Claude Code版のworktree活用は「Claude Codeとgit worktreeで並列作業する方法」で解説しています。

並列化に向くタスク/向かないタスク

すべてのタスクを並列化できるわけではありません。向き不向きを見極めることが、並列実行を活かすうえで重要です。

並列化に向くタスクと向かないタスクの対比図。独立したファイルの修正やテスト追加は向いており、同じファイルを複数タスクが変更する場合や依存関係のある変更は向かないことを示す図

タスクを依頼する前に「この作業は他のタスクと同じ箇所を触るか」を一度確認する習慣をつけておくと、後からのコンフリクト解消に時間を取られずに済みます。

注意点:使用量とレビュー負荷

並列実行には便利さの裏側で気をつけたい点もあります。

つまずきポイント/よくあるエラー

よくある質問

クラウドとローカルworktree、どちらを優先すべきですか?

まずはクラウドへのタスク委任から試すのがおすすめです。セットアップの手間が少なく、待ち時間に別のタスクを追加投入するだけで並列化を体感できます。ネットワーク環境に依存したくない場合や、ローカル固有の設定を使いたい場合はworktreeを検討してください。

何個までタスクを並列で走らせられますか?

同時に扱える上限はプランや実行環境によって変動しやすいため、具体的な数値は公式サイトで確認してください。数を増やすほどレビュー負荷も高まるため、確認しきれる範囲にとどめるのが実用的です。

並列実行中にエラーが出たタスクだけ止めることはできますか?

クラウド版はタスクごとに個別のステータスを確認できるため、問題が起きたタスクだけを確認・中断できます。ローカルのworktreeセッションも、対象のターミナルだけを終了すれば他のセッションに影響しません。

まとめ

Codexでの並列実行には、手軽なクラウドへの複数タスク委任、ローカルで完結するgit worktree+複数CLIセッション、IDE拡張とCLIを組み合わせる方法の3つの選択肢があります。

独立した作業は積極的に並列化しつつ、依存関係のあるタスクは順序を意識して依頼し、完了した差分はその都度確認する習慣を持つことが、並列実行を安全に活かすポイントです。

基本操作をおさらいしたい方は「Codexの使い方完全ガイド」、クラウド版の詳しい使い方は「Codexクラウドの使い方」、CLI版の操作方法は「Codex CLIの使い方」もあわせてご覧ください。