AgentDesk：配置codex，并增强codex的功能

Codex App 的外部增强启动器 AgentDesk，解锁插件入口、支持供应商配置、会话管理等功能。

项目地址：https://github.com/xxloocee/AgentDesk

这是什么

AgentDesk 是面向 Codex App 的外部增强启动器和管理工具（基于 Codex++ 二次开发）。它不修改 Codex 原始安装文件，通过外部 launcher 启动 Codex 并注入增强脚本。

主要功能

  • 插件入口解锁：API Key 模式下原生插件入口不可用，AgentDesk 直接解锁
  • 供应商配置：支持多个 API 供应商，把模型请求转到自定义兼容 API
  • 会话管理：会话删除、Markdown 导出、项目移动
  • 会话同步：切换官方账号和 API 模式，都不会丢失会话
  • 用户脚本：独立管理，启动时注入自定义脚本
  • Provider 同步：切换供应商后旧会话仍可见
  • 自动更新：通过 GitHub Release 检测更新

下载安装

从 GitHub Releases 下载：

  • Windows：AgentDesk-*-windows-x64-setup.exe
  • macOS Intel：AgentDesk-*-macos-x64.dmg
  • macOS Apple Silicon：AgentDesk-*-macos-arm64.dmg

安装后有两个入口：

  • AgentDesk：静默启动，只负责启动 Codex 并注入增强功能
  • AgentDesk 管理工具：控制面板，用于配置供应商、管理增强功能和用户脚本

供应商配置使用方法

适合已经在 Codex 中完成官方账号登录，同时想把模型请求转到自定义 API 的场景。

如果你是通过 Dogzee / 中转 API / BYOK 方式接入 Codex，并且遇到原版 Codex 看不到插件入口、plugins/tools 不可用、会话切换后丢失，这一页就是对应方案。

  1. 打开管理工具的 供应商配置 页面
  2. 确认 启用供应商配置切换 已勾选
  3. 点击 添加供应商，Base URL 填 https://ergouzi.life/v1
  4. API Key 填 Dogzee API密钥，模型选择API密钥分组支持的模型
  5. 保存后在供应商列表切换到这个配置
  6. 点击右上角 重启 AgentDesk，或退出后从 AgentDesk 入口重新启动

AgentDesk 会自动在 ~/.codex/config.toml 中写入对应 provider 配置。

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

当前 AgentDesk 管理工具里重点看 供应商配置 页面。如果你看到的界面没有"中转注入"，按"供应商配置"里的添加供应商流程走即可。

供应商切换后会话恢复

如果从默认/官方供应商切到 API 供应商后读不到会话，或者从 API 供应商切回默认登录后读不到会话，通常是会话 metadata 没有完成 Provider 同步。先不要删除 ~/.codex 目录。

恢复顺序：

  1. 打开 AgentDesk 管理工具 → 会话管理。
  2. 执行会话同步 / Provider 同步 / 历史会话修复。
  3. 完全退出 Codex 后，从 AgentDesk 入口重新启动。

Provider 同步备份通常在 ~/.codex/backups_state/provider-sync。本地会话数据库在 ~/.codex/sqlite/*.db，旧版可能是 ~/.codex/state_5.sqlite，排查时不要先删这些文件。

和 CC Switch 的关系

CC Switch 负责快速生成 Codex 的 Dogzee provider 配置；AgentDesk 负责从增强入口启动 Codex，并提供供应商配置、会话同步、用户脚本等能力。

只想让模型请求走 Dogzee，可以先用 CC Switch 配置 Codex。如果还需要 Codex App 里的插件入口或增强能力，就改从 AgentDesk 入口启动。

常见问题

  • AgentDesk 菜单没出现 → 确认是从 AgentDesk 入口启动，不是原版 Codex
  • 插件显示后端连不上 → 重启 AgentDesk，或在管理工具查看日志
  • 已经用 CC Switch 配好但插件不可用 → 配置可以继续用；启动入口换成 AgentDesk
  • macOS 提示无法打开 → 系统设置 → 隐私与安全性 → 允许打开（未签名应用）；若提示“已损坏”，可执行：
    • sudo xattr -rd com.apple.quarantine /Applications/AgentDesk.app
    • sudo xattr -rd com.apple.quarantine /Applications/AgentDesk\ 管理工具.app