企业官网建设流程全解析

AgentDesk 配置 Codex+ selltoken 中转 API 实测教程(2026 年 8 月更新)

用 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

配置流程

1. 打开 AgentDesk 管理工具
2. 进入供应商配置页面，确认启用配置切换
3. 填写 API Key、Base URL 和模型
4. 切换到新供应商后从 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 还没同步到当前供应商视图，不是会话真的被删了。

恢复方法：

1. 不要删除~/.codex目录，也不要删除本地会话数据库。
2. 打开AgentDesk 管理工具 → 会话管理。
3. 执行会话同步 / Provider 同步 / 历史会话修复（不同版本按钮名可能略有差异）。
4. 完全退出 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 文档。