CC Switch Pro Integration Guide
Import an API configuration from the WOX dashboard into CC Switch Pro
CC Switch Pro Integration Guide
Import an API configuration from the WOX dashboard into CC Switch Pro
1. Overview
CC Switch Pro is our cross-platform desktop workspace for AI coding tools. It brings provider and model configuration for Claude Code, Codex, and Gemini CLI together with local routing, failover, MCP, Skills, sessions, and usage management.
The WOX dashboard can generate Deep Links compatible with CC Switch Pro 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 Pro shows a configuration preview before writing anything, and the import proceeds only after you confirm it.
2. Install CC Switch Pro
Download CC Switch Pro from one of its official sources:
On the downloads page, select a CC Switch Pro installer that matches your operating system and processor architecture, then follow the installation instructions. Check the official downloads page for the currently available Windows, macOS, and Linux builds.
Launch CC Switch Pro at least once after installation to register its URL protocols. Pro supports ccswitch-pro:// and also accepts the ccswitch:// import links currently generated by the dashboard.
3. Prepare a WOX API Key
- Sign in to WOX and open the API Keys page.
- Create a new key or select an existing one.
- Open the Models and Pricing page and confirm a model ID currently available to your account.
Model availability changes with account permissions and platform configuration. The import dialog loads the currently available models dynamically and also lets you enter a model ID manually, so you do not need to use a fixed example model.
4. Import with One Click
The dashboard currently labels these actions Import to CC Switch and Open CC Switch. Their compatible import links open the local CC Switch Pro application.
- On the API Keys page, find the key you want to use.
- Click the three-dot menu in the upper-right corner of the key card.
- Select Import to CC Switch (compatible with CC Switch Pro).
- Select the target application: Codex, Claude, or Gemini.
- Enter a provider name, then select or enter the primary model.
- If you select Claude, optionally enter model mappings for Haiku, Sonnet, and Opus. Leave any mapping you do not need empty.
- Click Open CC Switch.
- In CC Switch Pro, 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 Pro. 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:
- The WOX provider is enabled in CC Switch Pro.
- The primary model is a model ID currently available to your account.
- The API Key is still valid.
- Your network can reach the WOX service address.
6. Deep Link Security
A CC Switch Pro import link contains the complete API Key. Click Open CC Switch only on your own device. Do not copy, share, screenshot, or record the link. If the link or key may have been exposed, immediately delete the old key in the WOX dashboard and create a replacement.
The browser passes the link to the local CC Switch Pro application. WOX does not display the generated import link as copyable text. CC Switch Pro 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 Pro is installed and has been launched at least once.
macOS
Reinstall CC Switch Pro or run the protocol registration command provided by CC Switch Pro in Terminal:
/usr/bin/open -a "CC Switch Pro" --args --register-protocolWindows
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-pro
HKEY_CLASSES_ROOT\ccswitchLinux
Confirm that the CC Switch Pro .desktop file is installed and includes the appropriate MimeType entries for ccswitch-pro and the compatible ccswitch protocol.
For more product, installation, and usage information, visit the CC Switch Pro website.