OpenRouter Proxy for Claude Code

Use any OpenRouter model (Qwen, Llama, Mistral, etc.) with Claude Code.

Architecture

Claude Code CLI → Local Proxy (localhost:8787) → OpenRouter API

The proxy converts Anthropic API format to OpenAI format, enabling Claude Code to work with any OpenRouter model.

Quick Start

1. Prerequisites

• Docker Desktop
• Claude Code CLI
• OpenRouter API Key

2. Configure (Optional)

For prompt-free setup, create a .env file:

cp .env.example .env
# Edit .env with your API key

3. Launch

Windows:

.\launch-claude-openrouter.ps1

Mac/Linux:

./launch-claude-openrouter.sh

Documentation

Guide	Description
Setup Guide	Detailed installation instructions
Configuration	Environment variables and .env setup
Architecture	How the proxy works, agent/MCP support
Model Guide	Choosing the right OpenRouter model
Troubleshooting	Common issues and solutions

Stop the Proxy

docker compose down

Links

• OpenRouter Models
• OpenRouter Docs
• y-router