Codex - macOS

本页介绍如何在 macOS 上安装 Codex，并通过配置文件接入 LuminaToken。

环境准备

开始前请确认：

• 系统为 macOS
• 已安装 Node.js 与 npm
• 已在 LuminaToken 控制台创建 API Key

安装 Codex

在终端执行：

npm install -g @openai/codex

安装后可先检查版本：

codex --version

配置 ~/.codex/config.toml

创建或编辑 ~/.codex/config.toml，至少保证包含指向 LuminaToken 的 Base URL。一个简化示例如下：

model = "gpt-4.1"
base_url = "https://api.luminatoken.cc/v1"

说明：

• base_url 指向 LuminaToken 的 OpenAI 兼容入口。
• model 请按你实际可用模型填写，以上只是示例。

如果你的 Codex 版本支持更细的 provider 配置，请以当前 CLI 版本说明为准，但核心地址仍然是 https://api.luminatoken.cc/v1。

配置 ~/.codex/auth.json

创建或编辑 ~/.codex/auth.json，将你的 LuminaToken API Key 写入认证信息。示例：

{
  "api_key": "你的API_Key"
}

如果你当前版本的 Codex 对 auth.json 字段名有额外要求，请以对应版本实际格式为准；关键点是让认证文件中保存 LuminaToken 的 API Key。

验证配置

先检查两个文件是否存在：

ls ~/.codex

再确认版本可执行：

codex --version

如果 CLI 支持查看当前配置，可再执行对应检查命令；若没有，直接发起一个最简单的请求测试即可。

推荐做法

使用独立 Key

不要和其他工具共用同一个高频 Key，便于消费统计和安全管理。

保持配置精简

第一次接入时只配置最关键的 base_url 与认证信息，等链路稳定后再做个性化调整。

关注版本差异

Codex 的配置字段可能随 CLI 版本迭代而变化，因此当你升级 CLI 后，建议重新核对一次本地配置格式。

排查建议

CLI 可以启动，但请求失败

• 检查 base_url 是否为 https://api.luminatoken.cc/v1
• 检查 auth.json 中的 Key 是否完整
• 检查账户是否有余额

配置文件写了但似乎没生效

• 确认文件路径是否准确
• 确认没有被项目内局部配置覆盖
• 升级或切换版本后重新核对配置格式

下一步

• 如果你需要 Windows 或 Linux 配置，请继续看 Codex - Windows / Linux。
• 如果你想直接理解请求格式，请阅读 OpenAI 格式。