给 Codex 接国内 API

结论先看这里:

  1. 给 Codex 接国内 API(DeepSeek / GLM / Qwen / Agnes),就是把一个「能聊天的智能接口」接进 Codex,让你在国内也能稳定用。
  2. Key 是一串给你的专属密码,填进设置就能让 Codex 用这个模型。
  3. 接好之后用一条测试命令验证;能正常回话就说明接对了。
  4. 常见报错:401 是密码错、404 是地址错、超时是网络或地址问题。
  5. 小白沚鹿可以一键把国内 API 接进 Codex,填 API Key(即模型服务商发给你的密钥)即用,不用碰命令行。
  6. 还没有 API Key?去官方开通:DeepSeek · Qwen(阿里云百炼) · GLM(智谱)

为什么要用 DeepSeek / GLM / Qwen / Agnes?

结论:因为官方模型在国内连接不稳定,国内 API 在国内更顺、更省心。

为什么要用国内 API? Codex 自己只负责「干活」,真正动脑的是背后的模型。Codex 默认的官方模型在国内连接不稳定,容易超时、连不上。DeepSeek / GLM / Qwen / Agnes 这些是国内也能稳定访问的国内 API,把它们接进 Codex,就能让 Codex 在国内顺利用起来。

它们是什么接口? 这些都是「OpenAI 兼容接口」——说人话就是,它们长得和 Codex 认的接口一样,所以 Codex 能直接拿来当大脑用,不用改 Codex 本身。只要填对 Key 和地址就行。

Key 是什么?从哪里来?

结论:Key 是一串专属密码(类似会员卡号+密码),在模型服务商官网注册后获得。

Key 是什么? Key 就像你在这个模型服务那里的「会员密码」——Codex 每次请模型帮忙,都要报上这个 Key,服务商才知道是你、并给你计算用量。它通常是一长串字母和数字,要保管好,不要随便发给别人。

怎么拿到、怎么填? 去对应模型官网注册账号,在「API 密钥 / Key」页面生成一串 Key;然后把它填进小白沚鹿或 Codex 的设置里。小白沚鹿会帮你把 Key 和接口地址一起接好,你不用自己抄地址、改文件。

填进去之后怎么验证?

结论:接好后跑一条测试,看 Codex 能否正常回话,能回话就说明接对了。

怎么验证? 填入 API Key 后,让 Codex 做一件小事(比如「帮我写一句 Hello World」)。如果它正常回答了,说明国内 API 已经接好;如果报错,再根据报错号排查。小白沚鹿一键接好后会自动帮你跑一次验证,省去你自己试。

顺手提一句: 接国内 API 之前,Codex 本身得先装好(见Codex 国内怎么装)。如果还没装,可先下载后免费检测

常见报错 401 / 404 / 超时 是什么意思?

结论:401 是密码错,404 是地址错,超时是网络或地址问题。

401 未授权: 你的 Key 填错了、复制少了字符,或者这个 Key 已经失效。回去服务商后台重新生成一串、仔细粘贴即可。

404 找不到: 接口地址填错了,Codex 按这个地址去找模型,结果没找到。检查地址是否和该服务商给的一致,注意别多写或少写路径。

超时 / 连接失败: 多半是网络问题,或地址写成了连不通的节点。换网络、或确认地址正确后再试。若反复超时,也可考虑给 Codex 接本地模型(见给 Codex 接本地模型),数据留在自己电脑里。

相关:查看价格 · 前往下载

常见问题

国内 API 安全吗?我的 Key 会给别人吗?
Key 是你自己的账号凭证,只在你本地填进设置里使用。小白沚鹿不会收集你的 Key,也不会替你保管。建议你只在官方渠道获取 Key,并保管好不要外传。
接了国内 API 还要装 Node 吗?
要。Codex 本身仍然需要 Node 这个基础环境才能运行。接国内 API 解决的是「Codex 用哪个大脑」,而 Node 解决的是「Codex 能不能跑起来」。小白沚鹿会把两者一起装好。
一个 Key 能用在几台电脑?
这取决于你买模型时那个服务商的规则,和 Codex 无关。多数服务商按用量或按账号计费,你可查看对应服务商的说明。小白沚鹿只负责把 Key 接进 Codex。
接错模型会搞坏 Codex 吗?
不会。接模型只是改 Codex 用哪个接口,不会影响 Codex 本体。如果接错了,把 Key 或地址改回正确值即可,最多是用不了,不会损坏已装好的 Codex。
Agnes 是什么?
Agnes 是支持 OpenAI 兼容接口的一个国内 API 服务,和 DeepSeek / GLM / Qwen 一样,可以当作 Codex 的大脑接进去用。具体能跑什么以该服务当前提供的能力为准。

不想自己折腾?

下载小白沚鹿,免费检测你的电脑,一键把国内 API 接进 Codex。

也看看:Codex 国内怎么装 · 给 Codex 接本地模型 · 查看价格