1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code から Codex CLI を呼んで重い作業を分担する――codex exec・AGENTS.md・結果ファイルだけ読む運用

1
Posted at

なぜ作業を分けるのか

Claude Code を使っていると、長い下書きや読み合わせを頼むたびに、クレジットの減りが気になります。筆者の記録では、消費の大半は Agent ツールで起動した子エージェントによるものでした。そこで、長い原稿の執筆や別担当の事実確認を Codex CLI に回す運用にしました。

CLI は、コマンドで操作するための入口です。Claude Code が依頼文をファイルに書き、Bash ツールから codex exec を呼びます。Codex が終わったら、Claude は結果ファイルを読み、成果物を確認して報告します。

この記事は、Windows 11 での記録と、そのとき使った設定・スクリプトをもとにしています。Claude Code はデスクトップアプリの Code タブで使い、Codex CLI は ChatGPT アカウントでログイン済みでした。実測メモでは、この PC に Codex のデスクトップアプリは入っていません。

狙いは、ChatGPT の契約枠で動く Codex に重い作業を分担することです。ただし、Claude のクレジットが何%減ったかは測っていません。節約率を示す記事ではなく、依頼と確認の流れを共有する記事です。

分担表を先に決める

筆者の CLAUDE.md では、作業を次のように分けています。

Codex に任せる Claude Code が担当する
教材・本の章・手順書・記事などの長い下書き 何をするかの判断と依頼文の作成
別担当による事実確認・読み合わせ 結果の確認と持ち主(筆者)への報告
大量のファイルを読んで要点をまとめる調査 記憶・GitHub・Obsidian の操作
プログラムの作成・実行・集計・変換 ブラウザ操作・出品・投稿・送信
codex review によるコードレビュー 数回のツール操作で済む小さな作業

依頼する仕事が決まったら、読むファイル、作るファイル、完成の条件を Claude が書きます。Codex が動いている間は同じファイルに触らず、終了してから Claude が確認します。

codex exec の呼び方

まず、作業用の scratchpad に codex_依頼.md を用意します。scratchpad は依頼文と結果を置く作業場所です。依頼文には、目的、読むファイル、作るファイルの場所、完成の条件、禁止事項を日本語で書きます。

以下は Claude Code の Bash ツールから流す形です。<対象フォルダ> や <scratchpad> は、実際の場所に置き換えます。

読むだけの調査や事実確認では、次のコマンドを使っています。

codex exec --sandbox read-only --skip-git-repo-check --ephemeral -C "<対象フォルダ>" -o "<scratchpad>/codex_結果.txt" - < "<scratchpad>/codex_依頼.md"

下書きやスクリプトを作らせるときは、次の形です。

codex exec --sandbox workspace-write --skip-git-repo-check --ephemeral -C "<書いてよいフォルダ>" -o "<scratchpad>/codex_結果.txt" - < "<scratchpad>/codex_依頼.md"

材料に記録されている使い分けは、次のとおりです。

指定 この運用での使い方
exec 依頼文を渡して Codex に作業を頼む呼び出しです(対話の画面を開かずに終わるまで動きます)
--sandbox read-only 調査・確認など、読むだけの作業に使います
--sandbox workspace-write 下書きやスクリプトの作成・実行に使います
-C 対象フォルダを指定します。書き込みを許す場合は、書いてよいフォルダを指定します
-o Codex の最後のメッセージ(完了報告)の書き出し先。Claude はこれだけを読みます
- < "…/codex_依頼.md" ファイルに書いた依頼文を入力として渡す形です

codex exec --help の説明では、--skip-git-repo-check は Git リポジトリの外でも実行できるようにする指定、--ephemeral はセッションのファイルをディスクに残さずに実行する指定です。-o(--output-last-message)は、エージェントの最後のメッセージを書き出すファイルの指定です。作業フォルダが Git 管理でないことが多く、毎回の依頼を履歴として残す必要もないので、この二つを付けています。

書き込み用の手順では、-C に指定したフォルダの中だけを書ける場所として扱っています。人から預かったフォルダや共有ドライブは指定しない決まりです。作業範囲は依頼文にも書き、既存ファイルの上書き・削除を禁止します。

ネットが必要な作業についてだけ、材料には -c sandbox_workspace_write.network_access=true を追加する手順があります。ここに載せた下書き・確認のコマンドには付けていません。

Claude Code 側では Bash ツールの run_in_background: true で実行します。これは上のコマンドに足す CLI オプションではなく、Bash ツール側の指定です。終了後は -o の結果ファイルだけを読み、実行ログ全体は読みません。作られたファイルは要所を確かめてから渡します。

ここでいう「結果ファイルだけ読む」は、成果物を確認しないという意味ではありません。実行経過をすべて読み込む代わりに、完了報告を結果ファイルで受け取り、原稿や確認結果の必要な箇所を Claude が確認する、という分け方です。

更新で場所が変わる問題を入口スクリプトで吸収する

実測メモにある CLI 本体の場所は、次の形でした。

%LOCALAPPDATA%\OpenAI\Codex\bin\<ハッシュ>\codex.exe

更新で <ハッシュ> のフォルダ名が変わるため、依頼のたびに本体のパスを直接書く運用にはしていません。代わりに、次の場所にある入口から呼んでいます。

C:\Users\<ユーザー>\.local\bin\codex

材料にある Git Bash 用の入口は、次のスクリプトです。

#!/bin/sh
# Git Bash用:いちばん新しいCodex本体を探して起動
exe=$(ls -t "$LOCALAPPDATA"/OpenAI/Codex/bin/*/codex.exe 2>/dev/null | head -n1)
[ -z "$exe" ] && { echo "Codexが見つかりません。Codexアプリを一度起動してください。" >&2; exit 1; }
exec "$exe" "$@"

このスクリプトでは、対象の codex.exe を更新時刻順に並べ、先頭を起動します。渡された引数は "$@" で本体へ渡します。ここでいう「いちばん新しい」は、このスクリプトが更新時刻で選んだものを指します。

PATH が通っていない古いシェルでは、入口をパス付きで呼びます。Bash では次の形です。

"$USERPROFILE/.local/bin/codex"

PowerShell からの入口の呼び方も材料にあります。

& "$env:USERPROFILE\.local\bin\codex.cmd"

ただし、codex.cmd の中身は材料に含まれていません。上のシェルスクリプトを、そのまま PowerShell 用として扱うことはしません。

なお、入口のエラー文は「Codexアプリを一度起動してください」と、アプリがある前提の書き方のままです。筆者の PC にはデスクトップアプリは入っておらず、上の場所にある CLI 本体だけで動いています。

AGENTS.md に書く決まり

依頼ごとの条件とは別に、Codex に読ませる共通ルールを AGENTS.md に置いています。材料の内容から、下書きと確認に関係する決まりを抜き出すと、次のようになります。

返事・原稿・コメント・ファイルの中身は日本語。
架空の数字・体験・感想・レビューを作らない。
出どころがない数字は書かない。
確かめていないことを言い切らない。
分からないことは「分からない」と書く。
投稿・出品・公開・送信など、外に出す操作をしない。
既存ファイルを上書き・削除しない。
頼まれたフォルダの外には書かない。
有料の API・サービスを使わない。
個人の情報を原稿や記録に書かない。

材料では、同名のファイルがすでにあり、中身がある場合は、書き換えずに止まって報告する決まりです。依頼文にも、新しい名前で作ることと、Claude と Codex が同じファイルを同時に触らないことを書きます。

作業の終わりには、作ったファイル、字数や件数、確認できずに書かなかったこと、気になったことを短く報告させます。こうしておくと、Claude が結果ファイルを読んだとき、何を確認すればよいか分かります。

たとえば、下書き依頼は次のように具体化できます。以下は材料の決まりを記事用に整理した依頼文の例です。

目的:渡した材料をもとに、日本語の下書きを作る。
読むもの:指定した材料ファイル。
作るもの:指定フォルダ内の新しい原稿ファイル。
完成の条件:材料にない数字や体験を足さない。
禁止事項:既存ファイルの上書き・削除、外部への投稿・送信。
終了時の報告:保存先、字数、確認できず書かなかったこと。

実例:教材を書かせ、別の Codex に事実確認を頼む

実測メモの 11/10 の例では、Codex が教材の原稿を書きました。記録上の分量は、無料部分が 5,482 字、有料部分が 26,819 字です。その後、別に起動した Codex に、読むだけの設定で事実確認を頼んでいます。

確認結果は「重大 0・中 1」でした。中の指摘は、「人が確かめて出している」と読める一文について、その根拠が記録にないというものでした。この一文は修正しています。

一方、11/9 に Claude の子エージェントで作った別の教材では、独立した事実確認を 5 回行っています。指摘件数は 25→10→12→6→3 件でした。これは「読み合わせは最大 3 回」という決まりを破った反省として残されています。

現在の決まりは、読み合わせを最大 3 回にし、2 回目以降は直した所だけを確認することです。Codex に任せる場合にも同じ決まりを適用しています。なお、この比較は別の教材の記録であり、同じ条件で両者の性能や使用量を比べた実験ではありません。

つまずいたことは二つ

Windows の py ランチャーが見つからなかった

Codex の中では Windows の py ランチャーが見つからず、HTML を組み立てるスクリプトは Claude 側で実行しました。材料には原因や Codex 側での修復手順はありません。

元ファイルへの指摘を公開物への指摘と取り違えた

Codex から「図の目印が残っている」という指摘もありました。しかし、確認対象が元ファイルだったための誤りで、公開ページには目印はありませんでした。

その後は、指摘を公開物で確かめてから直す決まりにしています。今回の記事作成で外部ページを確認したという意味ではなく、実測メモに残っている過去の対応です。指摘が出たときは、何のファイルを見た指摘なのかも確認する必要があります。

測っていないこと・運用上の注意

Claude のクレジット削減率は測っていません。筆者の記録には「かなり少なくなった」という感触がありますが、比較に使える数値ではありません。Codex 側の使用量も未測定です。処理の速さや費用の比較も、ここにある記録からは示せません。

また、人から預かった機密のファイルを Codex に渡す場合は、渡してよいか持ち主に確認してから、という決まりにしています。書き込み先の指定や共通ルールがあっても、渡す材料の確認は別に必要です。

Codex が動かない場合や ChatGPT の枠が切れた場合だけ、Claude の Agent を使ってよい、という例外もあります。その際は持ち主に一言伝えます。枠の具体的な上限や料金、各オプションの詳しい仕様は材料にないため、この記事では扱いません。

おわりに

この運用では、Claude Code が判断と依頼文を担当し、Codex CLI が長い下書きや別担当の確認を受け持ちます。AGENTS.md と依頼文で範囲を決め、終了後は結果ファイルを読み、成果物の要所を確認します。

入口スクリプトは本体の場所が更新で変わる問題を吸収し、確認回数の決まりは読み合わせの区切りになります。削減率は未測定ですが、重い作業の渡し方と、戻ってきた結果の確認方法を整理した実例として共有しました。

この運用全体(決まり・記憶・点検・やめる基準)を実録にまとめた教材を Tips に置いています:https://tips.jp/u/hina-mina/a/7lmUBZTy

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?