OpenAI Codex App 是用于并行处理多个 Codex 线程的桌面客户端,适合在本机或已连接主机上分开管理项目任务。按 macOS 或 Windows 下载安装后,用 ChatGPT 账户或 OpenAI API key 登录,选择项目并确认 Local,即可开始;用 API key 时,部分云端能力如 cloud threads 可能不可用。
OpenAI Codex App 安装与功能
Codex app 是一个专注的桌面体验,用于并行处理 Codex threads,内置 worktree 支持、automations 和 Git 功能。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex。查看 what’s included。
开始使用
Codex app 适用于 macOS 和 Windows。
大多数 Codex app 功能在两个平台上都可用;平台差异会在相关文档中单独说明。
1. 下载并安装 Codex app
下载适用于 macOS 或 Windows 的 Codex app。使用 Intel Mac 时,请选择 Intel build。
2. 打开 Codex 并登录
安装完成后,打开 Codex app,并使用 ChatGPT 账户或 OpenAI API key 登录。
如果使用 OpenAI API key 登录,某些功能可能不可用,例如 cloud threads。
3. 选择项目
选择一个希望 Codex 处理的项目文件夹。
如果你以前使用过 Codex app、CLI 或 IDE Extension,会看到之前处理过的项目。
4. 发送第一条消息
选择项目后,确认 Local 已选中,让 Codex 在你的机器上工作,然后发送第一条消息。
你可以让 Codex 处理项目相关问题,也可以问它一些关于电脑本身的问题。下面是几个示例:
Tell me about this project
Build a classic Snake game in this repo.
Scope & constraints:
- Implement ONLY the classic Snake loop: grid movement, growing snake, food spawn, score, game-over, restart.
- Reuse existing project tooling/frameworks; do NOT add new dependencies unless truly required.
- Keep UI minimal and consistent with the repo’s existing styles (no new design systems, no extra animations).
Implementation plan:
1) Inspect the repo to find the right place to add a small interactive game (existing pages/routes/components).
2) Implement game state (snake positions, direction, food, score, tick timer) with deterministic, testable logic.
3) Render: simple grid + snake + food; support keyboard controls (arrow keys/WASD) and on-screen controls if mobile is present in the repo.
4) Add basic tests for the core game logic (movement, collisions, growth, food placement) if the repo has a test runner.
Deliverables:
- A small set of files/changes with clear names.
- Short run instructions (how to start dev server + where to navigate).
- A brief checklist of what to manually verify (controls, pause/restart, boundaries).
Find and fix bugs in my codebase with minimal, high-confidence changes.
Method (grounded + disciplined):
1) Reproduce: run tests/lint/build (or follow the existing repo scripts). If I provided an error, reproduce that exact failure.
2) Localize: identify the smallest set of files/lines involved (stack traces, failing tests, logs).
3) Fix: implement the minimal change that resolves the issue without refactors or unrelated cleanup.
4) Prove: add/update a focused test (or a tight repro) that fails before and passes after.
Constraints:
- Do NOT invent errors or pretend to run commands you cannot run.
- No scope drift: no new features, no UI embellishments, no style overhauls.
- If information is missing, state what you can confirm from the repo and what remains unknown.
Output:
- Summary (3–6 sentences max): what was broken, why, and the fix.
- Then ≤5 bullets: What changed, Where (paths), Evidence (tests/logs), Risks, Next steps.
如果你还想看更多示例,可以查看 Codex use cases。如果你刚开始接触 Codex,建议先读 best practices guide。
用 OpenAI Codex App 可以做什么
多任务并行处理项目
同时运行多个项目线程,并快速在它们之间切换。
Worktrees
使用内置 Git worktree 支持,把并行代码改动隔离开。
Remote connections
使用 ChatGPT 手机 App,在已连接的主机上启动、引导、批准和审查 Codex 工作。
Computer use
让 Codex 使用 macOS App 处理 GUI 任务、浏览器流程和原生应用测试。
Appshots
把前台 Mac 应用窗口连同截图和可用文本一起发给 Codex。
代码审查与交付
查看 diff、处理 PR 反馈、暂存文件、提交并推送。
终端和 actions
在每个线程里运行命令,并启动可重复执行的项目 actions。
In-app browser
打开渲染后的页面,留下评论,或者让 Codex 操作本地浏览器流程。
Chrome extension
安装 Chrome 插件后,Codex 可以在你管理网站批准的同时,使用 Chrome 处理已登录的浏览器任务。
图像生成
在处理周边代码和资产时,也可以在线程中生成或编辑图片。
Automations
安排周期性任务,或者唤醒同一个线程做持续检查。
Skills
在 App、CLI 和 IDE Extension 之间复用说明和工作流。
侧边栏和 artifacts
查看计划、来源、任务摘要和生成文件预览。
Plugins
连接 apps、skills 和 MCP servers,扩展 Codex 的能力。
与 IDE Extension 同步
在 App 和 IDE session 之间共享 Auto Context 和活跃线程。
Need help? Visit the troubleshooting guide.
常见问题
OpenAI Codex App 怎么安装
先下载适用于 macOS 或 Windows 的安装包,再打开登录即可。Intel Mac 需要选 Intel build。Linux 目前还没有正式版本,可以先订阅通知。
OpenAI Codex App 用 API key 登录有什么限制
使用 OpenAI API key 登录时,部分功能可能不可用,原文明确提到 cloud threads 可能不可用。若你需要这类云端能力,改用 ChatGPT 账户登录。
OpenAI Codex App 和 CLI、IDE Extension 有什么关系
三者可以共享你之前处理过的项目;Skills 也能跨 App、CLI 和 IDE Extension 复用。App 更偏向桌面并行工作,IDE Extension 更适合在编辑器里边写代码边调用 Codex。