Codex 代码审查:VPS 智能体合并前的检查关卡

Codex 代码审查:VPS 智能体合并前的检查关卡 — 在 VPS 上运行 Codex 代码审查:选择 --base、--uncommitted 或 --commit,记录已审查的版本,并将测试与人工批准分开。
2026年11月19日1 分钟阅读
Share with

智能体忙了一整夜,终于完成补丁。终端显示任务结束,但分支仍然需要审查。我们要的是对真实差异的第二次检查,而不是再次听取执行者对自己意图的总结。

Codex 代码审查为仓库提供独立、聚焦的检查步骤。在 VPS 上,重要的不只是「审查运行了吗」,还包括「它检查了哪些文件、哪个版本,由谁决定发布」。本文介绍手动 Codex CLI 流程,并非 Office Claws 的自动合并功能。

Codex 代码审查:选择正确的差异范围

OpenAI 的 CLI 概览介绍了对未提交修改、单个提交或相对基础分支的变更进行专门审查。审查指南区分了工作副本审查和拉取请求审查。我们使用自有执行服务器上的工作副本。

目标CLI 命令适合场景常见错误
工作区codex review --uncommitted提交前检查修改另一个进程仍在编辑文件
分支codex review --base origin/main对照集成分支检查功能远程跟踪引用已经过时
单个提交codex review --commit <SHA>调查某次明确的修改把单个提交当成整个功能

当前 CLI 参数定义规定这些目标互斥,也不允许将位置参数形式的自定义提示与这些选择器组合使用。请查看已安装版本的帮助,不要拼接不同示例中的参数。未提交目标包含已暂存、未暂存和未跟踪的变更;将仓库上下文发送给模型前,先检查是否包含秘密信息。

工作区、分支和提交分别定义不同的审查范围

大约 3 分钟运行你的第一个智能体

安装 Office Claws CLI,连接你的 Contabo 账户和 Codex 订阅,你的智能体就会拥有自己的 VPS 和办公室里的一张桌子。

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/月 + 你自己的 Contabo VPS · 密钥保存在你的钥匙串中

开始审查前固定交接状态

审查分支前,我们先结束开发智能体的修改,并提交预期补丁。暂停向该工作副本写入的其他进程。请替换示例路径和基础分支;fetch 只更新 Git 引用,不会合并到当前分支。

cd ~/work/product-api
codex --version
codex review --help
git fetch origin
git status --short
git rev-parse HEAD
git rev-parse origin/main
git diff --stat origin/main...HEAD
codex review --base origin/main

将输出的两个提交 ID、Codex 版本与审查结果一起记录。三点差异有助于预览从共同祖先开始的分支变更,但不能保证每种审查实现内部使用完全相同的上下文。若差异为空或混入无关工作,先修复交接状态,再消耗一次审查运行。

并行开发时,为待审查候选版本使用独立工作副本或 worktree。worktree 隔离工作文件,不隔离 Unix 凭据或网络。另一个进程正在变基或切换分支时,不要检查一个持续变化的目标。并行工作流指南介绍任务边界;这里则固定被检查产物的身份。

修改后,旧审查结果仍只描述旧状态。重新运行相关测试,并审查更新后的候选版本。如果集成分支也变化了,还要检查新的基础关系:此前没有问题的审查,不能证明后续合并结果同样可靠。

把发现变成证据,而不是通行证

审查进程结束不等于获得批准。不要把它的退出码当成缺陷数量,也不要将「没有发现问题」视为安全证明。我们会对照引用的代码与预期行为核实每条疑虑。

对每个可处理的问题,保留触发输入、文件和行号、预期与实际行为,并尽可能增加回归测试。无法复现时,记录原因,而不是凭猜测重写代码。无法访问依赖或必要服务时,也要明确保留这一限制。

固定版本依次通过审查、测试和人工批准后才合并

单独运行项目真实的检查命令。有效交接应包含已审查的候选与基础提交 ID、测试命令和结果、未解决的问题以及人工合并决定。即使智能体没有报告问题,身份验证、数据库结构迁移和凭据处理的修改仍需专门检查。

OpenAI 将专门审查描述为只报告发现、不修改工作区的流程。要求智能体应用修复是另一个编辑步骤。这种区别不是操作系统安全边界:仍需采用适当的沙箱与批准设置,不要仅为检查差异就把生产部署凭据放到审查服务器上。

在 VPS 上分离审查与部署

Office Claws 在由你控制的 VPS 基础设施上运行基于 Codex 的智能体,并提供桌面与 CLI 管理层。它不会把上述命令变成保证有效的策略引擎,也不会自动批准 PR。通过 SSH检查工作副本,并让操作人员可以查看日志。

第二次审查同样使用模型访问额度。自带 ChatGPT 套餐并不意味着无限审查,也不会取消套餐限制;本地 CLI 审查与托管的拉取请求审查是不同流程。增加并发前,请核实当前权限并阅读订阅指南。

我们的建议是从一个已完成分支、一个明确基础、一对已记录版本和一次人工合并批准开始。只有在你能解释清楚审查对象、证据保存位置,以及什么机制阻止未审查版本进入生产时,再增加自动化。

作者

Office Claws Team

在 Office Claws 构建 AI 智能体管理的未来。分享关于基础设施、安全和开发者体验的见解。

大约 3 分钟运行你的第一个智能体

安装 Office Claws CLI,连接你的 Contabo 账户和 Codex 订阅,你的智能体就会拥有自己的 VPS 和办公室里的一张桌子。

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/月 + 你自己的 Contabo VPS · 密钥保存在你的钥匙串中