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

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配置流程打开 AgentDesk 管理工具进入供应商配置页面确认启用配置切换填写 API Key、Base URL 和模型切换到新供应商后从 AgentDesk 启动 Codex第一步安装并打开管理工具从 AgentDesk Release 页面下载对应系统的安装包WindowsAgentDesk-*-windows-x64-setup.exemacOS IntelAgentDesk-*-macos-x64.dmgmacOS Apple SiliconAgentDesk-*-macos-arm64.dmg安装后通常会有两个入口AgentDesk用于启动 Codex 并注入增强功能AgentDesk 管理工具用于配置供应商、管理增强能力和用户脚本配置时先打开AgentDesk 管理工具。第二步进入供应商配置页面在管理工具左侧点击供应商配置。确认启用供应商配置切换已经勾选。这个开关打开后AgentDesk 在你手动切换供应商时会写入 Codex 的config.toml/auth.json关闭后不会自动改这些文件。AgentDesk 供应商配置入口与添加供应商按钮第三步添加供应商点击添加供应商新增一个 炻光API 供应商配置。最关键的三项Base URLhttps://selltoken.top/v1API 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 配好但插件不可用 → 配置可以继续用启动入口换成 AgentDeskmacOS 提示无法打开 → 系统设置 → 隐私与安全性 → 允许打开若提示已损坏可在终端执行sudo xattr -rd com.apple.quarantine /Applications/AgentDesk.appsudo xattr -rd com.apple.quarantine /Applications/AgentDesk\ 管理工具.app更多问题看 炻光API 文档。