Skip to content

CC-Switch Setup ​

Download: CC-Switch Releases

Download and install ​

Choose the package for your operating system from the Release page.

  • Windows: download the .exe installer and follow the wizard.

  • macOS:

    bash
    brew tap farion1231/ccswitch
    brew install --cask cc-switch
  • Linux desktop: download the matching .deb package and install it with dpkg.

Additional settings ​

Review settings such as applying the channel to the Claude Code plugin, skipping first-run confirmation, preserving official login, and sharing Codex session history.

CC-Switch additional settings 1

CC-Switch additional settings 2

WARNING

Cross-provider continuation of old sessions may fail when encrypted content cannot be decoded by the other backend. Start a new session when this happens.

Switch and manage channels ​

Click a channel in the main window to make it active. Channels can be edited, deleted, and reordered.