千龙AI快充接单中 · 平均 5 分钟到账

中转配置

把 Claude Code / Codex
接到中转线路上

装的还是官方的程序,本身一个字都不用改。中转只改两件事:请求发到哪、用谁的额度。

适用工具

Claude Code / Codex 等命令行工具,装的仍是官方版

需要准备

接口地址 + 密钥两个值,找我们要

官方订阅

不需要,也不需要国外信用卡

配置工具

CC Switch,开源免费,下面有完整步骤

价格

扫码咨询报价

先弄明白「中转」是什么

你装的还是官方的 Claude Code、Codex,程序本身一个字都不用改。中转只改两件事:

所以不需要官方订阅、也不需要国外信用卡,装好工具填两个值就能用。CC Switch 就是替你填这两个值的工具 —— 不用它也行,但要自己去改配置文件,容易改错。

本页目录

  1. 01下载安装 CC Switch
  2. 02准备好两个值
  3. 03配置 Claude Code
  4. 04配置 Codex
  5. 05日常怎么切换
  6. 06想切回官方登录
  7. 07常见问题
  8. 08要地址和密钥找这里

1下载安装 CC Switch

开源免费工具,GitHub 上 14K+ star。下载页里文件很多,按下面对号入座。

Windows

macOS

Linux

装 CC Switch 之前,请先把 Claude Code 或 Codex 本身装好 —— 它是管配置的,不负责装工具。下载地址在 GitHub,国内直连有时很慢,多刷新几次通常能下。

2准备好两个值

配置前先找我们要这两样,缺一不可。

接口地址

也叫 Base URL、中转地址,一个网址,形如 https://xxx.xxx/v1。最常见的填错是结尾多写或少写 /v1 —— 按我们给的原样粘贴,不要自己加减。

密钥

也叫 API Key,一长串字符,通常以 sk- 开头。相当于密码,不要外发、不要截图发群里。

这两个值是成对的,换了地址就得换配套的密钥,不能混用。

3配置 Claude Code

  1. 打开 CC Switch在顶部切到 Claude Code 这个工具。
  2. 点「添加供应商」准备新建一条配置。
  3. 选预设或自定义我们给的中转如果在预设列表里,直接选它;不在就选自定义。
  4. 填三项名称(自己起,方便认,比如「中转A」)、接口地址、密钥。
  5. 保存并启用保存后回主界面,选中它,点启用。
  6. 验证一次打开终端运行 claude,能正常对话就说明通了。

Claude Code 支持热切换 —— 切完不用重启终端,直接生效。这是它独有的,别的工具没有。

4配置 Codex(ChatGPT 的命令行工具)

  1. 切到 Codex在 CC Switch 顶部切换工具。
  2. 添加供应商同样是选预设或自定义,填名称、接口地址、密钥。
  3. 保存并启用回主界面选中它,点启用。
  4. 关掉终端再重新打开然后运行 codex。

Codex 必须重启终端才生效,这是最常见的「我配好了但没反应」。除 Claude Code 外,Gemini CLI 等其他工具也都要重启终端。

5日常怎么切换

配好多个之后,切换只要点一下。

一条线路卡了或者额度用完,切到另一条继续用,不用改任何配置文件。

6想切回官方登录

  1. 添加「官方登录」预设在「添加供应商」里加一个官方登录预设。
  2. 启用它,然后重启 CLI 工具这一步不能省。
  3. 走一遍登录流程按工具自己的提示完成登录 / OAuth。

Codex 有个额外步骤:从第三方切回官方后,要先执行一遍 Log out → Log in,之后才能在官方和第三方之间随意来回切。

7常见问题

配好了但没生效,还是走官方
九成是没重启终端。除 Claude Code 支持热切换外,Codex、Gemini CLI 等都必须把终端窗口关掉重开。还不行就回 CC Switch 确认那个供应商是已启用状态。
切换之后我的插件 / MCP 配置不见了
配置是跟着供应商走的。在「编辑供应商」→「通用配置面板」里点「从当前供应商提取」,把插件这类通用数据提成「通用配置」;之后新建供应商时勾上「应用通用配置」(默认就勾着),会自动带过去。原来的配置都存在第一次导入的那个默认供应商里,没有丢。
有个供应商删不掉
正在启用中的供应商不能删。先切换到另一个供应商,再回来删它。
报错提示地址或密钥无效
按顺序查:① 接口地址结尾的 /v1 是不是多写或少写了;② 密钥有没有复制到多余的空格或换行;③ 地址和密钥是不是配套的同一家;④ 都没问题就是额度用完或线路故障,找我们确认。
配置存在哪,换电脑怎么办
存在 ~/.cc-switch/cc-switch.db。CC Switch 自带导入导出,也支持通过 Dropbox / OneDrive / iCloud / WebDAV 在多台设备之间同步。
用中转还需要挂代理吗
看中转服务本身。国内可直连的中转不需要额外挂代理;如果我们说需要,或者你连不上,就开着我们的订阅节点再用,两者不冲突。

8要地址和密钥找这里

扫下面这张图加好友,要地址和密钥、问报价都走这里。配置卡住了,直接把报错截图发过来。

联系二维码

手机长按图片识别;电脑请用手机相机对着屏幕扫码

这是一张图像化二维码,直接扫图中画面即可,不用去找黑白方块。