Mastering CC Switch: The Ultimate Tool for Managing AI Coding Tools

As an AI developer, juggling multiple AI coding tools like Claude Code, Codex, and Gemini CLI can be a hassle, especially when switching between them and managing configurations. Enter CC Switch — a cross-platform desktop application (supporting Mac, Linux, and Windows) designed to unify the management of these tools.

What is CC Switch?

CC Switch acts as a central hub for AI coding tools. It eliminates the need to manually edit configuration files (like settings.json for Claude Code, agent.toml for Codex, and .env for Gemini CLI) when switching AI providers. With CC Switch, you can:

• Switch between AI providers with a single click.
• Manage Skills, system prompts, conversation history, and MCP services globally.
• Track usage costs across different AI tools to identify the most cost-effective options.

Getting Started with CC Switch

Step 1: Download and Install

1. Visit the CC Switch official website and select the version for your operating system.
2. Run the installer and follow the on-screen instructions. Once installed, launch CC Switch.

Step 2: Initial Setup

When you first open CC Switch, you will see the main interface. Click the settings icon in the top-left corner, scroll down to the "General" section, and enable the "Skip Claude Code Initial Setup" option. This skips the Anthropic login prompt when using Claude Code, a common fix for network issues.

Configuring AI Providers

1. Click the + icon in the top-right corner of CC Switch.
2. Choose an AI provider from the preset list (e.g., Kimi for Coding).
3. Configure API Keys and Models: For example, with Kimi for Coding, go to the Kimi Code console, create a new API key, paste it into CC Switch's configuration field, set the model (e.g., Kimi 2.5), and enable features like 1M context window.
4. Click "Add" to save. To switch, simply click "Enable" next to the provider.

Managing Skills

Skills are reusable tools that can be used across multiple AI coding tools:

1. Click the wrench icon in the top-right corner to open the Skills Manager.
2. Import Existing Skills: Click "Import Existing" to scan your system for installed skills.
3. Install New Skills: Use the search bar to find skills. Switch the search type to skill.sh for better results. Click "Install" to add a skill. You can also install skills from ZIP files.
4. Update Skills: Click "Check for Updates" to update installed skills.

System Prompt Management

CC Switch lets you manage system prompts across all AI tools:

1. Click the text icon in the top-right corner to open Prompt Management.
2. Add a Prompt: Click "Add Prompt" and name it (e.g., "Frontend Project"). Paste your system prompt into the content field and save.
3. Switch Prompts: Use the toggle switch next to a prompt to apply it across all AI tools. This automatically updates configuration files like claude.md for Claude Code and agent.md for Codex.

Conversation History Management

1. Click the history icon in the top-right corner.
2. Search and Filter: Use the search bar to find specific conversations.
3. Restore Conversations: Copy the command provided by CC Switch and paste it into your terminal to restore a conversation.
4. Delete Conversations: Select conversations and click "Delete" to remove them.

MCP Service Management

MCP (Model Control Protocol) services extend the functionality of AI tools:

1. Click the MCP icon in the top-right corner.
2. Add an MCP Service: Choose a preset MCP service (e.g., fetch for web requests) or create a custom one. Configure the service details and apply it to your desired AI tools.
3. Test the MCP Service: In Claude Code, use the MCP command to test the service.

Tracking Usage Costs

1. Go to Settings > Usage Statistics.
2. View Metrics: See token usage, request counts, and costs for tools like Claude Code, Codex, and Gemini.
3. Cost Comparison: Use the cost breakdown to identify which tool is the most affordable. You can also set cost multipliers for proxy services.

Conclusion

CC Switch is a game-changer for AI developers, simplifying the management of multiple AI coding tools. By centralizing configuration, skills, prompts, and usage tracking, it saves time and reduces errors. Whether you are switching between AI providers, managing skills, or keeping an eye on costs, CC Switch has you covered.