最近实践了Codex Cli编程,把一些使用体会积累下来。
一、上车Codex
在国内某鱼二手平台搜索"codex拼车"可以花十几块钱体验ChatGPT最新的模型,同时利用最新的gpt-5.1-codex-max high开启Codex Cli之旅。
二、Codex Cli是什么
Codex Cli是一个终端编程工具,整个过程都是在终端完成的。
三、安装Codex Cli
进入官网 安装,按照步骤安装即可。
四、了解终端的指令
Mac电脑上终端就是"终端.app",终端的简单使用命令如下,可以看一下下面的表格:
| 目标场景 | 命令示例 | 说明 |
|---|---|---|
返回用户主目录 (/Users/你的用户名) |
cd 或 cd ~ |
最简单的命令,让你迅速"回家"。 |
| 进入当前目录的某个子文件夹 | cd Documents |
使用相对路径,进入当前目录下的 "Documents" 文件夹。 |
| 进入任意指定路径 | cd /Users/你的用户名/Desktop |
使用绝对路径,可以从任何地方直接跳转到目标路径。 |
| 返回上一级目录 | cd .. |
一个点代表当前目录,两个点代表上级目录。 |
| 返回上两级目录 | cd ../.. |
返回上两级目录。 |
| 回到之前的目录 | cd - |
在两个目录之间快速切换,非常方便。 |
| Tab键补全 | 输入部分路径后按Tab键 | 自动补全路径或文件名,按两次Tab可列出所有匹配项。 |
| 查看当前目录内容 | ls |
列出当前路径下的所有文件和文件夹。 |
PS:如果已经进入了Codex,可以在前面加!使用终端的指令。
五、了解Codex的斜杠命令
Codex CLI 内置斜杠命令一览
下面这些命令都要在 已进入 Codex 交互界面后 使用:
-
/model
切换当前使用的模型和推理强度,比如在 gpt-5-codex 和 gpt-5 之间切。
-
/approvals
设置 Codex 的授权模式(Auto / Read Only / Full Access),控制能否自动改文件、跑命令等。
-
/review
让 Codex 审查当前工作目录中的代码改动(本地 git diff),找问题、提建议。
-
/new
在同一个 Codex 进程里开启一段新的对话,清空上下文但还在当前代码仓库下继续工作。
-
/init
在当前目录生成一个 AGENTS.md 模板文件,用来写给 Codex 的"项目说明书",长期指导它怎么干活。
-
/compact
把当前对话内容压缩成总结,释放上下文长度,防止"上下文爆掉"。
-
/undo
撤销 Codex 上一次操作(包括文件修改 / 命令执行),恢复到之前的状态。
-
/diff
查看当前 git diff(包括未跟踪文件),方便你在提交前检查 Codex 改了什么。
-
/mention
把某个文件/目录"点名"加入上下文,例如:
kotlin/mention src/lib/api.ts
之后它会重点参考这个文件。
-
/status
查看当前会话状态:正在用哪个模型、审批策略、可写目录、token 使用情况等。
-
/mcp
列出已配置的 MCP(Model Context Protocol)工具,比如你接了浏览器、数据库之类的额外工具时,可以看 Codex 当前能调用哪些。
-
/prompts
自定义了prompts可以触发
-
/skills
自定义了skills可以触发
-
/logout
退出 Codex 登录状态,清除本机保存的认证信息(共享电脑上挺有用)。
-
/quit
退出 Codex CLI,结束当前会话。
-
/exit
和 /quit 一样,也是退出 Codex 的别名。
-
/feedback
把日志发送给 Codex 维护团队,用来报 bug 或反馈问题。
六、初始化项目
进入项目根目录,输入codex回车。然后输入斜杠命令/init,等待一段时间后,项目的根目录会生成一个文件AGENTS.md,这是一份Markdown文件,是Codex总结的一些项目规范,是所有Agent读取项目时生成、创建、修改的基础规范准绳。自己也可以往里面添加,只要是项目的规范都可以加在里面,让所有的Agent都遵循规则。
AGENTS.md不需要加入忽略,上传到仓库管理。
七、选择模型
输入斜杠命令/model, 选择Codex使用的模型,我现在使用的是gpt-5.1-codex-max high。