Codex CLI 支持通过 config.toml 使用 OpenAI 兼容的 API 地址。对于 MoonGPT，核心配置是完整的 /v1 基础地址和控制台生成的 API Key。

准备 API Key

在 macOS 或 Linux 中，可以先为当前终端设置：

export OPENAI_API_KEY="YOUR_API_KEY"
printenv OPENAI_API_KEY | codex login --with-api-key

这条命令会让 Codex CLI 使用 API Key 完成登录。当前终端关闭后，临时环境变量会失效；Codex 会按客户端的凭证存储设置缓存登录信息。不要把真实 Key 直接写入项目仓库。

配置 openai_base_url

Codex 的个人默认配置位于 ~/.codex/config.toml。添加以下内容：

openai_base_url = "https://api.moongpt.icu/v1"

这里应填写完整的 OpenAI 兼容基础地址，并保留末尾的 /v1。Codex 会在此基础上调用对应的 API 路径。

启动 Codex

进入测试项目目录运行：

codex

使用 MoonGPT API Key 时，请先完成上面的 API Key 登录，并以控制台展示的可用模型和分组为准。

用户配置与项目配置

个人默认配置保存在 ~/.codex/config.toml。可信项目还可以在仓库的 .codex/config.toml 中保存项目级覆盖项，但不建议把 API Key 写入项目配置或任何可能提交到 Git 的文件。

常见排查顺序

  1. 确认 codex 命令本身可以运行；
  2. 检查 openai_base_url 是否为 https://api.moongpt.icu/v1；
  3. 确认 OPENAI_API_KEY 未被截断、停用或过期；
  4. 检查 Key 所属分组是否支持 OpenAI 兼容协议；
  5. 查看控制台是否有对应的失败请求和错误信息。

工具权限仍需人工把关

更换 API 地址不会改变 Codex 在本地修改文件和执行命令时的权限边界。涉及删除、发布、依赖安装和凭证操作时，仍应逐项检查工具计划与实际改动。

配置文件的位置和可用字段可能随 Codex 版本变化，最新信息请参考 OpenAI 官方 Codex 配置文档。