第 2 章
入门
12 分钟2 / 8安装与登录:从零跑通工具链
安装 Node、Codex CLI、IDE 扩展,完成账号登录,并验证版本与权限。
安装
CLI
登录

本章目标:在本机装好 Codex,能在终端打开交互会话,并在 VS Code 系编辑器中看到 Codex 面板。全程约 10–15 分钟。

前置条件
- Node.js 18+(推荐 LTS;可用 node -v 检查)
- Git 与一个本地项目目录(任意小型仓库即可)
- ChatGPT / OpenAI 账号(按你的订阅与区域策略登录)
- 可选:VS Code、Cursor 或 Windsurf(装 IDE 扩展)
安装 Codex CLI
官方 CLI 包名为 @openai/codex。全局安装后,任意目录都能启动会话:
bash·全局安装
npm i -g @openai/codex
# 验证
codex --version登录
- 1
启动登录流程
在终端运行 codex,按提示完成浏览器或设备码登录。首次会写入本地凭证配置。
- 2
确认身份
登录成功后,CLI 应能创建会话。若失败,检查网络代理、系统时间与账号权限。
- 3
进入项目目录
cd 到你的仓库根目录再启动。工作目录决定智能体默认看到的文件系统范围。
bash·第一次交互会话
cd ~/projects/my-app
codex
# 或带初始提示
codex "用三句话总结这个仓库的技术栈与启动方式"安装 IDE 扩展
在 VS Code / Cursor / Windsurf 中搜索并安装 OpenAI 的 Codex / ChatGPT 扩展(扩展 ID 常见为 openai.chatgpt,以商店当前名为准)。
- 打开扩展市场,搜索 Codex 或 OpenAI
- 安装后重启窗口(Reload Window)
- 点击活动栏中的 Codex 图标;若没有,用命令面板搜索 “Codex”
- 用与 CLI 相同的账号登录;配置通常可共享
冒烟检查清单
| 检查项 | 期望结果 |
|---|---|
| codex --version | 打印版本号,无 command not found |
| 在仓库内 codex 只读提问 | 能描述目录与 package.json 等 |
| IDE 侧边栏打开 | 可发送消息并看到回复 |
| 审批 / 权限提示 | 改文件或跑命令前有策略相关提示 |
常见问题
- 找不到命令:检查 PATH、npm 全局 bin 是否在 shell 配置中
- 登录循环:清缓存后重登;检查浏览器是否拦截弹窗
- 模型/额度错误:确认订阅与组织策略是否包含 Codex
- 沙箱/权限过严:先用只读任务验证,再逐步放宽(见安全章)