中转配置
把 Claude Code / Codex
接到中转线路上
装的还是官方的程序,本身一个字都不用改。中转只改两件事:请求发到哪、用谁的额度。
适用工具
Claude Code / Codex 等命令行工具,装的仍是官方版
需要准备
接口地址 + 密钥两个值,找我们要
官方订阅
不需要,也不需要国外信用卡
配置工具
CC Switch,开源免费,下面有完整步骤
价格
扫码咨询报价
先弄明白「中转」是什么
你装的还是官方的 Claude Code、Codex,程序本身一个字都不用改。中转只改两件事:
- 请求发到哪 —— 从官方地址改成中转服务的地址
- 用谁的额度 —— 从你的官方订阅改成中转给你的密钥
所以不需要官方订阅、也不需要国外信用卡,装好工具填两个值就能用。CC Switch 就是替你填这两个值的工具 —— 不用它也行,但要自己去改配置文件,容易改错。
1下载安装 CC Switch
开源免费工具,GitHub 上 14K+ star。下载页里文件很多,按下面对号入座。
Windows
- 常规电脑选
CC-Switch-v版本号-Windows.msi - ARM 设备(骁龙笔记本)才选
-Windows-arm64.msi
macOS
- 选
CC-Switch-v版本号-macOS.dmg,Intel 和 Apple 芯片通用
Linux
- 选
-Linux-x86_64开头的,格式挑.AppImage/.deb/.rpm之一
装 CC Switch 之前,请先把 Claude Code 或 Codex 本身装好 —— 它是管配置的,不负责装工具。下载地址在 GitHub,国内直连有时很慢,多刷新几次通常能下。
2准备好两个值
配置前先找我们要这两样,缺一不可。
接口地址
也叫 Base URL、中转地址,一个网址,形如 https://xxx.xxx/v1。最常见的填错是结尾多写或少写 /v1 —— 按我们给的原样粘贴,不要自己加减。
密钥
也叫 API Key,一长串字符,通常以 sk- 开头。相当于密码,不要外发、不要截图发群里。
这两个值是成对的,换了地址就得换配套的密钥,不能混用。
3配置 Claude Code
- 打开 CC Switch在顶部切到 Claude Code 这个工具。
- 点「添加供应商」准备新建一条配置。
- 选预设或自定义我们给的中转如果在预设列表里,直接选它;不在就选自定义。
- 填三项名称(自己起,方便认,比如「中转A」)、接口地址、密钥。
- 保存并启用保存后回主界面,选中它,点启用。
- 验证一次打开终端运行
claude,能正常对话就说明通了。
Claude Code 支持热切换 —— 切完不用重启终端,直接生效。这是它独有的,别的工具没有。
4配置 Codex(ChatGPT 的命令行工具)
- 切到 Codex在 CC Switch 顶部切换工具。
- 添加供应商同样是选预设或自定义,填名称、接口地址、密钥。
- 保存并启用回主界面选中它,点启用。
- 关掉终端再重新打开然后运行
codex。
Codex 必须重启终端才生效,这是最常见的「我配好了但没反应」。除 Claude Code 外,Gemini CLI 等其他工具也都要重启终端。
5日常怎么切换
配好多个之后,切换只要点一下。
- 系统托盘(Windows 右下角 / macOS 右上角)—— 点开图标直接点供应商名字,立即生效,最快
- 主界面 —— 选中供应商,点「启用」
一条线路卡了或者额度用完,切到另一条继续用,不用改任何配置文件。
6想切回官方登录
- 添加「官方登录」预设在「添加供应商」里加一个官方登录预设。
- 启用它,然后重启 CLI 工具这一步不能省。
- 走一遍登录流程按工具自己的提示完成登录 / OAuth。
Codex 有个额外步骤:从第三方切回官方后,要先执行一遍 Log out → Log in,之后才能在官方和第三方之间随意来回切。
7常见问题
配好了但没生效,还是走官方
切换之后我的插件 / MCP 配置不见了
有个供应商删不掉
报错提示地址或密钥无效
/v1 是不是多写或少写了;② 密钥有没有复制到多余的空格或换行;③ 地址和密钥是不是配套的同一家;④ 都没问题就是额度用完或线路故障,找我们确认。
配置存在哪,换电脑怎么办
~/.cc-switch/cc-switch.db。CC Switch 自带导入导出,也支持通过 Dropbox / OneDrive / iCloud / WebDAV 在多台设备之间同步。
用中转还需要挂代理吗
8要地址和密钥找这里
扫下面这张图加好友,要地址和密钥、问报价都走这里。配置卡住了,直接把报错截图发过来。
手机长按图片识别;电脑请用手机相机对着屏幕扫码
这是一张图像化二维码,直接扫图中画面即可,不用去找黑白方块。