Claude CodeからCodexに作業を渡す方法｜codex exec・SDK・App Serverの比較

2026年10月5日2026年10月27日

Claude Codeで作業しながら、一部の作業だけCodexに任せたいときの、指示の渡し方をまとめました。

方法は4つあり、ふだん使いなら、Claude Codeに codex exec を実行させるのがいちばん簡単です。

codex exec：Claude Codeがコマンドとして実行し、結果を受け取る（おすすめ）
スキルやCLAUDE.md：渡し方の手順をまとめ、毎回同じやり方で渡す
Codex SDK：TypeScriptかPythonのプログラムから、会話を続けて操作する
Codex App Server：自分のアプリにCodexを組み込むための仕組み

この記事は、Claude CodeとCodexの公式ドキュメント（2026年10月23日に再照合）に基づきます。

参照：非対話実行、Codex SDK、App Server、権限。CLIヘルプの構文は確認しましたが、委譲・SDK実行・認証・画面の再現は未実施です。

以前あった codex mcp-server（CodexをMCPサーバーとして動かすコマンド）は、公式に廃止されています。

4つの方法の比較

方法	手軽さ	続きの会話	向いている使い方
`codex exec`	いちばん簡単	resume でできる	作業を丸ごと渡して、結果だけ受け取る
スキル・CLAUDE.md	書くだけ	中身しだい	同じ渡し方をくり返す
Codex SDK	プログラムが要る	できる	スクリプトやCIで、何往復もやり取りする
Codex App Server	いちばん重い	できる	画面のあるアプリにCodexを組み込む

出典：Claude Code・Codex ドキュメント（再照合日 2026-10-23）

方法1｜codex exec を実行させる（おすすめ）

codex exec は、Codexを対話画面なしで1回動かすコマンドです。

途中経過は標準エラーに、最後の答えだけが標準出力に出るので、結果を受け取りやすくなっています。

codex exec "このリポジトリの構成を要約して"

呼出し前に、Codexを実行する作業フォルダーが対象リポジトリであることを確認します。

親の会話内容が自動で全部渡るわけではないため、担当ファイル・必要な前提・完了条件をプロンプトや仕様ファイルに含めてください。

Claude Codeへの頼み方は、たとえば次のようになります。

codex exec を使って、Codex に tests/ の失敗しているテストを直させて。サンドボックスは workspace-write で。

ファイルを書き換えさせるときはサンドボックスを指定する

公式資料はcodex execの標準を読取り専用と説明していますが、実際の実行では読込む設定と権限を確認します。呼出し先にCodexのインストールと認証が必要で、通常はGitリポジトリ内で実行します。

ファイルを編集させるときは、--sandbox で書き込みを許可します。

指定	できること
`--sandbox` read-only（標準）	読むだけ
`--sandbox` workspace-write	作業フォルダの中を書き換えられる
`--sandbox` danger-full-access	サンドボックスの隔離を外す。外側で隔離したCI等に限定

出典：Codex ドキュメント（再照合日 2026-10-23）

--full-autoは現在の公式資料では未対応です。既存スクリプトは--sandbox workspace-writeなどへ移行します。自動承認レビューを使う--approve-for-meも別の選択肢で、無制限の許可ではありません。

ファイル書込みとネットワークは別の権限です。通信可否は有効な設定で確認してください。現行のpermissionsプロファイルと旧sandbox設定を混在させず、親のClaude Code側の制限も確認します。

結果の受け取り方と続きの頼み方

やりたいこと	書き方
最後の答えをファイルに保存	`codex exec -o ./output.txt "<依頼>"`
途中経過を JSON Lines で受け取る	`codex exec --json "<依頼>"`
決めた形の JSON で答えさせる	`codex exec "<依頼>" --output-schema ./schema.json -o ./result.json`
直前の続きを頼む	`codex exec resume --last "<次の依頼>"`
IDを指定して続きを頼む	`codex exec resume <SESSION_ID> "<次の依頼>"`
前のコマンドの出力を渡す	`コマンド \| codex exec "<依頼>"`

出典：Codex ドキュメント（再照合日 2026-10-23）

長い指示はファイルから標準入力で渡すと引用符の問題を減らせます。本文のパイプ例はBash用です。PowerShellではGet-Content -Rawなどを使い、文字コードも確認します。複数の実行がある場合、--lastではなくJSONLのthread.startedで得たIDを保存して再開してください。

cat spec.md | codex exec -

codex exec を使うときの注意

Claude Codeは、コマンドを実行する前に許可を求めることがあります。

本文の設定例は.claude/settings.jsonのpermissions.allowへ追記します。既存設定を丸ごと置き換えないでください。このルールはcodex execの引数全体に一致し、特定の依頼だけを許可するものではありません。

{
  "permissions": {
    "allow": ["Bash(codex exec *)"]
  }
}

Codexの作業は時間がかかることがあり、Claude Codeのコマンドには待ち時間の上限があります。

--jsonで監視する場合は、turn.completedだけでなくturn.failedやerrorも確認します。

失敗イベントがある実行や、プロセス終了を確認できない実行を、成功した後続処理へそのまま渡さないでください。

対応する実行環境ならバックグラウンドで動かし、完了状態と終了コード、結果を確認します。bareモードなどバックグラウンド非対応の環境では、呼出し側のタイムアウト設計が必要です。結果ファイルがあるだけで完了とは判断しません。

また、Codexはあらかじめログインしておく必要があります。

APIキーで動かすときは、公式の例では CODEX_API_KEY を実行のときだけ渡しています。

方法2｜スキルやCLAUDE.mdに渡し方をまとめる

毎回同じ手順で渡すなら、Claude Codeのスキルにまとめておくと便利です。

たとえば「Claudeが仕様を書く → codex exec で実装させる → Claudeが差分を確認する」という流れを1つのスキルにします。

---
name: codex
description: 実装を Codex に任せて、結果を確認する
disable-model-invocation: true
---
1. 担当ファイル・実行場所・完了条件を spec.md に書き、親と同じファイルを同時編集しない
2. cat spec.md | codex exec --sandbox workspace-write - を実行する
3. 終了コード・出力・git diff・テスト結果を確認し、未完事項を報告する

例はプロジェクトの.claude/skills/codex/SKILL.mdへ保存します。/codexとして呼び出せます。本文の手順はBash用で、実行環境に合わせて調整してください。

CLAUDE.mdに呼出し方を定める方法もありますが、独立した連携機能ではなく指示です。上位の指示や実行権限に従い、記載だけで自動実行される保証はありません。

方法3｜Codex SDK を使う

Codex SDKにはTypeScriptとPythonがあります。TypeScriptはNode.js 18以降のサーバー側で使い、Pythonは3.10以降でローカルapp-serverを操作します。言語ごとにAPIが違うため、次のTypeScript例をそのままPythonへ移せません。

npm install @openai/codex-sdk
pip install openai-codex

TypeScriptでは、次のように会話（スレッド）を作って指示を送ります。

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();
const result = await thread.run("CIの失敗を調べて直す計画を立てて");
console.log(result.finalResponse);
// 同じthreadへ続けて指示を送る例（確認待ちは自動挿入されない）
const implementation = await thread.run("その計画を実装して");
console.log(implementation.finalResponse);

あとから resumeThread で、IDを指定して会話を再開することもできます。

公式は、CIでの自動化や、Codexとやり取りするエージェントを作る用途に、SDKを勧めています。

方法4｜Codex App Server

App Serverは、CodexのVS Code拡張機能のような、画面のあるアプリを支えている仕組みです。

codex app-server で起動し、JSON-RPCという形式で、会話の作成、指示の送信、途中の割り込みなどを行います。

公式は、自動化やCIならSDKを使うよう書いていて、App Serverは自分の画面にCodexを組み込むとき向けです。

Claude Codeから作業を渡すだけなら、ここまでの仕組みは要りません。

どれを選ぶか

作業を丸ごと任せて結果を見るだけなら、方法1の codex exec
同じ渡し方をくり返すなら、方法2のスキルで codex exec を包む
プログラムで何往復もやり取りするなら、方法3の Codex SDK
自分のアプリの画面にCodexを入れるなら、方法4の App Server

ネットで「CodexをMCPサーバーにしてClaude Codeから呼ぶ」という手順を見かけたら、廃止前の情報か、非公式のツールです。

関連記事：CodexからClaude Codeに作業を渡す方法

関連記事：Claude Codeのスキルの作り方

よくある質問：Claude CodeからCodexに作業を渡すとき

Claude Codeから、一部の作業だけCodexに任せる方法は、ありますか？

4つの方法を紹介しています。

ふだん使いなら、Claude Codeに codex exec を実行させるのがいちばん簡単です。

そのほか、スキルやCLAUDE.mdに渡し方をまとめる方法、Codex SDK（TypeScriptかPythonから操作）、Codex App Server（自分のアプリにCodexを組み込む仕組み）があります。

4つの方法は、どう選べばよいですか？

作業を丸ごと任せて結果を見るだけなら、方法1の codex exec。

同じ渡し方をくり返すなら、方法2のスキルで codex exec を包みます。

プログラムで何往復もやり取りするなら、方法3の Codex SDK。

自分のアプリの画面にCodexを入れるなら、方法4の App Server です。

codex exec とは、何ですか？

Codexを対話画面なしで1回動かすコマンドです。

途中経過は標準エラーに、最後の答えだけが標準出力に出るので、結果を受け取りやすくなっています。

公式資料では標準を読取り専用と説明していますが、実際に読み込む設定と有効な権限も確認してください。

Codexにファイルを書き換えさせるには？

--sandbox で書き込みを許可します。

--sandbox read-only（標準）は読むだけ、--sandbox workspace-write は作業フォルダの中を書き換えられ、--sandbox danger-full-access はサンドボックスの隔離を外すため、外側で隔離したCI等に限定します。

結果の受け取りや、続きの頼み方は？

最後の答えをファイルに保存するには -o、途中経過を JSON Lines で受け取るには --json、決めた形のJSONで答えさせるには --output-schema を使います。

直前の続きは codex exec resume --last、IDを指定するときは codex exec resume にセッションIDを付けます。

前のコマンドの出力は、パイプで渡せます。

codex exec を使うときの注意点は？

Claude Code側の許可とCodex側の権限は別です。本文の設定例は.claude/settings.jsonのpermissions.allowへ追記します。既存設定を丸ごと置き換えないでください。このルールはcodex execの引数全体に一致し、特定の依頼だけを許可するものではありません。

Codexの作業は時間がかかることがあり、Claude Codeのコマンドには待ち時間の上限があるため、対応する実行環境ならバックグラウンドで動かし、完了状態と終了コード、結果を確認します。bareモードなどバックグラウンド非対応の環境では、呼出し側のタイムアウト設計が必要です。結果ファイルがあるだけで完了とは判断しません。

また、Codexはあらかじめログインしておく必要があり、APIキーで動かすときは、公式の例では CODEX_API_KEY を実行のときだけ渡しています。