バージョン 2.1.328 で変更された点
変更ログのエントリでは、ほとんどのモデルにおいてローカルコマンドに3つの変更が加えられています:
- スコープ: レビューは「バグと CLAUDE.md 違反のみ」を報告するようになりました。
- ラベル: 各指摘事項に Important、Pre-existing、または Nit のマークが付きます。
- 出力: 各要約の最後に修正案が表示されます。報告すべき事項がないレビューでは、1行で「Code review found no issues.(コードレビューで問題は見つかりませんでした)」と表示されるようになりました。
「ほとんどのモデルで(on most models)」という限定的な表現が両方の行に登場します。変更ログには、どのモデルが除外されているかは記載されていません。アップデート後もレビューにクリーンアップの提案が含まれている場合、使用しているモデルが例外の1つである可能性があります。
クリーンアップ作業がなくなったわけではありません。別のコマンドに移動しただけであり、変更ログには「再利用、簡素化、効率化のクリーンアップには /simplify を実行してください」と明記されています。
なぜドキュメントにはまだ古いスコープが記載されているのか
リリース当日、ローカルレビューのページは依然として古い説明で始まっています。「Claude はブランチの変更をレビューし、正確性のバグを探し、会話の中で見つかった内容を報告します。モデルとエフォートレベルに応じて、レビューは再利用、簡素化、効率化のクリーンアップも対象とします。」
コマンドリファレンスにも同様の記述があります。「モデルとエフォートレベルに応じて、レビューはクリーンアップの機会も対象とします。」
変更ログの方がより新しい情報源です。また、残された2つのカテゴリを明示しているため、より具体的です。リリースノートとドキュメントページの内容が同日に食い違っている場合、安全な解釈は「ページがまだ追いついていない」ということです。インストールされているバージョンを claude --version で確認し、2.1.328 と比較してください。
以前の変更ログのエントリを見ると、これが以前にも移動したことがあることがわかります。あるリリースでは、中程度のエフォートでのレビューが「Opus 5.5 や Sonnet 5.5 を含む、調整されたレビュー設定のないモデルで、クリーンアップと CLAUDE.md の規約違反も報告するように」変更されました。/code-review のスコープは、しばらくの間、モデルやエフォートレベルによって変化してきました。バージョン 2.1.328 では、ほとんどのモデルでそれが絞り込まれました。
Important、Pre-existing、Nit の意味
変更ログでは、ローカルコマンドに対するこれら3つのタグの定義は示されていません。GitHub 上のマネージド Code Review サービスでも同じ3つのラベルが使用されており、そのドキュメントでは次のように定義されています:
- Important: 「マージ前に修正すべきバグ」
- Nit: 「軽微な問題。修正する価値はあるが、ブロッキングではない」
- Pre-existing: 「コードベースに存在するが、この PR によって導入されたものではないバグ」
Pre-existing(既存の問題)は、最も注意深く読む価値があるものです。これは本物のバグですが、あなたの変更が原因ではありません。これはスコープを決定するのに役立ちます。今すぐ修正することも、記録して別途対処することもでき、自分の変更のブロック要因として扱う必要はありません。変更ログでは、これらのタグはローカルコマンドへの変更として説明されているため、このリリース以前は、引き継いだバグと自分が導入したバグがラベルなしで同じリストに並んでいた可能性があります。
Nit は軽微な問題をカバーします。マネージドサービスでは、チームはレビュー専用ファイルを通じて、何が Nit で何が Important かを再調整できます。ローカルコマンドは、次に説明する別のファイルセットを読み取ります。
ローカルレビューが読み取るファイル
ここで、変更があなたの指示に関連してきます。ローカルレビューのページには、「レビューは、非インタラクティブな -p 実行を含め、あなたの CLAUDE.md に従います。REVIEW.md は読み取りません」と記載されています。
したがって、手元のマシンの /code-review にとって、CLAUDE.md はプロジェクトルールを記載するドキュメント化された場所です。同じページに直接こう書かれています。「すべてのレビューにプロジェクトルールを適用するには、それらを CLAUDE.md に追加してください。」
新しいスコープでは、これがより重要になります。CLAUDE.md 違反は、現在ほとんどのモデルでレビューが報告する2つの事項のうちの1つです。チームの Wiki、プルリクエストのテンプレート、またはあなたの頭の中にしかない規約は、報告の対象になりません。
マネージドサービスのカスタマイズページでは、反対側から同じ境界線を引いています。「サービスは CLAUDE.md と REVIEW.md の両方を読み取ります。自分のマシン上の Claude Code セッション内で実行する /code-review コマンドは、CLAUDE.md ファイルを読み取り、REVIEW.md は読み取りません。」そのアドバイスは、「両方に適用したいガイダンスは CLAUDE.md に入れ、REVIEW.md はプルリクエストレビューに特化したルールのために残しておく」というものです。
サービスについては、同じページで CLAUDE.md がどのように適用されるかが説明されています。「ルールに違反する変更は、問題に適合する重要度レベルの指摘事項になります。」また、サービスはルートファイルと、変更された各ファイルの親ディレクトリにある CLAUDE.md ファイルを読み取るとも記載されています。
/simplify が適切なコマンドであるタイミング
/simplify はクリーンアップを担当するコマンドです。コマンドリファレンスでは次のように説明されています。「変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。」4つのレビューエージェントが並行して実行され、既存のヘルパーの再利用、簡素化、効率化、および変更が適切な抽象化レベルにあるかどうかをカバーします。
同じエントリで、境界線が明示されています。「レビューは正確性のバグを探しません。バグを見つけるには /code-review を使用してください。」
スクリプトを混乱させる可能性のある名称の歴史があります。ローカルレビューのページには、「このコマンドは v2.1.147 より前は /simplify という名前で、デフォルトで修正を適用していました。バグ発見のために /simplify をスクリプト化していた場合は、/code-review --fix に切り替えてください」とあります。
つまり、現在は明確に分かれています:
/code-reviewはバグと CLAUDE.md 違反を見つけ、報告します。/simplifyはクリーンアップの機会を見つけ、修正を適用します。
これらはどちらの順序で実行しても構いません。妥当な習慣としては、まず /code-review を行い、クリーンアップによってコードの形が変わる前に正確性の問題を修正することです。
レビュー対象の選択
ターゲットを指定しない場合、ローカルページには「/code-review は、アップストリームブランチに対する現在のブランチのコミットと、未コミットの変更をレビューします」とあります。ブランチにアップストリームがない場合は、main または前のコミットと比較されます。
エフォートレベルやフラグの後にターゲットを入力することで、別の場所を指すことができます。ドキュメント化されたターゲットには、プルリクエスト番号、別のブランチと比較したブランチ、コミット範囲、ファイルまたはディレクトリのパスが含まれます。パスは、独自のルールを持つ CLAUDE.md があるモジュールなど、特定の領域に新しいスコープを適用したい場合に便利です。
ターミナルで結果を読む代わりに結果を投稿するには、--comment を使用します。これは「GitHub のプルリクエストにインラインコメントとして、または GitLab のマージリクエストに単一のノートとして指摘事項を投稿します」。これらのコメントには同じタグが付随するため、プルリクエストのスレッドで Pre-existing なものを簡単に見つけることができます。
Claude が自動的にレビューを開始する場合
常に自分でコマンドを入力するとは限りません。ローカルページには、Claude がレビューを開始する2つの方法がリストされています。1つ目は、自然言語で依頼する場合です。「Claude に変更をレビューするように頼むと、スキルを実行できます」。2つ目は、プロンプトが /code-review であるセッションスコープのスケジュールされたタスクです。
どちらの実行も、入力されたコマンドと同じスコープを使用するため、スケジュールされたレビューもバグと CLAUDE.md 違反を報告するようになりました。コマンドを手動使用のみに限定したい場合、設定ファイルの skillOverrides エントリを使用して、スキルをユーザー呼び出しのみにする方法がページに記載されています。これにより、コマンドを自分で使える状態に保ちつつ、Claude やスケジュールされたタスクがレビューを開始するのを停止できます。
レビューの変更または置き換え
/code-review はバンドルされたスキルです。ページではその意味を次のように説明しています。「その指示は Claude Code に組み込まれているため、ディスク上に開いたり編集したりできる SKILL.md ファイルは存在しません。」
新しいスコープがチームに合わない場合は、ドキュメント化されたオプションがあります。ページには、「code-review という名前のプロジェクトスキルまたはパーソナルスキルは、バンドルされたスキルの代わりに実行され、/review エイリアスは引き続きバンドルされたレビューを実行します」とあります。また、独自のレビュアーサブエージェントやレビュースキルを作成することもできます。
置き換える前に、ページが最初に示しているより簡単なルートを検討してください。ルールを CLAUDE.md に入れることです。バンドルされたレビューはすでにそのファイルに従っており、スコープが狭まったことで、そこにある明確なルールは、長い好みのリストよりも指摘事項として浮上しやすくなっています。
レビューがチェックできるルールの書き方
CLAUDE.md 違反は、ルールが具体的な場合に最も報告しやすくなります。「ディレクトリを手動で編集してはならない」、「すべての API ルートには特定のミドルウェアが必要である」、「テストは本番データベースに触れてはならない」といった記述は、レビューが比較するための具体的な材料を与えます。
「コードを綺麗に保つ」といった曖昧な好みは、/simplify が扱う内容に近くなります。これらを CLAUDE.md から除外することで、ファイルが短く保たれ、レビューだけでなく Claude がそれを読み取るすべてのタスクに役立ちます。
ローカルレビューの実行方法
ドキュメントのいくつかの詳細は、結果を読むのに役立ちます。
バックグラウンドで実行される。 「ターミナルセッションでは、レビューは独自のコンテキストウィンドウを持つバックグラウンドサブエージェントとして実行されるため、会話を埋め尽くすことはありません。レビューが完了すると、指摘事項が会話に届きます。」
修正を求めない限り報告のみを行う。 --fix がない場合、ページには「レビューの指示は Claude に報告のみを求めます」とあります。--fix を使用した場合でも、編集は引き続きあなたの許可モードに従います。
バックグラウンド修正後のリワインドには制限がある。 ページには、バックグラウンドレビューが --fix による編集をセッションのチェックポイント外で適用すること、および /rewind は Claude が会話内ですでに編集したファイルのみを復元することが記載されています。それ以外については git を使用するようにアドバイスされています。
エフォートによってカバレッジが変わる。 「low では、レビューは最も自信のある指摘事項を報告するため、誤検知が少なくなります。medium から max にかけて、レビューはカバレッジを広げます。」レベルを入力しない場合、レビューは以前のセッションからであっても、最後に入力したレベルを再利用します。
デスクトップアプリではリストが表示される。 デスクトップアプリのような構造化された結果を求めるホストアプリケーションでは、各エントリに「ファイルの場所、1文の要約、およびカテゴリタグが表示される」とあります。修正も追跡されます。「セッションの後半で Claude が報告された指摘事項を修正すると、それらを再度報告します。Claude Code は、更新された指摘事項リストの各項目を fixed(修正済み)、skipped(スキップ)、または no change needed(変更不要)としてマークします。」このステータスリストは作業中に便利で、セッションが続く限り維持されます。
指摘事項には制限がある。 --max-findings で上限を増減でき、指摘事項ツールを通じて報告される場合、ドキュメント化された制限は 32 です。
Code Review および ultrareview との違い
3つのレビューツールが名前を共有していますが、新しいスコープが適用されるのはそのうちの1つだけです。
/code-reviewはセッション内でローカルに実行され、CLAUDE.md を読み取り、現在はほとんどのモデルでバグと CLAUDE.md 違反を報告します。- Code Review(マネージドサービス)は、組織の GitHub 上のプルリクエストをレビューし、CLAUDE.md と REVIEW.md の両方を読み取ります。
- Ultrareview は
/code-review ultraで開始され、クラウドでより深いレビューを実行します。
ローカルページには /review は /code-review のエイリアスであると記載されているため、変更は両方の名前に適用されます。
何をアップロードし、どこに指摘事項が戻ってくるかを含むクラウドオプションについては、Claude Code での ultrareview のガイドで詳しく解説しています。
よくある間違い
/code-review でクリーンアップの提案を探す。 ほとんどのモデルでは、それらは /simplify に移動しました。
ローカルレビューのために REVIEW.md にレビュー規則を入れる。 ローカルコマンドはそれを読み取りません。CLAUDE.md を使用してください。
すべての指摘事項をブロッキングとして扱う。 サービスでは、Nit は非ブロッキング、Pre-existing はその変更によって導入されたものではないと定義されています。
今日の時点で変更ログよりもドキュメントページを信頼する。 ページにはまだ古いスコープが記載されています。
バグを見つけるために /simplify を使用する。 これは正確性のバグを探しません。
解決策: CLAUDE.md にレビュールールを持たせる
ステップ 1: アップデートしてバージョンを確認する
claude --version を実行します。新しいスコープは 2.1.328 で導入されました。
ステップ 2: レビューに関連するルールを CLAUDE.md に移動する
Wiki やテンプレートにしかない規約は、ローカルレビューが読み取るファイルには含まれません。
ステップ 3: レビューの習慣を分ける
バグとルール違反には /code-review を実行し、その後にクリーンアップのために /simplify を実行します。
ステップ 4: 後回しにすることにした Pre-existing な指摘事項を記録する
どれを残したか、なぜか、そしてそれらがどこにあるかを書き留めておきます。
MemoryLake でのセットアップ
CLAUDE.md は Claude Code がプロジェクトルールを読み取る場所であり、それを短く保つことが使いこなすコツです。一部のコンテキストはそこには適していません。なぜそのルールが存在するのか、どの Pre-existing なバグを後回しにすることにしたのか、どの領域で同じ指摘事項が繰り返されるのか、そしてレビューの後に何を決定したのか、といったことです。
MemoryLake は、レビューの決定事項、後回しにした問題、ルールの背後にある理由など、そのようなプロジェクトコンテキストのためのメモリレイヤーです。これらを1か所で管理し、ChatGPT、Claude Code、Codex など、接続するアシスタントから利用できるようにします。
エントリはあなた自身の言葉で作成します。CLAUDE.md ファイル、Claude Code セッション、レビュー結果、リポジトリ、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。Claude Code のレビューは、Anthropic が説明している通りに動作します。
ステップ 1: API キーを作成する
サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保管してください。

ステップ 2: 最初のメモリをアップロードする
解決策のステップ 4 で書いた内容、つまり後回しにした指摘事項とその理由から始めましょう。1つの決定につき1つのエントリにします。

ステップ 3: AI とエージェントを接続する
Claude Code、Codex、および使用している他のアシスタントを接続します。次のレビューや修正は、同じ決定事項から開始できます。

実務で何が変わるか
第一の違いは、繰り返される指摘事項が減ることです。後回しにされた Pre-existing なバグは、その理由とともに記録されています。
第二に、CLAUDE.md がスリムになります。ルールはそこに留まり、その背後にある履歴は別の場所に保管されます。
第三に、ツール間での一貫性です。同じレビューの決定事項が、Claude Code や他のアシスタントでも利用可能になります。
/code-review のベストプラクティス
バージョンを把握する。 スコープの変更は 2.1.328 で導入されました。
ルールは CLAUDE.md に置く。 これはローカルレビューが従うファイルです。
REVIEW.md はマネージドサービス専用にする。 ローカルコマンドはそれを読み取りません。
タグを読む。 Important はマージ前に修正すべきもの、Nit はブロッキングではないもの、Pre-existing はあなたの変更によって導入されたものではないものです。
クリーンアップには /simplify を実行する。 これは修正を適用し、バグは探しません。
意図的にエフォートを選択する。 Low は確実性を重視し、高いレベルはカバレッジを広げます。
バックグラウンド修正後は git を使用する。 リワインドは、バックグラウンドレビューが編集したすべてのファイルを復元するわけではありません。
結論
2026年11月19日にリリースされた Claude Code 2.1.328 では、ほとんどのモデルで /code-review がバグと CLAUDE.md 違反に絞り込まれ、各指摘事項に Important、Pre-existing、または Nit のマークが付き、各要約の最後に修正案が表示されるようになりました。クリーンアップは /simplify に移動しました。これは修正を適用し、正確性のバグは探しません。ローカルのドキュメントページにはまだ古いスコープが記載されている場合があるため、変更ログでバージョンを確認してください。
ローカルレビューは CLAUDE.md に従い、マネージドサービスが使用する REVIEW.md は読み取りません。新しいスコープでは、CLAUDE.md はレビューがチェックする2つの事項のうちの1つであるため、ローカルで強制したいルールはそこに記述してください。その背後にある理由や決定事項は、単一のレビューよりも長く残る場所に保管しておきましょう。