Codex - Windows / Linux

本页介绍如何在 Windows 与 Linux 上安装 Codex，并接入 LuminaToken。

通用准备

开始前请确认：

• 已安装 Node.js 与 npm
• 已在 LuminaToken 控制台创建 API Key
• 已准备好使用 https://api.luminatoken.cc/v1 作为 OpenAI 兼容入口

安装命令：

npm install -g @openai/codex

安装完成后，建议先执行：

codex --version

Windows 配置

在用户目录下创建 ~/.codex/config.toml，示例：

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

再创建 ~/.codex/auth.json：

{
  "api_key": "你的API_Key"
}

如果你更习惯图形界面，也可以手动创建这两个文件；关键是路径与内容格式正确。

Linux 配置

在 Linux 下同样创建：

• ~/.codex/config.toml
• ~/.codex/auth.json

推荐内容与上面一致：

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

{
  "api_key": "你的API_Key"
}

验证

先确认目录和文件存在：

ls ~/.codex

再确认 CLI 可执行：

codex --version

随后发起一次最小调用测试，确认请求确实走到了 LuminaToken。

版本说明

Codex 的配置结构可能随着版本更新而调整，因此：

• 本页示例适合作为最小接入思路
• 升级 CLI 后，建议对照当前版本帮助信息确认字段名
• 核心原则不变：认证使用 LuminaToken API Key，网关地址使用 https://api.luminatoken.cc/v1

常见问题

auth.json 写好了但仍然报认证错误

• 检查 Key 是否复制完整
• 检查 JSON 格式是否正确
• 检查是否同时存在其他冲突认证方式

config.toml 没生效

• 检查文件路径是否放在当前用户目录下
• 检查字段名是否与你所用 Codex 版本匹配
• 检查是否存在项目级配置覆盖

请求可发出，但结果异常

优先检查：

1. 模型名称是否可用
2. Base URL 是否写成 /v1
3. 账户余额是否充足

下一步

• 想继续了解直接调用方式，请阅读 OpenAI 格式。
• 如果你仍在比较工具选型，也可以回到 工具概览。