claude-codex

Claude Codex Adapter is a bridge that makes the Codex desktop application think it is talking to the standard Codex coding agent, when it is actually talking to Claude Code instead. Codex is a desktop app with its own user interface for approving AI-suggested code changes; this project hijacks the communication channel between Codex and its backend so you can enjoy Codex's visual approval workflow while the actual AI work is done by Claude Code.

In practice, it works by placing a small shim script on a remote server that intercepts the commands Codex sends when connecting via SSH. When Codex tries to start its normal backend service, the shim redirects that traffic to this adapter, which translates the messages into Claude Code calls and translates the results back into the format Codex expects. From Codex's perspective, nothing has changed — it still shows you file-change diffs to approve and displays the AI's responses as usual, but the intelligence behind those responses comes from Claude Code.

A typical use case is running Claude Code on a remote server (perhaps because your local machine is slow, or because the AI API is region-restricted and you need to route through a proxy) while keeping the familiar Codex graphical interface on your local computer. The adapter also supports a local mode where both pieces run on the same machine.

It is written in TypeScript and requires Node.js 24 or newer to run.