Codex 概览

Codex 是面向开发任务的命令行 AI 工具，适合与终端、本地仓库和自动化脚本结合使用。如果你已经熟悉 OpenAI 生态，Codex 往往是接入 LuminaToken 最自然的一条路径。

什么是 Codex

Codex 可以理解为一类“面向工程执行”的命令行助手，通常擅长：

• 读写本地代码仓库
• 结合命令行执行构建、测试与检查
• 在明确约束下完成多步开发任务
• 以 OpenAI 兼容配置方式接入统一网关

适合场景

OpenAI 工具链用户

如果你已经在使用 OpenAI 兼容 SDK、环境变量或代理配置，Codex 通常更容易直接接入。

终端驱动开发

如果你的工作习惯以终端为中心，例如频繁使用 Git、构建脚本、测试命令，Codex 会比较顺手。

自动化与多环境配置

Codex 的本地配置文件方式适合区分个人环境、项目环境和实验环境。

接入 LuminaToken 的方式

Codex 常见的接入思路是：

1. 安装 CLI
2. 配置 ~/.codex/config.toml
3. 配置 ~/.codex/auth.json
4. 将 Base URL 指向 https://api.luminatoken.cc/v1

也就是说，Codex 这条链路更偏向 OpenAI 兼容方式。

为什么使用 /v1

因为很多 OpenAI 兼容客户端会把接口根路径视为 API 版本入口。对于这类工具，推荐使用：

https://api.luminatoken.cc/v1

这样更符合工具本身对 OpenAI 兼容地址的预期。

适合怎么管理

对 Codex，推荐以下做法：

• 本地配置文件中只保留网关与行为配置
• API Key 放在独立认证文件或安全环境中
• 为不同机器使用不同 Key

文档阅读建议

• macOS 用户请继续看 Codex - macOS。
• Windows 或 Linux 用户请继续看 Codex - Windows / Linux。

常见建议

先用最小配置跑通

先确认 CLI 能读到配置文件和 Key，再做高级定制。

不要混用多个来源的配置

如果你同时配置了环境变量、全局文件和项目级文件，排障时会变得很混乱。建议先明确主配置来源。

保留清晰的 Key 命名

例如 codex-macos-main、codex-linux-ci，方便后续消费统计与权限回收。