Claudex

Claudex

Run the Claude Code harness with GPT models from a ChatGPT subscription.

Claudex is a small, opinionated setup layer around Claude Code and Raine's claude-code-proxy. You keep Claude Code's interface, tools, skills, hooks, permissions, and agents while requests are translated to the Codex Responses backend.

The translation layer is the work of Raine (@raine) and the claude-code-proxy contributors. Claudex only packages a launcher, tested defaults, and setup documentation. If this is useful, please star and support the upstream project.

What you get

- ccx: a separate launcher, so normal claude and codex remain untouched.
- GPT-5.6 Sol by default, with shortcuts for the other models currently recognized by the proxy.
- Sol for Claude Code's small/background utility requests instead of silently falling back to a Haiku alias the proxy cannot route.
- Sol at medium effort for the dedicated ccx bg lane.
- An optional custom background sub-agent configured at high effort.
- An interactive wizard that asks which models and effort levels you want.
- Proxy health checks and automatic Homebrew service recovery.
- Bounded sub-agent fan-out, request retries, and request timeouts by default.
- A ccx solo escape hatch that disables the Agent tool for one session.
- No API key in the repository. Authentication is handled by the proxy's Codex OAuth flow.

Requirements

- macOS or Linux with Homebrew, or Windows 10/11 with Windows PowerShell 5.1.
- Claude Code 2.1.217 or newer. That is the first release supporting all three configurable sub-agent limits.
- Homebrew installed.
- claude-code-proxy 0.1.17 or newer. The installer adds it when missing.
- A ChatGPT plan with Codex access. Model availability varies by account and can change.
- Git for cloning this repository.
- On…