GPTImage

Image generation for Claude Code — powered by GPT Image 2, through your ChatGPT subscription.

No API key. No per-image bill. You sign in with your ChatGPT account once, and Claude Code can generate & edit images in any project.

⚠️ Grey area, by design. "Sign in with ChatGPT" is officially meant for Codex. GPTImage reuses that token to reach GPT Image 2 (ChatGPT Images 2.0). It works and is widely done, but it is not an officially sanctioned API. Keep usage personal/local. Heavy use can trigger plan rate-limits (429) or, worst case, account restrictions. You accept that risk by using this.

What you get

• A local MCP server Claude Code talks to (generate_image, image_auth_status).

• A Claude Code skill (/gptimage) that teaches the agent when and how to use it.

• A CLI for login and one-shot generation.

• No API key. No password ever handled by the tool — you log in yourself in the browser.

Related MCP server: imagethis

Requirements

• Node.js ≥ 20 (tested on v22)

• A ChatGPT account with an active plan (Plus / Pro / etc.)

Install with your agent

Paste one prompt into Claude Code, Codex, Cursor or any coding agent and it installs GPTImage for you, connects it, and makes a test image. You only sign in to ChatGPT in your browser when asked. → AGENT-INSTALL.md

Install — one flow

git clone https://github.com/Connected-Mate/gptimage.git
cd gptimage
npm install
./install.sh

./install.sh registers the tool with the agents it finds (Claude Code, Codex, Cursor — or choose with --agent claude|codex|cursor|none), then opens your browser to sign in with ChatGPT (skipped if you're already signed in; --no-login to skip, --yes never prompts). When you see the success screen, you're done.

Because the tool is registered at the user level, it works in every Claude Code project on your machine — you only set it up once. (Restart Claude Code if it was already open, so it picks up the new tool.)

Check it any time:

npm run status     # show plan, account, token expiry
npm run logout     # remove stored credentials
npm run login      # sign in again

Use it in Claude Code

Open Claude Code in any project and just ask:

Generate a watercolor red fox in snow and save it to fox.png using the gptimage tool.

Claude Code calls generate_image and saves the PNG.

Work reference-first (recommended)

GPT Image 2 is much stronger at transforming existing images than creating from scratch. The skill teaches Claude Code to:

1. Ask you for reference images before the first generation (style samples, brand assets, screenshots, sketches) and store them in a references/ folder at your project root.

2. Source references for you if you have none — browsing Pinterest, Dribbble, or sites relevant to your project — and asking for your approval before generating.

3. Iterate with your feedback: drop screenshots of the result in context (or annotated captures of what's wrong); they go into references/ and feed the next generation.

The references/ folder becomes your project's visual memory — the more it grows, the better the results.

Or from the terminal

npm run gen -- --prompt "a red fox in snow, watercolor" --out fox.png --size 1024x1024
npm run gen -- -p "apply Image 1's style to Image 2" -o out.png --ref style.png --ref subject.png

How it works

your prompt
   │
   ▼
generate_image (MCP tool)
   │   reads your ChatGPT token from ~/.gptimage/auth.json  (or ~/.codex/auth.json)
   │   refreshes via auth.openai.com/oauth/token if expired
   ▼
POST https://chatgpt.com/backend-api/codex/responses
   model: gpt-5.5, tools:[{ type: image_generation }]  ← GPT Image 2
   headers: Authorization: Bearer <subscription token>, chatgpt-account-id
   ▼
SSE stream → "image_generation_call" → base64 PNG
   ▼
saved to disk (auto-versioned, never overwrites)

Configuration (env vars)

Roadmap

• edit_image — first-class image editing endpoint

• inpaint_with_mask — pixel-precise zone editing via PNG alpha masks

• Multiple-output / variations in one call

• Optional OpenAI API-key backend as a fallback when the plan is rate-limited

Credits / prior art

• yuji-hatakeyama/opencode-gpt-imagegen — the OpenCode plugin this mirrors

• numman-ali/opencode-openai-codex-auth — OAuth/PKCE flow reference

• EvanZhouDev/openai-oauth — Codex OAuth proxy reference

Not affiliated with OpenAI. Use at your own risk, in accordance with OpenAI's terms.