它到底是什么

claude ultrareview 是在 shell 里运行的非交互式子命令。它启动与会话内 /code-review ultra 相同的 ultrareview：一个跑在 Anthropic 云端沙箱里的多 agent 深度代码审查。命令会阻塞到远端审查结束，把发现结果打印到 stdout。

官方 CLI reference 的定义是："Run ultrareview non-interactively. Prints findings to stdout and exits 0 on success or 1 on failure."

官方文档对 ultrareview 本身的描述：

• Ultrareview 是 research preview 功能，功能、定价和可用性可能变化。
• 每条上报的 finding 都经过独立复现和验证。
• 审查在云端沙箱运行，不占用本地资源。

用法 / 语法

claude ultrareview [target]

官方文档给出的 target 形式：

claude ultrareview              # 当前分支相对默认分支的 diff
claude ultrareview 1234         # 审查 PR #1234
claude ultrareview origin/main  # 相对指定 base 分支审查
claude ultrareview 1234 --json  # CLI reference 中的官方示例

不带参数时，审查范围是当前分支与默认分支之间的 diff，包含未提交和已 staged 的改动。当分支与 base 没有共同历史（no merge base）时，会退化为审查仓库中所有 tracked 文件。

退出码 / 输出格式

退出码 0 不代表没有 bug。 它只表示审查跑完了，判断有无问题需要解析输出。

输出流分工：

• stdout：格式化的 findings，加 --json 时为原始 bugs.json payload。
• stderr：进度信息和实时 session URL，所以 stdout 保持可解析。
• 使用 --post 时，发布评论的链接也打印到 stderr。

官方文档没有给出 bugs.json 的字段结构，下游解析前请先用真实输出确认。

Shell 集成 / 自动化

因为进度信息走 stderr，可以直接把 stdout 重定向到文件：

# 保存原始 payload,进度仍显示在终端
claude ultrareview 1234 --json > bugs.json

# 限制最长等待 20 分钟
claude ultrareview origin/main --timeout 20

# 在 github.com PR 上审查并把 findings 发布为一条 PR 评论
claude ultrareview 1234 --post

--post 的行为（据官方文档）：

• 子命令在打印 findings 后立即开始发布。
• 发布不是从本机发出的：Claude Code 把 session ID 发给 Anthropic API，由 API 通过你连接到 Claude 账号的 GitHub 账号发布评论。
• 评论不是 review 或 approval，末尾带有 "Generated by Claude Code" 标注。
• 审查失败、超时或被中断时不发布任何内容。
• 审查完成但评论未发布时，原因打印到 stderr,findings 仍在 stdout，可以手动发布。

若你想要 GitHub PR 上的自动审查且不写 CLI 步骤，官方文档指向 Code Review，它直接集成到仓库并以行内评论发布 findings。

与会话内同名命令的差异

/ultrareview 在账号可用 ultrareview 时是 /code-review ultra 的别名。

claude -p '/code-review ultra' 这种用法要求 Claude Code v2.1.218 或更高版本。在 v2.1.218 之前，非交互会话里的 /code-review ultra 运行的是本地审查。

运行约束 / 限制

经典使用场景

• CI / 脚本中做合并前的深度审查：官方文档将该子命令定位为"从 CI 或脚本启动 ultrareview，无需交互会话"。
• 审查指定 PR：claude ultrareview <PR 号>。此时 Claude Code 不上传本机任何内容，沙箱直接从托管方 clone PR。
• 对照非默认 base 审查：claude ultrareview origin/main，或其他 base 分支名。
• 把审查结果交给其他工具处理：--json 输出 bugs.json payload。

常见坑

• CI 里运行即同意计费。 官方文档说明，运行子命令就等于同意 billing 和 terms 提示，不会再等待输入。Pro/Max 各有 3 次一次性免费额度，不会刷新；之后按 usage credits 计费，文档给出的典型费用为每次 $5 到 $25，取决于改动大小。Team 和 Enterprise 没有免费次数。
• 免费次数在 cloud session 启动后就被消耗。 提前停止或未能完成的审查也会占用一次免费额度。
• Ctrl-C 只终止本地子命令。 远端审查会继续运行，可用 stderr 里打印的 session URL 在浏览器中查看。
• 超时默认 45 分钟。 文档称一次审查通常 5 到 10 分钟。超时按失败处理，退出码为 1，且不会发布评论。
• --post 与 --no-post 同时传时不发布，以 --no-post 为准。
• 不要用 claude -p '/code-review ultra' 代替子命令。 它在 findings 到达前就退出，不会发布任何内容。
• PR 目标是 URL 时必须与当前目录仓库一致。 文档在交互命令部分写明"粘贴的 URL 必须指向当前目录中的仓库"。子命令部分声明 base-branch 处理与交互命令一致，但没有逐项列出 PR 引用的接受形式，文档示例只使用 PR 号。

来源

• Find bugs with ultrareview - Claude Code Docs
• CLI reference - Claude Code Docs（docs.claude.com/en/docs/claude-code/cli-reference 会 301 重定向到此）