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: Gemini MCP

Requirements

• Node.js ≥ 20 (tested on v22)

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

Install — one flow

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

./install.sh registers the tool globally with Claude Code, then opens your browser to sign in with ChatGPT. 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.

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.