fuergaosi233

fuergaosi233 / claude-codex

Public

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

39
1
85% credibility
Found May 17, 2026 at 40 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This project is a bridge that lets you use the Codex desktop application to interact with Claude Code running on a remote computer. Normally, Codex connects to a local AI assistant, but this adapter tricks it into talking to Claude Code over SSH instead. You get the polished Codex interface while Claude actually runs wherever you want—perhaps a powerful cloud server. The adapter handles translating between the two systems, manages file approvals, and keeps everything in sync.

How It Works

1
💻 You want AI coding help on a powerful remote machine

You've got Claude Code running on a fast server somewhere else, but you wish you could use the nice Codex desktop app to talk to it.

2
🔌 You find a bridge that connects them together

This adapter acts like a translator between the Codex app on your computer and Claude Code on your remote server.

3
🛠️ You set up the adapter on your remote machine

Following simple instructions, you install a small helper program on the server where Claude Code lives.

4
🔒 You connect your Codex app to the remote host

Just like adding any remote connection in Codex, you point it to your server and everything wires up automatically.

5
💬 You chat with Claude Code as if it were local

Ask questions, request code changes, approve file edits—all through the familiar Codex interface, but Claude actually runs on your powerful remote machine.

✨ You get the best of both worlds

The comfortable Codex app experience combined with the raw power of Claude Code running on a remote server, all working together seamlessly.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 40 to 39 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-codex?

Claude-codex is a bridge that connects the Codex desktop app to Claude Code, letting you use Claude through Codex's familiar interface on remote machines via SSH. The adapter sits between Codex's native app-server protocol and Claude Code's runtime, handling the translation layer so everything just works. You install a lightweight shim on the remote host, and Codex routes its connections through to Claude Code. It requires Node.js 24+ and Python 3.10+, with Claude Agent SDK as the backend engine.

Why is it gaining traction?

The hook here is clear: if you want Codex's GUI experience but need to run code on a remote server, this eliminates the usual friction. You get Claude Code's capabilities (MCP server support, file checkpointing, per-thread git worktrees) through Codex's approval workflow. The permission bridging means Claude's Bash commands appear as Codex command approvals, and file edits surface as diffs you can accept or reject. Optional features like reverse proxy routing for API calls and model/effort configuration give you control over behavior without abandoning the GUI.

Who should use this?

Developers who live in the Codex desktop app but need to work on remote SSH hosts. If you want Claude Code's agentic capabilities but prefer not to switch between a terminal and a GUI, this fills that gap. Teams with limited Codex seat licenses might also benefit, since you're routing Codex's connection to a shared Claude Code installation.

Verdict

At 39 stars this is early-stage and niche, and the setup involves multiple moving parts (Node, Python, SSH, shims). The documentation is thorough, but the credibility score of 0.85% reflects a small user base. Worth evaluating if your workflow matches the described use case, but treat it as a project with ongoing development rather than a stable, battle-tested tool.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.