Developer tools

Claudex

Set up Claude Code with CLIProxyAPI, Codex OAuth, and model routing from one terminal UI.

CLIWindowsmacOSLinux

View source GitHub

Overview

Claudex is an unofficial launcher and setup tool for running Claude Code through CLIProxyAPI. It detects the current OS and CPU, downloads a compatible CLIProxyAPI release, starts Codex OAuth login, discovers available models, and maps them to Claude Code's Opus, Sonnet, Haiku, and subagent slots.

Guided terminal setup

Use a Rich-powered menu for first-run setup, model assignment, status checks, updates, and launch actions.

CLIProxyAPI installer

Finds the latest compatible release, downloads it, verifies SHA-256 when metadata is available, and installs it under ~/.claudex.

Codex OAuth flow

Starts the local CLIProxyAPI configuration and runs the Codex OAuth login used by the proxy.

Model assignment

Maps discovered text models to Opus, Sonnet, Haiku, and subagent aliases for Claude Code.

Install

Claudex requires Python 3.10 or newer, Claude Code available as claude in PATH, and internet access for the first setup. After setup, restart your terminal and run claudex.

View source

Clone and run

git clone https://github.com/Riyoway/claudex_installer.git
cd claudex_installer
python claudex.py

Python 3

python3 claudex.py

FAQ

What does Claudex install?

It can download a compatible CLIProxyAPI release, place it under ~/.claudex, create the local configuration, run Codex OAuth login, discover models, and install the claudex shell command.

Does it install Claude Code?

No. Claude Code must already be installed and available as claude in your PATH.

Where is data stored?

Claudex stores auth data, downloads, CLIProxyAPI versions, and configuration under ~/.claudex.

Is it official?

No. Claudex is not affiliated with Anthropic, OpenAI, or the CLIProxyAPI project.