AgentDesk 配置 Codex

客户端接入

用 AgentDesk 供应商配置接入 Codex，保留插件入口和增强能力。

AgentDesk 是面向 Codex App 的外部增强启动器与管理工具（基于 Codex++ 二次开发）。它适合想让 Codex 走炻光API 自定义 API，同时还想保留插件入口、tools、会话同步和用户脚本的用户。

建议配置过程中先关掉原版 Codex 软件。配置完成后，从 AgentDesk 入口启动 Codex，不要直接打开原版 Codex。

开始前先准备好

下载 AgentDesk

炻光API 令牌（如果还没有，先去 selltoken.top 控制台 → API令牌 页面添加，令牌分组请选择 codex 专属分组，或参考如何新建指定分组的令牌）

已安装并登录过 Codex App

不清楚分组和模型支持的关系，先看分组详细表格和分组的特殊性及价格差异。

关键地址： https://selltoken.top/v1（注意要加 /v1）

配置前检查

正式添加供应商前，建议先确认三件事：

令牌已经创建成功，且分组为 codex 专属分组（务必选对，否则 Codex 请求会失败）

https://selltoken.top/v1 在当前网络环境可以访问

如果之前手动改过 Codex 配置，先备份 ~/.codex/config.toml

配置流程

打开 AgentDesk 管理工具

进入供应商配置页面，确认启用配置切换

填写 API Key、Base URL 和模型

切换到新供应商后从 AgentDesk 启动 Codex

第一步：安装并打开管理工具

从 AgentDesk Release 页面下载对应系统的安装包：

Windows：AgentDesk-*-windows-x64-setup.exe

macOS Intel：AgentDesk-*-macos-x64.dmg

macOS Apple Silicon：AgentDesk-*-macos-arm64.dmg

安装后通常会有两个入口：

AgentDesk：用于启动 Codex 并注入增强功能

AgentDesk 管理工具：用于配置供应商、管理增强能力和用户脚本

配置时先打开 AgentDesk 管理工具。

第二步：进入供应商配置页面

在管理工具左侧点击 供应商配置。

确认 启用供应商配置切换 已经勾选。这个开关打开后，AgentDesk 在你手动切换供应商时，会写入 Codex 的 config.toml / auth.json；关闭后不会自动改这些文件。

AgentDesk 供应商配置入口与添加供应商按钮

第三步：添加供应商

点击 添加供应商，新增一个炻光API 供应商配置。

最关键的三项：

Base URL：https://selltoken.top/v1

API Key：你的炻光API 令牌

模型名称：建议先用 gpt-5-codex（以当前 codex 专属分组实际支持的模型为准）

地址必须加 /v1，只写根域名通常会导致请求失败。

如果当前令牌分组不支持 gpt-5-codex，就换成分组里可用的模型。

如果界面里有协议/API 类型选项，优先选择 OpenAI-compatible / Responses API 这一类；具体名称以当前 AgentDesk 版本显示为准。

添加聚合供应商 用于组合多个供应商，不是本教程必需；第一次配置炻光API 时，用 添加供应商 即可。

AgentDesk 供应商表单中的名称、接入模式、Base URL、Key 与协议选择

配置模型列表与上下文窗口

在供应商表单下方的 模型列表 中，为需要使用的模型分别添加一行：

模型名称：填写当前炻光API 令牌分组实际支持的模型名，不要直接照抄截图中的示例

上下文窗口：可以填写 1M、200K 或纯数字；留空时使用 Codex 默认长度

从上游获取：可以尝试自动获取模型列表，导入后仍要确认模型是否属于当前令牌分组

AgentDesk 模型列表与上下文窗口配置

第四步：应用配置并启动

保存配置后，回到供应商列表，切换到刚刚创建的炻光API 供应商。

如果 Codex 已经打开，建议点击右上角 重启 AgentDesk，或退出后重新从 AgentDesk 入口启动。后续使用时也建议从 AgentDesk 启动，这样供应商配置、插件入口和增强脚本才会一起生效。

AgentDesk 会自动写入或维护 ~/.codex/config.toml / auth.json 里的 provider 配置。一般不需要手动改配置文件。

如果想从 API 供应商切回官方登录态，在 供应商配置 页面切回默认/官方供应商，并重启 Codex 即可。

AgentDesk config.toml 与 auth.json 预览

切换供应商后会话不见怎么办

如果从 默认供应商 / 官方登录 切到炻光API 这类 API 供应商后读不到会话，或者从 API 供应商切回默认登录后读不到会话，通常是会话 metadata 还没同步到当前供应商视图，不是会话真的被删了。

恢复方法：

不要删除 ~/.codex 目录，也不要删除本地会话数据库。

打开 AgentDesk 管理工具 → 会话管理。

执行会话同步 / Provider 同步 / 历史会话修复（不同版本按钮名可能略有差异）。

完全退出 Codex 后，从 AgentDesk 入口重新启动。

AgentDesk 的 Provider 同步会处理本地会话 metadata，让不同供应商切换后旧会话仍可见。同步备份通常在 ~/.codex/backups_state/provider-sync。

本地会话数据库通常在 ~/.codex/sqlite/*.db，旧版可能是 ~/.codex/state_5.sqlite。恢复前不要先删这些文件。

插件入口怎么办

AgentDesk 负责的是 Codex 客户端侧增强，不是炻光API 后台开关。

如果你在原版 Codex 的 API Key / BYOK / 自定义 API 模式下看不到插件入口，或者 plugins、tools、function calling、外部增强能力不可用，就用 AgentDesk 的供应商配置路线启动。

当前版本里重点看 供应商配置 页面，不需要再去找单独的"中转注入"入口；关键是启用供应商配置切换，添加炻光API 供应商，然后从 AgentDesk 入口启动 Codex。

和 CC Switch 的区别

CC Switch：更适合快速生成 Codex 的炻光API provider 配置，路线最短

AgentDesk：更适合需要插件入口、会话同步、用户脚本、供应商切换等增强能力的场景

如果只是让模型请求走炻光API，可以先看 [CC Switch 配置 Codex](../CC Switch 配置 Codex/CC Switch 配置 Codex.md)。如果配置后插件入口不可用，或者本来就需要增强能力，直接走 AgentDesk。

排错

找不到供应商配置页面 → 检查 AgentDesk 版本，更新到新版后再看左侧导航

请求失败 → 检查 Base URL 是否写成 https://selltoken.top/v1

模型不可用 → 换成当前 codex 专属分组支持的模型，如 gpt-5-codex

插件入口没有出现 → 确认是从 AgentDesk 入口启动，不是直接打开原版 Codex

已经用 CC Switch 配好但插件不可用 → 配置可以继续用，启动入口换成 AgentDesk

macOS 提示无法打开 → 系统设置 → 隐私与安全性 → 允许打开；若提示"已损坏"，可在终端执行：

sudo xattr -rd com.apple.quarantine /Applications/AgentDesk.app

sudo xattr -rd com.apple.quarantine /Applications/AgentDesk\ 管理工具.app

更多问题看炻光API 文档。

AgentDesk 配置 Codex