Codex 使用教程 2026：App、CLI 安装、中文设置与常见问题
想快速上手 Codex，先判断你适合使用 App 还是 CLI，再完成安装和登录，最后按本文步骤完成第一个项目。
适合第一次使用 Codex 的新用户、希望在电脑上进行 AI 编程的开发者，以及需要排查安装和登录问题的用户。
- 想要图形界面，选择 Codex App；习惯终端，选择 Codex CLI
- 完成对应系统的安装、登录和项目配置
- 按中文设置、额度和故障排查部分验证可用性
Codex 的版本、模型、套餐和可用能力更新较快，操作时请以客户端和 OpenAI 官方页面的当前提示为准。
Codex 是 OpenAI 的 AI 编程代理，可以读取项目代码、修改文件、运行测试、解释报错并协助完成多文件任务。现在使用 Codex 主要有两种方式：适合大多数新用户的 Codex App，以及适合开发者和终端用户的 Codex CLI。
如果你只想快速开始，建议先安装 Codex App；如果你习惯在终端中工作，或者需要在服务器、WSL 和脚本环境里使用，再选择 Codex CLI。本文把两种方式放在同一篇教程中，覆盖下载、安装、登录、首次使用、中文回复、WSL、额度和常见问题。
# 一、Codex App 和 Codex CLI 怎么选？
| 使用方式 | 适合人群 | 主要特点 |
|---|---|---|
| Codex App | 新用户、希望使用图形界面的开发者 | 项目管理、对话、Review、并行代理和 Worktree 集成在一个界面中 |
| Codex CLI | 习惯终端的开发者、Linux 或 WSL 用户 | 在终端中读取和修改代码，便于脚本化和命令行工作流 |
# 二、什么是 Codex？
Codex 不只是代码补全工具。它可以在获得授权后读取项目文件，根据任务修改代码，运行测试，并展示修改内容供你检查。常见用途包括：
- 解释现有项目和陌生代码
- 编写或修改功能
- 修复 Bug 和测试失败
- 进行代码重构
- 生成测试、文档和 Pull Request
- 同时处理多个相互独立的任务
Codex App 更像是一个图形化的工作区；Codex CLI 则更适合终端和自动化工作流。模型、套餐、额度和具体功能会随产品更新变化，请以当前账户页面和客户端显示为准。
# 三、安装前准备
- 一台 macOS、Windows 或 Linux 电脑
- 一个可以正常登录 ChatGPT 的账号
- 稳定的网络连接
- 需要处理的代码项目或测试项目
- 第一次使用时，建议先备份代码或使用隔离分支
# 四、Codex App 下载、安装与登录
Codex App 只建议从 OpenAI 官方页面或官方应用商店下载：
不要从不明下载站获取安装包。
# 4.1 macOS 安装
- 打开 chatgpt.com/codex (opens new window)。
- 点击下载 macOS 版本，打开 .dmg 文件。
- 将 Codex 图标拖入“应用程序”文件夹。
- 第一次打开时，根据 macOS 的“隐私与安全性”提示确认是否允许打开。
# 4.2 Windows 安装
- 打开 chatgpt.com/codex (opens new window) 下载 Windows 版本，或在 Microsoft Store 搜索 Codex。
- 如果使用应用商店，请确认发布者为 OpenAI。
- 按安装向导完成安装并打开应用。
- 如果需要终端工作流，再选择 WSL + Codex CLI。
# 4.3 登录 ChatGPT 账号
- 打开 Codex App，点击“登录”。
- 选择账号登录，浏览器会跳转到 OpenAI 登录页面。
- 登录 ChatGPT 账号并完成授权。
- 返回 Codex App，确认项目和对话界面可以正常打开。
如果登录时要求额外验证，请按照页面提示操作。不同账号、地区和登录环境的验证要求可能不同。
# 五、第一次使用 Codex App
- 在左侧 Projects 中新建或打开一个项目。
- 先让 Codex 介绍项目结构和主要文件。
- 给出一个明确的小任务，例如“找到登录页面的入口并解释相关文件”。
- 让 Codex 先说明计划，再确认是否修改文件。
- 修改完成后查看 Review 或 Diff，确认变更范围。
- 运行测试或手动验证，再决定是否保留修改。
第一次使用时，建议采用“解释项目 → 小范围修改 → 查看差异 → 运行测试”的流程。
# 六、Codex CLI 安装
Codex CLI 适合习惯终端的用户。安装命令和支持的平台可能随版本变化，执行前请以官方说明为准。
# 6.1 macOS 和 Linux
先确认 Node.js 和 npm 可用：
node --version
npm --version
然后安装 Codex CLI：
npm install -g @openai/codex
安装后进入项目目录并启动：
cd your-project
codex
macOS 用户也可以根据当前官方说明选择 Homebrew 安装方式。不要长期依赖固定的旧版本命令。
# 6.2 Codex CLI 登录
首次启动时，CLI 通常会引导你完成账号授权。也可以根据当前版本的帮助信息确认登录命令：
codex --help
登录后，先让 Codex 解释当前目录结构，确认账号、目录权限和网络正常，再开始修改代码。
# 6.3 Windows 用户：App 还是 WSL？
Windows 用户现在可以直接使用 Codex App。如果需要 CLI 工作流，可以在 WSL 中安装 Linux 发行版，再按 Linux 方式安装 Codex CLI。
- 想要图形界面和项目管理：选择 Codex App
- 经常使用终端、脚本或 Linux 工具链：选择 WSL + Codex CLI
- 不确定时：先使用 Codex App，熟悉后再尝试 CLI
# 七、Codex CLI 中文回复设置
如果希望 Codex CLI 默认使用简体中文，可以在项目根目录的 AGENTS.md 中加入：
Always respond in Simplified Chinese unless the user requests another language.
设置后，可以用下面的问题测试：
请用简体中文解释这个项目的目录结构，不要修改任何文件。
如果没有生效，检查 AGENTS.md 的位置、文件名和内容，再重新启动当前会话。
# 八、WSL 安装 Codex CLI
如果选择在 Windows 上使用 CLI，请优先使用 Windows 设置、Microsoft Store 或 Microsoft 官方文档提供的 WSL 安装方式，不要使用来源不明的网盘安装包。
在 PowerShell 中可以先查看状态：
wsl --status
wsl --update
进入 Ubuntu 或其他 Linux 发行版后，再按本文“macOS 和 Linux”部分安装 Node.js、npm 和 Codex CLI：
node --version
npm --version
codex --help
如果命令卡住或无法访问登录页，依次检查网络连接、浏览器授权状态、WSL 更新状态以及终端中的代理配置。不要直接修改 hosts 或使用来历不明的固定 IP。
# 九、模型、套餐与额度
Codex 的模型权限、额度和功能取决于当前 ChatGPT 套餐以及产品规则，具体以账户页面和 Codex 客户端当前显示为准。
- 小范围修改通常比大型重构消耗更少资源
- 长上下文、多文件任务和复杂测试可能消耗更多额度
- 额度用完后，按照账户页面提示等待恢复或调整套餐
- 不要把旧教程中的固定次数、固定价格或固定模型权限当作长期有效规则
# 十、常见问题
# Codex App 支持 Windows 吗？
支持。Windows 用户可以通过 Codex 官方页面或官方应用商店获取 App。若需要命令行工作流，可以选择 WSL + Codex CLI。
# Codex App 和 Codex CLI 有什么区别？
App 提供图形界面、项目管理、Review、Worktree 和并行任务等能力；CLI 在终端中工作，更适合开发者、Linux、WSL 和自动化脚本。
# Codex 如何设置中文回复？
可以在任务中直接说明“请用简体中文回复”，也可以在项目根目录的 AGENTS.md 中加入长期语言规则。
# Codex 登录失败怎么办？
先确认 ChatGPT 网页可以正常登录，再检查浏览器授权、系统时间、网络连接和当前账号权限。若客户端提示具体错误，优先按提示处理。
# Codex 修改代码安全吗？
不要默认接受所有修改。建议先提交或备份代码，让 Codex 先说明计划，修改后查看 Diff，最后运行测试。涉及生产环境时，先在隔离分支或 Worktree 中验证。
# Codex 和 GitHub Copilot 有什么区别？
Copilot 更偏向编辑器中的代码补全和建议；Codex 是可以围绕任务读取项目、修改多个文件、运行测试并解释结果的 AI 编程代理。
# 延伸阅读：Codex 专题
如果你已经完成基础安装，可以继续阅读：
- Codex App 与 CLI 的区别
- Codex 额度和使用限制
- Codex 接入 MiniMax 教程
- Codex 手机号验证教程
- Codex 重连和连接问题排查
- ChatGPT Business 开通教程
- ChatGPT Plus 升级教程
# 十一、总结
第一次使用 Codex，优先选择 Codex App，完成下载、安装、登录和第一个小任务；习惯终端的用户可以选择 Codex CLI，并根据需要配置中文回复和 WSL。
先让 Codex 理解项目 → 再处理小任务 → 查看 Diff → 运行测试 → 最后合并修改
Codex 的版本、模型、套餐和额度会持续更新。遇到安装、登录或功能问题时，以客户端当前提示和 OpenAI 官方页面为准。