CC Switch
Officially recommendedCross-platform desktop tool to centrally manage and switch AI configurations for Claude Code, Codex, and more.
Download CC Switch
macOS package (.dmg), architecture unlisted — verify before installing
Other downloads (2)
Getting a "can't verify the developer" warning?
If you see a warning on first launch, go to System Settings > Privacy & Security and click "Open Anyway". Open source software usually isn't signed with an Apple developer certificate, which is normal.
Clicking "Download" takes you to a source confirmation page first; the download starts after confirmation.
About CC Switch
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
See incorrect information? Tell us
Who it's for
- Developers using AI coding tools such as Claude Code, Codex, and OpenCode
- Teams or individuals who frequently switch between multiple provider/API configurations
- AI agent users who want to centrally manage skills
- Developers working with Windows Subsystem for Linux (WSL) environments
- Users who prefer open-source, cross-platform desktop tools
Who it's not for
- Users who do not use AI tools such as Claude Code, Codex, OpenCode, OpenClaw, or Hermes Agent
- Users who need only a single fixed API provider and do not require switching
- Users who expect the software to directly provide model APIs or subscription services
- Users who rely entirely on web or mobile AI services and do not use desktop command-line tools
Install guide
Download from the GitHub Releases page or the only official website ccswitch.io. Choose the appropriate file based on your system and architecture:
Windows
- x64 recommended:
CC-Switch-v3.19.1-Windows.msi; for the portable version, downloadCC-Switch-v3.19.1-Windows-Portable.zip. - arm64 recommended:
CC-Switch-v3.19.1-Windows-arm64.msi; or useCC-Switch-v3.19.1-Windows-arm64-Portable.zip. - Run the
.msiand follow the wizard to install; for the Portable version, extract the zip and run the main executable directly.
macOS
- Recommended: download
CC-Switch-v3.19.1-macOS.dmg, open it, and drag the app into the "Applications" folder. - Alternative:
CC-Switch-v3.19.1-macOS.zip. - If you see "cannot be opened because the developer cannot be verified" on first launch, you can allow it in System Settings → Privacy & Security, or right-click the app in Finder and select "Open".
Linux (based on release list)
- x86_64:
CC-Switch-v3.19.1-Linux-x86_64.deb/.rpm/.AppImage. - arm64:
CC-Switch-v3.19.1-Linux-arm64.deb/.rpm/.AppImage. - deb:
sudo dpkg -i CC-Switch-v3.19.1-Linux-x86_64.deb; rpm:sudo rpm -ivh CC-Switch-v3.19.1-Linux-x86_64.rpm; AppImage:chmod +x CC-Switch-v3.19.1-Linux-x86_64.AppImage && ./CC-Switch-v3.19.1-Linux-x86_64.AppImage. - The corresponding
.sigfiles can be used to verify the installer signature.
FAQ
Is CC Switch free software?
Yes. The project is open-source under the MIT license and can be downloaded and used for free. The GitHub repository is farion1231/cc-switch, and the only official website is ccswitch.io.
Which operating systems are supported?
The project officially supports macOS and Windows; the GitHub Releases list also provides Linux .deb, .rpm, and .AppImage packages (including x86_64 and arm64), and there are WSL-related topics. Please check the official release page for specific support details.
What do I need to prepare before first use?
CC Switch is used to manage and switch configurations for AI tools/agents such as Claude Code, Codex, OpenCode, OpenClaw, and Hermes Agent. Before using it, you typically need to have the corresponding command-line tools installed and have the relevant API keys/provider configurations ready.
How do I update to a new version?
Watch the GitHub Releases page, download the latest installer, and reinstall. It is recommended to keep your existing configuration before upgrading; follow the official release notes for details.
How can I verify that a downloaded file has not been tampered with?
The release list provides `.sig` signature files with matching names for several installers. You can download them and use them to verify the files; see the official release page or related documentation for the specific verification commands.