AI Agent / 系统课时
安装 Codex CLI
安装 Codex CLI
本课完成 Codex CLI 的安装与命令验证。你可以使用官方独立安装脚本,也可以选择 npm 或 Homebrew;无论采用哪条路径,最终都应确认终端能找到 codex,并能输出版本信息。
学习目标
- 根据操作系统选择官方安装方式
- 验证
codex命令和版本输出 - 处理 PATH、权限和重复安装问题
使用官方安装脚本
macOS 或 Linux 可在终端执行官方独立安装脚本,并立即检查版本。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version预期输出
codex-cli <VERSION>Windows 可在 PowerShell 中执行对应安装脚本。安装完成后关闭并重新打开终端,再检查版本。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version预期输出
codex-cli <VERSION><VERSION> 是当前安装版本,实际数字会随发布变化。如果脚本执行成功但命令仍不可用,通常是新安装目录尚未进入当前终端的 PATH。
使用包管理器安装
已经配置 Node.js 与 npm 的环境,可以执行 npm install -g @openai/codex。macOS 用户也可以执行 brew install --cask codex。包管理器路径便于统一升级,但应避免同时用多种方式安装,以免终端命中旧版本。
安装后仍以 codex --version 作为最小验证。若版本与预期不一致,先检查命令实际位置,再决定删除旧安装或调整 PATH 顺序。
启动首次会话
进入一个 Git 仓库并运行 Codex。首次启动会引导选择 ChatGPT 登录或其他可用认证方式。
cd <PATH>
codex预期结果
Codex 进入交互界面;未登录时先显示认证引导。<PATH> 替换为练习仓库路径。不要从用户主目录直接启动首次任务,否则智能体可能面对过大的文件范围,也不利于审查改动。
处理典型安装失败
出现“command not found”或“无法识别 codex”时,先重启终端并检查 PATH。npm 安装还应确认全局可执行目录已加入 PATH;不要习惯性使用管理员权限绕过配置问题。
如果网络下载失败,检查代理、DNS、TLS 证书和企业安全策略。重复运行官方安装脚本可用于安装或更新独立版本,但不要从不明镜像下载安装包。