CC Switch Integration Guide

Import an API configuration from the WOX dashboard into CC Switch

1. Overview

CC Switch is a cross-platform configuration manager for AI coding tools. It lets you manage provider configurations for clients such as Claude Code, Codex, and Gemini CLI in one place.

The WOX dashboard can generate official CC Switch Deep Links for the following applications:

• Codex
• Claude Code
• Gemini CLI

During import, WOX automatically fills in the service address, API Key, and model mappings for the selected application. CC Switch shows a configuration preview before writing anything, and the import proceeds only after you confirm it.

2. Install CC Switch

Download CC Switch from one of its official sources:

• CC Switch website
• GitHub Releases

CC Switch supports Windows, macOS, and Linux. On macOS, you can also install it with Homebrew:

brew install --cask cc-switch

Launch CC Switch at least once after installation to ensure that your system registers the ccswitch:// protocol.

3. Prepare a WOX API Key

1. Sign in to WOX and open the API Keys page.
2. Create a new key or select an existing one.
3. Open the Models and Pricing page and confirm a model ID currently available to your account.

4. Import with One Click

1. On the API Keys page, find the key you want to use.
2. Click the three-dot menu in the upper-right corner of the key card.
3. Select Import to CC Switch.
4. Select the target application: Codex, Claude, or Gemini.
5. Enter a provider name, then select or enter the primary model.
6. If you select Claude, optionally enter model mappings for Haiku, Sonnet, and Opus. Leave any mapping you do not need empty.
7. Click Open CC Switch.
8. In CC Switch, review the provider name, service address, models, and other settings, then confirm the import.

WOX automatically formats the service address for each client. Codex uses an API address ending in /v1, while Claude and Gemini use their corresponding base service addresses.

5. Enable and Test the Provider

After the import, select and enable the newly imported WOX provider in CC Switch. Then open the corresponding client and send a test request.

Claude Code can usually load the selected provider configuration immediately. If another client continues to use an old configuration, close and restart the terminal or the corresponding CLI tool.

If the request fails, check the following in order:

1. The WOX provider is enabled in CC Switch.
2. The primary model is a model ID currently available to your account.
3. The API Key is still valid.
4. Your network can reach the WOX service address.

6. Deep Link Security

The browser passes the link to the local CC Switch application. WOX does not display the generated import link as copyable text. CC Switch shows a confirmation dialog before writing the configuration; review its contents before continuing.

7. The Link Does Not Open

If nothing happens after you click Open CC Switch, first make sure that CC Switch is installed and has been launched at least once.

macOS

Reinstall CC Switch or run the protocol registration command provided by CC Switch in Terminal:

/usr/bin/open -a "CC Switch" --args --register-protocol

Windows

Run the installer again. If the link still does not open, check whether the following entry exists in the Windows Registry:

HKEY_CLASSES_ROOT\ccswitch

Linux

Confirm that the CC Switch .desktop file is installed and includes the appropriate MimeType entry for the ccswitch protocol.

For more protocol details, see the official CC Switch Deep Link documentation.