Claude Code Reviewを組織の全リポジトリに有効化 — 上書きと費用の注意

Claude Code Reviewは、GitHub組織の行にReview runsを設定するだけで、その組織の全リポジトリを対象にできます。後から増えたリポジトリにも効きます。ただし、個別に設定済みのリポジトリも上書きされ、レビューの回数が一気に増えるため、使うには月額の上限設定が必要です。

リポジトリを1つずつ選ぶ方法はGitHub PR自動レビューの設定と運用にあります。ここでは、組織単位でまとめて有効にする操作と、その副作用に絞って説明します。

組織行の設定で何が変わるか

Code Reviewの設定画面にあるRepositories表には、リポジトリの行のほかに、GitHub組織そのものの行が並びます。その行のReview runsを設定すると、Claude GitHub Appがアクセスできる組織内のリポジトリすべてが対象になります。設定後に追加されたリポジトリも含まれます。

範囲

組織行の設定が及ぶ範囲

• 対象になるもの

  組織内で、Claude GitHub Appがアクセスできる全リポジトリです。後から追加したものも入ります。

• 上書きされるもの

  個別に設定していたリポジトリも、選んだReview runsに揃います。同じ値でもう一度設定すると、再び揃います。

• 上書きされないもの

  リポジトリ自身の行でOffにしてあるものは、Offのままです。

組織の行には、レビューの深さを決めるreview levelがありません。levelは組織全体の既定値か、リポジトリごとの設定で決まります。

有効にする前に満たす3条件

組織行の設定は、次の3つがすべて揃っているときだけ使えます。

3つ目が見落としやすい条件です。上限が無いまま組織行を触ろうとしても進めません。広く有効にすると支出が大きく伸びうるため、止める仕組みを先に求める作りになっています。

Code Review自体の提供条件も別にあります。対象プランはTeamとEnterpriseで、Zero Data RetentionやHIPAA構成の組織では使えません。customer-managed encryption keysを使う組織も、今は対象外です。GitHub Enterprise Serverの組織を使っている場合は、組織行ではなくリポジトリ単位で追加することになります。接続の手順はGitHub Enterprise ServerでClaude Codeを使うにまとめています。

手順: 上限の設定から組織行の選択まで

手順

組織全体を対象にする流れ

1. 1

   月額上限を決める

   claude.aiのAdmin settingsにある使用量のページで、Claude Code Reviewサービスの月額上限を設定します。上限は組織全体にかかります。

2. 2

   Claude GitHub Appのアクセス範囲を確認する

   GitHub側でAppを「選んだリポジトリだけ」に入れている場合、レビューされるのもその範囲だけです。残りを含めたいなら、GitHubでAppのリポジトリアクセスを広げます。

3. 3

   組織の行でEditを押す

   Admin settings > Claude CodeのCode reviewセクションで、Repositories表のGitHub組織の行を探し、Editを押します。

4. 4

   Review runsを選んで確定する

   選択肢は、Once after PR creation、After every push、Manual (@claude review)、そしてOffの4つです。選んで確認すると、各リポジトリの次のPRから反映されます。

反映のタイミングは「次のPRから」です。すでに開いているPRに、さかのぼってレビューが走るわけではありません。

個別設定がある組織で起きること

一括設定でいちばん注意が要るのは、既存の個別設定です。たとえば次のような構成を考えます。

前と後

組織行を After every push にした場合

BEFORE

設定前の例

• 基盤チームのリポジトリ: Manual
• 小さなツール類: Once after PR creation
• 試験運用中のリポジトリ: Off

AFTER

設定後の結果

• 基盤チームのリポジトリ: After every push
• 小さなツール類: After every push
• 試験運用中のリポジトリ: Offのまま

ManualにしていたのはPRごとに依頼する運用を守るためだった、というチームもあるはずです。組織行の設定は、その意図を区別せず全員を同じ値に揃えます。Offだけが例外として残る点も覚えておくと、事前に止めたいリポジトリを絞れます。

組織行の設定のあとで、あるリポジトリだけ別の値に変えると、表でCustomと表示されます。組織の既定からの例外を、表を見て数えられます。

Manualで始めて段階的に広げる

起点を急ぐ理由がないなら、組織行はまずManual (@claude review)にしておく選択肢があります。開いても、pushしても、レビューは走りません。開発者がPRにコメントしたときだけ動くため、費用は依頼の回数に比例します。

Manualのリポジトリでは、PRに「Claudeにレビューを頼むには@claude reviewとコメントする」という案内コメントが付きます。この案内はShow tips on pull requestsがオンの間だけ出ます。開発者が自分で入口を見つけられるので、周知の手間は小さく済みます。

開発者が@claude review alwaysとコメントすると、そのPRだけがpushごとのレビューを購読します。この場合はコメント以降のpushで費用が加わります。@claude reviewだけなら1回きりで、以後のpushには続きません。Manualでも、現場の判断でPR単位に回数が増えうる点は、上限の根拠として押さえておきたいところです。

重いリポジトリだけ後から個別にAfter every pushへ変えれば、組織の既定をManualに保ったまま、必要な箇所を厚くできます。

広く有効にすると費用が読めなくなる理由

新しく追加したリポジトリの初期値はAfter every pushで、最もレビューの多い設定です。組織行をそのまま選んでも、同じ値になりやすい点に気をつけます。費用はレビュー1回の重さと回数の掛け算で、pushが多いリポジトリほど回数が膨らみます。ドラフトとフォークからのPRは自動レビューの対象外なので、その分は数えなくて構いません。

広げる前に、見積もりの試験運用を入れる手順がClaude Code Reviewの費用を見積もり、月額上限で止める方法に書かれています。代表的な数リポジトリでOnce after PR creationかManualにして、表のAverage cost列の平均費用を読み、月のPR数を掛けます。

上限に達すると、その月のレビューは止まります。止まったPRには「Code review skipped」で始まるコメントが付きます。原因の見分け方はClaude Code Reviewがスキップ・失敗するときの切り分けで扱っています。

元に戻す・止める操作

組織単位で有効にしたあとで止めたくなったときの操作は、対象の大きさで分かれます。

組織が一括の対象になっている間、個別のリポジトリは一覧から外せません。外したければ、先にそのリポジトリのCode reviewをオフにする形になります。Remove repositoryを使うと別のClaude組織がそのリポジトリを設定できるようになるため、組織をまたいで管理する場合は意識しておく項目です。

組織行を使う場面と使わない場面

対象の範囲をGitHub側のAppのアクセス権で決めている組織では、組織行を選ぶことと、Appに全リポジトリを許可することが事実上ひとつながりの判断になります。Appが全リポジトリにアクセスできる状態で組織行を選べば、新しいリポジトリを作った瞬間からレビューの費用が発生しうる、ということです。

なお、組織全体のGitHub Actionsやシークレットを一括で整える手順は、Code Reviewとは別の仕組みです。そちらはClaude CodeのGitHub Actionsを組織に導入を参照してください。

まとめ

組織行のReview runsは、全リポジトリへの展開と、将来のリポジトリへの自動適用を1回で済ませる設定です。その代わり、個別設定の上書きと費用の増加が同時に起きます。Manualで始めて、重要なリポジトリだけ厚くする順番なら、想定外の支出を抑えやすくなります。