必须正确配置第三方api key并选对分组(codex或svip),否则会静默失败报401;windows需在.codex目录下创建auth.json和config.toml双文件,macos/linux则须将密钥与base url写入shell配置文件并source生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Codex 中稳定调用 GPT-5.5、Claude 或 DeepSeek 等模型,必须正确填写第三方 API Key,否则启动后会卡在加载状态或报 401 错误——这个错误不会提示“密钥无效”,只会静默失败。
确认密钥来源与分组要求
先打开你获取 API Key 的平台(如 LetAiCode、DeepSeek、51relay 或 whatai),进入「API 密钥管理」页面。重点检查分组设置:【密钥分组必须选 codex 或 svip,选 default 或 free 极大概率导致 401】。部分平台创建时默认选 default,但 Codex 不识别该分组,且错误无明确提示。
复制 sk- 开头的完整密钥字符串。注意:该密钥仅显示一次,关闭页面即不可找回。
Windows 系统双文件配置法
这一步不能跳过:Codex 在 Windows 上不读取环境变量,只认 .codex 文件夹下的两个固定文件。
在文件资源管理器地址栏输入:C:\Users\{你的用户名}\.codex,按回车。若提示不存在,手动新建隐藏文件夹(名称带开头的点)。
在该文件夹内新建文本文件,重命名为 auth.json,用记事本打开,粘贴以下内容(只改引号内部分):
{"OPENAI_API_KEY": "sk-你的密钥"}
再新建一个 config.toml,粘贴基础配置(model_reasoning_effort 必须显式声明,否则长代码生成失败率上升):
model_reasoning_effort = "medium"<br>disable_response_storage = true<br>[model_providers.whatai]<br>name = "whatai"<br>base_url = "https://xxx.xxx/v1"<br>wire_api = "responses"
⚠️ 注意:base_url 必须以 /v1 结尾,少一个斜杠就会返回 model not found。
macOS/Linux 环境变量注入法
第一步:执行 echo $SHELL 查看当前 Shell 类型。macOS Catalina 及以后默认是 zsh,对应配置文件是 ~/.zshrc;旧系统或 Linux 常用 bash,则改 ~/.bash_profile。
第二步:用 nano 编辑对应文件:nano ~/.zshrc,在末尾新增两行(替换为你的真实密钥和 Base URL):
export OPENAI_API_KEY="sk-你的密钥"<br>export OPENAI_BASE_URL="https://xxx.xxx/v1"
第三步:执行 source ~/.zshrc 立即生效,再验证是否写入成功:echo "$OPENAI_API_KEY" 应输出密钥内容。
重启 Codex 桌面客户端,启动日志中出现 Using provider: whatai 或类似字样,表示已成功切换。
通用验证步骤
① 启动 Codex 后,新建对话,输入“你是谁”,等待响应。若返回模型身份(如“我是 GPT-5.5”),说明 Key 和 Base URL 均有效。
② 若提示 “Authentication failed” 或长时间空白,立即检查:【auth.json 是否放在 C:\Users\{user}\.codex 下(Windows)或环境变量是否 source 生效(macOS/Linux)】。
③ 打开开发者工具(Ctrl+Shift+I),切到 Network 标签页,发送一条消息,观察请求 URL 是否匹配你填的 base_url;响应状态码不是 200 则说明中转服务未通或密钥被拒。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











