Codex と Claude Code のタスク引き継ぎガイド：実装、レビュー、長時間タスク復旧まで

Codex と Claude Code のタスク引き継ぎでよくある誤解は、「二つの AI が同時にコードを書く」ものだと考えることです。安定した使い方はむしろ逆で、同じフェーズでは一つのツールだけが書き、もう一つはレビュー、振り返り、コンテキスト補完、または次の段階への引き継ぎを担当します。

Claude Code と Codex が同じファイル群を同時に編集すると、短期的には速く見えます。しかし後から、誰が何を変えたのか、どの変更がテスト失敗を生んだのか、どちらかが相手の設計を上書きしたのかが分かりにくくなります。引き継ぎの目的は並列でコードを書くことではなく、複雑なタスクを段階に分け、それぞれのツールを得意な場所で使うことです。

Quick Answer

まずは次の分担から始めるのが安全です。

基本ルールは三つです。

1. 同時にコードを書く Agent は一つだけにする。
2. 引き継ぎ前に必ず「引き継ぎパケット」を作る。
3. 受け取る側はすぐ編集せず、まず状態を確認する。

引き継ぎが必要な場面

すべてのタスクで二つのツールを使う必要はありません。引き継ぎが有効なのは次のような場面です。

• Claude Code が実装を終え、Codex に独立レビューさせたい;
• Codex が計画や findings を出し、Claude Code が修正する;
• 長時間タスクが途中で止まり、別の Agent が checkpoint から続ける;
• ローカル環境とクラウド環境で役割を分けたい;
• 一方が会話コンテキストを持ち、もう一方が PR 前レビューに向いている;
• 一つの Agent の自己完結を避け、第二の視点で設計を確認したい。

一行の設定変更や小さなテスト追加なら、引き継ぎは不要です。引き継ぎには、状態、境界、次の一手を書くコストがあります。

二つの Agent に同じファイルを書かせない

これは最重要の安全ルールです。

非推奨：

1
2

Claude Code continues the login refactor.
Codex optimizes the same login files at the same time.

推奨：

1
2
3

Claude Code implements the login refactor. When done, it stops and outputs a handoff packet.
Codex reviews the diff in read-only mode and does not modify files.
Claude Code fixes the Codex findings.

これなら責任範囲が明確です。問題が起きたとき、どのフェーズで入った変更か追跡できます。

引き継ぎパケットに含めるもの

Claude Code から Codex、または Codex から Claude Code へ渡すたびに、短いパケットを作ります。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

## Agent Handoff

### Original Goal
-

### Current Phase
- Plan / Implementation / Test / Review / Fix / Pre-release check

### Done
-

### Pending
-

### Changed Files
-

### Verification Run
-

### Current Risks
-

### Do Not Repeat
-

### Suggested Next Step
-

これは見栄えのよい要約ではなく、次の Agent が現場を復元するための記録です。ファイル、検証、境界を必ず含めます。

この考え方は AI Agent の長時間タスクが中断したときの再開方法 と相性がよいです。引き継ぎは、意図的な復旧の一種です。

Claude Code から Codex：実装後レビュー

最もよく使う安定パターンです。

1. Claude Code が機能を実装する。
2. Claude Code が最小限の関連テストを実行する。
3. Claude Code が引き継ぎパケットを出す。
4. Codex が diff を読み、読み取り専用でレビューする。
5. Claude Code が findings を修正する。
6. Codex が再レビューする。

Claude Code へのプロンプト：

1
2
3

Please implement this feature, but do not commit.
Before stopping, output a handoff packet with changed files, tests run, pending items, and risks.
Do not expand the scope before another Agent reviews it.

Codex へのプロンプト：

1
2
3

Please review the current uncommitted changes in read-only mode. Do not modify files.
Focus on bugs, regression risk, security issues, edge cases, and missing tests.
List findings by severity and reference exact file locations.

Codex CLI の公式ドキュメントでも review は独立した能力として扱われます。未コミット変更、特定 commit、base branch との差分をレビューし、優先度付き findings を返せます。この段階は読み取り専用に保つのが安全です。

Codex から Claude Code：findings の修正

Codex が findings を出したあと、レビュー役にそのまま修正させる必要はありません。Claude Code が実装コンテキストを持っているなら、findings を小さく処理させるほうが安定します。

1
2
3
4
5
6
7

Below are Codex review findings. Handle them one by one.

Constraints:
1. Fix only the issues referenced by the findings.
2. Do not do extra refactoring.
3. Run the smallest relevant test after each class of fix.
4. When done, report handled / not handled / needs human judgment.

これにより、レビュー指摘をきっかけにモジュール全体が書き直される事故を避けられます。

計画だけを Codex に任せる

Codex が先にコードベースを読み、影響範囲や計画を整理し、Claude Code が実装する流れも有効です。

1
2
3
4
5
6
7
8

Please only plan; do not modify files.
After reading the relevant code, output:
1. goal understanding;
2. impact area;
3. suggested files to change;
4. phased implementation plan;
5. verification for each phase;
6. risks and rollback strategy.

その後、Claude Code には第 1 フェーズだけ渡します。

1
2
3

Please execute only phase 1 from this plan.
Do not start phase 2 early.
Run the matching verification and output a handoff packet when done.

引き継ぎでは「一気に全部やる」ことを避け、フェーズごとに進めます。

長時間タスクの転送

Claude Code の会話に大量の文脈がたまった場合は、全ログをコピーするのではなく状態を圧縮します。

1
2
3
4
5
6

Please turn the current task into a handoff packet for Codex.
Requirements:
1. Under 800 words.
2. Include goal, done, pending, changed files, verification, and risks.
3. State Codex's first step after receiving it.
4. Mark commands that should not be repeated.

Codex 側では次のように始めます。

1
2
3

Below is a Claude Code handoff packet. First review it; do not modify files yet.
Check current git status and diff, verify the packet matches the workspace,
then execute only the stated first step.

「Claude Code の続きやって」より、はるかに安定します。

codex-plugin-cc のような橋渡しツールを使う場合は、codex-plugin-cc：Codex を Claude Code ワークフローに接続する も参考になります。プラグインがなくても、手動の引き継ぎパケットで多くのタスクは十分回ります。

resume の注意点

Codex CLI には codex resume があり、Claude Code にも --resume、--continue や会話復元があります。ただし resume は万能ではありません。

復元前に確認します。

1. この会話は現在のリポジトリのものか。
2. ワークスペース状態と会話の記憶は一致しているか。
3. 前回すでに副作用のあるコマンドを実行していないか。

復元後の最初のプロンプト：

1
2
3

We are resuming an old session. Do not edit files yet.
Please inspect the current workspace state and compare it with your remembered task state.
If they differ, trust the current workspace and output a recovery summary first.

古い計画を現在のファイル状態へ誤適用するのを防げます。

Git を境界線にする

Git は最も分かりやすい引き継ぎ境界です。

1
2
3

git status --short
git diff --stat
git diff

フェーズが完了したら、小さな commit にしてもよいです。

1
2

git add <files>
git commit -m "feat: implement login validation"

commit しない場合は patch として保存できます。

1

git diff > handoff-login-validation.diff

乱れたワークスペースで引き継がないでください。ユーザーの既存変更、Claude Code の変更、Codex の変更、次の Agent が触ってはいけないファイルを分けます。

Hooks と Skills で習慣化する

頻繁に引き継ぐなら、「終了前に引き継ぎパケットを出す」ことを Claude Code hook やプロジェクトルールに書きます。

1
2
3
4
5

If this turn changed files, output:
- changed files;
- verification run;
- pending items;
- suggested next step for Codex.

Codex 側では同じ手順を skill にできます。Codex Skills で独自ワークフローを書く を参考に、読み取り専用レビュー、引き継ぎ解析、長時間タスク復旧を固定手順に分けます。

ローカル、IDE、クラウドの分担

すべてを一つの画面に押し込む必要はありません。

重要なのは、どちらがどちらを置き換えるかではなく、コンテキストと責任境界を明確にすることです。

完整な引き継ぎ例

タスク：ユーザーインポートをリファクタし、テストを追加する。

1
2
3

Refactor the user import flow. Only handle CSV parsing and field validation.
Do not change UI or database schema.
Run the relevant unit tests and output a handoff packet.

Codex で読み取り専用レビュー：

1
2
3
4
5
6

Review the current uncommitted diff. Do not modify files.
Focus on:
1. CSV edge cases;
2. error handling;
3. types and null values;
4. whether tests cover failure paths.

Claude Code で findings を修正：

1
2
3

Fix only the P1/P2 issues from the Codex findings.
Do not do extra refactoring.
Run the related test after each fix.

最後に Codex が再レビューし、人間が commit、merge、release を判断します。

よくある失敗

二つの Agent が互いのコードを編集する

単一書き手ルールを使います。一つが書き、一つがレビューします。

引き継ぎパケットが長すぎる

引き継ぎパケットはチャット履歴ではありません。短く、構造化され、実行可能であるべきです。

検証情報がない

「完了しました」だけでは不十分です。何を実行し、何を実行していないか、何が失敗したかを書きます。

レビュー役にそのまま修正させる

レビューと修正は分けるほうが安全です。

古いコンテキストを無視する

resume 後は、編集前に現在のワークスペースと状態を合わせます。

最初から完全自動化しようとする

まずは引き継ぎパケット、読み取り専用レビュー、findings 単位の修正を安定させます。その後で hooks や skills を加えます。

引き継ぎチェックリスト

この表を埋められないなら、まだ引き継ぐべきではありません。

参考資料

• OpenAI Developers: Codex CLI features: https://developers.openai.com/codex/cli/features
• OpenAI Developers: Codex workflows: https://developers.openai.com/codex/workflows
• OpenAI Developers: Codex IDE extension features: https://developers.openai.com/codex/ide/features
• Anthropic Docs: Claude Code common workflows: https://docs.anthropic.com/en/docs/claude-code/common-workflows
• Anthropic Docs: Claude Code hooks guide: https://docs.anthropic.com/en/docs/claude-code/hooks-guide

まとめ

Codex と Claude Code の引き継ぎで重要なのは、二つの Agent を同時に働かせることではなく、段階的に協力させることです。

Claude Code は実装、修正、ローカルでの継続作業に向いています。Codex は独立レビュー、計画の再確認、PR 前チェック、長時間タスクの継続に向いています。毎回、目的、変更ファイル、検証、リスク、次の一手を含む構造化された引き継ぎパケットを使い、Git、resume、review、hooks、skills、checkpoint で境界を作ります。

「一つが書き、一つがレビューし、受け手はまず状態を確認する」を固定すれば、二つの AI が混乱して同時作業する状態から、制御されたエンジニアリングフローへ変えられます。