接入教程

中转接入教程

按工具查看接入步骤和排查方法。

首页/中转接入教程/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模型名是否照抄后台按服务商模型列表重新填写
命令行页面最容易出错的是复制旧教程里的命令。这里保留配置路径和排错逻辑，具体命令以当前版本为准。