有時候,直接提交 AI 撰寫的程式碼會讓人不安。在請人類審查者檢查前,需要先有一道初步過濾機制。
Claude Code 的 /code-review 就是用來做這件事。它會檢查目前分支的變更,找出錯誤與可整理之處。
本篇將依序整理各個階段,從可在本機調整強度的等級,到雲端的精密 ultra 檢查。
Claude Code 第 8 集介紹的 effort 等級,也會原樣套用到審查強度。
基本行為是檢查目前分支的變更
在工作階段輸入 /code-review,就會開始審查。
依據 官方文件,預設目標是比 upstream 超前的分支提交,以及尚未提交的變更。它會回報正確性錯誤,以及可重複使用、簡化與效率改善的機會。
也可以指定其他目標,例如檔案路徑、PR 編號、分支名稱,或 main...my-feature 這類範圍。
審查預設會由背景子代理在自己的上下文中執行。不會佔用目前的對話,完成後只會回傳結果。
等級:確信度還是涵蓋率
加上像 /code-review high 這樣的 effort 等級,就會改變審查強度。
- low·medium:只回報最有把握的發現。誤判較少
- high·xhigh·max:擴大涵蓋率。也可能包含把握度較低的發現
省略等級時,會重新使用上次手動輸入的等級。畫面也會顯示「重新使用上次輸入的 high」之類的提示。
只找問題,還是也讓它修正
--fix:審查結束後,直接將發現套用到工作樹--comment:以 PR 內嵌留言的形式發布發現
--fix有一點需要注意。背景審查的修改是在工作階段檢查點之外進行,因此無法用 /rewind 還原。不喜歡的話,必須用 git 還原。
ultra:雲端多代理審查
/code-review ultra的檢查規模不同。這是由多個代理在雲端平行深入調查的 ultrareview。
範圍也不同。它會將目前分支與儲存庫的預設分支比較,並包含未提交的變更。也可以像 /code-review ultra develop 一樣更換比較基準分支。
使用 官方 ultrareview 文件 時,需要以 claude.ai 帳號驗證。Pro·Max 可免費執行 3 次,之後每次審查約會從使用量點數扣除 5~25 美元。
如果目標是 github.com 的 PR,執行前對話框會顯示是否要將結果發布為自己帳號留言的選項。加上 --post 後會預先選取該項目,但是否發布仍會再詢問一次(v2.1.227 以上)。
日常提交使用本機等級就足夠;像發布前最終檢查這類重要時刻,再使用 ultra,這樣分工很自然。在 Bedrock 等無法使用 ultra 的環境中,此命令會靜默改以本機審查執行。
與同類命令的區別
另外還有兩個名稱相近的命令。
/simplify:不搜尋錯誤,只做整理與簡化,並套用修正的清理專用命令/security-review:只集中檢查變更中的安全漏洞
想找錯誤時使用 /code-review,想整理程式碼時使用 /simplify,分開處理即可。
調整審查標準
本機審查會像其他工作階段一樣遵循 CLAUDE.md 的專案規則。將團隊慣例寫在 CLAUDE.md 中,也會反映到審查結果。
另外,還有可自動審查 GitHub PR 的受管理 Code Review,僅供 Team·Enterprise 使用。它透過 REVIEW.md 這個專用審查檔案調整標準,但本機的 /code-review 不會讀取此檔案。
總結
作為提交前的習慣,/code-review 就足夠了。想重視確信度就用 low·medium,想擴大檢查範圍就用 high 以上。
要連修正一起交給它,使用 --fix;發布前的精密檢查則提升到 ultra。
下一篇將介紹一組查看工作階段狀態的診斷命令,包括 /doctor·/context·/usage 等。
來源與確認標準
- Claude Code 官方文件 — Code Review(Anthropic,確認於 2026-08-14)
- Claude Code 官方文件 — Ultrareview(Anthropic,確認於 2026-08-14)

![[Claude Code #9] /code-review,從 low 到 ultra 封面圖](/assets/images/posts/3a3c5139-78d7-4952-be11-c771eeb272d4/claude-code-review-effort-levels.jpg)