第 1 篇 Codex 安装与基础使用

安装、认证与环境验证━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━用途指导用户完成 OpenAI Codex CLI 的安装、认证和环境验证并提供基础命令用法。安装路径按优先级推荐npm跨平台最常用需 Node.js 22npm install -g openai/codexcodex --version官方一键脚本# macOS / Linuxcurl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows (PowerShell)powershell -ExecutionPolicy ByPass -c irm https://chatgpt.com/codex/install.ps1 | iexHomebrewmacOSbrew install --cask codex独立二进制从 github.com/openai/codex Releases 下载对应平台 tar.gz无 Node 依赖适合服务器/CI桌面 AppWindows 从 Microsoft Store 搜 OpenAI Codex或终端运行 codex app环境要求Node.js 22npm 方式、Git 2.23、内存 4GB推荐 8GBWindows官方已有原生 PowerShell 安装路径WSL2 体验仍最稳定wsl --install 后在 WSL 内装 Node 22认证二选一方式 A推荐ChatGPT 账号登录——首次运行 codex 弹浏览器授权需 Plus/Pro/Team/Edu/Enterprise 付费订阅Plus 约每 5 小时 30-150 次交互方式 BAPI Key——适合脚本/CIexport OPENAI_API_KEYsk-... # macOS/Linux$env:OPENAI_API_KEYsk-... # Windows PowerShell警告不要把 Key 写进 shell 配置文件并提交 Git。基础命令速查codex # 交互模式(建议在 git 仓库内)codex 解释这个代码库 # 单条任务codex --full-auto ... # 全自动(先开 git 分支!)codex exec ... # 无界面模式(CI)codex resume --last # 恢复上次会话git diff | codex 总结改动 # 管道输入会话内/model 换模型、/review 审查、/init 生成 AGENTS.md、/permissions 调权限。审批模式安全旋钮Suggest默认改动需批准→ Auto Edit自动改文件、命令需批准→ Full Auto全自主受 OS 级沙箱约束。新手先用 Suggest 跑熟。验证安装成功codex --version # 有版本号输出codex # 能进入交互界面并完成登录若报错转用 codex-troubleshooting 技能排查。