第 1 篇Codex App 是什么从安装环境到第一次打开本篇目录Codex App 到底是什么使用 Codex 前要准备什么安装 Node.js安装 Git安装 VS Code下载并启动 Codex App登录 ChatGPT 账户完成首次初始化看懂 Codex App 的三栏布局本篇小结与检查清单1. Codex App 到底是什么Codex App 可以理解为一个“会操作项目的 AI 助手”。普通聊天机器人通常只能回答你的问题。例如你问“帮我写一个网页代码”它可能会在聊天窗口里给你一段 HTML。但你还需要自己复制代码、创建文件、运行项目、排查报错。Codex App 的不同点在于它可以进入你的项目文件夹直接读取文件、修改文件、运行命令、启动本地服务还可以打开浏览器帮你验证页面效果。换句话说普通聊天机器人更像“顾问”。Codex App 更像“可以动手干活的项目助手”。你可以让它做很多事情例如创建一个网站。修改已有项目的内容。修复代码报错。使用插件连接外部工具。把重复任务做成自动化流程。2. 使用 Codex 前要准备什么正式安装 Codex App 之前建议先准备三个基础工具Node.jsGitVS Code这三个工具对 AI 编程非常重要。为什么要安装 Node.jsNode.js 可以让你的电脑运行 JavaScript 项目。很多网页项目、前端项目以及codex cli、claude code等Agent都需要 Node.js。为什么要安装 GitGit 是版本控制工具。它可以帮你保存项目的历史版本。这对 AI 编程特别重要因为 Codex 有时会一次修改很多文件。如果改得不好你需要能快速回到上一个稳定版本。没有 Git就像没有“撤回保险”。为什么要安装 VS CodeCodex App 可以查看和修改文件但它不是完整的传统代码编辑器。真正需要精细编辑代码时VS Code 仍然非常有用。你可以把 Codex 当作 AI 执行者把 VS Code 当作人工检查和手动修改工具。3. 安装 Node.js第一步打开 Node.js 官网在浏览器中搜索Node.js下载进入 Node.js 官方下载页面。第二步选择适合自己系统的版本如果你是 Windows 用户一般下载 Windows Installer。如果你是 Mac 用户一般下载 macOS Installer。对于新手推荐选择 LTS 版本。LTS 的意思是长期支持版稳定性更好。第三步运行安装包双击下载好的安装包。安装时通常一路点击Next → Next → Install → Finish大多数新手不需要修改默认选项。第四步验证安装是否成功安装完成后打开终端。Windows 用户可以打开 PowerShell 或 CMD。Mac 用户可以打开 Terminal。输入node-vnpm-v如果看到类似下面的版本号说明安装成功v24.15.011.12.1版本号不一定和这里完全一样只要能正常显示即可。4. 安装 Git第一步打开 Git 官网在浏览器搜索Git下载进入 Git 官方下载页面。第二步下载对应系统的安装包Windows 用户通常选择 64-bit Git for Windows。Mac 用户可以下载安装包也可以通过 Homebrew 安装。但对于新手使用官网安装包最简单。第三步运行安装程序双击安装包。新手可以保持默认设置一路点击 Next。安装过程中可能出现很多选项比如默认编辑器、PATH 配置、换行符处理等。刚开始不用纠结默认配置通常就够用。第四步验证 Git 是否安装成功打开终端输入git--version如果看到类似下面的结果就说明安装成功gitversion2.54.0.windows.15. 安装 VS Code第一步打开 VS Code 官网在浏览器搜索VS Code下载进入 Visual Studio Code 官网。第二步下载安装包根据你的系统下载 Windows 或 macOS 安装包。第三步完成安装双击安装包按照提示安装即可。Windows 用户安装时可以勾选以下选项Add to PATHRegister Code as an editor for supported file typesAdd “Open with Code” action to Windows Explorer file context menuAdd “Open with Code” action to Windows Explorer directory context menu这些选项可以让你以后更方便地从文件夹直接打开 VS Code。安装完后进入软件的扩展商店安装codex插件方便在vscode中使用codex。6. 下载并启动 Codex App第一步打开 Codex 官网在浏览器中搜索 Codex App 或通过 ChatGPT / OpenAI 相关入口进入 Codex 下载页面。第二步下载对应系统安装包Codex App 支持 Windows 和 Mac。官网通常会根据你的系统自动提供合适的安装包。第三步安装 Codex App双击安装包根据引导完成安装。安装完成后打开 Codex App。7. 登录 ChatGPT 账户Codex App 启动后会要求登录 ChatGPT 账户。操作步骤点击登录按钮。在浏览器中完成 ChatGPT 账户登录。授权 Codex App 使用账户。回到 Codex App。登录后你可能会看到一些初始化页面例如选择使用场景、工作类型、插件推荐等。注意不同账户类型的可用额度可能不同。你应该以自己登录后页面显示的信息为准。8. 完成首次初始化首次进入 Codex 时可能会让你选择使用场景。常见问题包括你主要用 Codex 做什么你是否偏向编程任务你是否需要插件或 Skills是否要设置沙箱对于新手可以这样选择工作类型编程、网页开发、日常任务。插件暂时保持默认。沙箱按照向导完成初始化。初始化完成后你就可以进入主界面了。9. 看懂 Codex App 的三栏布局Codex App 的界面大体可以分成三部分区域作用左侧栏管理项目、对话、任务、插件、自动化中间区输入需求、查看执行过程、审批权限右侧区显示浏览器、文件树、终端、预览和批注9.1 左侧栏管理项目和任务左侧栏像是 Codex 的“任务管理区”。你可以在这里看到新建对话按钮项目列表正在运行的任务历史对话搜索入口插件入口自动化入口常用快捷键功能WindowsMac新建对话Ctrl NCommand N搜索对话Ctrl GCommand G注意搜索功能通常更适合搜索对话标题不一定能完整搜索每一句聊天内容。9.2 中间区和 Codex 对话的地方中间区域是最重要的交互区域。你可以在这里输入任务需求查看 Codex 的执行过程批准或拒绝权限申请上传图片或文件选择模型或推理强度开启计划模式查看上下文用量9.3 右侧区浏览器、文件树、终端和预览右侧区域会根据任务自动变化。例如Codex 创建网页时右侧可能显示浏览器预览。Codex 修改代码时右侧可能显示文件树。Codex 运行命令时右侧可能显示终端。你对网页做批注时右侧可能显示批注界面。10. 本篇小结与检查清单完成本篇后你应该已经做到安装了 Node.js。安装了 Git。安装了 VS Code。安装并启动了 Codex App。登录了 ChatGPT 账户。完成了 Codex 首次初始化。看懂了 Codex 的三栏布局。新手检查清单请逐项确认[ ] node -v 能输出版本号 [ ] npm -v 能输出版本号 [ ] git --version 能输出版本号 [ ] VS Code 可以正常打开 [ ] Codex App 可以正常登录 [ ] 我知道左侧栏是项目和任务区 [ ] 我知道中间区是对话和审批区 [ ] 我知道右侧区可以显示浏览器、文件树和终端下一篇我们会正式创建项目文件夹并学习 Codex 的项目、对话、多任务并行、沙箱和权限控制。