CC-Switch Quick Config Tool

All-in-One AI CLI Manager — a cross-platform desktop app for unified management of Claude Code, Codex, OpenCode, and OpenClaw configurations.

Links

Resource	URL
GitHub Releases	farion1231/cc-switch

Why CC Switch?

Modern AI-powered coding relies on CLI tools like Claude Code, Codex, OpenCode, and OpenClaw — but each has its own configuration format. Switching API providers means manually editing JSON, TOML, or .env files, and there is no unified way to manage MCP and Skills across multiple tools.

CC Switch gives you a single desktop app to manage all your CLI tools. With 50+ built-in provider presets, a visual interface for one-click import and switching, unified MCP and Skills management, system tray quick switching, and a reliable SQLite database with atomic writes that protect your configs from corruption.

Core Features

• One App, Four CLI Tools — Claude Code, Codex, OpenCode, OpenClaw
• 50+ Provider Presets — Including AWS Bedrock, NVIDIA NIM, and more; just pick and switch
• Unified MCP & Skills Management — Cross-app bidirectional sync
• System Tray Quick Switch — No need to open the full app
• Cloud Sync — Dropbox, OneDrive, iCloud, WebDAV
• Local Proxy & Failover — Format conversion, auto-failover, circuit breaker, health monitoring
• Usage Tracking — Spending, requests, and token usage trend charts
• Session Manager — Browse, search, and restore conversation history across all apps
• Cross-Platform — Native desktop app for Windows, macOS, and Linux (built with Tauri 2)

Installation

Windows

Option 1: MSI Installer (Recommended)

Go to GitHub Releases and download the latest .msi installer. Double-click to install.

Option 2: Portable ZIP

Download the .zip portable version, extract it, and run directly — no installation required.

macOS

Option 1: Homebrew (Recommended)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Option 2: Manual Install

Download the .dmg file from GitHub Releases, open it, and drag the app into the Applications folder.

macOS builds are code-signed and notarized by Apple. You can install and open directly.

Linux

Arch Linux (AUR):

paru -S cc-switch-bin

Debian / Ubuntu:

sudo dpkg -i cc-switch_*.deb

Fedora / RHEL:

Download the .rpm package to install.

AppImage (Universal):

chmod +x CC-Switch_*.AppImage
./CC-Switch_*.AppImage

Quick Start

1. Launch CC-Switch
2. Select the CLI tool tab (e.g., Claude Code, Codex)
3. Click "Add Provider" and choose a preset template or custom configuration
4. Enter your API Key and endpoint information
5. Save the configuration and restart your terminal (Claude Code supports hot-switching)

For more configuration options and detailed usage, see the CC-Switch User Manual.

Resources

• GitHub Repository: farion1231/cc-switch
• Issue Tracker: GitHub Issues
• Downloads: GitHub Releases