Community画像github.com

matisiu09/codex-imagen

Codex (OpenAI) に写真を渡して、新しい画像を生成したり、組み込みのジェネレーター(gpt-image-2)で写真を修正・編集し、結果をフォルダに保存します。ユーザーが「これをCodexに渡して」「Codexで生成して」「Codexでこの写真を修正して」「Codex / OpenAI / gpt-imageで編集して」「CodexでXを消して」などと依頼したとき、あるいは「generate/edit this image with Codex」とトリガーしたときに使用します。動画は生成しません。

codex-imagen とは?

このスキルは、Claude が OpenAI の Codex CLI を呼び出して画像生成・編集を行うためのブリッジです。Codex の組み込みツール `image_gen`(gpt-image-2 モデル)を利用し、ユーザーのChatGPTプランの利用枠で動作します(APIキー不要)。Claude がユーザーの指示(「写真を編集」「新しい画像を生成」「テキストを含む画像の作成」など)を解析し、専用の Python スクリプトを実行して Codex に処理を委譲します。編集モードでは、指定した領域のみを変更し、顔・ポーズ・構図・色味を保持します。生成モードでは、スタイルやテーマの参照画像を与えることも可能です。結果は PNG ファイルとして指定フォルダに保存され、同時にレスポンス内容とログがテキストファイルで出力されます。画像ごとに約30秒〜2分かかり、タイムアウトは900秒に設定されていますが、`--timeout` オプションで調整可能です。処理後、Claude は各画像の品質(顔・手・製品・テキストのゆがみ)を確認し、結果と使用したプロンプトをユーザーに提示します。動画生成には対応していません。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/matisiu09/codex-imagen-skill/tree/HEAD/codex-imagen

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Codex imagen

Codex CLI(codex、npm install -g @openai/codex でインストールし、codex login でユーザーのChatGPTアカウントにログイン済み)は、組み込みツール image_gen(gpt-image-2)を使用して画像の生成・編集を行います。ユーザーのChatGPTプランの利用枠で動作し、APIキーは不要です。Claude が指示を組み立て、スクリプトを実行し、結果を確認します。

実行前の確認

  1. ユーザーに確認する: どの写真か、どのような変更か、どのような新しい画像か、何枚のバリエーションが必要か、保存先はどこか。画像内に表示するテキストがあれば、スペルを確認する。
  2. 消費量を伝える: 各画像はChatGPTプランの利用枠から消費されることを伝える。リクエスト前に何枚の画像を生成するかを明示する。
  3. プライバシー: 写真はOpenAIにアップロードされる。第三者の写真(クライアント、特定可能な人物など)の場合は、アップロードの許可を得る。
  4. 入力写真を確認し、正しいものであることを確かめる。

実行

python ~/.claude/skills/codex-imagen/scripts/codex_imagen.py \
  --foto "path/to/photo.jpg" \
  --pedido "床のケーブルを消して、それ以外はそのまま" \
  --modo editar --variantes 1 \
  --salida "path/to/output" --nombre photo_no_cable
  • --modo editar: 指定された部分のみ変更し、顔、ポーズ、構図、色味を保持します。写真がある場合のデフォルトモードです。
  • --modo generar: 新しい画像を生成します。写真(オプション)はスタイルやテーマの参考として使用できます。
  • --foto は複数指定可能です。最初の写真が編集対象となり、残りは補助的に使用されます。
  • --variantes N: N枚の画像を生成します。1回の呼び出しで1枚ずつ処理されます。
  • 各画像の処理には30秒〜数分かかります(タイムアウトは900秒。--timeout でバッチ用に延長可能)。
  • 出力: <名前>_v1.png、_v2…、<名前>_respuesta.txt(Codexの応答内容)、<名前>_log.txt。スクリプトは各ファイルのパスを含むJSONを出力します。

Codex は読み取り専用のサンドボックスで実行されます。プロジェクトのファイルには触れません。スクリプトは新しい画像を ~/.codex/generated_images/ からコピーします。

実行後

  • 各結果を確認する: 変更が正しく適用されているか、顔、手、製品、テキストがゆがんでいないか。失敗した場合は、1回につき1つの修正点を指定して再試行します。
  • 使用したプロンプトとともに、結果の画像をユーザーに提示します。
  • 元の画像は上書きしません。結果は常に新しいファイル名で保存されます。

動画について

Codex は動画を生成しません。AIによる動画生成には別のサービス(例:OpenAI API経由のSora。別途APIキーと費用が必要)が必要です。ユーザーに確認してください。

エラーが発生した場合

  • codex: command not found → npm install -g @openai/codex を実行します。
  • ログインしていない場合 → ユーザー自身がターミナルで codex login を実行するよう依頼します(Claudeがパスワードを入力することはできません)。
  • 画像が返ってこない場合 → <名前>_log.txt を確認します。プランの利用枠制限やコンテンツ拒否の可能性があります。codex features list で image_generation が true になっているか確認します。

関連スキル