Codex CLI 配置模型供应商

Codex CLI 的模型与 Provider 保存在 config.toml，API Key 单独保存在 auth.json。两个文件都位于当前系统用户的 .codex 目录中。

第 1 步：选择模型

打开 LAYSO AI 模型与价格 ↗，根据价格、上下文长度和能力选择模型，并复制页面显示的完整模型 ID。

下面以 gpt-5.5 为例。需要更换模型时，只修改配置中的 model。

第 2 步：添加模型供应商

先按系统找到当前用户的配置文件：

系统	config.toml 路径
macOS	/Users/<用户名>/.codex/config.toml
Windows	C:\Users\<用户名>\.codex\config.toml
Linux / WSL	/home/<用户名>/.codex/config.toml

打开该文件并加入以下配置：

model_provider = "layso_ai"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
cli_auth_credentials_store = "file"

[model_providers.layso_ai]
name = "LAYSO AI"
base_url = "https://api.layso.ai/v1"
wire_api = "responses"
requires_openai_auth = true

字段	说明
model_provider	使用 LAYSO AI 的 Provider ID：layso_ai
name	Codex 中显示的供应商名称：LAYSO AI
model	从 模型价格页 复制的完整模型 ID
model_reasoning_effort	推理强度；示例使用 high
disable_response_storage	禁止保存 Responses API 响应
cli_auth_credentials_store	强制把认证信息保存在当前用户 .codex/auth.json 文件中
base_url	LAYSO AI 的 OpenAI 兼容 Base URL
wire_api	Codex 自定义 Provider 使用的 Responses 请求格式
requires_openai_auth	使用 Codex 认证文件中的 OPENAI_API_KEY

第 3 步：把 API Key 写入认证文件

前往 LAYSO AI API Key 页面 ↗ 创建并复制 Key。不要把 Key 写进 config.toml；请按设备创建 auth.json。

认证文件内容在三个系统上相同：

{
  "OPENAI_API_KEY": "sk-..."
}

把 sk-... 替换为你在 LAYSO AI 获取的完整 API Key。

macOS

认证文件位置：/Users/<用户名>/.codex/auth.json（也就是 ~/.codex/auth.json）。

mkdir -p ~/.codex
nano ~/.codex/auth.json
chmod 600 ~/.codex/auth.json

在编辑器中粘贴上面的 JSON，保存并退出。

Windows

认证文件位置：C:\Users\<用户名>\.codex\auth.json（PowerShell 中为 $HOME\.codex\auth.json）。

New-Item -ItemType Directory -Force "$HOME\.codex"
notepad "$HOME\.codex\auth.json"

在记事本中粘贴上面的 JSON，保存时确认文件名是 auth.json，不是 auth.json.txt。

Linux / WSL

认证文件位置：/home/<用户名>/.codex/auth.json（也就是 ~/.codex/auth.json）。

mkdir -p ~/.codex
nano ~/.codex/auth.json
chmod 600 ~/.codex/auth.json

在编辑器中粘贴上面的 JSON，保存并退出。WSL 使用 Linux 用户目录，不要写入 Windows 用户目录。

auth.json 只保存 API Key，config.toml 只保存模型和 Provider。不要分享、截图或提交这两个文件中的认证信息。

第 4 步：启动并验证

codex

进入 Codex 后运行 /status，确认当前 Provider 为 LAYSO AI、模型 ID 与价格页选择一致。

更换模型

重新打开 LAYSO AI 模型与价格 ↗，复制另一个完整模型 ID，并修改：

model = "<MODEL_ID>"

保存后重新启动 Codex。一个 LAYSO AI API Key 可以访问全平台模型；成功请求会产生扣费明细，失败任务不会扣费。

认证排查

现象	处理方式
401 / 403	检查当前系统用户的 .codex/auth.json 是否存在、JSON 格式是否正确，以及 OPENAI_API_KEY 是否为有效 Key
404	确认 base_url = "https://api.layso.ai/v1"，不要重复追加 /v1
请求格式错误	确认 wire_api = "responses"
模型不存在	从 模型价格页 复制完整模型 ID
Provider 未生效	确认 model_provider = "layso_ai" 且配置段为 [model_providers.layso_ai]，然后重启 Codex
修改 Key 后仍使用旧 Key	确认 cli_auth_credentials_store = "file"，完全退出并重新启动 Codex

下一步

查看 Codex 桌面版，或回到 Codex CLI 概览。