CC Switch

Create a Essevin key, import it into CC Switch, and use the provider in Codex App, Codex CLI, or Claude Code.

CC Switch is a desktop configuration manager for Windows, macOS, and Linux. Use it when you prefer a graphical setup or regularly switch Claude Code and Codex providers. It manages configuration; it does not install Codex App, Node.js, or either CLI.

Only follow this guide for development tools

To make product images in the browser, skip API-key setup and use Creative Studio.

The complete path

Create a Essevin key → Import CCS → Choose Claude Code or Codex CLI → Confirm in CC Switch → Enable

Before you start

Choose the key by model

Prepare the target client first: Codex App, Codex CLI, or Claude Code.
Choose the key by model: Claude uses a Claude key, and GPT uses a GPT key.
Update CC Switch: use the latest release.

Install CC Switch

Download the current .dmg from CC Switch Releases. Install and open the app once so your browser can launch it during import.

Import from the Essevin console

Open Key Management

Open API keys and select New key in the upper-right corner.

Essevin API keys page (console UI shown in Traditional Chinese) with the New key button in the upper-right corner — Start on API keys and select New key. The console UI in this screenshot is shown in Traditional Chinese.

Name the key and choose what it is for

Enter a recognizable name, pick a card under Use with, and select Create. Pick Claude for Claude models and GPT for GPT models; if you need both, create one key for each. Every key draws from your plan's credits. Expiration is optional.

New key dialog with the name field and the Use with cards (Claude, GPT, Images, and video models) — Enter a name and pick what the key is used with before creating it. The console UI in this screenshot is shown in English.

Open Import CCS

Find the new key row, open its ··· menu, and select Import CCS. You do not need to copy the key manually.

Essevin key row More menu (console UI shown in Traditional Chinese) with Import CCS — Open the key row's More menu and select Import CCS. The console UI in this screenshot is shown in Traditional Chinese.

Choose the client

Choose Codex CLI for both Codex App and Codex CLI. Choose Claude Code when you use Claude Code. If you use both client families, repeat the import for each one.

Essevin client selection dialog (console UI shown in Traditional Chinese) with Claude Code and Codex CLI options — Codex App and Codex CLI use the Codex CLI option; Claude Code uses the Claude Code option. Only the option that matches the key's purpose is enabled: this screenshot uses a Claude key, so Codex CLI is unavailable and needs a GPT key. The console UI in this screenshot is shown in Traditional Chinese; the two client names themselves are not translated.

Review and confirm

In the browser prompt, select Open CC Switch. Verify the provider name, Base URL, and masked key, then select Import.

Enable the provider

Open the matching Claude Code or Codex tab in CC Switch, find the imported provider, and select Enable. The provider should now appear as active.

CC Switch Codex provider list with the Essevin provider and an Enable button; the button label and the routing-support badge are shown in Chinese in this screenshot — In CC Switch, open the target client tab and enable the Essevin provider. Sensitive balance data is redacted; the Enable button and badge text shown here are in Chinese even though the rest of the CC Switch UI is in English.

Verify in a new terminal

Run claude or codex and send a short test. For Codex App, fully quit and reopen the app before starting a test task. If an existing terminal still uses the previous provider, close it and open a new terminal.

Codex App and Codex CLI

CC Switch writes the user-level Codex provider configuration. After switching providers, fully restart Codex App or open a new Codex CLI session so it reloads the configuration.

Troubleshooting

Browser did not open CC Switch: launch it manually once, then retry Import CCS.
Provider did not change: open the matching client tab and select Enable.
Command not found or an old provider remains: install Node.js LTS and the target CLI, then use a new terminal.

On this page