上手指南
上手指南 / Codex

Codex 桌面版

Codex 桌面版现在集成在 ChatGPT 桌面应用里。它和 Codex 命令行版共用同一份配置文件,所以只要把配置文件写好,桌面版就能直接连到 AIPlayer 演示站,不用登录 ChatGPT 账号。

分三步:写配置 → 安装应用 → 打开验证。

还没有密钥的,先看 创建密钥(厂商选 Anthropic)。

一、写配置文件

按 Codex 命令行版那一页的 二、写配置 操作,只做这一步就够了,不需要安装命令行版。

写完后,配置文件在这个位置:

系统 配置文件位置
macOS ~/.codex/config.toml(你的用户文件夹下的 .codex 文件夹)
Windows C:\Users\你的用户名\.codex\config.toml
小贴士

配置里的密钥直接写在文件中(experimental_bearer_token 那一行),所以桌面版从桌面图标启动也能读到,不需要额外设置环境变量。

二、下载安装

  • macOS:浏览器打开 chatgpt.com/download,下载 macOS 版,双击 .dmg 后把图标拖进「应用程序」。

  • Windows:打开 Microsoft Store 的 ChatGPT 页面 安装;也可以在 PowerShell 里运行:

    powershell
    winget install --id 9PLM9XGG6VKS -s msstore

三、打开并验证

  1. 打开 ChatGPT 桌面应用,切到 Codex。
  2. 选一个本地文件夹作为工作目录(可以用命令行版那一页建的 ai-demo 文件夹)。
  3. 发一句「你好,回复 OK 就行」,能收到回复就成功了。界面上显示的模型应该是配置里写的 Claude 模型(如 Claude Sonnet 5.5)。
  4. 回到 https://demo.aiplayer.club,点左侧「使用记录」,能看到刚产生的记录。
注意

改了配置文件之后,必须彻底退出应用再重新打开才会生效:macOS 按 Command + Q;Windows 在任务栏右下角的图标上右键选择退出。只关窗口不算退出。

常见问题

现象 怎么办
打开 Codex 后要求登录 ChatGPT 说明应用没读到配置。检查配置文件的位置和文件名(必须是 config.toml,不能是 config.toml.txt),确认 requires_openai_auth = false 还在,然后彻底退出应用重开
报 401 配置里的密钥填错了或已被删除。到网站「API 密钥」页重新复制,重新做一遍「一、写配置文件」
报 model_not_found 配置里的模型名不在你的分组里。把 model 和 review_model 两行改成你分组里有的模型
报余额不足 账户余额用完了,到网站「兑换」页充值

更多报错见 常见问题。