Codex CLI，一个跑在终端里的 AI 程序员

删 console.log、补单元测试 … ——这些重复劳动占用了大量时间，却几乎不产生价值。它们不复杂，但足够琐碎，足以打断一整段心流。

Codex CLI 的出现，就是为了把这些脏活接过去。它是一个跑在终端里的 AI 编程师：读代码、改文件、跑命令、反复迭代，直到任务完成。

不过在开始之前，很多人会纠结一个问题：Codex CLI 和桌面应用到底有什么不同？我该用哪个？

一、为什么选 CLI ？

**

  • 终端是主战场的人

如果你日常工作就是泡在终端里的，用 npm/pnpm 跑构建——那么 CLI 对你来说就是最自然的选择。

Codex CLI 的核心理念是 把整个编码循环塞进终端：读文件、改内容、跑命令、做审查，全程不需要切换界面。从打开终端到开始干活，中间没有 IDE 加载、没有窗口切换，路径最短，干扰最少。

**

  • 追求自动化与无人值守的人

****这是 CLI 区别于桌面应用最独特的能力。CLI 支持非交互模式，可以放进脚本里调用，****这意味着你可以把 Codex 当成自动化流水线的一环——提交前做代码审查、自动补测试、生成文档，全程无人值守。这是图形界面永远做不到的事情。

**

  • 追求极致和相应速度的人

**

装完就能用，不用先装一堆运行时依赖。启动快、内存小、响应猛，对于需要频繁调用的场景来说，体验差距非常明显。

💡 两者并非只能二选一。它们共享同一套账号体系，你可以同时安装，在日常开发中用 CLI 快速处理小任务，在需要并行或审查时切到桌面应用，灵活切换。

二、安装与快速上手

Codex CLI 有几种安装方式

|  平台

|

命令

 macOS (Homebrew)

| brew install --cask codex | |

 macOS/Linux (脚本)

| curl -fsSL https://chatgpt.com/codex/install.sh | sh | |

 npm (跨平台)

| npm install -g @openai/codex |

安装完即可使用，但还需要做一些配置认证方式和 config.toml 核心配置。

codex支持两种方式认证

  • 方式一：ChatGPT 账号登录
<span leaf="">codex</span>

首次运行会自动唤起浏览器，选择 Sign in with ChatGPT 完成授权即可。适合有 ChatGPT Plus/Pro 订阅的用户，凭据会缓存在 ~/.codex/auth.json，后续无需重复登录。

  • 方式二：API Key 环境变量
<span leaf=""><span>export</span>&nbsp;<span>OPENAI_API_KEY</span>=<span>"sk-你的API密钥"</span></span>

核心配置文件：~/.codex/config.toml，config.toml 是 Codex CLI 的持久配置入口，可以统一管理模型、沙盒权限、审批策略等。

配置示例

<span leaf=""><span># ========================================================</span></span>

关键字段说明：

  • model：默认使用模型

  • approval_policy ：是否在敏感操作前征求确认

  • sandbox_mode：沙盒权限：控制 AI 能访问和修改的范围

接入第三方关键字段

  • base_url：API 端点地址，必须以 /v1 结尾

  • env_key：API Key 对应的环境变量名（不是直接写 Key 字符串）

  • wire_api：使用Responses API 的 Provider 需设置为 "responses"（OpenAI 已废弃 chat/completions 路径）

三、Codex CLI 实用的命令

命令体系分为：交互 / 非交互模式、斜杠命令（Slash Commands） 和启动参数

交互 / 非交互模式

| |

适用场景
codex

进入 TUI 界面，进行多轮对话、审查和迭代

| | codex "重构这个组件" |

直接带着任务启动交互会话

| | codex exec "运行测试" |

脚本化、CI/CD 自动化，执行完自动退出

| | codex -q "更新 CHANGELOG" |

不输出 UI，仅输出结果，适合流水线

|

**

斜杠命令

**

在交互会话中，输入 / 会弹出命令面板，以下是按用途分类的常用命

  • 会话控制

| |

说明
/status

查看当前会话配置：模型、工作目录、权限策略、上下文使用情况

| | /clear |

清空对话历史，保留配置，适合重启话题

| | /reset |

完整重置，清空对话历史和会话状态

| | /compact |

压缩长对话上下文，上下文窗口即将超限时用来“续命”

| | /resume |

恢复之前的会话（配合 --last 可恢复最近一次）

| | /fork |

克隆当前对话到新线程，适合尝试不同方案

| | /quit

 / /exit

|

退出 Codex

|

  • 代码审查与开发类

| |

说明
/review

触发代码审查，启动专用子代理检查 Bug、安全、可维护性，输出 P0-P3 优先级问题和正确性结论。不会修改代码，自动退出

| | /plan |

计划模式：只规划不执行，让 Codex 先给出方案再决定是否动手

| | /diff |

查看当前 Git 差异，了解 AI 准备改动哪些文件

| | /init |

在项目里创建 AGENTS.md，新项目建议第一步就做这个

|

  • 配置与模型类

| |

说明
/model

在会话中切换模型，如 /model gpt-4o、/model o1-mini

| | /approval |

切换审批模式：suggest、auto-edit、full-auto

| | /sandbox |

调整沙盒权限：read-only、workspace-write、danger-full-access

| | /goal | 新功能

：设定持续目标，Codex 会循环 计划→执行→测试→审查，直到满足停止条件

| | /personality |

切换性格：friendly（话多热情）、pragmatic（干练务实）、none（纯工具人）

|

  • 工具与技能类

| |

说明
/use

显式加载一个 Skill，如 /use pdf-editor

| | /skills |

浏览和插入可用技能

| | /mcp |

列出已连接的 MCP 工具

| | /apps |

管理 ChatGPT App Connectors，列出已连接和可安装的应用

|

四、总结

Codex CLI 不是“会聊天的 AI”，而是“能动手的 AI 程序员”。它把你终端变成一个 AI 驱动的编码工作台，让那些琐碎、重复、耗时的“脏活”不再消耗你的注意力。

掌握这些命令，你就能在终端里游刃有余地驾驭 Codex，把 AI 变成真正的协作伙伴。

你已经在用 Codex CLI 了吗？最常用的命令是哪个？欢迎在评论区聊聊。