CC-Switch Configuration Tool

Introduction

CC-Switch is a cross-platform desktop application that provides unified management for three major AI programming tools: Claude Code, Codex, and Gemini CLI. Through an intuitive graphical interface, it enables configuration switching, MCP server management, system prompt management, and Claude Skills management.

Core Features

One-click switching between different AI tool provider configurations
API endpoint speed testing and quality indicators
Multi-preset system prompt management
Unified MCP server architecture management
Claude Skills discovery and installation system
Configuration backup/restore (automatically keeps the latest 10 backups)
Deep link protocol support (ccswitch://)
Environment variable conflict detection

v3.8.0 Architecture Upgrade Highlights

SQLite + JSON dual-layer storage (SSOT principle)
New UI design with refined component styles
Japanese interface support
Auto-start on boot
Skills recursive directory scanning

Installation

Method 1: MSI Installer (Recommended)

Visit the releases page: https://github.com/farion1231/cc-switch/releases
Download the latest .msi installer
Run the installer and follow the wizard to complete installation
Launch CC-Switch from the Start Menu after installation

Method 2: Portable Version (No Installation Required)

Download the .zip portable version
Extract to any directory
Run cc-switch.exe to start using

Recommended: Homebrew Installation

# Add tap source
brew tap farion1231/ccswitch

# Install cc-switch
brew install --cask cc-switch

Manual Installation

Visit the Releases page
Download the .dmg installer
Open the DMG file and drag CC-Switch to the Applications folder
Launch from Launchpad or Applications folder

Debian/Ubuntu (Recommended)

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f  # Fix dependencies

AppImage Universal Version

chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

Arch Linux (AUR)

paru -S cc-switch-bin
# Or use yay
yay -S cc-switch-bin

Quick Start

Add Provider Configuration

Launch the CC-Switch application
Click the "Add Provider" button
Select a preset configuration (e.g., 元渊智能) or create a custom one
Fill in the following information:
- Provider Name: Custom name (e.g., "元渊智能")
- API Key: Obtain from https://ai.soraliststudio.com
- API Endpoint: https://api.ai.soraliststudio.com
- Model Selection: Choose available models based on your needs
Click "Save" to complete the configuration

Different AI tools (Claude Code, Codex, Gemini CLI) may require different token group configurations. Please create dedicated tokens on the 元渊智能 platform.

Switch Providers

Select the configuration you want to use from the provider list
Click the "Enable" button
Or use the system tray icon for instant switching

System Tray Quick Switch:

Right-click the CC-Switch icon in the system tray
Select the provider you want to switch to from the menu
Configuration takes effect immediately

Apply Configuration

After switching configurations, close and restart the corresponding AI tool to automatically apply the new configuration.

Advanced Features

API Endpoint Speed Testing

Find the target configuration in the provider list
Click the "Test Speed" button
View latency and quality metrics
Select the optimal provider based on results

System Prompt Management

Create system prompts for different scenarios
Quickly switch between different prompt presets
Import/export prompt configurations

MCP Server Management

Configure all MCP servers in one interface
Auto-sync to corresponding configuration files
Enable/disable servers

Claude Skills Management

Browse available Skills list
One-click install needed Skills
Recursive scanning of local Skills directories

Configuration Backup & Restore

Automatically creates backups on each configuration change
Keeps the latest 10 backup versions
One-click restore to any historical version
Export/import configuration files

Usage Tips

Auto-Start on Boot

Enable the "Auto-start on boot" option in settings, and CC-Switch will automatically run and minimize to the system tray when the system starts.

Environment Variable Conflict Detection

CC-Switch automatically detects and alerts you to environment variable conflicts, preventing configuration issues from causing CLI tools to malfunction.

Multi-language Support

Version 3.8.0 adds Japanese interface support. You can switch languages in settings.

Project Resources

GitHub Repository: https://github.com/farion1231/cc-switch
Issue Reporting: GitHub Issues
Latest Version: Releases Page

CC-Switch Configuration Tool

On this page