GitHub 今日 Trending 榜首是一枚老面孔的新爆发：openai/codex，目前 11.3 万 stars，仅今天一天就涨了 1.7 万。它的定位一句话就能说清：一个跑在你本地终端里的编码智能体。代码全部在你的机器上执行，模型通过自然语言驱动它完成读目录、改文件、跑命令、提 PR 这一整套开发动作。

项目是什么

Codex CLI 是 OpenAI 开源的轻量编码代理，用 Rust 编写。它和那些「只能聊天的对话助手」最大的不同，是它真的能动手——在终端里把整个代码库当作用地，直接把修改落盘到你的工作区。安装之后工程上不存在「怎么接入」的问题，因为它的默认形态就是本地命令行工具。

它在 Trending 上能维持这么高热度，靠的不是概念包装，而是三条被反复验证的硬能力，下面挑最惊艳的三个展开。

核心功能亮点

第一，AGENTS.md 让项目规则直接成为智能体的上下文。 这是我个人觉得最实用的一点。在项目根目录放一个 AGENTS.md，把目录结构、构建命令、命名约定、禁区写进去，Codex 每次执行会话都会自动读取它。等于把团队里「新人入职看的那份文档」喂给了智能体，它改代码时天然遵守这些约束，不会随机踩坑。我的几个仓库都放了自己的 AGENTS.md，效果是踩过的坑不再重复踩。

第二，exec 子命令让智能体可以被脚本和 CI 调用。 交互模式（直接敲 codex）之外，还有 codex exec "提示词" 这种非交互模式，跑完自动退出、输出结果，非常适合写进脚本或接入持续构建。配套的还有 codex review（非交互代码审查）和 codex apply（把智能体生成的 diff 用 git apply 精确落盘）。这几个命令加在一起，意味着它能从「人机对话」变成「流水线上的一环」，这是很多同类工具还没做到的。

第三，沙箱与审批策略做到可控。 默认模式下，智能体执行 shell 命令前会经你审批，配合 --sandbox 可选策略，把执行限定在指定范围内。--dangerously-bypass-approvals-and-sandbox 这个开关被官方标注为「极其危险」，只留给完全隔离环境。这种把安全边界显式做成参数而不是藏起来的设计，让它在「敢放手」和「敢放开」之间有了可调节的余地。

第四，配置项足够细，能调成你自己的形状。 配置文件在 ~/.codex/config.toml，核心是三类。模型类：model 决定底层模型，model_reasoning_effort 控制推理强度，personality 调整输出风格。能力类：plugins 按需开启文档、PDF、表格、演示文稿这些文件处理插件。集成类：mcp_servers 挂外部工具，[projects."<路径>"] 里用 trust_level = "trusted" 单独给某个仓库开信任。这些配置不是摆设，是一个成熟 CLI 该有的开放度——你可以把它调成只读审查器，也可以调成全自动写手。

我在项目里怎么用的

我手头有一个用 Vue 3 + uni-app 做的微信小程序项目，涉及数据查询、独立 SVG 仪表盘、页面路由几块，代码量不算小。我在仓库信任配置里把这个项目标为已信任，并写了 AGENTS.md 部署检查清单、设计规范这些文档。

实际用法大多是这些：写完一个大功能后，让 Codex 跑一遍 review 检查我可能漏掉的边界情况；或是在改完 pages.json 路由后，让它为新的入口页面补齐 uni-app 的组件模板和样式，省去我手工搭建骨架的时间。

最有价值的一次是数据层重构。我把查询拆成几段逻辑后，用一句提示词让它在现有代码基础上补一个聚合查询的函数，它参考 AGENTS.md 里写的表和命名约定，直接产出了可运行版本，我再手动微调即可。这种「把机械重复劳动交给它、把判断留给自己」的分工，正是它最有用的地方。

适合与不适合的场景

适合：单仓库、以文件和命令为核心的工作流；想给 CI 或脚本加一个「能读懂代码的代理」；已经习惯用自然语言描述任务的独立开发者。

适合有明确目录结构、有 AGENTS.md 承载规则的项目。规则越清晰，它发挥越稳定。

不太适合：需要强人工确认每一步的大型金融、医疗场景（审批全开则失去意义，不开则频繁打断）；纯 UI 视觉微调这种高度主观、需要人眼反复对比的工作（它对视觉判断力有限）；以及完全不写文档、代码一坨的仓库（没有上下文可读，它也只能瞎猜）。

快速上手

第一步，安装。三种方式任选：

npm install -g @openai/codex
# 或
brew install --cask codex

第二步，登录绑定你的账号：

codex login

第三步，进到项目目录，跑交互模式：

cd 你的项目
codex

第四步，写一个 AGENTS.md（可选但强烈推荐），把项目结构、构建命令、命名约定放进去。内容不用长，几行就够：

# 构建
cd uni-app && npm run build
# 约定
页面路由在 src/pages.json
接口请求统一走 src/utils/request.js

第五步，给脚本用的话，试非交互模式：

codex exec "检查一下这段代码有没有边界问题"

装完后可以跑 codex --help 看全部子命令，codex doctor 会诊断安装、认证和运行时健康状态。

一个编码智能体的价值，不在它噱头多响亮，而在项目规则喂给它之后，它能不能真的减少你重复劳动。Codex CLI 的关键优势就是它活在终端里、能动手落盘、能被脚本调用——三个动作都踩在了开发者的真实痛点上。