gitwtfhub

wtf is claudex?

victorv2i/claudex — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A setup script that lets developers run the Claude Code tool while actually using OpenAI models through their existing Codex subscription.

Mindmap

mindmap
  root((claudex))
    What it does
      Reroutes Claude Code
      Uses Codex subscription
      Separate config folder fix
    Tech stack
      Shell scripts
      systemd service
      Local proxy
    Use cases
      Cross-provider CLI access
      Effort level switching
      Dual login setups
    Audience
      Developers
      CLI power users

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

Why would anyone build with this?

REASON 1

Use the Claude Code interface while routing requests through an existing Codex subscription instead.

REASON 2

Switch between different response depth levels when using an alternate model provider inside Claude Code.

REASON 3

Keep a normal Claude Code login working side by side with this alternate setup.

What's in the stack?

ShellsystemdPython

How it stacks up

victorv2i/claudex123satyajeet123/bitnet-serverahloiscreamo/pod-search
Stars000
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an existing Codex subscription and only works on Linux due to a systemd dependency.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Claudex is a small setup script for developers who already use both the Claude Code command line tool and an OpenAI Codex subscription. It lets you run the Claude Code interface, with all its familiar commands and menus, while actually sending requests to OpenAI's models instead of Anthropic's, using the subscription you already pay for through Codex. The README explains a specific technical problem this project solves. If you are already logged into Claude Code with a Pro or Max subscription, a normal attempt to redirect it to a different model provider quietly fails, because Claude Code keeps using its own stored login token no matter what other settings you provide. The author found this out by inspecting the actual network traffic. The fix here is to give this alternate setup its own separate configuration folder, one that has no stored Claude login in it, so Claude Code is forced to use the alternate connection instead. Setting it up involves cloning the project and running its install script, which downloads a small local proxy program, sets up a background service that only listens on the local machine, and reuses your existing Codex login so you do not need to log in again separately. Once installed, running the command starts a normal-looking Claude Code session that is actually talking to the other provider's models behind the scenes, including a way to switch between different response depths or effort levels. The author is upfront that this routes a paid subscription through an unofficial local proxy, which sits in a legal gray area of that provider's terms of service, so it is used at the reader's own judgment. It currently only works on Linux, not macOS. It is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through installing claudex and connecting it to my existing Codex login.
Prompt 2
Explain why Claude Code silently ignores alternate API keys unless you use a separate config folder.
Prompt 3
Help me understand the risks of routing a Codex subscription through a local proxy like this.
Prompt 4
Show me how to uninstall claudex cleanly from my system.

Frequently asked questions

wtf is claudex?

A setup script that lets developers run the Claude Code tool while actually using OpenAI models through their existing Codex subscription.

What language is claudex written in?

Mainly Shell. The stack also includes Shell, systemd, Python.

What license does claudex use?

Use freely 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.