Codex 桌面版

Codex 桌面版不需要单独创建一套 Provider 配置。它与 Codex CLI 读取当前系统用户的同一份 config.toml 和 auth.json。本教程直接编辑这两个本地文件，不依赖 CC Switch 或其他供应商管理工具。

一个 Key，访问全平台模型

CLI 与桌面版可以复用同一个 LAYSO AI Provider 和 API Key。每个成功请求都有独立扣费明细，失败任务不会产生扣费。

与 Codex CLI 同步的文件位置

系统	Provider 配置	API Key 认证文件
macOS	/Users/<用户名>/.codex/config.toml	/Users/<用户名>/.codex/auth.json
Windows	C:\Users\<用户名>\.codex\config.toml	C:\Users\<用户名>\.codex\auth.json
Linux / WSL	/home/<用户名>/.codex/config.toml	/home/<用户名>/.codex/auth.json

两个客户端使用相同的 Provider ID layso_ai、显示名称 LAYSO AI、Base URL https://api.layso.ai/v1 和 responses Wire API。API Key 从 LAYSO AI API Key 页面 ↗ 获取。

验证桌面版配置是否生效

第 1 步：检查本地 config.toml

按照上表打开当前系统用户的 config.toml，确认内容与 Codex CLI 教程完全一致。其他模型 ID 请前往 LAYSO AI 模型与价格 选择。

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

以正文配置为准

截图用于说明字段位置。若截图中的 Provider ID 或模型 ID 与上方代码不同，请使用上方代码以及 LAYSO AI 模型目录中提供的完整模型 ID。

第 2 步：从桌面版打开配置文件

打开 Codex 桌面版设置，选择 Open config.toml。系统编辑器打开的文件必须与上表中的当前用户文件一致；不要在项目目录内另外创建 config.toml。

第 3 步：保存配置并写入 API Key

将第 1 步的配置粘贴到打开的 config.toml 并保存。文件中已有的其他 Codex 配置可以保留，但同名的顶层字段和 [model_providers.layso_ai] 不要重复声明。

前往 LAYSO AI API Key 页面 ↗ 创建 Key，然后把它写入上表中当前系统用户的 auth.json：

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

macOS：

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

Windows PowerShell：

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

Linux / WSL：

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

CLI 与桌面版会读取同一份认证文件。WSL 使用 Linux 用户目录；Windows 使用 Windows 用户目录。不要把真实 Key 写进 config.toml，也不要分享或提交 auth.json。

第 4 步：发送消息验证

完成两个文件后，完全退出并重新打开 Codex 桌面版。确认当前 Provider 显示为 LAYSO AI、模型与 CLI 配置一致，再发送一条小型测试任务。收到正常响应后，到 LAYSO AI 任务明细核对模型、Token 与扣费记录。

常见问题

桌面版看不到 LAYSO AI

确认打开的是当前系统用户的 ~/.codex/config.toml，并核对 model_provider = "layso_ai"。保存后必须完全退出桌面版再重新打开。

CLI 正常但桌面版认证失败

检查桌面版与 CLI 是否由同一系统用户运行，确认 .codex/auth.json 中的 OPENAI_API_KEY 有效，并确认 config.toml 包含 cli_auth_credentials_store = "file"，然后重启桌面应用。

配置修改后没有生效

检查 TOML 语法、模型 ID 和 Base URL；Base URL 必须是 https://api.layso.ai/v1，末尾不要重复添加 /v1。

安全建议

• 不要把真实 API Key 直接写进 config.toml。
• 不要在截图、日志或 Git 仓库中暴露完整密钥。
• 第一次验证只执行小型、只读任务。