Claude Proxy

Use any LLM provider with Claude Code. One command setup. Easy toggle on/off.

Quick Start

npm install -g claude-proxy
claude-proxy

The interactive wizard will ask you:

1. Which provider? (DeepSeek, OpenRouter, Ollama, Groq, etc.)
2. Your API key
3. Which model?
4. Start server + enable proxy? → Yes!

That's it. Claude Code now uses your chosen LLM.

Commands

| Command | Description | |---|---| | claude-proxy | Interactive setup wizard | | claude-proxy start | Start proxy server in background | | claude-proxy stop | Stop proxy server | | claude-proxy on | Point Claude Code to proxy | | claude-proxy off | Restore native Anthropic | | claude-proxy status | Show everything | | claude-proxy add | Add a custom provider | | claude-proxy restart | Restart the server |

Toggle Between Proxy and Native Claude

claude-proxy on     # Use DeepSeek/Gemini/etc.
claude-proxy off    # Back to native Anthropic

No manual settings.json editing. The toggle backs up your settings before modifying.

Manual Setup (Custom Port)

If you want to use a different port or set things up manually:

# Run the wizard, it asks which port you want
claude-proxy setup

# Or edit the config directly
cat ~/.claude-proxy/config.json

{
  "port": 9999,
  "apiKey": "sk-your-key",
  "provider": "deepseek",
  "model": "deepseek-chat",
  "apiBaseUrl": "https://api.deepseek.com/chat/completions"
}

Then:

claude-proxy start   # Start on port 9999
claude-proxy on      # Configure Claude Code
claude-proxy off     # Restore original settings

Built-in Providers

• DeepSeek — deepseek-chat, deepseek-reasoner
• OpenRouter — Claude, Gemini, GPT models via one API
• Ollama — Local models (no API key needed)
• Groq — Fast inference
• SiliconFlow — Chinese provider with DeepSeek/Qwen models
• Volcengine — ByteDance provider

Custom Providers

claude-proxy add

Enter name, API URL, key, and models. Works with any OpenAI-compatible API.

How It Works

Claude Code ──(Anthropic format)──▶ localhost:6666 ──(OpenAI format)──▶ DeepSeek/Gemini/etc.

claude-proxy runs a local server that:

1. Receives Anthropic-format requests from Claude Code
2. Converts them to OpenAI format
3. Forwards to your chosen provider
4. Converts the response back to Anthropic format
5. Returns it to Claude Code

Claude Code has no idea it's not talking to Anthropic.

Files

| Path | Purpose | |---|---| | ~/.claude-proxy/config.json | Proxy configuration | | ~/.claude-proxy/settings-backup.json | Original Claude Code settings backup | | ~/.claude-proxy/custom-providers.json | Your custom providers | | ~/.claude-proxy/proxy.pid | Server process ID |

Troubleshooting

Server won't start? Check if port is already in use:

lsof -i :6666

Claude Code still using Anthropic? Make sure proxy is enabled:

claude-proxy status
claude-proxy on

Switch back to native Claude:

claude-proxy off