Codex 是 OpenAI 推出的 AI Agent 编程助手,默认依赖 ChatGPT 账号,不少新手卡在账号和网络这一步。本文整理了一套无需科学上网、无需 ChatGPT 账号的 Codex 安装方案:通过 CC Switch 把 Codex 接入 DeepSeek 等国产模型,全程只需 3 个大步骤、约 10 分钟即可跑通,文末附常见报错排查与安全注意事项。 Codex 安装整体只需三步:获取 Codex → 装 CC Switch → 配置 API Key
Codex 是什么
Codex 是 OpenAI 推出的一款 Agent(智能体)产品,内置 GPT 系列模型。它不只是帮你写代码的补全工具,而是一个装在电脑里的"智能小机器人":你下达指令,它能自己拆解任务、执行操作、交付结果,除了编程之外也能处理多种日常任务。
理解 Codex 的关键是理解 Agent 这个概念。可以把 Agent 想象成一个住在你电脑里的助理,它能帮你干活,但在干活之前必须装上一个"超级大脑"——也就是大模型。Codex 的默认大脑是 ChatGPT,这正是很多人卡在账号、网络问题上的根本原因。
- 它是什么:OpenAI 官方出品的 Agent 工具,有桌面应用和命令行(Codex CLI)等多种形态。
- 它干什么:接收自然语言指令,自动完成写代码、改文件、跑任务等工作。
- 卡点在哪:默认模型是 ChatGPT,账号注册、网络环境、手机认证对新手都不友好。
- 怎么绕开:用第三方工具(如 CC Switch)把 Codex 的模型换成 DeepSeek、Kimi 等国产模型。
目前最热门的两款 Agent 工具是 OpenAI 的 Codex 和 Anthropic 的 Claude Code,二者定位不同,选择时不必纠结:
Codex 与 Claude Code 都是热门 Agent 工具,但侧重点不一样
结论:如果你是零基础用户,希望一个工具覆盖多种场景,从 Codex 入手更合适;如果你是专职程序员、主要需求是辅助写代码,可以优先考虑 Claude Code。
Codex 安装思路:为什么需要 CC Switch
想在 Codex 里用上 DeepSeek,中间需要一个"翻译官"来完成模型切换,这个工具就是 CC Switch。它是一款免费开源的应用,一个程序就能管理你的 AI 编程工具配置,支持在多个模型供应商之间一键切换。
整个安装逻辑非常简单,一共三步:
- 获取 Codex:先把 Codex 安装到电脑里;
- 安装 CC Switch:用它让 Codex 接上 DeepSeek;
- 配置 API Key:拿到 Key 后在 CC Switch 里完成配置。
CC Switch 官网提供各平台安装包,macOS 用户也可用 Homebrew 安装
什么是 API 和 API Key
配置之前需要搞懂两个词:API 和 API Key。用一个大白话比喻就能讲清楚:
- API 是"点餐窗口":API 本质是软件和软件之间沟通的方式。就像你去奶茶店,不用进后厨,只要站在点餐窗口告诉店员要什么奶茶、几分糖、加什么小料,店员做好后从窗口递给你。这个"点单取餐的窗口"就是 API——Codex 把请求发过去,模型把结果传回来,走的都是这个窗口。
- API Key 是"会员卡":奶茶店只认会员下单,你要用这个窗口,必须先出示会员卡。同理,模型不是想用就能用,调用前必须出示密钥,这个密钥就是 API Key。
API 是软件沟通的窗口,API Key 是调用前的凭证
理解到这一层就够用了:Codex 通过 API 向模型发请求、收结果,而 API Key 就是证明"你有资格调用"的凭证。
Codex 接入 DeepSeek 详细步骤(实操演示)
下面是完整的实操流程,方法对所有电脑系统都适用,照着做即可。
第 1 步:下载安装 Codex
打开 OpenAI 官网,在页面中间位置点击"下载安装 Codex",按提示完成安装。安装好之后先不用管它,稍后再回来验证。
第 2 步:下载安装 CC Switch
打开 CC Switch 官网,在页面中间点击下载安装。CC Switch 免费开源,各平台版本都有,Windows 和 macOS 均可使用。
第 3 步:在 CC Switch 中添加 DeepSeek 供应商
打开 CC Switch,点击右上角的加号(+),在弹出的供应商列表里找到 DeepSeek 大模型并选中。如果你想接其他模型(比如 Kimi),也在这个页面里找,然后点击右下角"添加",再点击"确认"。
CC Switch 主界面,添加 DeepSeek 后会出现在供应商列表中
第 4 步:去 DeepSeek 官网创建 API Key
回到 CC Switch 主页,找到刚配置的 DeepSeek 这一行,点击编辑。编辑页里其他选项都不用动,只需要填 API Key 这一行。接下来去 DeepSeek 官网获取它:
- 打开 DeepSeek 首页,点击"API 开放平台";
- 进入开放平台后,在左侧菜单找到 API Keys;
- 点击"创建 API Key",名称随意填写,没有限制;
在 DeepSeek 开放平台创建 API Key,单个账号最多可保留 100 个
特别注意:API Key 相当于你的银行卡密码,创建后只显示一次,一定不要随便给别人看,也不要截图发到群里或评论区。
第 5 步:给 DeepSeek 账户充值
有了 API Key 还不够,调用模型需要账户里有余额。在 DeepSeek 开放平台点击"充值"即可,支持在线充值与对公汇款两种方式。
DeepSeek 开放平台充值页面,档位从 10 元起
第一次使用建议只充 5 元或 10 元测试,跑通流程、确认好用之后再按需续充,避免浪费。另外 DeepSeek 采用按 tokens 计费的峰谷电价模式,周末及每日低谷时段费用更低,批量跑任务可以挑这些时段。
第 6 步:回填 API Key 并启用
- 回到 CC Switch 的 DeepSeek 编辑页,把复制的 API Key 粘贴进去,点击保存;
- 回到 CC Switch 主页,找到 DeepSeek 这一行,点击"启用"。
第 7 步:验证是否配置成功
重新打开 Codex,看右下角的模型名称:如果显示的是 DeepSeek,说明配置成功。再输入一句"你好"测试,能正常收到回复,就说明 Codex 已经可以正常使用了。
重开 Codex 输入"你好",能正常回复即配置成功
Codex 安装常见问题(FAQ)
Q:不装 CC Switch,Codex 能直接用吗?
A:可以,但 Codex 默认使用 ChatGPT 模型,需要 ChatGPT 账号和相应的网络环境。用 CC Switch 换成 DeepSeek 等国产模型,是为了绕开账号、网络和付费门槛。
Q:除了 DeepSeek 还能接什么模型?
A:CC Switch 的供应商列表里支持多家模型,视频中演示的还有 Kimi 等国产模型,添加方式完全一样:右上角加号 → 选中 → 添加 → 确认。
Q:配置完成后 Codex 里模型没变成 DeepSeek 怎么办?
A:先确认在 CC Switch 主页已点击 DeepSeek 的"启用",然后完全退出并重新打开 Codex,再检查右下角模型名称。多数"配置了但不生效"的问题都是没点启用或没重启应用导致的。
Q:API Key 填了还是报错?
A:依次检查三点——Key 是否复制完整(前后不能有空格)、账户是否有余额、供应商配置是否已保存并启用。账户欠费是最常见的隐形原因。
Q:充值充多少合适?
A:首次 5–10 元即可完成测试和轻度使用,DeepSeek 按 tokens 计费、价格便宜,日常对话和小任务消耗很低,好用再续充。
Codex 安装注意事项与避坑指南
- API Key 等同于银行卡密码:不要发给任何人、不要发在评论区或群聊里;泄露后应立即到 DeepSeek 开放平台删除重建。单个账号最多可保留 100 个 API Key,建议按用途分开创建、便于管理。
- Key 只显示一次:创建后第一时间复制保存,关掉弹窗后无法再次查看完整 Key。
- 先小额充值试水:首次 5–10 元足够,确认流程跑通、模型好用后再续充,避免闲置浪费。
- 版本要新:Codex 与 CC Switch 都在持续更新,下载时认准官网最新版本(本文截图时 CC Switch 为 v3.20.1),旧版本可能出现配置项对不上的情况。
- 换模型要"启用":在 CC Switch 里改完配置必须点击启用并重启 Codex,否则仍在使用默认模型。
- 官方政策可能变化:Codex、DeepSeek 开放平台的界面与计费规则会随版本调整,具体以两家官网最新说明为准。