CC Switch 是一款跨平臺的桌面應(yīng)用，用于統(tǒng)一管理 Claude Code、Codex、Gemini CLI 等主流 AI 編程工具的供應(yīng)商配置。以下是 Windows 系統(tǒng)上的完整安裝和使用方案。

?? 一、系統(tǒng)要求

• 操作系統(tǒng)：Windows 10 及以上（64位）
• 前置條件：已安裝 Claude Code 或其他支持的 CLI 工具
• 網(wǎng)絡(luò)：需要訪問 GitHub 下載安裝包

?? 二、下載與安裝

CC Switch 提供兩種安裝方式，可根據(jù)需求選擇。

方式一：MSI 安裝包（推薦）

適合長期穩(wěn)定使用，支持自動更新。

• 訪問 GitHub Releases 下載最新版本的 CC-Switch-v{版本號}-Windows.msi
• 雙擊運行 MSI 安裝包，啟動安裝向?qū)?/li>
• 建議將安裝路徑修改至非系統(tǒng)盤（如 D:\Program Files\CC Switch），避免占用系統(tǒng)盤空間
• 依次點擊“下一步”完成安裝
• 安裝完成后，桌面會生成快捷方式，雙擊即可啟動

方式二：便攜版（免安裝）

適合臨時使用或多設(shè)備遷移，無需寫入注冊表。

• 下載 CC-Switch-v{版本號}-Windows-Portable.zip
• 解壓至純英文路徑（中文路徑可能導(dǎo)致數(shù)據(jù)庫初始化失敗）
• 直接運行 CC-Switch.exe
• 如遇 Windows SmartScreen 攔截，點擊“更多信息”→“仍要運行”即可

注意：Windows 版本已禁用“一鍵安裝”功能，Claude Code 等工具需手動安裝后再通過 CC Switch 管理。

?? 三、快速使用

3.1 啟動應(yīng)用

雙擊桌面快捷方式或 CC-Switch.exe 啟動 CC Switch。

3.2 添加配置

CC Switch 支持兩種使用方式：

桌面端操作

在可視化界面中，點擊“添加配置”，填寫以下信息：

• 配置名稱：自定義（如 dev、prod、deepseek）
• API URL：模型服務(wù)的 API 端點地址
• Token/API Key：對應(yīng)的 API 密鑰

命令行操作（CLI 模式）

如果偏好命令行操作，CC Switch 也提供了 CLI 工具：

# 1. 檢查系統(tǒng)狀態(tài)
ccs diagnostics
# 2. 添加配置
ccs add dev https://api.anthropic.com sk-ant-api03-your-token
# 3. 查看所有配置
ccs list
# 4. 切換配置
ccs switch dev
# 5. 查看當(dāng)前配置
ccs current

3.3 支持的 CLI 工具

CC Switch 統(tǒng)一管理以下工具的配置：

• Claude Code
• Codex
• Gemini CLI
• OpenCode
• OpenClaw

?? 四、配置示例

場景：接入 DeepSeek 代理服務(wù)

如果你需要通過 CC Switch 管理 Hermes 的代理配置（如 Hermes 文檔中使用的 CCSwitch 代理），可以參考以下設(shè)置：

說明：這里的 15721 端口是 CCSwitch 代理服務(wù)的監(jiān)聽端口，用于將請求轉(zhuǎn)發(fā)至 DeepSeek 等底層模型服務(wù)。

場景：切換官方和自定義端點

# 添加官方 Claude API 配置
ccs add claude-official https://api.anthropic.com sk-ant-xxx
# 添加自定義代理配置
ccs add my-proxy http://127.0.0.1:15721/v1 sk-xxx
# 切換配置
ccs switch my-proxy

??? 五、安全特性

CC Switch 內(nèi)置了多項安全保護機制：

?? 六、常見問題

Q1: 啟動時被 SmartScreen 攔截

點擊“更多信息”→“仍要運行”即可正常啟動。

Q2: 解壓后啟動失敗

檢查解壓路徑是否包含中文字符，確保使用純英文路徑。

Q3: 配置切換后不生效

# 檢查當(dāng)前狀態(tài)
ccs current
# 重新切換配置
ccs switch <配置名稱>
# 檢查 Claude Code 配置文件
cat ~/.claude/settings.json

Q4: 配置文件不存在

# 運行診斷檢查
ccs diagnostics
# 確保 Claude Code 已安裝并至少運行過一次
# 手動創(chuàng)建目錄（如需要）
mkdir -p ~/.claude

?? 七、配置文件位置

?? 參考資源

• CC Switch GitHub Releases
• CC Switch NPM 包
• SiliconFlow CC Switch 文檔

到此這篇關(guān)于Windows 安裝和使用CC Switch超詳細攻略的文章就介紹到這了,更多相關(guān)Windows安裝和使用CC Switch內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論