cc-switch (CC Switch) Installation Guide — macOS

Goal of this guide: install cc-switch (a GUI manager for switching API configurations across multiple tools) on macOS, then use it to configure Claude Code, Codex, and other tools to connect to MYAI168.

cc-switch is a GUI app (built with Tauri 2). This guide installs it primarily via Homebrew Cask, with manual .dmg download as an alternative.

Before You Start

• macOS (Apple Silicon or Intel).
• Homebrew is recommended (https://brew.sh); without it you can still use Method B (manual download).
• Official sources: GitHub Releases https://github.com/farion1231/cc-switch/releases, official site ccswitch.io

cc-switch is in the official Homebrew cask repository, so open Terminal and install it directly (no private tap needed):

brew install --cask cc-switch

After installation, open "CC Switch" from Launchpad / Applications.

(If brew cannot find the cask or the install fails, run brew update and retry, or use Method B and download manually.)

1. Download the macOS installer from the Releases page (.dmg extension; current releases ship a single universal file that works on both Apple Silicon and Intel).
2. Double-click the .dmg and drag "CC Switch" into the Applications folder.
3. If Gatekeeper blocks the first launch ("cannot be opened because the developer cannot be verified"): go to System Settings → Privacy & Security, find the blocked CC Switch and click "Open Anyway"; or right-click the app → Open → click Open again.

After opening "CC Switch":

• The window opens on the "Claude Code" panel by default.
• A CC Switch icon appears in the menu bar.
• The switcher at the top left of the window lists the manageable tools: Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes Agent.
• If you have already used these tools, cc-switch usually auto-imports the existing configurations.

Suggested settings (optional): go to Settings → General and enable start-on-boot, minimize-to-menu-bar, etc. as needed.

cc-switch is only a "configuration manager" — it does not include the AI tools themselves. Install Claude Code / Codex and the other CLIs first, then use cc-switch to configure them to connect to MYAI168.

For installing each tool and setting up MYAI168, see the corresponding Developer Center pages:

• Claude Code → see the "Claude Code CLI macOS" page
• Codex → see the "Codex CLI macOS" page
• Hermes → see the "Hermes Agent macOS" page (note: cc-switch writes for Hermes may silently fail; manual setup is recommended for Hermes)

Common Settings (when adding a provider on each tool tab in cc-switch)

• Claude Code → endpoint https://www.myai168.com/en/api/anthropic (without /v1), model claude-opus-4-8, key supplied via either apiKeyHelper or ANTHROPIC_API_KEY (see the Claude Code page).
• Codex → endpoint https://www.myai168.com/en/api/openai/v1, model gpt-5.6-sol.

If you only use Claude Desktop (GUI chat, no terminal), the Claude Desktop tab in cc-switch can be configured directly and supports "one-click import of providers from Claude Code".

• Gatekeeper blocks with "developer cannot be verified" → System Settings → Privacy & Security → click "Open Anyway" for CC Switch; or right-click → Open.
• brew install fails / cask not found → run brew update first and retry (cc-switch is in the official cask repository, no tap needed); or use Method B and download the .dmg.
• "No official website configured / No Routing Support" label → normal; it just means you are using a custom endpoint (MYAI168) and does not affect usage.
• Update cc-switch → Homebrew: brew upgrade --cask cc-switch; manual download: install the new .dmg over the old version.
• Back up the settings → cc-switch settings live in ~/.cc-switch/; before a major upgrade you can manually back up ~/.cc-switch/cc-switch.db.

Official

• https://github.com/farion1231/cc-switch
• https://github.com/farion1231/cc-switch/releases