claude-multi-proxy

Use Claude Code with multiple AI providers. Switch between Claude (Anthropic) and Codex (OpenAI) models using /model.

Forked from pinion05/codex-claudecode-proxy

How it works

Claude Code ──→ Local Proxy (CLIProxyAPI) ──→ Anthropic API (Claude OAuth)
                      ↓
                      └──→ Codex API (OpenAI OAuth)

Both providers use OAuth authentication — no API keys needed. Just log in with your existing subscriptions.

Installation

# npx (no install needed)
npx -y claude-multi-proxy

# or install globally
npm install -g claude-multi-proxy
claude-multi-proxy

This will:

1. Download and install CLIProxyAPI
2. Prompt OAuth login for Claude and Codex
3. Configure Claude Code to route through the proxy
4. Set up a LaunchAgent for auto-start

Model Switching

After installation, use /model in Claude Code:

| Command | Model | Provider | |---------|-------|----------| | /model opus | Claude Opus | Anthropic | | /model sonnet | Claude Sonnet | Anthropic | | /model haiku | Claude Haiku | Anthropic | | /model codex | GPT-5.3 Codex | OpenAI |

Commands

# Install (safe to re-run)
npx -y claude-multi-proxy

# OAuth login (individual)
npx -y claude-multi-proxy claude-login
npx -y claude-multi-proxy codex-login

# Status
npx -y claude-multi-proxy status

# Start/stop
npx -y claude-multi-proxy start
npx -y claude-multi-proxy stop

# Uninstall: stop proxy and restore Claude Code settings
npx -y claude-multi-proxy uninstall

# Purge: uninstall + remove all proxy files
npx -y claude-multi-proxy purge

Advanced Usage

Profile-isolated operation (recommended)

Use one profile per terminal/Claude process to isolate proxy state and settings.

# work profile
npx -y claude-multi-proxy --profile work

# personal profile
npx -y claude-multi-proxy --profile personal

By default:

• default profile uses ~/.cli-proxy-api and ~/.claude/settings.json
• non-default profile uses ~/.cli-proxy-api-<profile> and ~/.claude/settings.<profile>.json

Custom Claude settings path

npx -y claude-multi-proxy --claude-settings-path ~/custom/claude-settings.json

Skip settings update

npx -y claude-multi-proxy --no-global-settings

This skips Claude settings update/cleanup during install/uninstall.

Profile-aware commands

npx -y claude-multi-proxy status --profile work
npx -y claude-multi-proxy start --profile work
npx -y claude-multi-proxy stop --profile work
npx -y claude-multi-proxy uninstall --profile work

Requirements

• macOS (LaunchAgent-based)
• Node.js >= 18
• Claude Code installed
• Anthropic account (Claude subscription)
• OpenAI account (for Codex)

Differences from upstream

| Feature | codex-claudecode-proxy | claude-multi-proxy | |---------|----------------------------------------------|-------------------| | Target user | No Claude subscription | Both subscriptions | | Providers | Codex only | Claude + Codex | | Model slots | All overridden to Codex | Original Claude models preserved | | Codex access | Replaces Sonnet/Opus/Haiku | Separate /model codex | | Auth method | Codex CLI token sync | CLIProxyAPI native OAuth | | LaunchAgents | 2 (proxy + token sync) | 1 (proxy only) |

Known Issues

Thinking block signature error when switching models

When switching from Codex to Claude (e.g., /model codex → /model opus) within the same session, you may encounter a 400 error:

Invalid `signature` in `thinking` block

Cause: CLIProxyAPI wraps Codex responses in Claude-format thinking blocks, but cannot generate cryptographically valid signatures (only Anthropic's servers can). When conversation history containing these blocks is sent to Claude's API, signature validation fails.

Workaround: Use /clear before switching models to reset the conversation history.

Operational recommendation: Use one profile per terminal/process (e.g., --profile work, --profile personal) and keep model switching within the same process to a minimum.

/clear
/model opus

See CLIProxyAPI #1584 for upstream tracking.

Safety

• Claude Code settings are backed up before any changes
• uninstall removes proxy-related Claude Code settings keys
• Proxy binds to 127.0.0.1 only (localhost)

License

MIT