给 Codex 接国内 API
结论先看这里:
- 给 Codex 接国内 API(DeepSeek / GLM / Qwen / Agnes),就是把一个「能聊天的智能接口」接进 Codex,让你在国内也能稳定用。
- Key 是一串给你的专属密码,填进设置就能让 Codex 用这个模型。
- 接好之后用一条测试命令验证;能正常回话就说明接对了。
- 常见报错:401 是密码错、404 是地址错、超时是网络或地址问题。
- 小白沚鹿可以一键把国内 API 接进 Codex,填 API Key(即模型服务商发给你的密钥)即用,不用碰命令行。
- 还没有 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 接本地模型),数据留在自己电脑里。