MemoryLake
返回全部文章
Tutorial2026 年 11 月 18 日·11 分钟阅读

Claude Code 中的 Ultrareview 是什么?它从您的分支上传了什么,结果在哪里返回,以及为什么发布到 PR 取决于保持会话开启 (2026)

在合并重大更改之前,您运行了 /code-review ultra 1234 并选择将结果发布到拉取请求(PR)。审查提示需要一段时间,于是您合上笔记本电脑去开会了。当您回来并恢复对话时,发现 PR 中没有发布任何内容。

Anthropic 的文档解释了原因:“Claude Code 仅在该会话中保留发布选项。如果会话在审查完成前结束,即使您稍后恢复对话,Claude Code 也不会发布任何内容。”

本指南涵盖了什么是 ultrareview、它从您的机器上传了什么、它与本地审查有何不同、结果在哪里返回、发布到拉取请求的工作原理、停止审查或切换帐户时会发生什么、如何从脚本运行它,以及如何保留您从每次审查中学到的知识。

什么是 ultrareview

Anthropic 的文档用两句话描述了它:“Ultrareview 是一种深度代码审查,作为云端会话在 Anthropic 的基础设施上运行。当您运行 /code-review ultra 时,Claude Code 会在云端沙箱中启动一组审查代理(agents),以查找您的分支或拉取请求中的错误。”

与本地的 /code-review 相比,文档列出了三个区别:

  • 更高信号。 “每个报告的发现都经过独立复现和验证,因此结果侧重于真实的错误,而不是风格建议”。
  • 更广覆盖。 更庞大的审查代理集群并行探索更改。
  • 不占用本地资源。 审查在云端沙箱中运行,因此您的终端可以保持空闲。

它永远不会自动启动。文档指出:“该命令仅在您使用 /code-review ultra 调用时运行;Claude 不会自行启动 ultrareview。”

Ultrareview 需要 claude.ai 帐户,因为它作为云端会话运行。它无法通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用,也不适用于启用了零数据保留(Zero Data Retention)或 HIPAA 配置的组织。文档称,在这些情况下,“/code-review ultra 会改为在您的会话中运行本地审查”。

它审查什么

文档指出,在不带参数的情况下,“ultrareview 会审查当前分支与默认分支之间的差异(diff),包括未提交和暂存的更改”。

您可以将其指向其他目标:

  • 不同的基准。 /code-review ultra develop 将您的分支与 develop 进行对比审查。提交 ID 或标签(tag)也同样适用。
  • 拉取请求。 /code-review ultra 1234,或粘贴当前目录仓库的 PR URL。
  • 纯文本备注。 您可以描述正在处理的内容,例如检查身份验证更改。

最后一个选项是很有用的审查上下文。文档称:“Claude 会将您的文本作为备注保留,显示在启动对话框中,并在结果到达时将发现与之关联。” 备注仅针对该次运行。它不会改变审查范围,范围仍是您的当前分支。

它从您的机器上传了什么

这取决于目标。

对于拉取请求, 文档很明确:“当您审查拉取请求时,Claude Code 不会从您的机器上传任何内容。” PR 会在云端克隆。

对于分支, Claude Code 会“打包仓库状态并将其上传到云端沙箱,遵循将本地仓库上传到云端会话的规则”。这些规则在 Claude Code 云端文档中,它们决定了哪些内容会离开您的机器:

  • macOS、Linux 和 WSL 上未提交的凭据文件。 “Claude Code 会在上传中排除名称类似于凭据(credentials)或密钥(keys)的未提交更改文件。” 文档列举了 .env 文件、Terraform *.tfvars 文件以及密钥文件(如 id_rsa 和 *.pem)。通知会列出留在您机器上的文件。
  • 原生 Windows。 “对已跟踪文件的未提交更改将按原样上传,无论文件名是什么。” 文档建议在开始之前,将您不想上传到云端的编辑内容进行暂存(stash)或还原(revert)。
  • 未跟踪的文件。 “未跟踪的文件不包含在内;请对您希望云端会话看到的文件运行 git add”。

此外还有大小限制。云端文档称,打包后的仓库必须在 100 MB 以下,对于更大的仓库有回退方案。专门针对 ultrareview,分支审查默认最多可包含 500 个修改文件和 8,000 行修改,文档指出具体数值可能会发生变化。如果仓库太大无法打包,Claude Code 会建议创建一个草稿 PR 并改为审查该 PR。

在启动之前,Claude Code 会显示一个确认对话框,列出审查范围、剩余免费次数和预估费用。对于分支审查,范围包括文件和行数。查看该对话框是确认哪些内容将进入云端的关键时刻。

结果在哪里返回

审查在后台运行。文档称:“审查通常需要 5 到 15 分钟。” 您可以继续在会话中工作,/tasks 会列出正在运行和已完成的审查。

完成后,“Claude Code 会在您的会话中以通知形式显示验证后的发现。每个发现都包含文件位置和问题说明,以便您可以直接要求 Claude 修复它。”

因此,发现会返回到启动审查的会话中。对于分支审查,文档称 Claude Code 仅在您的会话中显示发现。对于拉取请求,您还可以选择发布它们。

我们在关于 Claude Code 团队如何验证 Claude 的工作 的指南中,介绍了该团队对验证的看法,包括为下一次运行记录了哪些内容。

发布到拉取请求的工作原理

对于 github.com 上的拉取请求,Claude 可以从您的 GitHub 帐户将完成的发现作为单条评论发布。文档称该评论“不是审查或批准”,并以一条说明该评论由 Claude Code 生成的备注结尾。

发布是每次运行的可选操作。默认是不发布。在交互式会话中,您可以在启动对话框中选择运行并发布。

发布本身发生在 Anthropic 侧。“Claude Code 不会从您的机器发布。它将审查的会话 ID 发送到 Anthropic API,后者通过您连接到 Claude 的 GitHub 帐户将审查存储的发现作为评论发布。”

这就是开头示例中的细节。在交互式会话中,Claude Code 在发现到达时开始发布,因此届时会话必须处于开启状态。文档称:“Claude Code 仅在该会话中保留发布选项。如果会话在审查完成前结束,即使您稍后恢复对话,Claude Code 也不会发布任何内容。”

发布选项存在于会话中,因此在发现到达前关闭会话意味着不会发布任何内容。当发布确实运行时,Claude 会告诉您是已发布、发现已发布还是失败。如果失败,发现将保留在您的终端中,以便您可以手动发布。

停止审查或切换帐户时会发生什么

文档涵盖了多种情况:

  • 您停止了审查。 “如果您停止审查,Claude Code 会归档云端会话,并且不会返回部分发现。”
  • 云端会话在 claude.ai 上被停止或归档。 Claude 会告知您审查已停止。
  • 会话被删除,或者您在其他地方登录。 “如果审查的云端会话已被删除,或者自启动以来您已登录到不同的 Claude 帐户或组织,Claude 会告知您未找到会话。”
  • 您在审查中途切换了帐户。 “如果您切换了帐户,审查可能仍会在启动它的帐户下完成。如果审查仍在运行,请重新登录该帐户并使用 claude --resume 恢复对话以重新连接。”

停止的审查仍然计费。文档指出,您提前停止或未能完成的审查仍会消耗一次免费额度。Pro、Max 和 Ultra 计划每个帐户包含三次一次性的免费额度,之后审查将按使用积分计费。

从脚本运行 ultrareview

对于 CI 或脚本,文档指向 claude ultrareview 子命令。它会启动相同的审查,等待完成,并打印发现结果。

文档中的两点警告同样适用:

  • -p 不会等待。 通过 claude -p 运行斜杠命令会启动云端审查并直接退出,而不会获取发现结果,因此请改用子命令。
  • 提前退出会丢失本地发现。 “如果子命令在发现到达前退出,它们永远不会到达您的终端。审查可能仍在云端运行。” 再次运行子命令会启动新的审查,而不是恢复之前的审查。

子命令会询问是否信任该文件夹。文档的建议是:“仅当您信任其代码时才信任它,因为 git 和 Claude Code 随后可以运行其 git 配置和项目设置中命名的程序。” 在 CI 作业中,--trust-workspace 标志会为该次运行信任文件夹。

Ultrareview 与 /code-review 的对比

文档对两者进行了比较:

  • /code-review 在您的会话中本地运行,耗时几秒到几分钟,计入正常使用量。它用于迭代时的快速反馈,可以审查工作差异、拉取请求、分支或路径。
  • /code-review ultra 在带有多个代理集群和独立验证的云端沙箱中运行,耗时约 5 到 15 分钟,先使用免费额度,然后使用使用积分。它用于在合并重大更改前建立信心。

人们最常尝试的操作

在选择发布后关闭会话。 发布选项仅保留在该会话中。

期望从停止的审查中获得部分结果。 Claude Code 不会返回部分发现。

在 CI 中通过 claude -p 运行。 请使用 claude ultrareview 子命令。

让新文件保持未跟踪状态。 未跟踪的文件不会包含在分支审查中。

假设未提交的机密永远不会上传。 在原生 Windows 上,对已跟踪文件的未提交更改无论名称如何都会上传。

解决方案:将审查、会话和记录保持在一起

第 1 步:检查启动对话框

在上传开始前确认范围和文件数量。

第 2 步:准备工作树

暂存您想要审查的文件,并隐藏您不想上传到云端的编辑内容,尤其是在 Windows 上。

第 3 步:如果要发布,请保持会话开启

保持运行直到发现到达且发布完成。

第 4 步:记录您对每个发现的决定

写下您修复了哪些发现,接受了哪些风险,以及原因。

在 MemoryLake 中设置

Ultrareview 的发现会到达一个会话中,如果您发布它们,则会出现在一个 PR 评论中。您对这些发现的决定——例如为什么接受某个发现、哪个模式导致了一类错误,或者下次需要仔细查看哪个区域——是项目上下文,下一次审查和您的其他工具无法从该评论中获取这些信息。

MemoryLake 是这类项目上下文(如决策、已知风险及其背后的原因)的记忆层,保存在您维护的一个地方,并可供您连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

您用自己的语言亲自编写条目。不会从您的 Claude Code 会话、云端会话、审查发现、拉取请求评论、仓库或任何供应商的存储中读取、写入或删除任何内容。Ultrareview 按照 Anthropic 描述的方式工作。

第 1 步:创建 API 密钥

登录并从控制面板生成密钥。像对待其他凭据一样,将其存储在仓库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用
MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用

第 2 步:上传您的第一条记忆

从您在修复步骤 4 中写下的内容开始:您对每个发现的决定。每个条目一个决定,并附带 PR 或分支信息。

MemoryLake 工作区显示已上传的第一批文档,列出了每个成为可搜索记忆的文件
MemoryLake 工作区显示已上传的第一批文档,列出了每个成为可搜索记忆的文件

第 3 步:连接您的 AI 和代理

连接 Claude Code、Codex 和您使用的其他助手。下一次审查或修复可以从相同的决策出发。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架

这在实践中改变了什么

第一个区别是审查之间的连续性。已接受的风险不会作为意外被重新发现。

第二个是比会话更持久的记录。决策不依赖于 PR 评论或终端。

第三个是跨工具的一致性。相同的决策在 Claude Code 和其他助手中均可使用。

Ultrareview 最佳实践

在合并重大更改前使用它。 使用 /code-review 获取快速反馈。

当您不想上传本地文件时,请审查 PR。 Claude Code 不会为 PR 审查从您的机器上传任何内容。

暂存您想要审查的内容。 未跟踪的文件不会被包含。

在 Windows 上注意凭据文件。 未提交的更改会按原样上传。

发布时保持会话开启。 选项在会话关闭后不会保留。

在 CI 中使用子命令。 -p 会在没有发现的情况下退出。

添加备注以聚焦。 Claude 会将发现与备注关联。

结论

Ultrareview 在 Anthropic 的基础设施上的云端沙箱中运行一组审查代理,并且每个报告的发现都经过独立复现和验证。对于分支,Claude Code 会根据云端上传规则上传您的仓库状态包,这些规则在 macOS、Linux 和 WSL 上会排除未提交的凭据文件,且不包含未跟踪的文件。对于拉取请求,它不会从您的机器上传任何内容。

发现会作为通知返回到启动审查的会话中。如果您选择将它们发布到拉取请求,请保持该会话开启,因为发布选项仅保留在那里。停止的审查不会返回部分发现,且仍会消耗一次免费额度。在审查运行时请留意会话,并将您对发现的决定记录在比会话更持久的地方。

常见问题

Claude Code 中的 ultrareview 是什么?

一种深度代码审查,作为云端会话在 Anthropic 的基础设施上运行,使用一组审查代理。

我该如何运行 ultrareview?

在 Claude Code 中运行 /code-review ultra,可选地带上基准分支或 PR 编号。

ultrareview 会上传我的代码吗?

对于分支审查,Claude Code 会上传仓库状态包。对于拉取请求,它不会从您的机器上传任何内容。

.env 文件会被上传吗?

在 macOS、Linux 和 WSL 上,名称类似于凭据的文件的未提交更改会被排除。在原生 Windows 上,对已跟踪文件的未提交更改会按原样上传。

为什么我的发现没有发布到 PR?

会话在审查完成前结束了。Claude Code 仅在该会话中保留发布选项。

如果我停止审查会发生什么?

Claude Code 会归档云端会话,并且不会返回部分发现。该次运行仍会计数。

ultrareview 需要多长时间?

通常需要 5 到 15 分钟。