How I hand a Claude Code session to Codex (and back) without re-explaining anything
When Claude Code hits its 5-hour limit mid-task, you can wait for the reset, pay for API tokens, or move the task to another agent. I use both Claude Code and Codex, so the third option is the obvious one. The hard part isn't switching apps. It's the handoff: the other agent knows nothing about the
When Claude Code hits its 5-hour limit mid-task, you can wait for the reset, pay for API tokens, or move the task to another agent. I use both Claude Code and Codex, so the third option is the obvious one. The hard part isn't switching apps. It's the handoff: the other agent knows nothing about the task.
Either way, the new side starts cold. You re-explain what the project is, where you were, which approaches you already ruled out, and what's broken now. Pasting the transcript doesn't work well either: tool calls and their output run to tens of thousands of words.
Then you switch back, and Claude doesn't know what Codex changed.
ccx links a Claude Code session with a Codex thread and keeps them in sync both ways, inside both desktop apps. It's open source (MIT) and runs entirely on your Mac.
When Codex runs out too, open the same Claude conversation and send anything ("continue"). Codex's progress comes in. Switch as many times as you like.
The code is already on your disk. All of this arrives as context for the model, not as new chat bubbles.
Each update is usually a few thousand tokens. Clicking again with nothing new does nothing.
v0.0.32 adds a usage heads-up. When either side's 5-hour window passes 90%, and again when it's used up, the menu bar notifies you once and offers that side's newest session to continue in the other app.
Does it bypass usage limits? No. You use your own Claude and ChatGPT/Codex plans, each within its own limits. ccx only moves the task between them.
Is anything uploaded? No. Sync is local. ccx reaches GitHub only to install and check for updates.
Windows, Linux, standalone CLIs? Not yet. macOS 13+ with the Claude and/or Codex desktop app.
Paste this into Claude Code or Codex and it installs itself:
Install ccx for me: run `curl -fsSL https://raw.githubusercontent.com/aaronwong1999/ccx/main/install.sh | sh` (it needs network access and writes to my home folder), then run `~/.local/bin/ccx doctor` and tell me the result. Enter fullscreen mode Exit fullscreen mode Feedback is welcome in Issues or on X ( @aaron0x10 ).