How do I install the Codex Image skill?

Run npx skillmds@latest add lwmxiaobei/codex-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codex Image safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codex Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codex Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codex Image?

lwmxiaobei (@lwmxiaobei) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codex Image by lwmxiaobei — Agent Skill

Name: Codex Image
Author: lwmxiaobei

Codex Image

Use this skill when the user wants to generate images, edit images, or create images with gpt-image / GPT Image / OpenAI image models. Triggers on requests like 'generate an image', 'create a picture', 'edit this image', 'modify the photo', 'use gpt-image', or any image generation/editing task that should run via OpenAI's hosted image_generation tool.

lwmxiaobei 6a1dcca 19 files · 111.6 KB Updated Sep 17, 2026

File contents

codex-image

Generate or edit images via OpenAI's Responses API by reusing the user's ChatGPT subscription — no OPENAI_API_KEY needed. The skill speaks to /v1/responses with the image_generation hosted tool while presenting an HTTP fingerprint indistinguishable from the official codex CLI.

When to invoke

Invoke this skill when the user asks to generate or edit an image and:

They explicitly mention codex-image / "codex image" / "use my ChatGPT quota", or
They have an active codex login (~/.codex/auth.json exists) and have not asked for an API-key based generator, or
They explicitly want to avoid paying for OPENAI_API_KEY usage.

Do not use this skill when:

The user has an OPENAI_API_KEY set and wants to use it directly (use a generic Images API skill instead).
The user wants Google / Gemini / Adobe / other vendor image models.
The user wants pure local background removal (imagegen skill covers that).

Commands

codex-image generate "<prompt>" [--output-format png|webp|jpeg] [--out PATH] [--force]
codex-image edit --input REF1.png [--input REF2.png ...] "<prompt>" [--out PATH] [--force]
codex-image login
codex-image logout
codex-image status

Run codex-image --help for full flags. See references/cli.md for details and examples.

Prompting

See references/prompting.md. The guidance is compatible with the sibling imagegen skill so prompts can be reused.

Auth

The skill resolves an access token like so:

Read $CODEX_HOME/auth.json (default ~/.codex/auth.json).
If the access token is close to expiry, refresh it.
If the file is missing or refresh fails, launch a PKCE OAuth browser flow (binds 127.0.0.1:1455, falling back to :1457). On success, write auth.json so subsequent calls — including codex itself — reuse it.

Use codex-image login to force the OAuth flow. Use codex-image logout to clear tokens (keeps the file shape; codex will treat it as logged-out). Use codex-image status to inspect the current credential.

Output

By default images are written to:

$CODEX_HOME/generated_images/codex-image/<UTC>-<slug>.<ext>

with file mode 0o644. Pass --out PATH for an explicit destination.

Exit codes

Code	Meaning
0	Success
2	User input error
3	File-system error
4	Auth/plan error (HTTP 403)
5	Network / rate-limit error (retries exhausted)
6	Partial success (stream broken)
7	API business error (`response.failed`)
130	User interrupt (Ctrl+C)

Legal

Unofficial skill. Read LEGAL.md before use.

---name: codex-imagedescription: Use this skill when the user wants to generate images, edit images, or create images with gpt-image / GPT Image / OpenAI image models. Triggers on requests like 'generate an image', 'create a picture', 'edit this image', 'modify the photo', 'use gpt-image', or any image generation/editing task that should run via OpenAI's hosted image_generation tool.---# codex-imageGenerate or edit images via OpenAI's Responses API by **reusing the user'sChatGPT subscription** — no `OPENAI_API_KEY` needed. The skill speaks to`/v1/responses` with the `image_generation` hosted tool while presenting anHTTP fingerprint indistinguishable from the official `codex` CLI.## When to invokeInvoke this skill when the user asks to generate or edit an image **and**:- They explicitly mention `codex-image` / "codex image" / "use my ChatGPT quota", **or**- They have an active `codex` login (`~/.codex/auth.json` exists) and have not asked for an API-key based generator, **or**- They explicitly want to avoid paying for `OPENAI_API_KEY` usage.Do **not** use this skill when:- The user has an `OPENAI_API_KEY` set and wants to use it directly (use a generic Images API skill instead).- The user wants Google / Gemini / Adobe / other vendor image models.- The user wants pure local background removal (`imagegen` skill covers that).## Commands```codex-image generate "<prompt>" [--output-format png|webp|jpeg] [--out PATH] [--force]codex-image edit --input REF1.png [--input REF2.png ...] "<prompt>" [--out PATH] [--force]codex-image logincodex-image logoutcodex-image status```Run `codex-image --help` for full flags. See[`references/cli.md`](./references/cli.md) for details and examples.## PromptingSee [`references/prompting.md`](./references/prompting.md). The guidance iscompatible with the sibling `imagegen` skill so prompts can be reused.## AuthThe skill resolves an access token like so:1. Read `$CODEX_HOME/auth.json` (default `~/.codex/auth.json`).2. If the access token is close to expiry, refresh it.3. If the file is missing or refresh fails, launch a PKCE OAuth browser flow (binds `127.0.0.1:1455`, falling back to `:1457`). On success, write `auth.json` so subsequent calls — including `codex` itself — reuse it.Use `codex-image login` to force the OAuth flow.Use `codex-image logout` to clear tokens (keeps the file shape; `codex` willtreat it as logged-out).Use `codex-image status` to inspect the current credential.## OutputBy default images are written to:```$CODEX_HOME/generated_images/codex-image/<UTC>-<slug>.<ext>```with file mode `0o644`. Pass `--out PATH` for an explicit destination.## Exit codes| Code | Meaning ||------|---------|| 0 | Success || 2 | User input error || 3 | File-system error || 4 | Auth/plan error (HTTP 403) || 5 | Network / rate-limit error (retries exhausted) || 6 | Partial success (stream broken) || 7 | API business error (`response.failed`) || 130 | User interrupt (Ctrl+C) |## LegalUnofficial skill. Read [`LEGAL.md`](./LEGAL.md) before use.

Frequently asked questions