mcpField
C
codex-gpt-image

codex-gpt-image

github.com/ningzimuクリエイティブ・メディア70262 回インストール7 週間前に更新
リポジトリ

codex-gpt-image について

codex-gpt-imageは、Codex OAuth経由で画像を生成・編集するスキルです。SKILL.mdに対応し、ネイティブの画像ツールを持たないエージェント向けで、OpenAI APIキーではなくローカルのCodex認証を使います。

主な機能

  1. 01Codex OAuth経由の画像生成
  2. 02参照画像を使った画像編集
  3. 03認証状態の確認とログイン
  4. 04生成画像のローカル保存

活用シーン

  1. 01Codexサブスクリプションでの画像生成
  2. 02OPENAI_API_KEYを使わない画像編集
  3. 03複数のエージェントでのローカル画像ワークフロー共有

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ningzimu/codex-gpt-image --skill codex-gpt-image

インストール後、Claude Code で/codex-gpt-imageを入力して読み込まれたか確認します。

同梱ファイルreferences/openai-images-api-parameters.mdscripts/codex_gpt_image.py

詳細

Codex GPT Image

OpenAI API キーを使用する方法ではなく、Codex OAuth を通じて画像を生成または編集するには、このスキルを使用します。同梱の CLI はローカルの Codex 認証ファイルを読み取り、Codex Images バックエンドのエンドポイントを呼び出します。

使用する場合

  • ユーザーが Codex 認証／サブスクリプションを通じて gpt-image-2.5-flare または GPT Image を使うよう求めている場合。
  • 現在のエージェントが SKILL.md に対応しているものの、ネイティブの画像ツールを備えていない場合。
  • ユーザーが OPENAI_API_KEY を使用しないことを明示している場合。
  • ユーザーが Codex、Claude Code、OpenClaw、Hermes Agent などのエージェント間で、同じローカル画像ワークフローを使いたい場合。

ユーザーが公式の OpenAI Images API、OpenAI 互換ゲートウェイ、または API キーによる課金を希望している場合は、このスキルを使用しないでください。このスキルは Codex OAuth 専用です。

基本的なワークフロー

以下の CLI コマンドは、すべてこのスキルのフォルダーを作業ディレクトリとして実行することを前提としています。それ以外の場合は、この SKILL.md から scripts/codex_gpt_image.py の絶対パスを解決してください。

  1. ローカルの Codex 認証を確認します。

    python3 scripts/codex_gpt_image.py auth-status

  2. Codex 認証が見つからない場合は、デバイスコードによるログインフローを実行します。

    python3 scripts/codex_gpt_image.py login --open-browser

    CLI にブラウザー URL と短いユーザーコードが表示されます。この手順はユーザー自身が完了する必要があります。トークンを貼り付けるよう求めてはいけません。

  3. ユーザーが実際に入力したプロンプトを使って画像を生成します。リクエストに必要な CLI フラグのみを選択し、このスキル内のプロンプトの文言を再利用しないでください。

  4. 画像を編集する、または参照画像を使う場合は、1 つ以上の --image 入力を渡します。編集では、ユーザーが求める変更内容と、変更せず維持すべき要素に基づいてプロンプトを作成します。

  5. 保存先のパス、指定されたモデル、確認できた場合は実際の出力サイズ、Codex OAuth が使用されたかどうかを報告します。バックエンドが特定していない限り、指定されたモデルが使われたと主張してはいけません。

デフォルト

  • 認証ファイル：~/.codex/auth.json
  • 認証ファイルの上書き：CODEX_AUTH_FILE=/path/to/auth.json
  • ログインのフォールバック：login は OpenAI Codex のデバイスコード認証を使用し、同じ認証ファイルに書き込みます
  • ログインクライアント ID：--client-id、CODEX_APP_SERVER_LOGIN_CLIENT_ID、その後に公開されている Codex のデフォルト値
  • Images のベース URL：https://chatgpt.com/backend-api/codex
  • 画像モデル：gpt-image-2.5-flare
  • サイズ：auto
  • 品質：auto
  • 背景：auto
  • モデレーション：auto
  • 出力形式：png
  • 出力圧縮：jpeg と webp では 100

パラメーター値、デフォルト、モデル固有の制約、CLI との対応付けについて詳しくは、references/openai-images-api-parameters.md を参照してください。

パラメーターの選択

ユーザーのリクエストで特定のオプションが必要な場合を除き、公式 API のデフォルト値を優先してください。model、size、quality、background、moderation、output_format の値を明示的に選ぶ前に、リファレンスを確認してください。

プロンプトの作成

プロンプトは明確で、実制作を意識した内容にしてください。

  • 作成するアセットの種類を明記します。
  • 表示する正確なテキストがあれば、引用符で囲みます。
  • 構図、背景、スタイル、制約を指定します。
  • 編集では、変更せず維持すべき要素を繰り返し明記します。
  • 依頼がない限り、ロゴ、透かし、追加のテキストを入れないでください。

失敗時の対応

  • 認証ファイルが見つからない場合：codex_gpt_image.py login --open-browser を実行するか、ユーザーに codex login の実行を依頼してから再試行します。
  • 401／403 の場合：Codex OAuth トークンの期限切れ、アカウントのアクセス権不足、またはエンドポイントがセッションを拒否している可能性があります。ユーザーに Codex 認証を更新してもらいます。
  • ネットワーク障害の場合：リクエストが冪等で、ユーザーが画像の重複生成の可能性を了承する場合は、一度だけ再試行します。
  • ~/.codex/auth.json のトークンを表示したり、貼り付けたりしてはいけません。

実装に関する注意事項

CLI は、次の内容で Codex Images リクエストを送信します。

  • 生成エンドポイント：POST https://chatgpt.com/backend-api/codex/images/generations
  • 編集エンドポイント：POST https://chatgpt.com/backend-api/codex/images/edits
  • 認証：Authorization: Bearer <access token from ~/.codex/auth.json>
  • モデル：gpt-image-2.5-flare

JSON 形式の Images レスポンスを解析し、返された Base64 画像データをローカルファイルに書き込みます。

GPT Image 2.5 との互換性

日常的な生成にはデフォルトの Flare モデルを使用するか、精密な編集には --model gpt-image-2.5-sunburst を選択してください。どちらのモデルも日付付きスナップショットも、xhigh および max の品質と、PNG/WebP による透明な背景に対応しています。旧モデルでは新しい品質レベルを使用できません。この CLI では、旧モデルの透明度を無効にしています。Codex OAuth の利用可否は、アカウントとバックエンドの段階的な展開状況によって異なります。

2026-09-11 に実施した Codex OAuth の検証では、無効なモデル名も受け付けられ、実際のモデル ID は省略され、要求したサイズとは異なる寸法が返されました。生成に成功しても、モデルや品質の選択が検証されたことにはなりません。これらのフラグは要求した設定として扱い、公開 API の機能が OAuth バックエンドでも保証されているかのように説明しないでください。

コメント

Markdown 対応