explaingit

kdsuomi/cc-simplerouter

Analysis updated 2026-05-18

98GoAudience · developerComplexity · 3/5Setup · easy

TLDR

A command line tool that lets you run Claude Code with a different AI model provider, like OpenRouter or Gemini, without editing config files.

Mindmap

mindmap
  root((cc-simplerouter))
    What it does
      Swap Claude Code models
      No manual config editing
      Keeps subscription intact
    Tech stack
      Go
      PowerShell
      Shell scripts
    Use cases
      Use OpenRouter models
      Try Gemini or OpenAI
      Pin inference provider
    Audience
      Developers
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run Claude Code against an OpenRouter model instead of a paid Claude subscription.

USE CASE 2

Try a Gemini, OpenAI, DeepSeek, Z.AI, or Meta model inside Claude Code's interface.

USE CASE 3

Pin a specific OpenRouter inference provider for a model to avoid flaky routing.

USE CASE 4

Switch between models per project without editing environment variables by hand.

What is it built with?

GoPowerShellShell

How does it compare?

kdsuomi/cc-simplerouterawuqing/backupxaymanhs/nanotdb
Stars9896102
LanguageGoGoGo
Setup difficultyeasyeasymoderate
Complexity3/53/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the Claude Code CLI already installed and an API key from whichever provider you choose.

No license is stated in the README, so reuse and redistribution terms are unclear.

In plain English

cc-simplerouter is a small command line tool that lets you run Claude Code, Anthropic's coding assistant, with a completely different AI model behind it, such as one from OpenRouter, Google AI Studio's Gemini, OpenAI, DeepSeek, Z.AI, or Meta. Normally, switching Claude Code to another provider means editing configuration files, setting environment variables, or running your own local proxy server by hand. This tool does all of that automatically each time you launch it, and it never touches your existing Claude Code account or subscription sign in. You install it with a single install script for Windows, macOS, or Linux, which downloads a prebuilt binary. The first time you run the simplerouter command, it opens a picker where you choose a provider, paste in that provider's API key, and select a model from a filtered, curated list. After that first setup, you can just type simplerouter to relaunch with your saved choice, or pass flags like minus minus model and minus minus provider to skip the picker and jump straight into a chosen model. Under the hood, the tool sets environment variables for the launched Claude Code process only, pointing it at the right endpoint and your saved key. For most providers that require a different request format than Claude Code expects, simplerouter starts a small proxy running only on your own machine for that single session, translating between Claude Code's requests and the provider's API, and shutting the proxy down as soon as Claude Code exits. For OpenRouter specifically, you can also press Tab in the model picker to pin a specific inference provider behind that model, which the tool passes through using the same local proxy trick. There is also a flag to disable Claude Code's thinking related request fields if a particular provider does not support them, and a flag to reset your saved API keys and start fresh. This project is aimed at developers who already use Claude Code and want the flexibility to try cheaper or different AI models without permanently reconfiguring their setup or running extra infrastructure themselves.

Copy-paste prompts

Prompt 1
Walk me through installing cc-simplerouter and connecting it to my OpenRouter key.
Prompt 2
Explain how simplerouter's local proxy translates requests for a Gemini model.
Prompt 3
Help me launch Claude Code with a specific model using the --model flag.
Prompt 4
Show me how to reset my saved API keys with --reset-key.

Frequently asked questions

What is cc-simplerouter?

A command line tool that lets you run Claude Code with a different AI model provider, like OpenRouter or Gemini, without editing config files.

What language is cc-simplerouter written in?

Mainly Go. The stack also includes Go, PowerShell, Shell.

What license does cc-simplerouter use?

No license is stated in the README, so reuse and redistribution terms are unclear.

How hard is cc-simplerouter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cc-simplerouter for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.