下面是 CC Switch 完整的安装 + 配置步骤(适配 Codex + DeepSeek),全程照着做就能在国内环境用 Codex 写代码,不用翻墙。
一、下载并安装 CC Switch
1. 打开官方 GitHub 发布页
🔗 https://github.com/farion1231/cc-switch/releases
2. 下载对应版本(Windows)
- 推荐下载:
CC-Switch-vX.X.X-Windows.msi(自动更新版,稳定) - 或者下载便携版
.zip(无需安装,解压即用)
3. 安装/解压
.msi:双击安装,一路下一步即可.zip:解压到E:\tools\cc-switch这类路径,双击CC Switch.exe打开
二、准备 DeepSeek API Key(必须)
1. 打开 DeepSeek 开放平台
🔗 https://platform.deepseek.com/ 用手机号注册/登录,免费额度就能用。
2. 创建 API Key
- 左侧菜单进入「API Keys」
- 点击「创建 API Key」,随便起个名字(比如
codex-ccswitch) - 生成后立刻复制 Key(格式:
sk-xxxxxx),保存好,关闭页面就看不到了。
三、配置 CC Switch 以适配 Codex
1. 打开 CC Switch,选择 Codex 分组
- 启动 CC Switch
- 在顶部/左侧的工具列表里,选择 Codex(不是 Claude Code)
2. 添加 DeepSeek 供应商
- 点击右上角的
+ Add Provider - 供应商类型选择
DeepSeek(CC Switch 有预设,自动填好接口地址) - 在 API Key 输入框,粘贴刚才复制的
sk-xxxxxx - 点击「Add」保存
3. 激活 DeepSeek 为当前供应商
- 在供应商列表里,找到刚添加的 DeepSeek
- 点击卡片上的 「Enable/激活」 按钮
- 看到状态变为「使用中/Active」就成功了
四、验证 Codex 是否生效
1. 打开 PowerShell,进入你的项目文件夹
cd E:\你的项目文件夹2. 初始化 Codex(只做一次)
codex init3. 直接测试对话
codex 帮我写一个读取 JSON 文件的 Python 脚本- 如果能正常回复、修改文件,说明配置成功 ✅
- 如果报错,检查 API Key 和供应商是否激活
五、常见问题与排错
-
codex命令找不到 执行:$env:Path += ";E:\nodejs_global"再试
codex --version -
提示 API Key 无效
- 确认 DeepSeek API Key 正确,没有空格
- 确认在 CC Switch 里选的是 DeepSeek,且已激活
- 确认 DeepSeek 账号里还有余额/免费额度
-
Codex 能对话但无法修改文件
- 用管理员身份打开 PowerShell 再试
- 确认项目文件夹有读写权限
关键说明
- 这种方式是把 Codex 当成前端界面,实际跑 DeepSeek 的模型,不是 OpenAI 官方服务
- 优点:国内直连、不用翻墙、免费额度可用
- 限制:Codex 的部分高级功能(如 OpenAI 专属模型)会不可用,日常写代码完全够用
如果你愿意,我可以帮你把「DeepSeek API Key 创建 + CC Switch 配置 + Codex 测试」这三步的命令和界面操作整理成一份可直接复制的脚本和操作清单,你照着点就行。需要吗?