跳到主要内容

使用 CC-Switch 配置鹊桥

Claude Code 与 Codex 在 CC-Switch 中的操作基本一致，只是请求地址略有不同。

前置条件​

通用步骤​

  1. 打开 CC-Switch
  2. 顶部/侧边选择要配置的 CLI：
    • Claude Code
    • Codex
  3. 点击右上角 「+」
  4. 选择 自定义配置 / Custom
  5. 填写以下信息后保存
  6. 在列表中 启用 / 设为当前 该配置

填写字段（鹊桥）​

Claude Code​

字段填写内容
名称鹊桥（任意）
请求地址 / Base URLhttps://5202828.xyz
API Key / 密钥控制台复制的 sk-...
提示

Claude / Anthropic 协议地址一般 不要 加 /v1。 若软件界面强制要求带路径，以软件说明为准，优先试 https://5202828.xyz。

Codex（OpenAI 兼容）​

字段填写内容
名称鹊桥-Codex
请求地址 / Base URLhttps://5202828.xyz/v1
API Key / 密钥同一个或单独创建的 sk-...
提示

Codex / OpenAI SDK 通常需要 /v1 后缀。

配置示意​

CC-Switch
 └─ Claude Code
     └─ [+] 自定义
         ├─ 名称：鹊桥
         ├─ 地址：https://5202828.xyz
         └─ 密钥：sk-xxxx
 └─ Codex
     └─ [+] 自定义
         ├─ 名称：鹊桥-Codex
         ├─ 地址：https://5202828.xyz/v1
         └─ 密钥：sk-xxxx

验证是否生效​

Claude Code​

claude
# 或
claude --version

进入交互后发一句简单问题，例如「回复 OK」。能正常返回即表示链路通。

Codex​

codex

首次启动按提示完成初始化，再试一问。

切换 / 多供应商​

你可以同时保存多个供应商配置（官方、其他中转、鹊桥）：

  • 在 CC-Switch 列表里点选即可切换
  • 托盘菜单也可快速切换（若版本支持）
  • 切换后 新开一个终端 再运行 CLI，避免旧环境变量残留

视频教程（可嵌入 B 站）​

后续可把 B 站稿件 BV 号嵌到本页。示例：

<iframe
  src="//player.bilibili.com/player.html?bvid=BVxxxxxxxxxx&page=1"
  scrolling="no"
  border="0"
  frameborder="no"
  framespacing="0"
  allowfullscreen="true"
  width="100%"
  height="480"
></iframe>

失败排查​

现象处理
401 / 鉴权失败令牌复制是否完整；是否被禁用
连接超时本机网络 / 代理；确认可打开 https://5202828.xyz
404 / 模型不存在分组是否包含该模型；模型名是否写对
配置不生效是否点了「启用」；是否重启了终端 / IDE

下一步：