@gkorepanov/ccodex
v0.5.11
Published
Unofficial Codex App compatibility bridge for Codex CLI and Claude Code runtimes.
Readme
Claude Code'x
Claude models in the Codex App, next to GPT.
CCodex lets you pick Claude in the Codex App's model picker. Claude chats run on real Claude Code with your own Claude subscription, and GPT chats keep running on your Codex as before. It works in the desktop app, on servers you open over SSH, and from the ChatGPT app on your phone.
Install
curl -fsSL https://github.com/gkorepanov/ccodex/releases/latest/download/install.sh | shUpdate
ccodex update && codex app-server daemon restartThen quit and reopen the ChatGPT desktop app.
[!NOTE] An unofficial community project, not affiliated with OpenAI or Anthropic. It's young, so expect bugs, and please report them.
What you get
- Claude next to GPT in the model picker, with Claude's effort levels and Fast mode.
- Switch models mid-chat. Move a chat from GPT to Claude or back, and it carries on where it was.
- The App works as usual in Claude chats: approvals, Plan mode, sub-agents, images,
/goal, side chats, editing and forking messages. - Your phone too. With remote control on, the ChatGPT mobile app drives Claude chats like GPT ones.
- One history with the
claudeCLI. A chat from the App opens withclaude --resume, and your CLI sessions show up in the App. /ccshows the chat's model, context use and your Claude and Codex limits.
How it works
Install CCodex on every machine where your chats run: your computer for the local app, and each server you open over SSH. There are no CCodex servers and no telemetry.
Setup
You need macOS on Apple silicon or Linux (x64 or arm64, glibc 2.31+), with Node.js 22–26. The installer adds Codex if it's missing, and Claude Code comes with CCodex.
- Install with the command above, or with
npm install -g @gkorepanov/ccodex && ccodex setup. Run it as your normal user, not withsudo. - Log in to whatever you aren't logged in to yet:
ccodex auth codex,ccodex auth claude. - Restart. Open a new shell and run
codex app-server daemon restart. Then:- app connected over SSH: reconnect to the server;
- local app on a Mac: quit it with ⌘Q and open it again;
- local app on Linux: start it with
CODEX_CLI_PATH=~/.ccodex/bin/codex.
If something goes wrong
ccodex doctorchecks the install and tells you what to run.ccodex uninstallremoves CCodex (add--purge --yesto delete~/.ccodextoo).- What setup changes on your machine, settings, logs and known quirks:
docs/details.md.
