返回首页

Codex 桌面版（PC）

Codex 桌面版是 OpenAI 官方发布的独立桌面应用（不是 CLI），把 Codex Agent 装进一个带 GUI 的客户端——并行多任务、Git 集成、Plan 模式、自动化工作流全部内置。

⚠️ 先区分清楚两个产品

  • Codex CLI：终端命令行工具（@openai/codex npm 包），全平台都有
  • Codex 桌面版（本页）：OpenAI 官方桌面应用，macOS 仅支持 Apple Silicon（M1/M2/M3/M4），Windows 从 2026 年 3 月起支持

两者共享 ~/.codex/ 配置目录，所以在 CLI 里配好 Picklyone，桌面版可以直接继承。

系统要求

平台要求
macOSApple Silicon（M1/M2/M3/M4 芯片）。Intel Mac 不支持
WindowsWindows 10/11，2026 年 3 月 4 日起支持
Linux暂未发布官方桌面版，用 CLI 版本 替代

第 1 步：下载安装

  1. 去 OpenAI 官方页面下载：developers.openai.com/codex/app 或 openai.com/index/introducing-the-codex-app
  2. 选择对应平台：
    • macOS：.dmg 安装包，或 brew install --cask codex
    • Windows：.exe / .msi 安装包，或从 Microsoft Store 搜索 "Codex"
  3. 运行安装包完成安装
  4. 首次打开，会问你登录方式：ChatGPT 账号 或 API Key

如果走 Picklyone，必须选 API Key 登录（ChatGPT 账号登录会走官方订阅额度，不走你的 Picklyone Key）。

第 2 步：配置接入 Picklyone

Codex 桌面版和 CLI 共用 ~/.codex/config.toml + ~/.codex/auth.json 这两个文件。配置方法有两种：

方式 A：用 CC-Switch 一键导入（推荐）

这是最省事的方式——不用自己写 TOML、不用改 JSON，点两下就好：

  1. 装好 CC-Switch（如果还没装）
  2. 登录 Picklyone，到 API 密钥 页
  3. 选中要用的 Key，点右侧下拉 → 配置指南
  4. 弹窗左侧选 CC-Switch
  5. 点 一键导入 Codex
  6. 浏览器会弹窗提示"打开 CC-Switch"，确认
  7. CC-Switch 里 Picklyone Provider 已经填好，点"启用"
  8. CC-Switch 会自动写入 ~/.codex/config.toml 和 ~/.codex/auth.json

完成后重启 Codex 桌面版，它就会读到新的配置。以后切换 Provider（官方 vs Picklyone vs 其它）只要在 CC-Switch 里点一下即可。

💡 为什么推荐 CC-Switch：桌面版没有 "Override API Base URL" 这种 GUI 选项（只有登录入口），所有自定义 endpoint 的配置都得改 ~/.codex/ 里的文件。CC-Switch 专门做这件事，比手改 TOML 不易出错，而且方便在 Picklyone 和官方 API 之间来回切。

方式 B：手动编辑配置文件

如果你不想装 CC-Switch，或者在不能装桌面应用的环境里：

~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml）

model_provider = "OpenAI"
model = "gpt-5.4-mini"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.picklyone.com/v1"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json（Windows：%USERPROFILE%\.codex\auth.json）

{
  "OPENAI_API_KEY": "pk_live_xxxxxxxxxxxxxxxx"
}

如果 .codex 目录不存在：mkdir -p ~/.codex（Windows：资源管理器手动新建）。

第 3 步：首次启动

  1. 打开 Codex 桌面版
  2. 登录时选 Use API Key（不是 "Sign in with ChatGPT"）
  3. 如果你走的是 方式 A / 方式 B 写好了 auth.json，桌面版会自动读取，不会再问你 Key
  4. 进入主界面后，跳过引导问题（"What do you want to build today?" 之类）
  5. 顶部 Model Selector 里确认显示的是 gpt-5.4-mini 或你 config.toml 里设的默认模型

界面主要区域

区域作用
Prompt Input输入任务指令（"帮我给 auth.js 加个 rate limit"）
IDE Selector把生成的代码丢到 VS Code / Cursor / 系统 IDE 里打开
Model Selector切换模型（Picklyone 支持 gpt-5.4-mini / gpt-5.4 / gpt-4o / o1 等）
Skill Section插件 / 扩展能力，让 Codex 能做真实动作（写文件、跑命令等）
/ 斜杠命令在输入框打 / 召唤命令菜单，比如 /plan 进入 Plan 模式（先拆解任务再执行）
Projects左侧项目列表，每个项目一个独立的工作区、worktree、上下文

Picklyone 使用建议

  • 必须用 API Key 登录，不是 ChatGPT 账号：桌面版默认引导走 "Sign in with ChatGPT"，那会消耗你的 ChatGPT 订阅额度，和 Picklyone 完全无关。走 API Key 才会读 auth.json，才会走 Picklyone。
  • 配合 CC-Switch 管多 Provider：桌面版 UI 里没有切换 Provider 的选项，想在"Picklyone vs 官方 OpenAI"之间快速对比，必须借助 CC-Switch。
  • 桌面版 + CLI 配置互通：你在 CLI 里做的任何 ~/.codex/ 配置改动，桌面版重启后就生效；反之亦然。可以把桌面版当 GUI 面板，CLI 当脚本化入口，同一份配置跑两种工作流。
  • Plan 模式开大任务：Codex 桌面版的 /plan 会先把大任务拆成步骤列表，每一步单独执行，这比一次性丢一整段 prompt 更省 token、也更可控。
  • 独立 Key + 日限额：和 CLI 一样，给桌面版单独建一个 Picklyone Key（例如命名 codex-desktop），设 日限额。桌面版的 Plan 模式 + 自动化可能连续调用数十次，没有限额保底容易踩坑。

常见问题

  • Mac 提示"您无法打开 Codex，因为它来自身份不明的开发者"：右键点安装包 → 打开 → 再次确认（macOS Gatekeeper 首次限制）。Apple Silicon 以外的 Mac 不支持，别用 Rosetta 硬跑。
  • 登录后仍提示"API Key invalid"：检查 auth.json 字段名是不是 OPENAI_API_KEY（全大写），而不是 api_key。Key 必须以 pk_live_ 开头、无空格。
  • 切了 Picklyone 但界面还显示官方计费：桌面版缓存了登录态。彻底退出（不是关窗口，是系统托盘退出），再重开。
  • Plan 模式生成的步骤一直卡住：确认你装了 CLI 的 codex 命令，桌面版的 Plan 有时会 fork 子进程跑 CLI。npm install -g @openai/codex 补上即可。
  • 想回到 ChatGPT 订阅模式：在桌面版设置里退出登录，下次启动选 "Sign in with ChatGPT"。但注意这样就不走 Picklyone 了。

下一步