图形界面玩顺之后,几乎所有人都会动同一个心思:把 Codex 挪进真实项目里去。Codex CLI 就是奔这个来的,它是命令行版本的 Codex,往 PowerShell、Terminal,iTerm 里一装,跟工程师的日常贴得更近。这篇按我实际摸过的顺序,把安装、登录,命令,沙盒一次交代完。
装之前先挑对包。Mac 和 Linux 走 npm,先确认 Node.js 在不在,终端分别敲 node -v 和 npm -v,版本号能蹦出来就没问题,然后一行搞定:npm install -g @openai/codex。Homebrew 党换 brew install --cask codex,殊途同归,纯看口味。Windows 建议开 PowerShell 或 Windows Terminal 操作,Node.js 先装好,npm 那行照跑,最后 codex --version 收个尾。有条提醒我必须放在最前面:头一回运行,离系统目录远点,C 盘根目录、桌面,下载夹,放着重要资料的目录统统别当工作区,老老实实先建个练习目录,比如 D:\AI-Codex-Projects\hello-codex,在里面练到手熟再碰正经项目。
头一次敲 codex,它先要你登录。新手走 ChatGPT 账号,codex login 跑起来,选 Sign in with ChatGPT,浏览器自动弹页,登成功凭证传回终端,花的额度算在 ChatGPT 套餐里。另一本是 API Key,给自动化脚本、CI/CD,服务器任务准备的。上 OpenAI Platform 建 Key,走环境变量登录,Windows PowerShell 写法是 env:OPENAI_API_KEY=”你的APIKey”,再 env:OPENAI_API_KEY | codex login --with-api-key。丑话两句:这本账按 Platform API 用量计费,规则没摸透前别让它长时间空转。Key 是极度敏感的东西,进代码,发别人,截屏外传,传 GitHub,这四件事一件都不许,真泄露了第一动作是回 Platform 删了重生成。命令敲错顶多重来一遍,这两条错了才是真麻烦。

命令分两拨,一拨在终端里敲,一拨进了会话用斜杠调。先说终端这拨。最常见的姿势是光杆 codex 敲下去,会话起来,任务直接带着走,codex “请解释这个项目结构” 这种一句话就开跑。手里有张报错截图,codex -i ./error.png 递进去,让它自己分析。人不在项目目录里也没关系,codex --cd 项目路径 指过去再启动。启动前拿不准环境,codex doctor 自动出一份诊断报告,省得瞎猜。上次的活干一半断了,codex resume --last 接着干,这条我几乎天天用。登录进出也在这拨。codex login 登录,codex login status 查状态,登没登对一查就有,codex logout 退出。任务干完归档用 codex archive,列表一下清爽。Codex 版本更新了,codex update 拉新版。不想进交互界面、只想让它干完就跑,codex exec “任务”,自动化场景里最好使。
进了会话,敲 / 快捷键菜单全出来。平时挂手边最多的是 /model,模型和推理强度在这调。日常默认模型加中档,难缠的 bug 提到高推理,改文案这种直接压到低档。文件改完必看 /diff,它把改动摊给你,没有例外。复杂活先要方案,/plan 开计划模式。新项目头一回跑 /init,生成 AGENTS.md 项目规则。上下文太长,/compact 压一压。要看当前模型、权限,上下文,/status 一下就有数。收工 /quit。
沙盒按权限分三档。read-only 光看不动手,做纯分析选它。workspace-write 项目内可读可写,日常主力。danger-full-access 围栏全拆,新手看见绕着走。最稳的启动姿势复制这段:codex --sandbox workspace-write --ask-for-approval on-request,人话翻译:项目里随便干活,敏感动作先打报告。
见到这几条,先停手。--sandbox danger-full-access 文件网络限制全开。--yolo 审批和沙盒一起免。rm -rf 一口气能删掉一大片。git reset --hard 没存的东西当场蒸发。curl xxx | sh 下什么执行什么。这几条新手统统跳过,别好奇。拿不准的命令有现成的裁判,直接问 Codex 自己,让它解释这条命令的作用和风险,有没有更安全的替代写法。
正常干活是这么一圈。cd 进项目,git status 看一眼改动。codex 启动,任务丢进去,/diff 看它改了什么,再拿 git diff 复核一遍。没问题就 git add . 加 git commit 存一版。收尾 codex archive 归档,或者 /quit 退出。这一圈跑顺,Codex CLI 就算上手了。下一篇讲剩下两个入口,编辑器里的 IDE 插件,还有跑云端的 Codex Web。