主题
Codex下载与Codex App使用指南：桌面端、CLI、Worktrees和多智能体工作流【2026年8月】
最后更新：2026-08-22
国内 Codex 与多模型 API 开发工具推荐
国内进行 Codex、代码、脚本或多模型 API 开发时，可以按任务选择以下第三方工具：
- 💻 网页端多模型/Codex 开发额度（ZeoGPT）：zeogpt.com平台标称可同时使用网页端多模型服务，并按套餐提供独立 Codex 开发额度；Plus、Pro 5x、Pro 20x 等档位及具体额度以登录后的实时页面为准，不等同于 OpenAI 官方 API 余额。另见 Codex 安装与配置教程（登录后查看）。
- 🔌 API/脚本接入（ZeoAPI）：zeoapi.com多模型 API 接入、脚本和原型测试。
以上均为邀请链接（仅指产品入口）；ZeoGPT Codex 教程链接为平台功能页。ZeoGPT 与 ZeoAPI 均为第三方服务，不是相关模型厂商的官方网站或官方产品；所列套餐、额度、型号与能力来自平台标称，具体功能与可用性以登录后的实际页面为准，第三方开发额度不等同于 OpenAI 官方 API 余额。请勿上传账号密码、API Key、合同或其他敏感资料。
本站为独立中文教程与导航博客，并非 OpenAI 官方网站，也不提供站内对话或代码执行功能。手机上想用 Codex，请打开 OpenAI 官方产品页或对应客户端，本站只讲解下载、安装、配置与工作流。文中提到的网页版、App、CLI、云端任务和 IDE 均指 OpenAI 官方产品形态，第三方开发工具会另行标注。
想把 Codex 真正用起来，先记住这条主线：核验官方唯一下载入口 → 判断自己要 Codex App、CLI、网页版还是云端任务 → 按系统装好并验证版本 → 用 ChatGPT 账号或 API Key 登录 → 配置 config.toml → 在测试项目里跑第一次只读分析和小范围修改 → 需要并行时再用独立分支或 Worktrees 拆任务。整篇教程只围绕 OpenAI 当前的 Codex，不把早期弃用的旧 Codex 模型、第三方同名软件、增强启动器和不明镜像混为一谈。安装命令以 openai/codex 官方仓库 当前 README 为准，版本会持续更新，实际安装时不要照搬任何文章记录的固定版本号。
Codex 下载先核验哪些官方入口
搜索“Codex下载”“codex官网下载安装”时最常见的错误不是命令输错，而是从错误的地方下载。Codex 没有一个五花八门的“官方下载站”网络，能作为核验基准的只有 OpenAI 自家页面。建议把下面三个地址固定为核验链路，任何第三方下载页都拿来跟它们对照：
- OpenAI Codex 产品页：核对当前产品形态、支持场景和官方说明。
- OpenAI Codex 官方文档：核对认证、系统支持、CLI 与配置说明。
- openai/codex 官方 GitHub 仓库：核对安装命令、源码、README 与版本发布，这是命令的权威来源。需要手动下载二进制时，再看该仓库的 Releases 页面核对平台与架构。
辨别仿冒站可以用几个稳定信号：
- 官方安装脚本域名指向 OpenAI 自有域，不是任何个人博客、网盘或第三方镜像。
- 官方从不通过网盘、论坛附件、二维码或客服私聊发放安装包。
- 官方不会要求你先关闭杀毒软件、以管理员身份运行未知脚本，或在下载前输入 ChatGPT 账号密码。
- 页面若强调“绿色版”“破解版”“免登录版”“完整整合包”“内置模型直连”，基本可以判定不是官方入口。
Codex 会读取本地代码并可能执行命令，来源错误的风险远高于普通阅读软件。看到要求复制浏览器 Cookie、上传 API Key 或运行不明脚本时，应立即停止。还没选好入口，可以先看 Codex 官网入口选择指南 与 Codex官网下载真假核验。
Codex App 是什么，先和 CLI 区分
“Codex App”指 Codex 的桌面/图形界面形态，很多人搜索“codex桌面版”“codex官网下载电脑版”，其实要的就是官方 App，而不是下载站上打包的第三方安装器。它和 CLI 的差别，是理解整套工具的关键：
- Codex App（桌面端）：提供图形界面，适合可视化地看项目、切换会话、审查修改和管理任务，对不习惯纯终端的人更友好。
- Codex CLI：运行在终端里，直接读取本地仓库、改文件、跑命令，反馈即时、脚本化能力强，适合已经习惯命令行的开发者。
两者可能共享账号或部分能力，但安装方式、权限模型、项目访问和排错路径不同。选择很直接：想要图形化管理，先看官方 Codex App；想让工具深度嵌进终端和脚本，用 CLI。想直接上手桌面版和沙箱，可看 Codex Windows 桌面版与 Sandbox 指南；想按三种安装方式逐一比较，可看 Codex 安装教程。
需要说明的是，App、CLI 的具体命名、版本节奏和能力覆盖会随官方更新变化，以 OpenAI Codex 官方文档 与仓库 README 的当前描述为准，本文不把某一时刻的界面细节当作长期承诺。
桌面端、网页版、CLI 与云端任务的关系
当前 Codex 可以出现在网页、桌面应用、命令行和编辑器中，还能把较重的编码工作交给云端任务处理。它们的安装方式与权限边界不同，先对照下面这张表确定自己要哪一种：
| 形态 | 是否需要本地安装 | 更适合什么任务 | 从哪里开始 |
|---|---|---|---|
| Codex 网页版 | 通常不需要 | 快速提问、阅读仓库、发起编码任务 | ChatGPT 内的 Codex 入口 |
| Codex 云端任务 | 通常不需要 | 较长、可并行、发起后稍后回看的工作 | 网页/App 内的任务入口 |
| Codex App（桌面） | 需要安装或从 CLI 启动 | 图形界面管理项目、会话与修改 | 官方 App 页面 |
| Codex CLI | 需要 | 在终端读取项目、改文件、跑测试 | openai/codex |
| Codex IDE 扩展 | 需要编辑器扩展 | VS Code、Cursor 等编辑器内协作 | OpenAI Codex 官方文档 |
理解它们的关系比记住每个名字更重要：网页版和云端任务偏“发起—等待—回看”，本地 CLI 和 App 偏“即时读改—当场验证”。云端任务的可用范围、并发数和限制，以及桌面端、网页端的功能覆盖，都会随版本和你的账号计划变化，请以登录后的官方页面为准。整套登录与工作流对照可看 ChatGPT Codex 使用、CLI 与 API 指南。
Windows / macOS / Linux 下载与安装
无论选哪种形态，本地 CLI 都是很多工作流的基础。动手前先做前置检查，能省掉一大半“命令找不到”的报错：使用完整的官方终端而不是残缺的第三方壳；打算用 npm 就先确认 node --version、npm --version 正常返回，Node 建议用官方仍在维护的 LTS 版本；确认公司电脑没有全面禁止远程脚本、用户级安装或未知发布者程序。
Windows（PowerShell，命令以官方 README 为准）：
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"macOS / Linux（官方 shell 脚本）：
bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh已用 Homebrew 或 Node 管理工具的用户，也可按官方 README 使用：
bash
brew install --cask codex
npm install -g @openai/codex安装结束后关闭当前终端，重新打开再核对：
bash
codex --version
codex --help
## Windows 用 where.exe codex，macOS/Linux 用 command -v codex三个命令分别确认版本、帮助信息和实际调用路径。若版本能返回，但路径命令显示多个位置，说明电脑里可能同时存在旧版 npm 安装、手动下载版本或其他同名命令，应先确认哪个路径来自官方安装，再决定是否清理旧版本。Windows 脚本无法运行时，按“确认能访问官方脚本地址 → 检查公司策略限制 → 改用 npm → 从官方 Release 下载对应架构文件 → 最后再考虑 WSL2”的顺序排查，不要一开始就关掉安全软件或永久放开执行策略。跨平台系统要求与验证细节，可参考 Codex 跨平台安装环境指南。
首次登录与 config.toml 配置
进入一个不含敏感信息的测试目录，运行 codex，首次启动优先按界面选择 Sign in with ChatGPT。官方文档说明 ChatGPT 的 Plus、Pro、Business、Edu、Enterprise 等计划包含 Codex，具体可用范围以你账号登录后的实际页面为准。浏览器登录成功不等于终端一定完成认证，必须回到终端确认已收到登录结果。远程服务器或无浏览器环境，可尝试设备码登录并用 codex login status 检查状态。
需要 API Key 时，应从环境变量通过标准输入交给 Codex，不要把完整 Key 写进命令参数、截图、文章或仓库：
bash
## macOS / Linux
printenv OPENAI_API_KEY | codex login --with-api-key
## PowerShell
$env:OPENAI_API_KEY | codex login --with-api-key示例中的密钥一律用 <YOUR_API_KEY> 这类占位符表示，不要在任何地方粘贴真实的 Key。Codex 默认把状态和用户配置放在 ~/.codex，也可用 CODEX_HOME 改变目录：
| 系统 | 常见配置路径 |
|---|---|
| Windows | %USERPROFILE%\.codex\config.toml |
| macOS/Linux | ~/.codex/config.toml |
| 自定义目录 | $CODEX_HOME/config.toml |
项目还可以有 .codex/config.toml。当前官方实现中，命令行会话覆盖通常高于项目配置，项目配置又高于用户配置。遇到“改了配置却不生效”，要同时检查当前目录、命令行参数、项目级配置和用户级配置。一个偏保守的基础示例，把审批和沙箱都留在收紧状态：
toml
## ~/.codex/config.toml
approval_policy = "on-request"
sandbox_mode = "workspace-write"具体可用值和默认行为可能随版本变化，修改前请核对官方配置文档与当前 CLI 输出。密钥、config.toml 与 MCP 的完整配置边界，可看 Codex API Key、config.toml 与 MCP 配置指南。
Worktrees 解决什么问题
当你要并行推进多件事，或者让 Codex 同时处理多个任务时，最容易出问题的地方是不同改动互相踩到同一批文件。Worktrees（Git 多工作树）就是为这种场景设计的：它允许从同一个仓库检出多个独立工作目录，每个目录挂在不同分支上，改动彼此隔离，不必反复 git stash 或来回切分支。
一个典型用法是给每条任务开一个独立工作树：
bash
## 从主仓库为不同任务创建隔离的工作目录和分支
git worktree add ../task-refactor -b task/refactor
git worktree add ../task-tests -b task/add-tests
## 完成后清理
git worktree remove ../task-refactor这样一来，重构任务和补测试任务各自在独立目录、独立分支里进行，Codex 在其中一个目录里读改文件时，不会影响另一个任务的状态。Codex 是否内置对工作树/复杂任务拆分的支持、以及具体交互方式，会随版本变化，请以 OpenAI Codex 官方文档 与仓库 README 的当前说明为准；即便工具不直接管理工作树，Worktrees 本身也是 Git 原生能力，可以手动为并行任务提供隔离环境。多智能体与 CLI 组合的更多思路，可参考 GPT-5.6 max/ultra 的 Codex CLI 多智能体教程。
多智能体任务如何拆分和验收
“多智能体”或并行任务听起来高效，但真正的风险不在于能不能同时跑，而在于结果能不能验收、会不会互相污染。把握两个核心原则就能稳住：隔离和验收。
拆分与验收可以按下面这张步骤表推进：
| 步骤 | 做什么 | 验收标准 |
|---|---|---|
| 1. 拆任务 | 把大目标拆成边界清晰、彼此独立的小任务 | 每个任务能单独描述“改哪些文件、达成什么” |
| 2. 分环境 | 每个任务用独立分支或独立 Worktree | 任务之间不共享工作目录、不改同一批文件 |
| 3. 执行 | 让每个任务只在自己范围内读改文件、跑命令 | 任务不越界修改依赖、配置或无关文件 |
| 4. 审查 | 逐个 git status、git diff 查看改动 | Diff 清晰、可读、可回滚 |
| 5. 测试 | 跑与改动相匹配的测试或构建 | 测试通过、构建成功 |
| 6. 合并 | 分别评审后再依次合并 | 合并顺序可控，冲突可解释 |
要牢记：智能体的自述不是验收结果，文件改动、Diff、测试输出和可回滚性才是。不要让多个任务同时写同一份文件，也不要为了赶进度直接跳过审查合并。并行度越高，越要靠分支/工作树隔离和自动化测试兜底，而不是靠“看起来跑通了”。
一个安全的本地开发工作流
第一次运行不要直接改生产项目。新建测试目录，或复制一个没有 .env、密钥、客户数据和生产配置的小项目，先建 Git 基线：
bash
git init
git add .
git commit -m "baseline before Codex"启动后第一条任务只要求读取和解释：
text
只读取当前项目，说明目录结构、启动命令和测试命令。
不要修改文件，不要安装依赖，不要访问网络。只读结果正常后，再给一个极小修改：
text
只修改 tests/example.test.ts，为现有函数补一个边界测试。
不要修改依赖、配置和其他文件。完成后给出 Git Diff 摘要和测试命令。修改后必须自己 git status、git diff 并运行原有测试或构建。三个原则值得长期遵守：密钥放环境变量或 Secret 系统、第一次使用保留审批、项目规则写进 AGENTS.md。把这套流程和 Worktrees 结合，就能从“单任务安全试跑”自然扩展到“多任务并行且可验收”。想继续深入命令与会话恢复，可看 Codex CLI 常用命令大全。
权限、密钥和生产仓库隔离
Codex 能读代码、能执行命令，权限设置直接决定风险大小。三条边界建议长期坚持：
- 审批与沙箱：第一次使用保留
approval_policy = "on-request"和收紧的sandbox_mode，确认可控后再逐步放开，不要一上来就开完全访问。权限模型的完整说明可看 Codex 权限设置指南。 - 密钥隔离：API Key、Token、Cookie 一律放环境变量或 Secret 系统，绝不写进
config.toml、命令参数、截图或仓库；示例只用<YOUR_API_KEY>占位。 - 生产仓库隔离：不要让 Codex 在生产仓库主分支上直接改动。用独立分支或 Worktree 隔离，评审 Diff、跑测试后再合并；批量删除、强制推送、重置历史等高风险操作应由人工确认。
需要区分的一点是认证路径：ChatGPT 登录和 OpenAI API Key 是两条不同路径，权限、会话和使用条件都不同，能登录 ChatGPT 网页并不代表一定能用 API。第三方 API 地址只有在明确兼容当前 Codex 的请求、认证、模型名和工具调用格式时才可能工作，且不是官方入口，接入前要核对数据流向、日志与服务条款。安全无法承诺“绝对”，这套边界只是把可控性拉高，不能替代你自己的审查。
入口与工作流选择对比表
把常见需求对应到入口，能少走很多弯路：
| 你的需求 | 更合适的入口 | 是否需要本地安装 | 注意点 |
|---|---|---|---|
| 只想问代码问题、看解释 | Codex 网页版 | 否 | 反馈即时，不改本地文件 |
| 发起较长任务、稍后回看 | Codex 云端任务 | 否 | 可用范围与并发以官方页面为准 |
| 图形化管理项目和会话 | Codex App（桌面） | 是 | 从官方入口下载，不用第三方打包器 |
| 终端里读改文件、跑测试 | Codex CLI | 是 | 注意 PATH 与多环境冲突 |
| 编辑器内协作 | Codex IDE 扩展 | 是 | 需装对应编辑器扩展 |
| 多任务并行、互不干扰 | CLI + 独立分支/Worktrees | 是 | 每任务隔离，Diff 与测试验收 |
如果你在国内需要更顺的开发环境，把“官方 Codex + 合规访问”和“第三方开发平台”分开看待更稳妥：需要中文网页端多模型或独立 Codex 开发额度时，可以评估文首推荐框里的 ZeoGPT（第三方服务，非 OpenAI 或 Codex 官方产品），其标称的 Plus、Pro 5x、Pro 20x 档位与 Codex 开发额度以登录后页面为准，不等同于 OpenAI 官方 API 余额；只做脚本、原型和多模型 API 测试，可以看 ZeoAPI（第三方 API 中转服务，非模型厂商官方 API）。两者都是邀请链接、都不是官方入口，接入前请先用公开或脱敏代码测试，不要上传 API Key、.env、客户数据、生产日志或私有仓库。更完整的国内路线可看 Codex 国内使用指南 2026。
错误与避坑清单
| 现象 | 优先检查 | 不建议做的事 |
|---|---|---|
codex 命令找不到 | 终端是否重开、PATH、安装目录、多个 Node 环境 | 反复安装不同来源的同名包 |
| 下载脚本连接失败 | 网络、代理、CA 证书、能否访问官方脚本地址 | 转去下载站找“绿色版”替代 |
| 版本与预期不同 | 实际执行路径、npm/Homebrew/手动版本冲突 | 只看包管理器显示，不看实际路径 |
| ChatGPT 登录循环 | 浏览器账号、回调端口、代理、CLI 版本、组织策略 | 复制 Cookie 或把账号密码交给第三方 |
| 401 | Key 是否撤销、变量名、当前 Shell 是否读取、认证方式 | 截图或公开完整 Key |
| 403 | 项目、组织、模型权限与策略限制 | 连续生成新 Key 掩盖权限问题 |
| 429 | 速率、并发、可用额度和重试策略 | 无限重试或并发轰炸 |
| 并行任务互相覆盖 | 是否用了独立分支/Worktree、是否改同一批文件 | 多个任务共享一个工作目录 |
| 无法修改文件 | 沙箱模式、审批、目录权限、项目规则 | 直接启用完全访问后继续试错 |
config.toml 不生效 | 用户级、项目级、会话参数和 CODEX_HOME 优先级 | 同时改多个配置来源 |
需要版本检查、升级失败处理与降级，参考 GPT-5.6 Codex 更新与最低版本排查；命令与 IDE 入口可从 安装、CLI 与 IDE 进入，不要靠反复覆盖安装“修好”环境。
事实边界
- Codex 的下载方式、App/CLI/网页版/云端任务的能力、Worktrees 与多智能体支持，都会随版本变化，本文所有形态描述以 OpenAI Codex 产品页 与 OpenAI Codex 官方文档 的当前说明为准。
- 本文提供官方链接供读者复核，但“提供了 URL”不等于已核验每一处具体功能、套餐、额度或地区可用性，请以你访问时的官方页面为准。
- 第三方平台（如 ZeoGPT、ZeoAPI）的标称功能、套餐和额度是第三方页面展示，不是 OpenAI 官方能力，第三方开发额度不等同于 OpenAI 官方订阅或 API 余额。
- 安全建议只能提升可控性，不能承诺绝对安全；并行任务必须靠独立分支或工作树、Diff 和测试验收，而不是靠“看起来跑通了”。
常见问题
Codex 下载应该优先选哪个方式？
Windows 可先用官方 PowerShell 安装脚本，macOS/Linux 可先用官方 shell 脚本；已经统一用 Node.js 或 Homebrew 管理工具的开发者，也可选 npm 或 Homebrew。无论哪种方式，都要核对官方 README、版本号和实际命令路径，不要照搬任何文章记录的固定版本号。
Codex App 和 Codex CLI 是同一个东西吗？
不是同一种交互形态。CLI 主要在终端工作，Codex App（桌面/图形界面）更适合可视化管理项目、会话与修改，网页版和云端任务运行在浏览器或云侧，IDE 入口嵌入编辑器。它们可能共享账号或部分能力，但安装、权限、项目访问和排错方式不同，具体形态以官方文档为准。
Codex 云端任务和本地 CLI 有什么区别？
云端任务通常在远端环境里执行较长或可并行的编码工作，适合发起后离开、稍后回来看结果；本地 CLI 直接读取你机器上的仓库并可能执行命令，反馈更即时、也更贴近本地环境。两者的可用范围、并发与限制以你账号登录后的官方页面为准。
Worktrees 是用来干什么的？
Worktrees 指 Git 的多工作树能力，可以从同一个仓库检出多个独立工作目录，让不同分支的改动互不干扰。配合 Codex 时，它常用来给并行任务提供彼此隔离的目录和分支，避免多个任务同时改同一份文件造成冲突。是否内置以及如何使用以当前官方文档为准。
多智能体或并行任务怎么保证不出乱子？
核心原则是隔离与验收：每个任务在独立分支或独立工作树里进行，完成后单独查看 Git Diff、跑相关测试或构建，再决定是否合并。不要让多个任务同时写同一批文件，也不要把智能体的自述当成验收结果，文件改动、Diff 和测试输出才是。
第三方“绿色版/破解版”Codex 能不能下载？
不建议。Codex 会读取本地代码并可能执行命令，来源不明的安装包可能植入后门、窃取 ChatGPT 凭据或篡改仓库文件。任何要求关闭安全软件、输入 ChatGPT 密码或复制浏览器 Cookie 的下载页都应立即停止，只从 OpenAI 官方文档、仓库或 Release 下载。
config.toml 一定在用户目录吗？
默认用户配置通常位于 ~/.codex/config.toml，Windows 对应用户目录下的 .codex\config.toml。设置 CODEX_HOME 会改变目录，项目还可能有 .codex/config.toml，会话参数也可能覆盖配置，因此排查要同时看多个来源。
官方参考与核验入口
Codex 的安装脚本、版本、认证、系统支持、云端任务与配置字段会继续变化，实际操作前应再次查看以上官方页面。继续阅读可进入 Codex 官网入口选择指南 与 Codex VS Code 插件与 API 使用指南。