Jason
bbed2a1fe1
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
4.0 KiB
1.2 Installation Guide
Prerequisites
Install Node.js
The CLI tools managed by CC Switch (Claude Code, Codex, Gemini CLI) require a Node.js environment.
Recommended version: Node.js 18 LTS or higher
Windows
-
Visit the Node.js official website
-
Download the LTS version installer
-
Run the installer and follow the prompts
-
Verify installation:
node --version
npm --version
macOS
# Install with Homebrew
brew install node
# Or use nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts
Linux
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# Or use nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts
Install CLI Tools
Claude Code
Option 1: Homebrew (recommended for macOS)
brew install claude-code
Option 2: npm
npm install -g @anthropic-ai/claude-code
Codex
Option 1: Homebrew (recommended for macOS)
brew install codex
Option 2: npm
npm install -g @openai/codex
Gemini CLI
Option 1: Homebrew (recommended for macOS)
brew install gemini-cli
Option 2: npm
npm install -g @google/gemini-cli
Windows
Installer
- Visit the Releases page
- Download
CC-Switch-v{version}-Windows.msi - Double-click to run the installer
- Follow the prompts to complete installation
Portable Version (No Installation Required)
- Download
CC-Switch-v{version}-Windows-Portable.zip - Extract to any directory
- Run
CC-Switch.exe
macOS
Option 1: Homebrew (Recommended)
# Add tap
brew tap farion1231/ccswitch
# Install
brew install --cask cc-switch
Update to the latest version:
brew upgrade --cask cc-switch
Option 2: Manual Download
- Download
CC-Switch-v{version}-macOS.zip - Extract to get
CC Switch.app - Drag it to the Applications folder
First Launch Warning
Since the developer does not have an Apple Developer account, a "developer cannot be verified" warning may appear on first launch:
Recommended solution: Open Terminal and run the following command:
sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/
Alternative solution (via System Settings):
- Close the warning dialog
- Open "System Settings" > "Privacy & Security"
- Find the CC Switch prompt and click "Open Anyway"
- Reopen the app to use it normally
Linux
ArchLinux
Install using an AUR helper:
# Using paru
paru -S cc-switch-bin
# Or using yay
yay -S cc-switch-bin
Debian / Ubuntu
- Download
CC-Switch-v{version}-Linux.deb - Install:
sudo dpkg -i CC-Switch-v{version}-Linux.deb
# If there are dependency issues
sudo apt-get install -f
AppImage (Universal)
- Download
CC-Switch-v{version}-Linux.AppImage - Add execute permission:
chmod +x CC-Switch-v{version}-Linux.AppImage
- Run:
./CC-Switch-v{version}-Linux.AppImage
Verify Installation
After installation, launch CC Switch:
- The app window displays correctly
- A CC Switch icon appears in the system tray
- You can switch between Claude / Codex / Gemini apps
Auto Update
CC Switch includes built-in auto-update functionality:
- Automatically checks for updates on startup
- Displays an update prompt in the UI when a new version is available
- Click to download and install
You can also manually check for updates in "Settings > About".
Uninstall
Windows
- Uninstall via "Settings > Apps"
- Or run the uninstaller in the installation directory
macOS
- Move
CC Switch.appto Trash - Optional: Delete the configuration directory
~/.cc-switch/
Linux
# Debian/Ubuntu
sudo apt remove cc-switch
# ArchLinux
paru -R cc-switch-bin