本文要点
这份教程适合第一次接触 Codex 的普通用户。你将完成安装、账号或 API 接入，并学会选择工作目录、创建任务和继续历史会话。
安装 Codex
Codex 提供桌面端和命令行两种方式。新手优先选择桌面端，需要在终端中工作或执行长任务时再安装 CLI。
Windows 桌面端
推荐新手使用一键安装工具；也可以直接下载安装包，或通过微软商店安装。
Windows 命令行
打开 PowerShell，优先运行 OpenAI 官方安装命令。
powershell -ExecutionPolicy Bypass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
查看参考教程提供的第三方脚本
该脚本来自 daheiai.com，并非 OpenAI 官方内容。执行前请先检查脚本内容并自行评估风险。
powershell -ExecutionPolicy Bypass -c "irm https://daheiai.com/codex.ps1 | iex"
macOS / Linux 命令行
打开系统终端，优先运行 OpenAI 官方安装脚本。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
查看参考教程提供的第三方脚本
该脚本来自 daheiai.com，并非 OpenAI 官方内容。执行前请先检查脚本内容并自行评估风险。
curl -fsSL https://daheiai.com/codex.sh | sh
Codex++ 配置教程
Codex++ 是 Codex App 的第三方增强启动器。它通过独立管理工具配置供应商和模型，适合需要使用自有 API 服务的用户。
Codex++ Windows 安装包
适用于 Windows x64，下载完成后双击安装程序，按照界面提示完成安装。
下载 Windows 版 19.5 MBCodex++ macOS BuildKit
适用于 macOS，下载压缩包后解压，并按照压缩包内的构建说明进行操作。
下载 macOS 版 20.6 MB- 1打开管理工具
先退出正在运行的 Codex，再打开“Codex++ 管理工具”，进入左侧的“供应商配置”。
- 2添加供应商
点击添加供应商，按你的 API 服务文档填写名称、Base URL、API Key 和模型名称。
- 3保存并应用
确认配置后保存并启用该供应商。不同服务的接口地址和模型名称不一样，请以服务商文档为准。
- 4通过 Codex++ 启动
关闭管理工具后，使用“Codex++”入口启动 Codex。进入对话页面后选择刚配置的模型并发送一条测试消息。
配置后无法使用怎么排查
先检查 Base URL 是否包含服务商要求的路径、API Key 是否有效、模型名称是否完全一致。仍然失败时，在 Codex++ 管理工具中检查运行状态和日志，再重新启动 Codex++。
Codex 基础使用
桌面端和 CLI 的核心流程相同：选择工作目录，然后直接用自然语言描述希望完成的任务。
- 1选择工作目录
选择你希望 Codex 读取和修改的项目文件夹，不要一开始就授权包含大量私人文件的目录。
- 2输入任务
清楚说明目标、限制条件和完成标准。任务越具体，结果越容易检查。
- 3继续历史会话
使用一段时间后，左侧会积累项目会话，可以回到原任务继续处理。
Codex 的独特优势
持续执行目标
把目标和停止条件写清楚后，Codex 可以持续推进多步骤工作。长任务仍应设置检查点，并限制可操作范围。
浏览器协作
配合浏览器能力后，可以检查网页状态、填写界面和验证前端效果，适合处理需要“看见页面”的任务。
项目级上下文
可以读取目录、修改代码、运行测试并继续历史会话，比只在聊天窗口里粘贴片段更适合真实项目。
常见问题
提示“找不到 codex 命令”
先关闭并重新打开终端，再运行 codex --version。使用 npm 安装时，请确认 Node.js 与 npm 的全局命令目录已经加入 PATH。
Windows 阻止脚本执行
确认使用本页提供的官方 PowerShell 命令，并以正常用户身份重新打开 PowerShell。公司设备可能受管理员策略限制，需要联系管理员。
浏览器登录后终端没有反应
保持原终端窗口开启，确认浏览器完成授权后返回终端。如果登录页被网络工具拦截，可以退出 Codex 后重新运行 codex。
如何更新 Codex
独立安装版本可重新执行对应系统的官方安装命令；npm 版本可再次运行 npm install -g @openai/codex。
现在可以开始第一个任务
从一个项目文件夹启动 Codex，用清晰的目标描述你希望完成的工作。