摘要： 别再跟AI“闲聊”写代码了，是时候让它自己动手了。OpenAI Codex CLI 不仅仅是个问答机器人，更是一个能读代码、改文件、跑命令的“AI实习生”。本文旨在帮你跳过繁琐的文档，5分钟内从零完成环境检查、安装、登录，并亲手跑通第一个自动化任务。更有防坑指南与高阶交互技巧，让你真正把AI用成生产力工具，而不是聊天玩具。
如果你还在复制粘贴ChatGPT生成的代码片段，那你可能还没意识到：AI编程早就进入了“Agent（智能体）”时代。现在的AI不再是只会动嘴的军师，而是能直接在你的终端里敲键盘、改文件、跑测试的实干家。
OpenAI推出的Codex CLI就是这样一位“AI搭档”。与Cursor这类AI IDE不同，Codex的本质是编码代理，重点在于替你读代码、改代码、跑命令、执行任务。它不挑编辑器，只要你有个终端，它就能干活。
废话不多说，我们直接上手。
一、上岗前的体检：环境与门票
很多人上来就敲安装命令，结果卡在各种依赖上。先别急，确认两件事：工具链和门票。
1. 底层环境：Node.js
Codex CLI基于Node.js开发，没它寸步难行。官方建议Node.js版本至少≥18，推荐22+以避免兼容性问题。打开终端，依次输入：
node -v npm -v
看到版本号心里才有底。如果提示找不到命令，先去装Node.js。另外，Windows用户特别注意：官方提到Windows支持目前偏“实验性”，更稳妥的方式是使用WSL（Windows Subsystem for Linux）环境，能帮你避开很多权限和路径的坑。
2. 门票：ChatGPT订阅
这是最容易卡壳的地方。Codex并非独立售卖，它已包含在ChatGPT的Plus、Pro、Team及Enterprise等订阅计划中。想用它，你得先有个能用的ChatGPT付费账号。当然，如果你是API玩家，也可以通过Key来调用，但对于新手来说，直接用ChatGPT账号登录是最省心的。
二、5分钟极速安装与登录
确认好环境，接下来的动作要快。
1. 一键安装
无论你是Mac还是Linux，只需一行命令：
npm install -g @openai/codex
Mac用户如果习惯用Homebrew，也可以直接 brew install codex。
装完别忘了验货，这很重要：
which codex codex --version
如果 which codex 没返回路径，或者 --version 没输出版本号，说明PATH没配好，这时候去排查环境变量，别怀疑Codex本身。
2. 灵魂认证：登录
命令装好了≠能用。还得认证。最直接的方式：
codex login
终端会启动一个本地服务并弹窗让你在浏览器里登录ChatGPT账号授权。如果没有自动弹窗，手动复制终端里给出的URL到浏览器打开即可。登录完成后，务必确认状态：
codex login status
只有看到“Logged in using ChatGPT”之类的字眼，才说明认证畅通。如果你没有订阅，想用API Key，可以通过环境变量 OPENAI_API_KEY 或者在 ~/.codex/auth.json 中配置。
三、第一次派活：千万别搞大动作
进入你想操作的项目目录，输入 codex 启动交互界面。这时候你会看到Model和Directory信息，一定要先确认Directory是不是你的目标目录，这是新手最常翻车的地方。
接着，别急着让它“重构整个系统”。就像带新人，先给个简单明确的任务试试水。比如原文中的例子就非常好：“创建一个C语言的计算阶乘的程序，测试并运行”。
下达指令后，别光盯着结果，观察它的动作节奏：
先侦察：它会先跑
pwd、ls看看自己在哪，目录里有啥。再动手：写代码，并且是考虑周全的代码（比如包含了错误输入处理）。
后验证：它会自己编译，跑正常输入，跑边界值（0和20），甚至跑非法输入（负数或字母）来验证鲁棒性。
这比那种只会生成一段代码让你自己测的工具强太多了，这才是Agent该有的样子。
四、别被坑惨了：高阶交互与潜规则
Codex的交互界面看似简单，实则暗藏玄机。不懂这些，你会觉得自己在跟一个智障对话。
1. 想跑命令？加个“！”
这是最常踩的坑！在Codex里直接输入 ls 或 pwd，它会把这当成你跟它聊天的文字，而不是要在终端执行的命令。想让它在本地Shell里干活，必须加叹号前缀：!ls、!pwd、!rg --files。
2. “@”锁定上下文
大项目里文件繁多，如果你只让它改某个文件，别让它全盘扫描。用 @文件名 的方式直接把相关文件拽进上下文，比如 @factorial.c 修复这里的内存泄漏。这能极大节省Token，防止它“幻觉”。
3. 安全模式的选择
Codex提供了几种权限模式：
Suggest模式：只读，改任何东西都要你确认。新手推荐。
Auto Edit模式：能自己改文件，但跑命令要你确认。日常开发最常用。
Full Auto模式：全自动，但在沙箱里断网运行。适合跑测试和批量修改。
4. 斜杠命令提效
/model：随时切换模型或推理强度（比如从medium切到xhigh应对复杂逻辑）。/compact：聊太长上下文爆了？用它压缩记忆。/review：让它审查一下当前的改动，找找Bug。/new：清理上下文，开始新话题。
五、生存备忘录
最后，把关键操作浓缩成一张表，存下来备用：
| 操作 | 命令/技巧 | 核心提醒 |
|---|---|---|
| 环境检查 | node -v / npm -v | 必须Node 18+，Windows建议WSL |
| 安装 | npm install -g @openai/codex | 装完查 which codex |
| 登录 | codex login | 需ChatGPT Plus/Pro订阅 |
| 状态确认 | codex login status | 别装完就用，确认登录成功 |
| 启动 | cd 项目目录 后输入 codex | 务必确认Directory路径正确 |
| 执行Shell | !ls / !pwd | 不加 ! 就是闲聊，加了才是命令 |
| 文件引用 | @filename | 锁定上下文，省钱防呆 |
| 任务节奏 | 小任务起步，先规划后执行 | 不要一上来就“重构宇宙” |
最后一句忠告：Codex再强，也是个“实习生”。你负责架构和Review，它负责搬砖。用好Git做Checkpoint，出了错随时回滚，这才是AI时代开发者的正确姿势。
文章来源：大国Ai导航 及 网络公开资料整理
