CC-Switch 一鍵設定教學（新手推薦）

新手推薦首選！

CC-Switch 是專為零基礎使用者設計的一鍵設定工具——無需手動修改設定檔，圖形化介面操作，十幾秒完成通道切換。

設定步驟

1. 下載並安裝 CC-Switch

• Windows：前往 CC-Switch GitHub Releases 下載 .msi 安裝包
• macOS（Homebrew）：

brew tap farion1231/ccswitch
brew install --cask cc-switch

• Linux：Releases 頁面下載 .deb 包安裝

下載後在本機完成安裝。

2. 開啟軟體，選擇要設定的 CLI

啟動 CC-Switch，在主介面選擇你要設定的工具（如 Claude Code、Codex 等），然後點擊「新增供應商」進行設定。

3. 填寫供應商資訊

• 供應商名稱：填寫 NextHub
• 請求網址：Claude Code 填 https://api.nexthub.cc；Codex 填 https://api.nexthub.cc/v1
• API 格式：依你選擇的 CLI 類型進行設定
• API Key：填寫你在控制台產生的金鑰

請求網址要不要帶 /v1？

Claude Code 走 Anthropic 協定，會自動在網址後拼接 /v1/messages，填裸網域即可；Codex 走 OpenAI Responses 協定（/v1/responses），請求網址需要帶 /v1。

填寫完成後，點擊右下角「新增」按鈕儲存設定。

4. 確認通道已生效

回到主介面，查看目前使用的通道，確保已切換到你剛設定的 NextHub 通道。

5. 跳過 Claude Code 初次安裝確認（選用）

在主介面點擊「設定」按鈕，進入通用設定頁面，找到「跳過 Claude Code 初次安裝確認」，確保這項是開啟的。

6. 終端機執行驗證

開啟終端機，執行 claude 或 codex 進行簡單對話，查看設定是否正常。收到回覆就表示設定成功了 🎉

claude

也能設定 Claude Desktop

CC-Switch 內建 Claude Desktop 面板，支援一鍵匯入 Claude Code 裡已有的供應商，切換後記得徹底重新啟動 Claude Desktop。詳細步驟見 Claude Desktop 設定教學。

CC-Switch 功能亮點

一鍵切換 API 設定、視覺化設定管理、MCP 伺服器管理、系統匣快捷操作、本機代理支援熱切換、全自動通道故障轉移。