Codex 新手保姆级教程：从安装到跑通第一个项目要几步？
Codex 是 OpenAI 推出的 AI 编程智能体，能读文件、写代码、执行命令、处理 Git 流程。新手第一次上手最怕“不知道从哪开始”。这篇教程用最直白的步骤，带你从零安装到成功跑通第一个小项目。
01 先准备好账号与网络
Codex 需要 ChatGPT Plus / Team 账号才能正常使用，同时需要稳定的网络访问 OpenAI 服务。账号准备好后，就可以进入安装环节。
02 下载并安装 Codex 桌面 App
- 打开浏览器，访问 OpenAI 官网的 Codex 页面：https://openai.com/zh-Hans-CN/codex/
- 根据系统选择 Windows 或 Mac 版本，点击下载。
- 下载完成后：
- Mac：双击 .dmg 文件，把 Codex 图标拖到「应用程序」文件夹。
- Windows：双击 .exe 安装包，按提示完成安装。
- 首次打开若弹出“无法验证开发者”，请到「系统设置 → 隐私与安全」里点击「仍要打开」。
安装完成后，用你的 ChatGPT 账号登录，进入主界面。
03 选择成长路线，生成个性化计划
登录后，Codex 会询问你的编程水平和目标方向。建议直接选「C（成长路线图）」并按提示回答，系统会自动生成一套适合你的学习与实践计划。也可以跳过，稍后手动设置。
04 认识 Codex 主界面
左侧栏从上到下主要包含：
- 新对话：当前项目下新建对话窗口。
- 搜索：快速查找历史对话。
- 项目列表：你已打开或创建的所有项目。
- 设置：个性化、API Key、Git 配置等。
界面右侧是对话与代码展示区，操作一目了然。
05 安装 IDE 插件（可选但推荐）
如果你习惯用 VS Code：
- 打开 VS Code，进入扩展市场搜索「Codex」。
- 点击安装，安装后在项目右上角会出现 Codex 图标。
- 点击图标即可在编辑器内直接调用 Codex。
注意：桌面 App 与 IDE 插件数据互通，改一个地方，另一个也会同步。
06 初始化你的第一个 Git 项目
找一个不怕改坏的小项目或 Demo，进入文件夹后执行：
git init
git add .
git commit -m "initial commit"
这样 Codex 就能基于 Git 历史帮你做 diff、commit、PR 等操作。
07 跑通第一个任务
不要一上来就改核心业务代码，建议从以下小任务开始：
- 给某函数补全注释
- 修复一个已知的报错
- 新增一个简单的单元测试
- 重命名几个变量并保持风格统一
操作步骤：
- 点击「新对话」，输入清晰需求，例如：“请帮我给 utils.py 里的 calculate 函数加上中文注释”。
- Codex 会先给出修改计划，确认无误后再执行。
- 完成后查看 diff，满意就让它自动 commit。
08 常见问题速答
- 无法登录？检查网络与账号订阅状态。
- 想用第三方 API Key？在设置里手动配置即可。
- 想跳过向导？登录后直接在左侧新建项目即可开始。
按照以上 8 步操作，普通新手 15–30 分钟就能完成安装并跑通第一个小项目。后续再逐步挑战更复杂的重构或功能开发，Codex 会成为你越来越得力的编程搭档。