OpenAI Codex review 面板用于查看 Codex 改了什么、留下针对性反馈,并决定哪些改动保留。它只适用于位于 Git repository 内的项目;如果项目还不是 Git repository,面板会提示先创建一个。你可以按未提交改动、整条分支差异或最近一轮改动切换范围,也能在本地项目里切换 staged 和 unstaged。
OpenAI Codex 代码审查面板
OpenAI Codex 的 review 面板用于查看改动、给出行级反馈,并决定保留哪些内容。它只对 Git repository 中的项目生效;如果项目还不是 Git repository,面板会先提示你创建一个。
它会显示哪些改动
review 面板反映的是 Git repository 的当前状态,不只显示 Codex 自己改过的内容。它会显示:
- Codex 做出的改动
- 你自己做出的改动
- 仓库里任何其他未提交改动
默认情况下,review 面板聚焦 uncommitted changes。你也可以把范围切换为:
- All branch changes(相对 base branch 的 diff)
- Last turn changes(仅最近一轮 assistant turn)
在本地工作时,还可以在 Unstaged 和 Staged 之间切换。
怎么在 review 面板里导航
- 点击文件名,通常会在你选定的 editor 中打开该文件。默认 editor 可以在 settings 里设置。
- 点击文件名背景,可以展开或收起 diff。
- 按住 Cmd 再点击某一行,会在你选定的 editor 中打开这一行。
- 如果你接受某个改动,可以 stage 改动或 revert 改动;不满意的部分也可以直接撤回。
行内评论怎么给 Codex 反馈
行内评论可以把反馈直接绑到 diff 的具体行上,通常是引导 Codex 修正问题最快的方式。
添加行内评论的步骤:
- 打开 review 面板。
- 把鼠标移到想评论的那一行。
- 点击出现的 + 按钮。
- 写下反馈并提交。
- 留完反馈后,再向线程发送一条消息。
因为评论是按行绑定的,Codex 能比泛泛的指令更准确地回应。
Codex 会把行内评论当成 review guidance。留完评论后,最好再补一条明确意图的跟进消息,例如 “Address the inline comments and keep the scope minimal.”
代码审查结果怎么显示
如果你用 /review 运行代码审查,评论会直接以内联形式显示在 review 面板里。
Pull request 审查怎么配合使用
当 Codex 对你的 repository 有 GitHub access,且当前项目位于 pull request branch 上时,Codex app 可以帮助你在不离开应用的情况下处理 pull request feedback。侧边栏会显示 pull request context 和 reviewer feedback,review 面板会把评论和 diff 放在一起,这样你就能在同一个线程里让 Codex 处理问题。
安装 GitHub CLI(gh),并用 gh auth login 完成认证,这样 Codex 才能加载 pull request context、review comments 和 changed files。如果 gh 不存在或没有认证,pull request 详情可能不会出现在侧边栏或 review 面板中。
当你想把完整修复流程放在一个地方时,可以这样做:
- 在 pull request branch 上打开 review 面板。
- 查看 pull request context、comments 和 changed files。
- 让 Codex 修复你希望处理的具体评论。
- 在 review 面板里检查生成的 diff。
- 准备好后,把改动 stage、commit 并 push 到 PR branch。
GitHub 触发的 reviews 可以参考 Use Codex in GitHub。
怎么 stage 或 revert 文件
review 面板包含 Git actions,方便你在提交前整理 diff。
你可以在这些层级上 stage、unstage 或 revert 改动:
- Entire diff:使用 review header 里的动作按钮,比如 “Stage all” 或 “Revert all”
- Per file:对单个文件 stage、unstage 或 revert
- Per hunk:对单个 hunk stage、unstage 或 revert
当你只想接受部分工作时,用 stage;当你想丢弃某些改动时,用 revert。
为什么同一个文件会同时显示 staged 和 unstaged
Git 允许同一个文件同时存在 staged 和 unstaged changes。发生这种情况时,面板在 staged 和 unstaged 视图里看起来像是“同一个文件出现了两次”。这是正常的 Git 行为。
常见问题
OpenAI Codex review 面板为什么看不到改动
先确认项目是不是 Git repository。review 面板只会显示 Git repository 里的状态,而不是单独某一次 Codex 编辑结果;如果仓库里还有其他未提交改动,它们也会一起显示。
OpenAI Codex 怎么给指定代码行留言
打开 review 面板,把鼠标移到目标行上,点击出现的 +,写完反馈后提交,再把意图补充到线程里。行内评论比整段说明更容易让 Codex 精准修改。
Pull request 详情为什么不显示
如果 gh 没有安装,或者 gh auth login 还没完成认证,pull request context、review comments 和 changed files 可能不会出现在侧边栏或 review 面板中。