SkillFoxx

Claude Codex Adapter CLI

Adapter that lets the Codex desktop app talk to Claude Code through the native app-server protocol in Remote mode.

  • 109 ★ on the repository
  • Last commit
  • MIT
CLI

Broad access

Why this level

  • The adapter runs commands and file edits on the remote machine through Claude Code, with approvals through the app.
  • The Anthropic key sits in the remote machine's environment variables.
All reasons and checks

nwverse/claude-codexAuthor:nwverse

Install

Manual install

npm install

Inside the repository clone; then `npm run build` and `npm run doctor`. Node.js 24 or newer is required.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The adapter runs commands and file edits on the remote machine through Claude Code, with approvals through the app.
  • The Anthropic key sits in the remote machine's environment variables.

This is third-party code. Review the repository files before installing.

What it does

In Remote mode the Codex app runs its usual SSH version probe and calls `codex app-server`. The adapter intercepts that call and hands it to Claude Code instead of the real Codex runtime, while every other command goes to the regular Codex CLI. Claude Code executes the agent turns, and in Codex App they look native. Claude's text and reasoning stream into the conversation, `Bash` and other tools become command approvals, and `Edit`, `Write` and `MultiEdit` show file changes with live diffs. MCP calls get the app's approval card. A reply can contain an inline visualization: metric tiles and charts the app draws inside the message.

Who it is for. Codex app users who want to run tasks on Claude models through Claude Code on a remote machine.

Good fit when

  • You like the Codex App interface but want Claude Code to do the agent work.
  • A remote SSH machine is ready and has Claude Code signed in.
  • File edits and commands should be approved through app cards with a diff.
  • A data analysis result should appear as charts right in the reply.

Not a fit when

  • The Codex app already works on the native Codex runtime for you.
  • You have no remote machine; the adapter targets Remote mode over SSH.
  • The environment cannot run Node.js 24.

Example request

Run a failing-test investigation through Claude Code on the remote machine and show file changes as approval cards.

Limitations

Node.js 24 or newer is needed for the stable `node:sqlite`, and `CLAUDE_CODEX_NODE` pins the binary. The remote machine needs a clone of the repository, a build and the `codex` shim ahead of the real one in PATH. Claude needs an Anthropic key in `ANTHROPIC_API_KEY` or a `claude /login` sign-in, and usage is billed on your plan. Provide keys only through the shell or a secret manager and never commit them. `CLAUDE_CODEX_REASONING_VISIBLE=0` hides Claude's reasoning. The project hooks into the Codex launch, so an app update may call for a new compatibility check.

How to disable. Remove the `codex` shim from `~/bin` and the `CLAUDE_CODEX_ADAPTER` and `ANTHROPIC_API_KEY` variables, then delete the repository clone. Disable the Remote connection in the Codex App settings.

FAQ

How do I install Claude Codex Adapter?

Run `npm install`, `npm run build` and `npm run doctor` in the repository clone. Then copy `scripts/codex-shim` to `~/bin/codex`, make it executable and add `~/bin` to PATH.

What does npm run doctor do?

It checks the environment: the Node.js version, required files and settings. Run it before adding the Remote connection in the app.

How does the adapter call Claude?

Through Claude Code on the remote machine. You need `ANTHROPIC_API_KEY` or a sign-in with `claude /login`.

How do Claude's actions look in Codex App?

Commands become approval requests, file edits show with a live diff and MCP calls get the app's card.

Where is the full guide?

On the project documentation site, in the Getting started section, which covers connecting Codex App and setting up the remote machine.

Discussion

No questions or reviews yet.

CLI tools
Needs a VPN

An MCP server that hands tasks to the Codex CLI from inside Claude Code: code questions, change review, web search and resumable sessions

MCP serverBroad access649

A plugin that syncs Claude Code, Codex CLI and Antigravity on one project and lets them hand work to each other.

PluginBroad access57
Editors’ pick

OpenAI's coding agent that runs locally in your terminal, with IDE and desktop versions

CLIBroad access135.1K

A Claude Code skill that hands implementation-heavy work to Codex CLI while Claude keeps planning, review and acceptance.

PluginBroad access62

Three Claude Code commands that bring Codex in for a second opinion on a plan, a plan critique and brainstorming in read-only mode

PluginMinimal access148
Needs a VPN

The /codex-workflows skill: Claude Code writes a script, dozens of Codex agents run it, and the run shows on a map

SkillBroad access330

README in short

A TypeScript adapter sits between Codex App and Claude Code, keeping the app's interface and action approvals.

README badge

Report a problem