TL;DR — Claude CodeからローカルのCodex CLIを呼び出し、生成した画像をプロジェクトに直接保存したことがある。この橋渡しによって、ウィンドウの切り替えやファイル移動は減った。ただし、利用できるかどうかは、ログイン方法、プラン、ツール、ローカルの権限に左右される。ChatGPTでログインして内蔵の画像生成を使うことは、無料や、すべてのアカウントで利用可能という意味ではない。
最近は、ほぼ一日中Claude Codeで作業している。記事を書き、タスクを分け、素材を整理し、コードを直す。でも画像が必要になると、ChatGPTのウェブ版へ切り替え、プロンプトを貼り、生成を待ち、ダウンロードして、プロジェクトへ戻すことが多かった。
そこで、この途切れをつなぎたくなった。Claudeが要求を整理し、ローカルのCodexが画像を生成し、最後に指定した場所へ保存する。本稿では2026年4月の実践経験を残し、今から試す読者が確認すべき条件も補足する。カバーは当時のワークフローの概念図であって、すべてのアカウントでそのまま実行できるという保証ではない。
画像をワークフローに戻したい人へ
すでにClaude Codeでプロジェクトを管理し、カバー画像、スライドの挿絵、製品のモックアップをよく必要とするなら、この連携の仕組みを理解する価値はある。減らせるのは、ツールの間で要求やファイルを移す動作だ。
たまに一枚生成するだけで、プロジェクトへの保存も必要ないなら、使い慣れた画面で直接作るのもいい。どの手順を省きたいのかを先に確認してから、CLI、Skill、ローカル接続ツールを増やすか決めたほうが、維持しやすい。
まず、用語を分かりやすく整理する
| 用語 | このワークフローでの役割 |
|---|---|
| Claude Code | 要求を理解し、プロンプトを整理し、許可を得てローカルのコマンドを実行する |
| Codex CLI | ターミナルで動く。ChatGPTサブスクリプションまたはAPI keyでログインできるが、課金と適用条件は異なる |
gpt-image-2 | 本稿で扱う画像モデル。OpenAIの内蔵画像生成の文書でも、現在この名前が使われている |
| Skill | 再利用できる作業指示。アカウントの利用権やOSの権限を自動で増やすものではない |
| MCP | ツールやサービスを接続する方法。できることは、具体的なツールと許可によって決まる |
| Cowork | 当時私が使っていたClaudeのデスクトップ作業画面。ターミナル版と同じ環境条件を、そのまま当てはめることはできない |
モデル、実行ツール、ログインしている身分は、別の層にある。ツール名だけを見ても、料金、アクセス範囲、最後に使われるモデルまでは判断できない。それぞれ確認する必要がある。
目指したのは、一枚の画像を指定した場所に保存すること
要求は具体的だった。
サングラスをかけた柴犬を一枚生成し、新しいファイルとしてこのプロジェクトのimagesフォルダに保存して。既存の画像は上書きしないで。
Claudeが説明を整理し、Codexが画像を生成し、実際の保存先を報告する。これは当時、私が動かした経路であって、「画像生成」の一言だけで、すべてのクライアントで再現できるという機能の約束ではない。
成功の判断も、エージェントが「完了」と言っただけでは足りない。ファイルが存在し、開くことができ、内容が要求に合っていて初めて、今回の画像を受け取れたと言える。
このワークフローはどう動くのか
四つに分けて考えられる。要求の整理、ローカルのCodexの呼び出し、生成と保存、成果物の確認だ。それぞれに失敗の原因がある。一度にすべてのツールを入れるより、分けたほうが原因を探しやすい。
Claude Codeがローカルのshellを実行できる場合、許可を得てCodexを呼び出せる。当時は、Claudeのデスクトップ環境からmacOSの操作ツールを通して、同じ経路を起動することも試した。ただし、それは別の連携層だ。ツールを利用できるか、どのパスに触れられるか、出力をデスクトップ画面へどう戻すかは、別途確認する必要がある。
だから今は、特定の第三者製MCPを、すべてのデスクトップ利用者に必須の唯一の橋とは書かない。当時のCoworkのoutputsパスも、共通設定とは扱わない。別のツールへ要求を送る前に、何を送るのか、そのツールがどこへアクセスできるのかを明確にしたい。
ログイン、プラン、権限を先に確認する
OpenAIの認証の文書では、ChatGPTサブスクリプションによるログインと、API keyによるログインを分けている。前者は対応するサブスクリプションの利用権を使い、後者はAPIの使用量に応じた課金になる。当時の私はChatGPTログインを使い、OpenAI API keyを別途渡していなかった。
でも、API keyを別途渡さないことは、使用量の負担がないことを意味しない。現在のCodexの使用量の説明では、内蔵の画像生成は使用量を消費し、Freeプランでは現在利用できない。ChatGPTウェブ版の画像生成の利用権を、そのままCodexにも当てはめることはできない。
自分の環境では、まずバージョン、ログイン状態、コマンドの説明を確認できる。
codex --version
codex login status
codex exec --help
これらの確認自体では画像を生成しない。まだインストールやログインをしていないなら、現在の公式のインストール・認証手順に従う。初回ログインにはブラウザが必要な場合があり、設定の全過程で一度もブラウザを開かないという話ではない。トラブル相談のために、ログイン認証情報やauth.jsonを他人へ貼り付けることもしない。
最小構成:まず一枚の生成を確認する
現在の公式の画像生成文書では、対話セッションで画像を説明する方法や、明示的に$imagegenを使う方法を案内している。まずCodex自身の画面でツールを利用できるか確認してからClaudeへつなぐと、変数を一つ減らせる。
当時は非対話型のコマンドを使った。以下は、プロジェクトのディレクトリとプロンプトの関係を理解するために、その呼び出し形式を残したものだ。自分のバージョンや実行方法で画像生成ツールを利用できるかは、引き続き確認が必要になる。
mkdir -p ./images
codex exec -C "$PWD" -s workspace-write \
'まず、このターンで内蔵の画像生成を使えるか確認してください。利用できる場合だけ、サングラスをかけた柴犬を一枚生成し、./images/shiba-new.png に保存してください。ファイルがすでに存在する場合、またはツールを利用できない場合は、停止して理由を説明してください。'
このコードを実行すると画像生成を依頼し、対応する使用量を消費する。先に、現在のプロジェクト、利用可能な枠、新しいファイル名を確認してほしい。プロンプトはデータとして扱い、任意の利用者入力をそのままshellコマンドへ連結しない。workspace-writeも、すべての作業の成功を保証するスイッチではない。
今回の改訂では文書とコマンドの説明だけを確認し、画像の再生成や、各バージョンの一連の動作テストは行っていない。非対話モードでツールを使えないなら、まず対話セッションに戻って確認する。すべての権限を広げて無理に進めない。
当時の出力を、一回の実践記録として残す
当時記録した結果は、約一分で、1254×1254、約2MBのPNG一枚だった。これはあの作業の結果であって、固定のサイズ、待ち時間、ファイル容量を保証するものではない。

私に役立ったのは、画像が直接プロジェクトに保存され、ウェブからダウンロードして移す必要がなくなったことだ。今日、この橋渡しが自分の仕事に合うかを判断するには、古い成果物を見るだけでなく、ツールの利用可否、出力先、費用を実際に確認する必要がある。
つまずいた二点:まず原因を絞り、それから対処する
一つ目はOperation not permittedだ。このメッセージは異なる箇所で出る可能性があり、それだけで~/.codex全体の所有者に問題があるとは判断できない。以前はディレクトリ全体の権限を再帰的に変えることを勧めていたが、対処が大ざっぱすぎるため、今回取り下げた。
出発点としては、失敗した手順と具体的なパスを記録し、作業ディレクトリ、ツールへの許可、保護された場所、確認できたファイル権限の問題のどれなのかを分けるほうがよい。原因が分からないときは停止し、管理者権限でフォルダ全体を一度に変えない。
二つ目は作業ディレクトリだ。-CはCodexの作業のルートを指定する。相対パスがどこを指すかは、そのルートと合わせて理解する必要がある。まずpwdで現在地を確かめ、最後に報告された絶対パスと照合する。プログラムが終了したことは、想定した場所に画像が保存されたことと同じではない。
Skillにまとめる:手順と停止条件を残す
一枚の生成を確認してから、Skillにまとめる価値が生まれる。当時はCLI版とデスクトップ版を作ったが、古いダウンロードパッケージには、古くなったプランやトラブル対処の説明が含まれる。そのため、本稿では直接ダウンロードしてインストールする案内を提供せず、古いパッケージで既存のスキルを上書きすることも勧めない。
今、自分のSkillを整理するなら、作業指示はこう書きたい。
- 今回の要求、画像の枚数、作業ディレクトリ、上書きしないファイル名を確認する。
- ログイン方法、利用できる画像生成ツール、対応する使用量を確認する。使えなければ理由を説明する。
- 現在のクライアントが対応する方法で呼び出し、デスクトップMCPとCLIの権限を混同しない。
- ファイルを開けるか、画像が要求に合うかを確認し、実際の保存先を報告する。
- 失敗時は原因を残し、ディレクトリ全体の権限変更、課金経路の変更、連続した再試行を独断で行わない。
これは作業指示の骨組みであって、今回動作を確認した新しいインストールパッケージではない。トリガー語やallowed-toolsは手順を整理する助けになるが、スキルが選ばれるか、実行を許可されるかは、実際の環境で決まる。説明を明確に書いても、スキルがすべてのツールを自動で得るわけではない。
どんな場合に、この連携を作る価値があるか
同じプロジェクトで原稿を書き、コードを直し、素材を作ることが多く、ツールのバージョンを維持する意思のある人は、特に恩恵を得やすいかもしれない。要求、画像、その後の編集を同じワークフローに置けば、移す動作を減らせる。
たまに画像を生成するだけで、明確な保存先や一括処理の必要がなければ、連携のために連携を増やさなくてもよい。一括処理なら、なおさら枚数、ファイルの規則、許容できる費用を先に定めてから始めたい。一度の成功を、無制限の自動化へ広げない。
中断を一つ減らし、それぞれの層の責任も見えるようにする
私は今も、この考え方が好きだ。Claudeが要求を整理し、Codexが実行できる部分を担い、画像がプロジェクトへ戻る。価値は接続したツールの数ではなく、要求から成果物までの間に、繰り返す動作をどれだけ減らせたかにある。
ログインに成功しても、画像生成ツールを必ず使えるわけではない。
API keyがなくても、使用量を消費しないわけではない。
ファイルが存在しても、内容と保存先を確認する必要がある。
権限エラーは原因を絞る必要があり、一律に権限を広げてはいけない。
これらの層を分けて考えると、ワークフローを維持しやすくなる。Codexを外部の確認役として使った別の経験は、Codexから第二の意見を得るにまとめた。ここでも同じで、ツールが結果を出したあと、最後は自分で確認する必要がある。
2026年11月改訂:OpenAIの公式の認証、画像生成、使用量の文書に基づき、プランと実行方法を整理した。古いパッケージの直接インストール、一括した権限修復、未確認のデスクトップ共通機能の説明は取り下げた。元のテスト画像は当時の記録として残し、再生成していない。


💬 コメント
読み込み中...