08 · CLI 入门:安装、会话与常用操作
CLI 的启动、交互界面、模型和权限选择、文件引用、差异审查与会话恢复。
CLI 是 Codex 最原始、也最灵活的形态。理解了它,你就理解了 Codex 的底层运转方式。
启动很简单,在项目目录里敲一条启动命令即可。启动后你会进入一个交互界面,这个界面通常可以「对话」,也可以切到「命令」模式执行一些内置指令。
进入之后,有两件事常常需要你选:用哪个模型、用哪种权限模式。模型决定「大脑的档位」,权限模式决定「它敢不敢放手干」。这两个选择,直接决定了任务的风格和风险。
「文件引用」是 CLI 里很实用的一个技巧。你可以把某个具体文件「喂」给它,让它聚焦在这个文件上,而不是让它自己去猜。这对于「就改这一个文件」这种精确任务尤其好用。
「差异审查」在 CLI 里同样重要。任务跑完后,用 diff 命令看改动,是必须养成的习惯。CLI 的好处是你可以把它和 Git 命令无缝衔接。
「会话恢复」解决的是「关了终端就没了」的痛点。CLI 支持保存和恢复会话,让你下次能接着上次的上下文继续,而不是从头开始。
常用的操作其实就那几类:启动、换模型、换权限、引用文件、看差异、恢复会话。把这些摸熟,CLI 的基本功就扎实了。
CLI 还有一个隐藏价值:它能被脚本调用。这意味着你可以把 Codex 嵌进你的自动化流程里。这一点后面第五组的「非交互模式」会专门展开,现在先知道有这个能力即可。
常见误区:很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」,理解了动机,规则就自然内化了,不用死记硬背。
五分钟练习:① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来,你对这一篇的理解会深 3 倍。
与其他篇的关系:这一篇是本组的基础。如果你跳过了前面几篇,建议先回去看,否则这里有些概念可能看着突兀。如果都看过了,那你可以直接进入更后面的实战环节,把这里学到的东西用上。
一页速览:如果只能记三件事,① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。