設定指南

中轉站設定指南

依工具瀏覽設定步驟與問題排查。

中轉站設定指南/CC-Switch-CLI 使用

CC-Switch-CLI 使用

CC-Switch-CLI 是一個命令行裡的 Provider 切換工具，適合沒有圖形界面的服務器、SSH 環境，或者需要在 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 之間快速切換服務商的人。

官方信息 下載和文檔以官方站點為準
GitHub CC-Switch-CLI 官方倉庫、命令列表和 Releases Releases 下載 Windows / macOS / Linux 版本 Homebrew macOS 可用 Homebrew 安裝

適合誰用

如果你是普通桌面用戶，優先使用 CC Switch 圖形界面；如果你已經習慣終端，或者需要批量管理配置，再看這一頁。下面代碼塊只放命令，說明文字放在代碼塊外，避免複製時把說明一起複製進去。

安裝和啟動

macOS / Linux 用戶可以按官方文檔使用安裝腳本或 Releases 包；Windows 用戶建議從 Releases 下載對應壓縮包，解壓後在程序所在目錄運行。

官方安裝腳本
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch

直接輸入 cc-switch 會進入交互界面，適合新手先看菜單；後面的命令適合你已經知道要做什麼時直接執行。

環境檢查

要確認的事怎麼看為什麼
已經安裝 CC Switch 或 CLI 版本本機終端能識別對應命令沒有安裝時，任何配置命令都會失敗
目標 CLI 已安裝Claude Code、Codex、Gemini CLI 至少能單獨啟動CC-Switch-CLI 不替你安裝目標工具
服務商信息完整準備好 Base URL、API Key、模型名命令行配置沒有圖形提示，少一項就容易失敗
先在測試目錄驗證不要直接在真實項目裡批量切換配置錯誤時更容易回退
先檢查本機環境 下面命令用來確認 CC-Switch-CLI 能看到哪些工具、當前 Provider 是什麼、代理狀態是否正常。
環境檢查命令
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider current

Provider 命令

Provider 就是一個服務商配置。新增 Provider 前，先準備好服務商後臺裡的 Base URL、API Key、模型名；編輯或切換時，先用列表命令確認編號。

查看、新增和編輯 Provider
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>
切換 Provider 和測試連接
cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>
<id> 需要替換成 cc-switch provider list 裡看到的編號。不要直接把 <id> 原樣複製執行。

按應用管理

如果你只想看某一個目標工具的配置，可以加 --app。這對 Claude Code、Codex、Gemini CLI 分開排錯很有用。

按應用查看 Provider
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider list
按應用確認當前 Provider
cc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider current

確認目標應用和當前 Provider 沒問題後，再執行切換。切換完成後重開終端，再用目標工具發最短測試問題。

切換後的最小測試
claude "請只回覆：Claude Code 已生效" codex "請只回覆：Codex 已生效" gemini "請只回覆：Gemini 已生效"

MCP 同步

MCP 不是每個新手都需要。只有當你已經在 Claude Code、Codex、Gemini CLI 裡使用 MCP，並且需要跨工具同步時，再處理這一塊。第一次建議先進 TUI 菜單查看 MCP 區域，不要直接複製舊教程裡的高級命令。

進入 MCP 管理入口
cc-switch cc-switch --app codex

配置思路

  1. 先確認你要切換的目標工具：Claude Code、Codex、Gemini CLI，還是其他 CLI。
  2. 把服務商後臺的 Base URL、API Key、模型名準備好。
  3. 在 CC-Switch-CLI 中新增或選擇 Provider。
  4. 把 Provider 應用到目標工具。
  5. 重新打開終端後，用目標 CLI 發一個最短問題測試。
  6. 確認成功後，再把同一 Provider 應用到其他目標工具。
場景建議
本機桌面使用優先使用 CC Switch 圖形界面，字段和狀態更直觀
遠程服務器 / SSH再使用 CC-Switch-CLI，操作前先確認當前版本命令
批量切換配置先在測試項目驗證成功，再應用到真實項目
多人共用機器不要把自己的 Key 寫進公共配置，先確認配置文件作用範圍

新手排錯

現象優先檢查處理方法
命令找不到是否安裝、是否加入 PATH重新打開終端，或回到官方安裝說明確認安裝位置
切換後目標工具沒變化終端是否重開、目標工具是否選對關閉當前終端窗口後重新打開，再測試
401 / UnauthorizedKey 是否完整、是否過期重新複製 Key，確認沒有多餘空格
model not found模型名是否照抄後臺按服務商模型列表重新填寫
命令行頁面最容易出錯的是複製舊教程裡的命令。這裡保留配置路徑和排錯邏輯，具體命令以當前版本為準。