codex-bridge

Give Claude Code image generation and a team of GPT-5 subagents — using the Codex CLI login you already have.

Claude Code can't generate images, and everything it does runs on your Claude quota. The Codex CLI can generate images with gpt-image-2, and runs on your ChatGPT plan — a completely separate budget. This plugin bridges the two.

Two things you get:

1. Claude can produce images. Ask for an icon, a mockup, a hero image, a full favicon set — Claude writes the prompt, drives gpt-image-2 through Codex, then looks at the result and regenerates if it missed.

2. Claude can delegate to GPT-5. Four Codex-powered subagents handle review, debugging, bulk implementation, and image work. Claude stays the orchestrator: it scopes the task, Codex does the volume, Claude verifies the result. Heavy work runs on your ChatGPT quota and its intermediate output never enters your Claude context.

No OpenAI API key. Everything routes through codex login, so it bills against your ChatGPT plan rather than API credits.

Demo

One style contract across a set. Each sibling was generated with an earlier icon passed as --ref, so the palette, stroke weight, glyph scale and margins carry over instead of being re-described and re-interpreted every time:

Every image in this repository was generated by this plugin — the GIF above, these icons, and the social preview card. The exact commands and the VHS recording script are in assets/README.md, so you can reproduce all of it.

Contents

• Demo · Install · Quickstart · What's inside
• Feature 1 — images · Feature 2 — GPT-5 subagents
• How it works · Limitations · Troubleshooting

Install

Prerequisites

Codex CLI	npm i -g @openai/codex or brew install codex
Logged in	codex login → verify with codex login status (should say Logged in using ChatGPT)
ChatGPT plan	Plus, Pro, or Team
Claude Code	any current version

Then:

/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge

Run /reload-plugins if Claude Code asks you to.

Other install methods

Try it for one session, no install:

git clone https://github.com/Sateezg/codex-bridge.git
claude --plugin-dir ./codex-bridge

Auto-load from your skills directory:

git clone https://github.com/Sateezg/codex-bridge.git ~/.claude/skills/codex-bridge
chmod +x ~/.claude/skills/codex-bridge/bin/*

Loads as codex-bridge@skills-dir on your next session.

Quickstart

Nothing to configure. Just ask in plain language:

generate a hero image for the landing page, save it in assets/
make the sky in assets/hero.png sunset orange, keep everything else
set up favicons and an OG card for this project
review my changes before I commit
ask codex why this test only fails under --parallel
rename useSession to useAuthSession across the whole repo

The last one is the interesting case. Claude notices it's mechanical work across many files and offers the split before starting:

This touches 34 files with the same change. I can hand the edits to Codex — runs on your ChatGPT quota and keeps 34 file dumps out of this context — then review its diff here. Want me to?

What's inside