Claude Code Auto-Fix完全ガイド — PRのCI失敗もレビューコメントもAIが自動修正する時代

Claude Code Auto-Fixは、Pull RequestのCI失敗やレビューコメントをAIが自動で修正してくれる機能です。Web・デスクトップ・モバイルでの使い方、仕組み、設定手順、注意点まで徹底解説します。

田中俊輔2026年3月27日22分で読める

Claude / Claude Code 開発・エンジニアリング

この記事でわかること

iこの記事を読むとできるようになること

Claude Code Auto-Fixとは何か、なぜ画期的なのかが理解できる
Web・デスクトップ・モバイルそれぞれでAuto-Fixを有効にする手順がわかる
CIの失敗やレビューコメントをAIがどう処理するのか、仕組みを理解できる
Auto-Mergeとの組み合わせで「完全放置でPRがマージされる」ワークフローを構築できる
注意点や制限事項を把握し、安全に運用できる

「Pull Requestを出したら、CIが落ちていた。ログを読んで、修正して、もう一度プッシュ。レビューコメントが来たから対応して、またプッシュ。CIが通ったと思ったら、今度は別のチェックが落ちていて……」

開発者なら誰もが経験するこの繰り返し。PRを出してからマージされるまでの「メンテナンス作業」は、地味だけど確実に時間を食います。

2026年3月、Anthropicはこの問題を根本から解決する機能を発表しました。Claude Code Auto-Fixです。

PRを作成したら、あとはClaudeに任せて別の作業に取りかかる。CIが失敗すればClaudeがログを読んで修正し、レビュアーがコメントを残せばClaudeが対応してプッシュする。戻ってきたときには、PRがグリーン（すべてのチェックがパス）の状態で待っている。そんなワークフローが現実になりました。

この記事では、Auto-Fixの仕組みから具体的な使い方、Auto-Mergeとの組み合わせ、そして知っておくべき制限事項まで、実践的に解説します。

Claude Code Auto-Fixとは

一言でいうと

PRを監視し、CI失敗やレビューコメントに自動で対応してくれるAI機能です。

従来、PRを出した後の作業フローは以下のようなものでした。

PRを作成する
CIが実行されるのを待つ
失敗したら原因を調べて修正する
レビューコメントが来たら対応する
再びCIが実行されるのを待つ
2〜5を繰り返す
すべてグリーンになったらマージする

Auto-Fixを使うと、ステップ2〜6をClaudeが自動で行います。開発者がやることは「PRを出してAuto-Fixをオンにする」、それだけです。

何が革新的なのか

Auto-Fix最大の特徴は、クラウド上で動作する点です。

ローカルのターミナルやデスクトップアプリを開いたままにしておく必要がありません。Web版やモバイルアプリからAuto-Fixを有効にすれば、Claudeがクラウド上でPRを監視し続けます。PCを閉じても、スマートフォンをポケットにしまっても、Claudeは働き続けます。

!こんな場面で特に便利

PRを出してから退勤したい — 翌朝にはPRがグリーンになっている
レビュー対応に時間を取られたくない — 明確な修正はClaudeが自動で対応
複数のPRを同時に管理している — それぞれにAuto-Fixを設定して並行で進められる

Auto-Fixの仕組み

Claudeはどうやって動いているのか

Auto-Fixを有効にすると、ClaudeはGitHubのPRイベントを**サブスクライブ（購読）**します。具体的には、以下のイベントを監視しています。

CIチェックの失敗: GitHub Actionsなどのワークフローが失敗した場合
新しいレビューコメント: レビュアーがPRにコメントを残した場合

イベントを受信すると、Claudeは内容を調査し、3つのパターンに分けて対応します。

パターン1: 明確な修正（Clear fixes）

Claudeが修正に自信を持っていて、これまでの指示と矛盾しない場合です。

Claudeの動作:

問題の原因を特定する
コードを修正する
変更をプッシュする
セッション内で「何をしたか」を説明する

たとえば、リンターが「未使用のimport文がある」と指摘した場合、Claudeはそのimport文を削除してプッシュします。テストが「期待値と実際の値が一致しない」で失敗している場合も、原因が明らかであれば自動で修正します。

パターン2: 曖昧なリクエスト（Ambiguous requests）

レビュアーのコメントが複数の解釈ができたり、アーキテクチャ上重要な変更を伴う場合です。

Claudeの動作:

問題を分析する
ユーザーに確認を求める
ユーザーの指示を受けてから行動する

たとえば、レビュアーが「このロジックはもう少しシンプルにできないか」とコメントした場合、「シンプル」の解釈が複数あるため、Claudeはユーザーにどの方向で修正すべきか確認します。

i完全自律ではない、という安心感

Auto-Fixは「判断が必要な場面では必ず人間に確認する」という設計になっています。アーキテクチャを変えるような大きな修正を勝手に行うことはありません。これは「便利だけど暴走しない」という、実用的なバランスです。

パターン3: 対応不要（Duplicate or no-action events）

イベントが重複していたり、変更が不要な場合です。

Claudeの動作:

セッション内にメモを残す
次のイベントに進む

たとえば、同じCIチェックが再実行されて同じ結果が出た場合、Claudeは重複と判断してスキップします。

GitHubへの返信について

ClaudeはレビューコメントのスレッドにGitHub上で直接返信する場合があります。

この返信は、あなたのGitHubアカウントを使って投稿されます。つまり、見た目上はあなたのユーザー名で表示されますが、各返信には「Claude Codeが書いた」というラベルが付くので、レビュアーにはAIが対応したことが明確にわかります。

!返信はあなたのアカウント名義で投稿される

ClaudeがGitHubに投稿する返信は、あなたのGitHubアカウントとして表示されます。ラベルで区別はされますが、この点を理解した上で使用してください。チームメンバーにも事前に共有しておくことをお勧めします。

Auto-Fixの使い方 — 環境別セットアップ

Auto-Fixは3つの環境から利用できます。それぞれの設定方法を見ていきましょう。

前提条件（すべての環境で共通）

Auto-Fixを使うには、以下の準備が必要です。

1. Claude GitHub Appのインストール

Auto-Fixが動作するには、対象リポジトリにClaude GitHub Appがインストールされている必要があります。

bash

# Claude GitHub Appのインストールページ
# https://github.com/apps/claude からインストール

GitHub Appのインストールページにアクセスし、対象のリポジトリ（またはOrganization全体）に対してインストールしてください。初回設定時にClaude Codeから案内が表示される場合もあります。

2. 対応しているプラン

Auto-Fixは以下のClaude有料プランで利用可能です。

プラン	月額	Auto-Fix利用
Pro	$20	可能
Max 5x	$100	可能
Max 20x	$200	可能
Team	チーム向け	可能
Enterprise	企業向け	可能

iレート制限について

Claude Code on the webのレート制限は、アカウント内の他のClaude利用と共有されます。Auto-Fixで複数のPRを同時に監視すると、その分レートを消費するので、プランに応じた使い方を心がけましょう。Maxプランであれば、並列のPR監視も余裕を持って行えます。

方法1: Claude Code on the web（Web版）

最もシンプルな方法です。ブラウザからClaude Codeを使ってPRを作成し、そのままAuto-Fixを有効にします。

手順:

claude.ai/code にアクセスする
GitHubアカウントを接続する（初回のみ）
リポジトリを選んでタスクを実行する
Claudeがコードを変更したら、PRを作成する
CI status bar（CIステータスバー）が表示される
CI status barを開き、「Auto-fix」を選択する

これだけです。あとはブラウザを閉じても、Claudeがバックグラウンドで監視を続けます。

既存のPRにAuto-Fixを設定する場合:

すでに作成済みのPRにも、Auto-Fixを後から設定できます。

Claude Code on the webでセッションを開く
PRのURLをチャットに貼り付ける
「このPRをauto-fixして」と指示する

https://github.com/your-org/your-repo/pull/123
このPRのCI失敗とレビューコメントをauto-fixしてください

方法2: デスクトップアプリ

Claude Codeのデスクトップアプリ（Mac/Windows）でも、Auto-Fixを利用できます。

前提条件（デスクトップ固有）:

bash

# GitHub CLIのインストールが必要
brew install gh        # macOS
winget install gh      # Windows

# GitHub CLIの認証
gh auth login

!GitHub CLI（gh）が必要です

デスクトップアプリでのPR監視には、GitHub CLI（ghコマンド）のインストールと認証が必要です。未インストールの場合、初めてPRを作成しようとした時にインストールを促すメッセージが表示されます。

手順:

Claude Codeデスクトップアプリでコードを編集する
PRを作成する（diff viewで変更内容を確認できる）
CI status barが表示される
CI status bar内の**「Auto-fix」トグルをオンにする**
必要に応じて**「Auto-merge」トグルもオンにする**

デスクトップアプリでは、CIが完了するとデスクトップ通知も送信されます。別のアプリで作業していても、CIの結果をすぐに確認できます。

方法3: モバイルアプリ

Claudeモバイルアプリ（iOS/Android）からも、Auto-Fixを指示できます。

手順:

Claudeモバイルアプリを開く
以下のように自然な言葉で指示する

このPRを監視して、CI失敗やレビューコメントがあれば自動で修正してください
https://github.com/your-org/your-repo/pull/123

英語でも指示できます。

Watch this PR and fix any CI failures or review comments
https://github.com/your-org/your-repo/pull/123

!通勤中にPRの面倒を見てもらう

朝の通勤電車の中で、昨夜出したPRのURLをスマートフォンのClaudeアプリに貼り付けて「auto-fixして」と一言。会社に着く頃にはPRがグリーンになっている、そんな使い方が可能です。

Auto-Mergeとの組み合わせ — 完全自動化ワークフロー

Auto-Fixだけでも十分に便利ですが、Auto-Mergeと組み合わせると、PRの作成からマージまでを完全に自動化できます。

Auto-Mergeとは

Auto-Mergeは、すべてのCIチェックがパスしたら自動的にPRをマージする機能です。

Auto-FixとAuto-Mergeを両方オンにすると、以下の完全自動化フローが実現します。

PRを作成する
Auto-FixとAuto-Mergeをオンにする
（あなたはここで離脱してOK）
CIが失敗 → Claudeが自動修正 → 再プッシュ
レビューコメント → Claudeが対応 → 再プッシュ
すべてのチェックがパス → Claudeが自動マージ
あなたが戻ってきたときには、PRはもうマージ済み

Auto-Mergeの前提条件

Auto-Mergeを使うには、GitHubリポジトリ側でも設定が必要です。

GitHubリポジトリの設定:

リポジトリの Settings を開く
General → Pull Requests セクションに移動する
「Allow auto-merge」にチェックを入れる

この設定がオフのままだと、Claude側でAuto-Mergeをオンにしても動作しません。

!マージ方式はsquashのみ

Auto-Mergeでのマージ方式はsquash merge（スカッシュマージ）に固定されています。複数のコミットが1つにまとめられてマージされます。merge commitやrebaseでのマージは選択できません。チームのマージ戦略と合致するか事前に確認してください。

並行作業のワークフロー

Auto-FixとAuto-Mergeの真価は、複数のPRを並行して管理するときに発揮されます。

タスクA: コードを書く → PR作成 → Auto-Fix ON → Auto-Merge ON
           ↓
タスクB: コードを書く → PR作成 → Auto-Fix ON → Auto-Merge ON
           ↓
タスクC: コードを書く → PR作成 → Auto-Fix ON → Auto-Merge ON
           ↓
   （すべてバックグラウンドでClaudeが対応中）
           ↓
   戻ってきたら、3つのPRがすべてマージ済み

Claude Codeのデスクトップアプリでは、並列セッション機能を使って複数のタスクを同時に進められます。各セッションは自動的にGit worktreeで分離されるため、ブランチが競合する心配もありません。

Diff View — 変更内容の確認とフィードバック

Auto-Fixを使う前に、Claudeが行った変更を確認したい場合は**Diff View（差分ビュー）**が便利です。

Diff Viewの使い方

Claudeがファイルを変更すると、画面に差分の統計情報（例: +12 -1）が表示されます。これをクリックすると、Diff Viewerが開きます。

Diff Viewでできること:

ファイルごとに変更内容を確認する
特定の変更箇所にコメントを残す（デスクトップアプリ）
コメントに基づいてClaudeに修正を依頼する
「Review code」ボタンでClaudeにセルフレビューを依頼する

セルフレビュー機能

Diff Viewの右上にある**「Review code」ボタン**を押すと、Claudeが自分の変更をレビューします。

Claudeのセルフレビューがチェックする項目は以下の通りです。

コンパイルエラー
明確なロジックエラー
セキュリティ上の脆弱性
明らかなバグ

逆に、以下の項目は指摘しません。

スタイルやフォーマットの問題（リンターの役割）
既存コードの問題（今回の変更に関係ない部分）
コーディング規約の細かい指摘

!PRを出す前のセルフチェックに

Auto-Fixに任せる前に、まずDiff ViewとReview code機能で一度確認する習慣をつけると、より品質の高いPRを出せます。明らかな問題はこの段階で修正し、CI失敗のリスクを減らせます。

Auto-Fixが修正できるCIの失敗

Auto-Fixは、CI/CDパイプラインで発生するさまざまな種類の失敗に対応できます。

対応可能な失敗の例

失敗の種類	具体例	修正の難易度
ビルドエラー	TypeScriptの型エラー、import文のミス	容易
テスト失敗	ユニットテストの期待値ミス、スナップショットの差分	中程度
リンターエラー	ESLint/Prettierの警告、未使用変数	容易
フォーマットの問題	コードフォーマットの不一致	容易
セキュリティスキャン	既知の脆弱性を持つパッケージの使用	中程度
カスタムチェック	プロジェクト固有のバリデーション	ケースによる

Claudeが得意なパターン

エラーメッセージが明確な場合: 「Type 'string' is not assignable to type 'number'」のようなメッセージがあれば、高い精度で修正できる
修正箇所が特定しやすい場合: 「file.ts:42:10」のようにファイル名と行番号が出力されていれば、素早く対応できる
定型的な修正: import文の追加/削除、型の修正、フォーマットの適用など

Claudeが慎重になるパターン

テストのロジック自体に問題がある場合: テストが間違っているのか実装が間違っているのか判断が難しい
アーキテクチャの変更が必要な場合: 大規模なリファクタリングが必要な失敗
外部サービスとの連携の問題: APIキーの期限切れ、サービスのダウンタイムなど、コードの修正では解決できない問題

セッションの連続性 — デバイスをまたいだ作業

Auto-Fixのもう一つの強力な特徴は、セッションがデバイス間を移動できることです。

CLI → デスクトップ

ターミナルでClaude Codeを使って作業した後、デスクトップアプリに切り替えたい場合。

bash

# CLIでの作業中に、デスクトップアプリへセッションを移す
/desktop

これだけで、CLIで行った作業の全コンテキストがデスクトップアプリに引き継がれます。

デスクトップ → Web/モバイル

デスクトップアプリで作業した後、外出先からモバイルで確認したい場合。

デスクトップアプリで**「Continue with Claude Code on the web」ボタン**をクリック
セッションがクラウドに移行される
Webブラウザまたはモバイルアプリから同じセッションにアクセスできる

!典型的なワークフロー例

午前中（デスクトップ）: コードを書いてPRを作成、Auto-FixとAuto-Mergeをオン
移動中（モバイル）: Claudeアプリで状況を確認、必要があれば追加の指示を出す
午後（デスクトップ）: 戻ってきたらPRはマージ済み、次のタスクに取りかかる

知っておくべき制限事項と注意点

Auto-Fixは非常に便利な機能ですが、以下の制限事項を理解した上で使用することが重要です。

プラットフォームの制限

項目	制限内容
対応リポジトリ	GitHubのみ。GitLab、Bitbucketなどは非対応
状態	Research Preview（リサーチプレビュー）。正式リリースではない
ネットワーク	クラウド環境はデフォルトでネットワークアクセスが制限されている

動作上の制限

項目	制限内容
マージ方式	Auto-Mergeはsquashのみ
権限モード	リモートセッションでは「Ask permissions」モードは使用不可
レート制限	アカウント内の他のClaude利用とレートを共有
返信の名義	GitHubへの返信はあなたのアカウント名義で投稿される

運用上の注意点

1. チームへの共有

Auto-Fixを導入する前に、チームメンバーに以下を共有しておくことをお勧めします。

ClaudeがGitHub上でコメントに返信する場合がある（ラベル付き）
CIの修正プッシュが自動で行われる場合がある
レビューコメントへの対応がAIによって行われる場合がある

2. ブランチ保護ルールの確認

Auto-MergeとAuto-Fixを使う場合、GitHubのブランチ保護ルール（Branch Protection Rules）と競合しないか確認してください。たとえば「最低1人のレビュー承認が必要」というルールがある場合、Auto-Mergeだけではマージできません。

3. 機密情報の取り扱い

Auto-Fixはコードの変更をプッシュするため、以下の点に注意が必要です。

環境変数やシークレットがコードにハードコードされていないか
.gitignoreが正しく設定されているか
CIの出力に機密情報が含まれていないか

実践: Auto-Fixを使ったワークフローの例

ここでは、実際のプロジェクトでAuto-Fixを使う流れを具体的に見ていきましょう。

シナリオ: Next.jsアプリの新機能追加

1. Claude Code on the webでタスクを開始する

ユーザープロフィールページに、アバター画像のアップロード機能を追加してください。
画像は最大2MBまで、JPEGとPNGのみ対応してください。

Claudeがコードを書き、テストを追加し、変更が完了します。

2. Diff Viewで変更を確認する

画面に表示される差分統計（例: +156 -12）をクリックして、Claudeが行った変更を確認します。問題がなければ、PRの作成に進みます。

3. PRを作成してAuto-Fixをオンにする

PRが作成されると、CI status barが表示されます。ここで「Auto-fix」をオンにします。必要であれば「Auto-merge」もオンにします。

4. 別の作業に移る

ここからは自由です。別のタスクに取りかかるもよし、休憩を取るもよし。Claudeがバックグラウンドで以下を処理します。

ESLintが「未使用のimport文」を検出 → Claudeが削除してプッシュ
TypeScriptの型チェックでエラー → Claudeが型を修正してプッシュ
テストが1件失敗 → Claudeが原因を特定して修正
レビュアーが「エラーメッセージをもう少し具体的に」とコメント → Claudeが対応

5. 戻ってきたらマージ済み

Auto-Mergeもオンにしていた場合、すべてのチェックがパスした時点で自動的にマージされています。

よくある質問

Q: Auto-Fixは無限ループしないの?

Claudeは各イベントに対して判断を行い、同じ修正を繰り返すことを避けます。重複イベントや対応不要なイベントはスキップされます。ただし、根本的に解決できない問題（外部サービスのダウンなど）に対しては、何度修正しても失敗し続ける可能性があります。そのような場合、Claudeはユーザーに状況を報告します。

Q: レビュアーの意図と違う修正をしたらどうなる?

Claudeが修正をプッシュした後も、レビュアーは通常通りレビューを続けられます。修正が意図と違っていた場合、レビュアーは再度コメントを残すことができ、Claudeがそのコメントに基づいて再修正を試みます。また、曖昧なコメントに対しては、Claudeは修正を行わずにユーザーに確認を求めます。

Q: Auto-Fixを途中で止められる?

はい。CI status barのAuto-fixトグルをオフにすれば、いつでも監視を停止できます。それまでにClaudeが行った変更はそのまま残りますが、新しいイベントへの自動対応は停止します。

Q: プライベートリポジトリでも使える?

はい。Claude GitHub Appをインストールし、適切な権限を付与すれば、プライベートリポジトリでもAuto-Fixは動作します。

Q: 料金は別途かかる?

Auto-Fix自体に追加料金はかかりません。ただし、Auto-Fixの処理はClaudeのレート制限を消費します。Pro/Max/Team/Enterpriseの各プランのレート上限内で動作します。

まとめ

Claude Code Auto-Fixは、PRのメンテナンス作業を大幅に自動化する機能です。

できるようになること:

CI失敗の自動検出と修正
レビューコメントへの自動対応
Auto-Mergeとの組み合わせによる完全自動化
Web・デスクトップ・モバイルからの操作
デバイスをまたいだシームレスな作業

覚えておくべきこと:

GitHub専用（GitLab等は非対応）
Claude GitHub Appのインストールが必要
曖昧な指示には人間の判断を求める（完全放置ではない）
GitHubへの返信はあなたのアカウント名義
Auto-Mergeのマージ方式はsquashのみ

「PRを出したら、あとはClaudeに任せる」。この記事で紹介したワークフローを取り入れることで、コードを書くことに集中できる時間が確実に増えるはずです。まずは小さなPRでAuto-Fixを試してみて、その便利さを実感してみてください。