第 2 章
入门
12 分钟2 / 8

安装与登录:从零跑通工具链

安装 Node、Codex CLI、IDE 扩展,完成账号登录,并验证版本与权限。

安装
CLI
登录

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

安装 Codex 包与安全登录示意
安装只是第一步;登录与权限策略决定你敢不敢让它动仓库

前置条件

  • 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. 1

    启动登录流程

    在终端运行 codex,按提示完成浏览器或设备码登录。首次会写入本地凭证配置。

  2. 2

    确认身份

    登录成功后,CLI 应能创建会话。若失败,检查网络代理、系统时间与账号权限。

  3. 3

    进入项目目录

    cd 到你的仓库根目录再启动。工作目录决定智能体默认看到的文件系统范围。

bash·第一次交互会话
cd ~/projects/my-app
codex

# 或带初始提示
codex "用三句话总结这个仓库的技术栈与启动方式"

安装 IDE 扩展

在 VS Code / Cursor / Windsurf 中搜索并安装 OpenAI 的 Codex / ChatGPT 扩展(扩展 ID 常见为 openai.chatgpt,以商店当前名为准)。

  1. 打开扩展市场,搜索 Codex 或 OpenAI
  2. 安装后重启窗口(Reload Window)
  3. 点击活动栏中的 Codex 图标;若没有,用命令面板搜索 “Codex”
  4. 用与 CLI 相同的账号登录;配置通常可共享

冒烟检查清单

检查项期望结果
codex --version打印版本号,无 command not found
在仓库内 codex 只读提问能描述目录与 package.json 等
IDE 侧边栏打开可发送消息并看到回复
审批 / 权限提示改文件或跑命令前有策略相关提示

常见问题

  • 找不到命令:检查 PATH、npm 全局 bin 是否在 shell 配置中
  • 登录循环:清缓存后重登;检查浏览器是否拦截弹窗
  • 模型/额度错误:确认订阅与组织策略是否包含 Codex
  • 沙箱/权限过严:先用只读任务验证,再逐步放宽(见安全章)