Codex 安装与入门教程：从下载、登录到完成第一个任务

先说结论

Codex CLI 是运行在终端里的 AI 编程助手，可以进入你的本地项目，阅读代码、修改文件、运行测试并检查改动。对于 macOS 和 Linux，当前官方推荐的独立安装命令只有一行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装完成后进入项目目录，运行 codex，按提示登录，再用一句明确的任务描述开始工作即可。第一次使用时，建议先让 Codex 解释项目，不要立刻要求它大范围重构。

本文依据 2026 年 8 月 23 日可访问的官方文档整理。Codex 更新较快，如果命令与本地界面不同，应以文末官方文档为准。

Codex CLI 适合做什么

Codex CLI 的价值不是单纯补全一行代码，而是围绕一个目标完成一段可检查的开发流程，例如：

• 阅读陌生项目并解释目录结构；
• 定位报错原因，给出修复方案；
• 修改多个相关文件并运行测试；
• 根据 Git 差异检查潜在问题；
• 把重复操作整理为脚本或自动化流程。

它可以调用你电脑上已经安装的开发工具，但最终结果仍需要你检查。尤其是数据库迁移、权限配置、线上发布等高风险操作，不应只看 Codex 的文字结论。

安装前需要准备什么

开始前建议准备：

1. 一台 macOS 或 Linux 电脑，以及可用的终端。
2. 一个准备测试的本地代码项目，最好已经使用 Git 管理。
3. 可用的 ChatGPT 登录方式，或安装流程中提供的其他登录方式。
4. 项目原本需要的运行环境，例如 Node.js、Python、Go 或 Java。

Codex 不会替你安装所有项目依赖。一个 Next.js 项目原本需要 pnpm install，安装 Codex 后仍然需要先把项目自己的依赖准备好。

Windows 用户不要直接在普通 PowerShell 中照抄上面的 Shell 命令。请打开 Codex 官方安装页面的 Windows 标签，根据当前提供的原生 Windows 或 WSL 方式操作，避免采用已经过期的第三方教程。

第一步：安装 Codex CLI

在 macOS 或 Linux 终端运行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装结束后检查命令是否可用：

codex --version

如果终端提示找不到 codex，先关闭并重新打开终端，让新的环境变量生效。仍然无效时，查看安装输出中是否提示需要把某个目录加入 PATH。

官方当前使用同一条安装命令更新 Codex。需要升级时重新运行即可：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

第二步：进入项目并登录

不要在主目录或包含大量无关文件的目录直接启动。先进入一个明确的项目：

cd /path/to/your-project
codex

第一次运行会要求选择登录方式。按界面提示使用 ChatGPT 或当前可用的其他方式完成登录。登录成功后，Codex 会把当前目录视为工作区，因此启动位置非常重要。

如果只是体验，可以创建一个小型测试仓库：

mkdir codex-demo
cd codex-demo
git init
codex

第三步：完成第一个任务

第一条指令建议从只读理解开始：

请先阅读这个项目，不要修改文件。告诉我它使用什么技术栈、如何启动、主要目录分别负责什么。

确认 Codex 理解项目后，再给一个范围明确的小任务：

请修复登录表单里邮箱为空时没有提示的问题。先定位原因，再修改最少的文件，最后运行相关测试并总结改动。

高质量任务通常包含四个要素：目标、范围、约束和验收方式。相比“帮我优化项目”，上面的指令更容易得到可检查的结果，也更节省反复沟通的时间。

五个常用命令

在 Codex 交互界面中，下面几个斜杠命令最适合新手：

命令可能随版本调整，可以在界面输入 / 查看本机版本支持的完整列表。

第一次使用时如何保证安全

最简单有效的做法是先创建 Git 检查点：

git status
git add .
git commit -m "chore: 保存 Codex 操作前状态"

如果项目中已有未完成改动，不要为了创建检查点随意提交，更不要删除它们。可以新建分支或 Git worktree，把 AI 任务隔离开。

同时遵守三条原则：

• 不把生产密钥、私钥或客户数据直接粘贴进提示词；
• 仔细阅读 Codex 准备执行的高风险命令；
• 完成后查看 git diff，并亲自运行测试或构建。

常见问题

Codex 和 ChatGPT 有什么区别

ChatGPT 可以讨论代码，Codex CLI 更靠近本地开发环境：它能在授权范围内读取项目文件、执行命令并形成实际代码改动。两者并不是简单的强弱关系，而是使用场景不同。

Codex 会不会自动修改所有文件

不会无条件修改所有文件。它的行为取决于你的任务描述、当前权限和项目规则。为了降低误改概率，应明确“只修改哪些范围”“先分析还是直接实现”以及“完成后运行什么验证”。

为什么安装成功后还是找不到命令

最常见原因是终端没有重新加载 PATH。重新打开终端后再试；如果仍然失败，按照安装输出补充路径，并确认当前用户对安装目录有执行权限。

下一步应该学什么

安装完成后，建议继续阅读Codex CLI 实战工作流，学习如何把任务拆成理解、计划、修改、测试和审查五个阶段。

参考来源

• OpenAI Codex CLI 官方文档
• OpenAI Codex CLI 命令参考