Codex config.toml 配置第三方 API 与 LuminAI 教程

本教程介绍如何通过配置文件将 Codex 直接接入 LuminAI，适用于 Codex CLI、Codex IDE 插件及 Codex 桌面端。

如果切换工具的路由模式不稳定，或者你希望减少中间环节，可以直接修改 Codex 配置文件。配置更改后需要重启 Codex 才会生效。

一、准备工作

开始前请准备好以下信息：

在 LuminAI 控制台创建的 API 密钥
当前令牌分组支持的模型名称
LuminAI 接口地址：https://ai.luminai.cc/v1

模型名称请以控制台的模型广场为准，不同令牌分组支持的模型可能不同。

二、打开 Codex 配置目录

Codex 的用户配置目录为 ~/.codex。其中 ~ 表示当前用户的主目录。

Windows

按 Win + R，输入以下路径并回车：

%USERPROFILE%\.codex

也可以在 CMD 中运行：

start "" "%USERPROFILE%\.codex"

或在 PowerShell 中运行：

Start-Process "$HOME\.codex"

macOS

打开终端并运行：

open "$HOME/.codex"

Linux

配置目录位于：

$HOME/.codex

如果 .codex 文件夹不存在，可以手动创建。

三、创建 `config.toml`

在 .codex 文件夹中创建或打开 config.toml，写入以下内容：

model_provider = "luminai"
model = "gpt-5.4"
model_reasoning_effort = "high"
model_verbosity = "high"
disable_response_storage = true

[model_providers.luminai]
name = "LuminAI"
base_url = "https://ai.luminai.cc/v1"
wire_api = "responses"
requires_openai_auth = true

配置项说明：

配置项	说明
`model_provider`	指定当前使用的自定义模型提供方
`model`	默认模型名称，请根据模型广场中的实际名称修改
`model_reasoning_effort`	推理强度，可按模型支持情况设置为 `low`、`medium`、`high` 或 `xhigh`
`base_url`	LuminAI 的 OpenAI 兼容接口地址，末尾需要保留 `/v1`
`wire_api`	Codex 使用的请求协议，目前填写 `responses`
`requires_openai_auth`	让该自定义提供方读取 Codex 保存的 API 密钥

四、创建 `auth.json`

在同一个 .codex 文件夹中创建或打开 auth.json，写入以下内容：

{
  "OPENAI_API_KEY": "sk-请替换为你的密钥"
}

将 sk-请替换为你的密钥 替换成你在 LuminAI 控制台创建的完整 API 密钥，然后保存文件。

五、重启并验证

保存两个配置文件后，需要完全退出并重新启动 Codex：

Codex CLI：按 Ctrl + C 退出，然后重新运行 codex
Codex IDE 插件：关闭并重新打开编辑器窗口
Codex 桌面端：完全退出应用后重新打开

启动后发送一条简单消息。如果能够正常返回内容，说明配置已经生效。

六、切换接口或模型

需要更换节点时，修改 base_url；需要更换模型时，修改 model。例如：

model = "模型广场中显示的模型名称"

[model_providers.luminai]
base_url = "https://新的接口地址/v1"

每次修改配置文件后，都必须重启 Codex，让程序重新读取配置。

常见问题

修改后没有生效

请确认配置文件名称是 config.toml 和 auth.json，而不是 config.toml.txt 或 auth.json.txt。Windows 用户可以在文件资源管理器中开启“显示文件扩展名”后检查。

提示 401 或认证失败

通常是 API 密钥无效、复制不完整或 auth.json 格式错误。请重新创建密钥，并确认 JSON 中的英文双引号和逗号格式正确。

提示模型不存在

当前令牌分组可能不支持 config.toml 中填写的模型。请前往模型广场复制正确的模型名称，然后修改 model 并重启 Codex。

请求地址仍然是 `127.0.0.1`

这通常表示 CC Switch 的路由模式仍在生效。请关闭路由模式，确认 base_url 已改为实际接口地址，然后完全退出并重新启动 Codex。