CC Switch Setup Guide

CC Switch is a free desktop app that configures Claude Code, Codex, and other AI coding tools through a graphical interface — no manual environment variables or config files. This guide shows how to install it and connect it to Router One.

Before you start, create your API Key on the Dashboard API Keys page (format: sk-xxx).

If you prefer the terminal, follow the manual CLI setup guide instead. CC Switch is the easier path when you don't want to touch environment variables or config files. CLI setup guide

Install CC Switch

CC Switch is open source and ships installers for macOS, Windows, and Linux.

Via Homebrew (recommended):

bash

brew tap farion1231/ccswitch
brew install --cask cc-switch

Or download the .dmg from the GitHub Releases page and drag CC Switch into Applications. The app is signed and notarized by Apple, so it opens without extra steps.

Install the CLI tool you want to use

CC Switch manages configuration for existing CLI tools — it does not install them. If you don't have one yet, install Claude Code (or Codex):

bash

npm install -g @anthropic-ai/claude-code

Need help installing Node.js or the CLI itself? The manual CLI setup guide covers each operating system step by step. CLI setup guide

Add Router One as a provider

Open CC Switch, pick the tool you want to configure (e.g. Claude Code), then click "Add Provider" and fill in:

Name	Router One (any label you like)
API Key	sk-your-api-key — the key you created in step 0

API endpoint (Base URL) — depends on the tool:

text

Claude Code:
https://api.router.one

Codex / other OpenAI-compatible tools:
https://api.router.one/v1

Switch and verify

Click the Router One entry in CC Switch to make it the active provider. CC Switch rewrites the tool's own config files for you.

Claude Code picks up the switch immediately — no restart needed. For other tools (Codex, etc.), restart the terminal or CLI session for the change to take effect.

Then launch the CLI as usual, e.g.:

bash

claude

CC Switch is a third-party open-source project (github.com/farion1231/cc-switch). Router One is not affiliated with it — if installation fails, check the project's issues page.