安装前的账号、系统与项目准备
从零开始掌握 OpenAI Codex——AI 编程工程 Agent。14 章覆盖认识 Codex、四种入口安装、核心功能(自动化/插件/Skill/MCP/Git/记忆)、标准工作流、实战案例和第三方模型接入。
一句话结论
安装 Codex 前,先把 ChatGPT 账号、网络、基础工具(Git/Node/VS Code)和项目目录准备好,并理解权限与安全边界。
第二篇:安装、配置与环境准备
安装前准备
账号准备
如果你是普通个人用户,建议准备:
- ChatGPT 账号
- 能正常访问 ChatGPT / OpenAI 服务的网络
- 选择当前包含 Codex 的 ChatGPT 套餐;套餐名称、额度和功能范围会变化,请以官方页面和你账号实际显示为准。
系统准备
Codex 四大形态:
| 方式 | 适合谁 | 需要准备 |
|---|---|---|
| Codex App 桌面版 | 小白、想要图形界面的人 | Windows 或 macOS |
| Codex CLI | 稍微懂终端的人 | 终端、Git、项目环境 |
| Codex IDE Extension 插件 | 用 VS Code / Cursor / Windsurf 的人 | 编辑器 + 插件 |
| Codex Web / Cloud | 想让 Codex 远程处理 GitHub 项目的人 | GitHub 仓库 |
Codex App 支持 macOS 和 Windows ;Codex CLI 支持 macOS、Windows 和 Linux。
软件工具准备
安装 Codex 之前,建议先准备这些基础工具:
| 工具 | 作用 | 下载 / 注册链接 |
|---|---|---|
| Git | 让 Codex 能看代码变更、生成 diff、回滚修改 | Git 官方下载 |
| VS Code / Cursor | 方便查看和编辑代码 | VS Code 下载 / Cursor 下载 |
| 终端 | Windows 用 PowerShell;Mac 用 Terminal | 不用下载,系统自带 |
| 浏览器 | 登录 ChatGPT / OpenAI / GitHub | Chrome 下载 |
| Node.js | 做网页、前端、Next.js、Vite 项目常用 | Node.js 下载 |
| Python | 做脚本、自动化、数据处理常用 | Python 下载 |
| GitHub 账号 | 如果要用 Codex Cloud 或推送代码,需要准备 | GitHub 注册 |
| Codex App | Codex 桌面版,用图形界面管理任务和项目 | Codex App 官方页 |
| Codex CLI | 在终端里使用 Codex,适合真实项目开发 | Codex CLI 官方文档 |
| Codex 网页版 | 连接 GitHub 后,让 Codex 在云端处理项目 | Codex Web |
项目目录准备
Codex 不是单纯聊天工具,它需要进入一个具体项目目录工作。官方入门流程也是:登录 Codex 后,选择电脑上的文件夹或 Git 仓库,再开始第一个任务。
建议你提前建一个专门练习目录,比如:
[code]
D:\AI-Codex-Projects
[/code]
里面可以放:
[code]
hello-web
ai-tools-page
xiaohongshu-cover-tool
landing-page-demo
[/code]
不要一开始就让 Codex 操作你最重要的真实项目。先用练习项目熟悉它怎么改文件、跑命令、生成结果。
权限与安全准备
Codex 可以读取、修改文件,还能在你的项目目录里运行命令。官方对 CLI 的描述就是:它可以在你选择的目录中读取、修改代码,并运行命令。
所以安装前要注意:
| 注意点 | 建议 |
|---|---|
| 不要直接放重要文件 | 先用测试项目 |
| 不要把密码/API Key 写在代码里 | 用 .env 文件,并避免上传 |
| 操作前先 Git 提交 | 方便回滚 |
| 看清 Codex 要执行的命令 | 不懂的命令先问它解释 |
| 不要给它整个 C 盘权限 | 只选择具体项目文件夹 |
推荐每个项目先初始化 Git:
[code]
git init
git add .
git commit -m "initial commit"
[/code]
这样 Codex 改坏了也可以回退。