Switch Claude Code to any provider
in one click.

A tiny desktop app that points Claude Code at OpenRouter, your own gateway, or a local model — safely editing only the env block of ~/.claude/settings.json. Your other settings are never touched.

⬇ Download free View source
🖥 macOS · Windows · Linux 🐍 Pure Python + tkinter 🔓 Open source 🛟 Auto-backup of settings.json

Why you need it

Claude Code reads its provider from environment variables inside settings.json. Editing them by hand is error-prone — one bad JSON brace and Claude Code refuses to start. This app makes it a two-click job.

⚡

Instant switching

Save multiple provider profiles (OpenRouter, corporate gateway, Ollama…) and jump between them with one click.

🩺

Connection test

Test the endpoint before applying — real HTTP request, clear pass/fail message with server details.

🛟

Safe by design

Only the managed ANTHROPIC_* keys change. Permissions, hooks and everything else stay untouched. A timestamped backup is written before every apply.

🔧

Self-repairing

Empty or broken settings.json? The app detects it, backs it up and writes valid JSON automatically.

🧩

Two auth modes

Bearer token (ANTHROPIC_AUTH_TOKEN) or x-api-key header (ANTHROPIC_API_KEY) — whatever your gateway expects.

⌨️

CLI included

Scriptable --cli mode for automation and dotfiles: apply, test, show, deactivate.

How it works

Three fields and a button — that's the whole workflow.

  1. Pick a profile & fill the form
    Base URL, model ID, optional small/fast model, and your API key. Choose Bearer or x-api-key auth mode.
  2. Test connection
    One click sends a real request to the provider so you know it works before touching anything.
  3. Apply to Claude Code
    The app backs up settings.json, merges only the provider keys into its env block, and you're done. Restart Claude Code and enjoy.

Prefer the terminal?

$ claude-provider-manager --cli apply \
    --name openrouter-main \
    --base-url https://openrouter.ai/api \
    --token sk-or-v1-... \
    --model anthropic/claude-sonnet-4-6 \
    --key-mode auth_token

# other commands: list · show · test · deactivate

Download

Grab the latest build for your platform from GitHub Releases.

🍎

macOS

Apple Silicon & Intel · DMG
Download DMG
🪟

Windows

x64 · portable ZIP
Download ZIP
🐧

Linux

x64 · tar.gz
Download tar.gz

Fetching latest release info…

First launch on macOS? Right-click the app → Open (unsigned build).

FAQ

Does it touch my other Claude Code settings?

No. Only ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN/ANTHROPIC_API_KEY, ANTHROPIC_MODEL and ANTHROPIC_SMALL_FAST_MODEL inside the env block are managed. Everything else in settings.json is preserved byte-for-byte, and a backup is written before every change.

Which providers work?

Any Anthropic-compatible endpoint: OpenRouter, LiteLLM, corporate gateways, OpenAI-compatible proxies, or a local Ollama instance exposed through such a bridge.

What is the "small/fast model"?

Claude Code uses a lightweight model for background tasks like chat titles. Point it at a cheaper model (e.g. a Haiku variant) if your provider has one — leave it empty to use your main model everywhere.

I emptied my settings.json and Claude Code errors out.

That's exactly what the repair feature is for: open the app and hit Apply (or Clear model config). It detects the empty file, backs it up and writes valid JSON again.