git404hub

what is claudex fr?

liuzhao1225/claudex — explained in plain English

Analysis updated 2026-05-18

16ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A one-command tool that lets you run OpenAI's Codex models inside the Claude Code interface through a private, localhost-only proxy on your own machine.

vibe map

mindmap
  root((Claudex))
    What it does
      Runs Codex in Claude Code
      Local proxy on localhost
      One command install
    Tech stack
      Bash
      CLIProxyAPI
    Commands
      claudex setup
      claudex login
      claudex doctor
      claudex uninstall
    Security
      Localhost only
      Checksum verified
      Private token file
    Risk
      Unofficial project
      Not supported by Anthropic
      Account risk warning

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Try Codex's gpt-5.6-sol model inside the Claude Code interface you already use daily.

VIBE 2

Run a local, checksum verified proxy that keeps your model traffic on your own machine.

VIBE 3

Switch between Claude Code and a Codex backed session with a single command.

VIBE 4

Diagnose or repair a broken proxy setup using the built in doctor and setup commands.

what's the stack?

ShellBashCLIProxyAPI

how it stacks up fr

liuzhao1225/claudexai-engineer-skool/zen-agentic-engineer-configali-expandings/mactune
Stars161616
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Unofficial workaround that Anthropic does not support, the README warns it may put your account at risk, and it requires a ChatGPT account with Codex access.

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Claudex lets you run OpenAI's Codex subscription models, particularly one called gpt-5.6-sol, inside the Claude Code terminal interface. It works by starting a small private proxy on your own machine that Claude Code talks to instead of Anthropic's servers, so from your point of view you keep using the familiar Claude Code interface while the model answering you is actually a Codex model reached through your ChatGPT account. The proxy only listens on localhost, meaning nothing outside your own computer can reach it. Installation is a single command that downloads a checksum verified installer, sets up a private configuration folder, opens a browser window for you to log into Codex through OAuth, and confirms the target model is reachable before finishing. After that you simply run the claudex command instead of claude to launch Claude Code through the proxy. A collection of subcommands handles ongoing use, including claudex setup to repair a broken install, claudex login to redo authentication, claudex doctor for diagnostics, claudex start, stop, and status to manage the background proxy process, and claudex uninstall to remove everything. The project is careful about what it touches on your system. It keeps its files under standard user-scoped directories, does not modify your existing Claude Code or Codex configuration, does not read your saved Codex login credentials, and will add at most one small reversible line to your shell configuration if needed, with a backup made first. The proxy's local API token is stored in a file only you can read and is never printed to the screen. The README is unusually direct about the risk involved: this is an unofficial, community built workaround, and Anthropic does not support routing Claude Code to non-Claude models this way. Using it could put your account at risk, and the project explicitly points to that warning before telling you to install it. It runs on macOS or Linux, requires Claude Code already installed, and needs a ChatGPT account with Codex access. It is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through installing Claudex on macOS and verifying gpt-5.6-sol is available.
prompt 2
Explain what account or policy risk I should understand before using Claudex.
prompt 3
Help me troubleshoot a Claudex port conflict on port 8317 using claudex doctor.
prompt 4
Show me how to uninstall Claudex while keeping my OAuth credentials with --keep-auth.

Frequently asked questions

what is claudex fr?

A one-command tool that lets you run OpenAI's Codex models inside the Claude Code interface through a private, localhost-only proxy on your own machine.

What language is claudex written in?

Mainly Shell. The stack also includes Shell, Bash, CLIProxyAPI.

What license does claudex use?

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claudex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claudex for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.