AI Agent / 系统课时

安装 Codex CLI

安装 Codex CLI

本课完成 Codex CLI 的安装与命令验证。你可以使用官方独立安装脚本,也可以选择 npm 或 Homebrew;无论采用哪条路径,最终都应确认终端能找到 codex,并能输出版本信息。

学习目标

  • 根据操作系统选择官方安装方式
  • 验证 codex 命令和版本输出
  • 处理 PATH、权限和重复安装问题

使用官方安装脚本

macOS 或 Linux 可在终端执行官方独立安装脚本,并立即检查版本。

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

预期输出

text
codex-cli <VERSION>

Windows 可在 PowerShell 中执行对应安装脚本。安装完成后关闭并重新打开终端,再检查版本。

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version

预期输出

text
codex-cli <VERSION>

<VERSION> 是当前安装版本,实际数字会随发布变化。如果脚本执行成功但命令仍不可用,通常是新安装目录尚未进入当前终端的 PATH。

使用包管理器安装

已经配置 Node.js 与 npm 的环境,可以执行 npm install -g @openai/codex。macOS 用户也可以执行 brew install --cask codex。包管理器路径便于统一升级,但应避免同时用多种方式安装,以免终端命中旧版本。

安装后仍以 codex --version 作为最小验证。若版本与预期不一致,先检查命令实际位置,再决定删除旧安装或调整 PATH 顺序。

启动首次会话

进入一个 Git 仓库并运行 Codex。首次启动会引导选择 ChatGPT 登录或其他可用认证方式。

bash
cd <PATH>
codex

预期结果

text
Codex 进入交互界面;未登录时先显示认证引导。

<PATH> 替换为练习仓库路径。不要从用户主目录直接启动首次任务,否则智能体可能面对过大的文件范围,也不利于审查改动。

处理典型安装失败

出现“command not found”或“无法识别 codex”时,先重启终端并检查 PATH。npm 安装还应确认全局可执行目录已加入 PATH;不要习惯性使用管理员权限绕过配置问题。

如果网络下载失败,检查代理、DNS、TLS 证书和企业安全策略。重复运行官方安装脚本可用于安装或更新独立版本,但不要从不明镜像下载安装包。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Codex CLI

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通