Quick Start

Get the proxy running in under 60 seconds. Node.js 18+ required.

Claude Code / Max Plan

No API key needed. Your subscription token passes through automatically.

Step 1 — Install and start the proxy

1npm install -g @relayplane/proxy
2relayplane start

Step 2 — Point Claude Code at the proxy

Run this in the same terminal you'll use for Claude Code. Or add it to ~/.zshrc / ~/.bashrc so it's always set.

1export ANTHROPIC_BASE_URL=http://localhost:4100
Common issue: If the dashboard stays empty, this env var isn't set in the terminal where you run claude. Run echo $ANTHROPIC_BASE_URL — it should print http://localhost:4100. If blank, re-run the export above.

Step 3 — Start Claude Code

1claude

Requests flow through the proxy automatically. Open http://localhost:4100 to see cost breakdowns.

API Key Users

1npm install -g @relayplane/proxy
1export ANTHROPIC_API_KEY=sk-ant-...
2# Optional: OpenAI, Gemini, xAI, etc.
1relayplane start
1export ANTHROPIC_BASE_URL=http://localhost:4100

Check your costs

1relayplane stats

View usage and cost breakdown by model. Dashboard also available at http://localhost:4100.

That's it. Simple tasks route to cheaper models automatically. Complex reasoning stays on Opus.

Next Steps