Codex
在 Codex 中使用虾马AI
在控制台为合适的分组创建 API Key，再从“使用密钥”复制为这把 Key 实时生成的 Codex 配置。静态教程不复制模型名或完整配置，避免动态能力变化后仍使用过期内容。
配置真源Key 列表中的“使用密钥”
配置目录用户目录下的 .codex
验收依据客户端成功响应 + /usage 记录
开始前准备
- 安装并确认 Codex 客户端可以正常启动。客户端安装与更新方式以其当前官方说明为准。
- 登录虾马AI，在模型广场确认目标能力当前所属分组。
- 进入API Key 管理，为 Codex 单独创建一把 Key，并设置合理额度、有效期和限速。
- 不要把完整 Key 发给第三方配置网站，也不要写入项目仓库或聊天记录。
从“使用密钥”获取实时配置
- 在 Key 列表找到刚创建的 Key，点击使用密钥。
- 选择页面当前提供的 Codex CLI 配置；如页面同时提供不同传输方式，按当前客户端能力选择。
- 选择 macOS / Linux 或 Windows，按页面逐项保存文件或设置环境变量。
- 如本机已有 Codex 配置，先备份并合并必要字段，不要直接覆盖已有的工具、权限或工作区设置。
不要从本文手工拼出完整配置。控制台会根据当前站点地址、Key 分组、客户端能力和认证模式生成内容；模型、端点和配置字段可能随服务或客户端版本变化。
Codex 的 Base URL 口径
| 填写位置 | 应使用的地址 | 注意事项 |
|---|---|---|
Codex config.toml | 复制“使用密钥”中 base_url 的完整值 | 不要凭通用 SDK 教程自行增删 /v1。 |
| OpenAI 兼容 SDK | 按OpenAI 兼容接入说明填写 | SDK 的 Base URL 口径不一定等于 Codex 配置口径。 |
| 完整 HTTP 端点 | 由客户端根据配置生成 | 若日志出现重复的 /v1/v1，说明地址被重复拼接。 |
判断地址是否正确，应看 Codex 最终发出的请求路径和控制台生成内容，而不是只看第三方教程中的字段名称。
macOS / Linux 配置
- 按“使用密钥”的提示创建用户级 Codex 配置目录。
- 将生成的
config.toml保存到页面标明的位置。 - 按页面继续保存鉴权文件或设置环境变量；不同分组可能采用不同方式，不要自行互换。
- 如果终端环境里还残留其他服务的同名变量，先确认它们不会覆盖文件配置。
配置文件包含完整 API Key。不要将用户目录下的鉴权文件复制进项目，也不要在截图或终端录屏中展示其内容。
Windows 配置
- 在资源管理器地址栏输入控制台提示的用户级 Codex 配置目录；目录不存在时先创建。
- 确认文件真实扩展名为
.toml或.json，避免被记事本保存成.txt。 - 分别保存或设置“使用密钥”生成的配置与鉴权内容。已有配置时先备份再合并。
- 使用 WSL 时，Windows 用户目录和 WSL 用户目录不是同一位置，应在实际运行 Codex 的环境中配置。
认证模式怎么选
控制台可能提供“兼容模式”和“API Key Mode”。默认先使用页面当前推荐或默认的模式；只有在客户端特定能力明确要求时再切换。切换模式后，应完整退出 Codex Desktop 或 CLI，重新启动并新建 task，让客户端重新读取配置和工具注册信息。
认证模式影响的是客户端如何使用 Key，不会改变这把 Key 所属的分组、额度或有效期。
重启并完成最小验证
- 保存文件后，完全退出所有正在运行的 Codex 进程和窗口。
- 重新启动客户端并新建 task，不要只在旧会话中重复发送。
- 发送一个不含敏感代码或数据的最小请求，确认客户端能返回正常内容。
- 登录虾马AI并打开使用记录，按时间、Key 和模型找到这次调用。
- 以记录中的实际模型、用量和费用为准；本文不固定模型名或单价。
常见问题
| 现象 | 优先检查 |
|---|---|
| 仍然要求登录其他账户 | 确认鉴权文件路径、内容和认证模式来自当前 Key 的“使用密钥”，然后完全退出并重启。 |
| 修改后没有生效 | 确认配置写在实际运行用户的目录；检查 Windows、WSL 或远程开发环境是否用了不同用户目录。 |
401 或鉴权失败 | 检查 Key 是否完整、启用且未过期，鉴权文件是否被其他环境变量覆盖。 |
403、额度或权限错误 | 检查账户余额、Key 额度、有效期、IP 规则及所选分组。 |
404 或路径错误 | 恢复“使用密钥”给出的 base_url，排除重复拼接 /v1。 |
| 模型不可用 | 确认模型属于这把 Key 当前绑定的分组，不要沿用旧教程中的模型名。 |
| 超时、TLS 或代理错误 | 检查系统时间、代理、证书和网络；保留时间、状态码和请求 ID 后有限次重试。 |
联系支持时不要提交完整 Key 或鉴权文件。只提供时间和时区、客户端版本、操作系统、脱敏后的 Key 名称、模型、HTTP 状态、错误正文及请求 ID。