切换深浅色
Codex 桌面版接入 XXAPI
让 AI 帮你完成配置
首次安装或切换到 XXAPI，都可以使用。
AI 打不开链接时，。
查看短提示词
你可以用桌面窗口操作 Codex。当前 OpenAI 官方文档已把原 Codex app 入口合并到 ChatGPT 桌面应用，本页配置的是其中的本地 Codex。
准备 Windows 或 macOS 电脑、XXAPI Key，并先按 Codex 终端版 配好 config.toml。终端已经能通过 XXAPI 回复后，桌面部分通常只剩下让应用读到同一份配置和密钥。
1. 安装官方桌面应用
打开 OpenAI 官方下载页，安装适合自己系统的 ChatGPT 桌面应用。原 Codex 独立版用户以官方下载页提供的当前版本为准。
macOS 下载页的安装包标注为 Apple Silicon，先在“关于本机”确认芯片类型。Windows 按下载页选择对应安装包。
Linux 用户先用 Codex CLI。官方虽另有 Linux 应用安装指南，但本页的桌面路径和启动命令按 Windows / macOS 编写。
✓ 完成标志
桌面应用已经安装，可以打开登录页或主窗口。
2. 完全退出应用，再检查配置
在应用菜单选择 Quit / 退出，让它结束运行。关闭窗口后仍可能留在后台。
打开以下文件，确认服务商表与终端版教程一致。
| 系统 | 配置文件 |
|---|---|
| Windows | %USERPROFILE%\.codex\config.toml |
| macOS | ~/.codex/config.toml |
toml
model = "替换为模型广场中的Codex模型ID"
model_provider = "xxapi"
web_search = "disabled"
[model_providers.xxapi]
name = "XXAPI"
base_url = "https://xxapi.ai/v1"
wire_api = "responses"
env_key = "XXAPI_API_KEY"已有配置时修改同名项，其他内容保留。桌面应用不会读取 WSL 中另一个 Linux 用户的 .codex 目录。
查看当前可用模型与分组从 XXAPI 后台读取
选择与你的 API Key 相同的分组，再复制模型名称。
✓ 完成标志
桌面所在系统的用户配置中，已选择 xxapi 服务商和可用于 Codex 的模型。
3. 让桌面应用读到 Key
终端中临时 export 或 $env: 设置的变量，通常不会自动传给从图标打开的应用。按系统选一种方式。
Windows
开始菜单搜索“编辑账户的环境变量”，打开后在上方用户变量区域点击“新建”。
| 项目 | 填写内容 |
|---|---|
| 变量名 | XXAPI_API_KEY |
| 变量值 | 自己的 XXAPI API Key |
确认保存后，先保存其他工作，再注销并重新登录 Windows，让桌面程序读取新变量。这里保存的 Key 属于个人系统设置，不要加入项目文件或截图发送。
macOS
打开“终端”，先把 Key 填入下面两行并执行。
bash
export XXAPI_API_KEY="替换为你的XXAPI_API_Key"
launchctl setenv XXAPI_API_KEY "$XXAPI_API_KEY"这会让当前登录会话中新启动的桌面应用读取该变量。重启电脑或注销后需要重新执行。用完若要清除，可执行 launchctl unsetenv XXAPI_API_KEY。
✓ 完成标志
当前桌面登录会话中的新应用可以读取 XXAPI_API_KEY。
4. 打开应用，进入本地 Codex
重新打开 ChatGPT 桌面应用，选择 Codex，然后选择“打开文件夹”或“选择项目”，打开 xxapi-demo 练习文件夹。前面的终端教程已经在用户目录中创建了它；Windows 可在文件夹选择框输入 %USERPROFILE%\xxapi-demo，macOS 按 Command + Shift + G 输入 ~/xxapi-demo。
界面名称会随版本变化。确认使用的是本机上的 Codex 会话；网页版、云端 Work 和手机端不会因为修改这个本地文件而接入 XXAPI。
如果还停在登录页，先按下方“仍要求登录”排查，不要把第三方 Key 随意粘贴到未经配置的官方登录窗口。
✓ 完成标志
可以在本地 Codex 的项目里新建消息。
5. 确认模型并发送消息
检查当前模型与 config.toml 中一致，发送下面一句。
text
请只回复“连接成功”，先不要读取或修改文件。然后回到 XXAPI 查看使用日志，核对请求时间和模型。仅看到应用有回复，还不能判断走的是哪家服务。
✓ 完成标志
本地 Codex 正常回复，XXAPI 记录中出现这次请求。
6. 以后切换模型或服务商
修改个人 config.toml，或在管理该文件的 CC Switch 里切换服务商。完全退出桌面应用再重开，并新建会话检查模型。已经打开的旧会话可能仍沿用原模型。
如果更换了 Key，也要同步更新第 3 步的变量。
✓ 完成标志
新会话选中新的模型，XXAPI 记录与所选模型一致。
已有官方登录或其他中转配置
先备份 config.toml。旧服务商表可以保留，只调整顶层 model_provider。本页 env_key 方式不要与 requires_openai_auth = true 混用，也无需直接修改 auth.json。
恢复旧服务商时把 model_provider 改回原值，再完全重启应用。不要删除整个 .codex，里面还包含历史会话。
常见问题
终端可用，桌面提示缺少 Key
先检查桌面所在系统和终端是否一致，尤其是 WSL。Windows 注销登录后重试；macOS 重新执行 launchctl setenv 后，从应用菜单彻底退出再打开。
仍要求登录官方账号
确认是本地 Codex，并检查应用版本、个人配置路径和环境变量。读取不到自定义服务商时，应用会落回默认登录流程。不要用替换登录文件或补丁来绕开问题，先让同一系统的 Codex CLI 读到正确配置。
已有回复，但 XXAPI 没有记录
先核对记录筛选范围和时间。检查当前模式是否为本地 Codex，以及新会话选中的模型与服务商。让模型自报身份不能证明请求经过了 XXAPI。