下面是 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

  1. 左侧菜单进入「API Keys」
  2. 点击「创建 API Key」,随便起个名字(比如 codex-ccswitch
  3. 生成后立刻复制 Key(格式:sk-xxxxxx),保存好,关闭页面就看不到了。

三、配置 CC Switch 以适配 Codex

1. 打开 CC Switch,选择 Codex 分组

  1. 启动 CC Switch
  2. 在顶部/左侧的工具列表里,选择 Codex(不是 Claude Code)

2. 添加 DeepSeek 供应商

  1. 点击右上角的 + Add Provider
  2. 供应商类型选择 DeepSeek(CC Switch 有预设,自动填好接口地址)
  3. 在 API Key 输入框,粘贴刚才复制的 sk-xxxxxx
  4. 点击「Add」保存

3. 激活 DeepSeek 为当前供应商

  1. 在供应商列表里,找到刚添加的 DeepSeek
  2. 点击卡片上的 「Enable/激活」 按钮
  3. 看到状态变为「使用中/Active」就成功了

四、验证 Codex 是否生效

1. 打开 PowerShell,进入你的项目文件夹

cd E:\你的项目文件夹

2. 初始化 Codex(只做一次)

codex init

3. 直接测试对话

codex 帮我写一个读取 JSON 文件的 Python 脚本
  • 如果能正常回复、修改文件,说明配置成功 ✅
  • 如果报错,检查 API Key 和供应商是否激活

五、常见问题与排错

  1. codex 命令找不到 执行:

    $env:Path += ";E:\nodejs_global"

    再试 codex --version

  2. 提示 API Key 无效

    • 确认 DeepSeek API Key 正确,没有空格
    • 确认在 CC Switch 里选的是 DeepSeek,且已激活
    • 确认 DeepSeek 账号里还有余额/免费额度
  3. Codex 能对话但无法修改文件

    • 用管理员身份打开 PowerShell 再试
    • 确认项目文件夹有读写权限

关键说明

  • 这种方式是把 Codex 当成前端界面,实际跑 DeepSeek 的模型,不是 OpenAI 官方服务
  • 优点:国内直连、不用翻墙、免费额度可用
  • 限制:Codex 的部分高级功能(如 OpenAI 专属模型)会不可用,日常写代码完全够用

如果你愿意,我可以帮你把「DeepSeek API Key 创建 + CC Switch 配置 + Codex 测试」这三步的命令和界面操作整理成一份可直接复制的脚本和操作清单,你照着点就行。需要吗?

相关链接

1.什么是 CC Switch | 2.CC Switch 完整的安装 + 配置步骤 | 3.启动codex