CC Switch (Recommended)

CC Switch is an open-source (MIT) desktop app that manages provider configs for Claude Code / Codex / Gemini CLI and other command-line tools from a single GUI. It supports Windows / macOS / Linux and lives in the system tray for one-click switching.

Why we recommend it

Each CLI stores its config in a different path and format (JSON / TOML / shell env), and those differ again across macOS, Linux, and Windows. Editing them by hand is error-prone — especially on Windows where export doesn't work and %APPDATA% paths differ from Unix. CC Switch hides all of that.

Install

Download the installer for your platform from ccswitch.io or GitHub Releases:

Platform	Package
macOS	`.dmg` (Intel / Arm)
Windows	`.exe` installer
Linux	`.AppImage` / `.deb`

After installing, launch it — it stays in the system tray.

Add TokOne

Switch to the CLI tab you want to configure (e.g. "Codex", "Claude Code", "Gemini CLI"), click "Add Provider", and fill in:

CLI	Base URL	Default model	Notes
Codex	`https://api.tokone.ai/v1`	`gpt-5.5`	Set wire protocol to `responses`
Claude Code	`https://api.tokone.ai`	`claude-opus-4-7`	No `/v1` — Claude Code appends the path itself
Gemini CLI	`https://api.tokone.ai/v1beta`	`gemini-3.5-flash`	Uses the Google protocol

Name: TokOne
API Key: the sk-xxx generated for the matching group in the TokOne console

Save, then switch to TokOne from the tray menu or main window.

Switch / roll back

Click a provider in the main window or tray menu to switch — the CLI's config file is rewritten automatically. Want the official account back? Switch to its preset and CC Switch writes the config back.

Verify

After switching to TokOne, run a simple command for the CLI in a terminal:

bash

codex  "Reply with OK"   # Codex
claude "Reply with OK"   # Claude Code
gemini "Reply with OK"   # Gemini CLI

A normal reply means the config works.

FAQ

The CLI still uses the old account after switching

CC Switch rewrites the config file, but an already-open terminal session still holds the old environment variables. Close and reopen the terminal.

I'd rather edit the config files by hand

See the per-client pages: Codex CLI · Claude Code · Gemini CLI.

Next steps

Quick Start — make your first call
Models — available models and how to choose

CC Switch (Recommended) ​

Install ​

Add TokOne ​

Switch / roll back ​

Verify ​

FAQ ​

The CLI still uses the old account after switching ​

I'd rather edit the config files by hand ​

Next steps ​