Claude Code DesktopのPR監視機能(CI status bar)を使う
Claude Code Desktopはプルリクエストを開くとCIの状況をセッション内に表示します。Auto-fixとAuto-mergeの設定、gh CLIの前提条件まで手順で確認します。
Claude Code Desktopでプルリクエストを開くと、セッション画面にCIステータスバーが自動で表示されます。GitHub CLI(gh)を使ってチェック結果をポーリングし、成功・失敗をセッション内で追える仕組みです。Auto-fixとAuto-mergeを組み合わせれば、CIが落ちたときの修正やマージまでClaudeに任せられます。
Claude Code DesktopのPR監視機能とは
プルリクエストを開くと、セッション内にCIステータスバーが現れます。Claude CodeはGitHub CLIを使ってチェック結果をポーリングし、失敗があれば表示します。ターミナルでgh pr checksを都度実行して確認する運用と違い、Desktopではセッションを見ているだけでCIの状態が目に入る点が特徴です。この特徴は、DesktopとCLIの使い分け全体の中でも視覚面での強みとして位置付けられています。
この機能を使うには、あらかじめGitHub CLIがマシンにインストールされ、認証済みである必要があります。未インストールの場合、Desktopは初めてPRを作成しようとしたタイミングでインストールを促します。
PR監視は、Claudeが変更を終えてからPRを開くまでの一連の流れの最後の工程にあたります。変更内容そのものはdiff viewで先にレビューしておくことが多く、diff viewでのレビューが済んだ変更をPR化し、CIステータスバーで結果を待つ、という順序で使うのが自然な流れです。
CIステータスバーで状況を確認する
手順は次の通りです。
- セッション内でClaudeにPRを作成させる、または自分でPRを開く
- セッション画面にCIステータスバーが自動で表示される
- チェックの成功・失敗がバーに反映される
- CIが完了すると、デスクトップ通知が届く
ステータスバーはセッションに紐づいているため、複数のセッションでそれぞれ別のPRを開いていれば、セッションを切り替えるだけでPRごとのCI状況を見比べられます。
Auto-fixとAuto-mergeを設定する
CIステータスバーにはAuto-fixとAuto-mergeという2つのトグルがあります。
| 機能 | 動作 | 前提条件 |
|---|---|---|
| Auto-fix | 動作CIチェックが失敗すると、失敗内容を読んで自動的に修正を試みる | 前提条件特になし(トグルをオンにするだけ) |
| Auto-merge | 動作すべてのチェックが通ったらPRをマージする(マージ方式はsquash) | 前提条件GitHubリポジトリ側でauto-mergeを事前に有効化しておく必要がある |
Auto-fixは、テストの失敗やリンターエラーのような比較的機械的に直せる問題に向いています。CIが落ちるたびに手動でログを読みに行く手間を減らせますが、失敗の原因が設計判断に関わるものだった場合は、Auto-fixに任せきりにせず自分でも確認したほうが安全です。
どちらのトグルもCIステータスバー自体に表示される設定なので、操作するにはまずPRを開いてステータスバーを表示させる必要があります。複数のPRを並行して進める場合は、セッションを切り替えるたびにトグルの状態を確認しておくと、意図しないマージや修正を防げます。
セッションを自動でアーカイブする
PRがマージまたはクローズされたら、そのセッションを片付けたくなる場面は多いはずです。Settings → Claude CodeのAuto-archive after PR merge or closeをオンにしておくと、Claude Code DesktopはPRがマージ・クローズされたタイミングでセッションを自動的にアーカイブします。対象はローカルセッションのうち、すでに実行が終わっているものに限られます。
複数のPRを並行して進めているときは、この設定をオンにしておくとサイドバーが自然に整理され、進行中のセッションだけが残ります。セッションの並行管理そのものについては、Claude Code Desktopの並列セッション機能の使い方で詳しく扱っています。
複数のPRを並行して監視する
CIステータスバーはセッション単位で表示されるため、PRを複数抱えているときは、それぞれ別のセッションで作業していれば自然とPRごとの監視になります。サイドバーを行き来するだけで「どのPRのCIが落ちているか」を横断的に把握できるのは、ターミナルでgh pr checksを都度打ち込む運用にはない利点です。
複数セッションの並行管理自体は、Gitワークツリーによる自動分離があってはじめて安全に成立する仕組みです。1つのプロジェクトで複数のPRを同時に進める場合は、セッション分離の前提を先に押さえておくと、PR監視も含めた全体像がつかみやすくなります。
よくある落とし穴
- Auto-mergeをオンにしたのにマージされない: 前提条件のリポジトリ側設定を有効化していないケースが大半です。トグル自体はDesktop側の設定なので、GitHub側の設定を見落としがちです
ghの認証が切れていることに気づかない: CI監視はghの認証状態に依存しています。認証が切れるとステータスバーが更新されなくなるため、CIの表示が長時間止まっているときはghの認証状態を疑ってください- Auto-fixに任せきりで修正内容を確認しない: Auto-fixはCIを通すことを優先して修正するため、テストの通し方が本来の意図とずれることがあります。マージ前にdiff viewで修正内容を確認する習慣をつけておくと安全です
PR監視はCLIでの確認と何が違うか
CLIでPRのCI状況を追う場合、ghコマンドを自分でターミナルに打ち込んで確認する運用になります。Desktopはこの確認作業をセッション画面に統合し、CIステータスバーとして常時表示する点が異なります。Auto-fixやAuto-mergeのようなトグル操作も、CLIには用意されていないDesktop固有の機能です。
一方で、CI監視の裏側で動いているのは同じgh CLIです。Desktopが特別なAPIを持っているわけではなく、GitHub CLIのポーリング結果をGUIとして見やすく表示している、という理解が実態に近いところです。GitHub Actions自体にClaude Codeを組み込みたい場合は、Claude CodeをGitHub Actionsに組み込む方法も参考になります。
よくある質問
ghがインストールされていないとPR監視は使えませんか
CI監視自体がgh CLIのポーリングに依存しているため、インストールと認証が前提条件です。ただし未インストールの状態で初めてPRを作成しようとすると、Desktop側からインストールを促す案内が出るため、事前に手動でセットアップしていなくても大きくつまずくことはありません。
Auto-mergeのマージ方式は選べますか
マージ方式はsquashに固定されています。コミット履歴をマージコミットやリベースで残したい場合は、Auto-mergeを使わずに手動でマージする必要があります。
Auto-fixが何度も失敗を繰り返す場合はどうすればいいですか
Auto-fixはCIの失敗内容を読んで修正を試みますが、原因が設計判断に関わる場合は繰り返し失敗することがあります。トグルをオフにして、CIステータスバーの詳細を自分で確認しながら手動で対応したほうが早いこともあります。
CI完了の通知はどこに届きますか
Claude Code Desktopはデスクトップ通知を送ります。セッションを開いていない状態でもCI完了が分かるため、複数のPRを並行して走らせているときに便利です。
複数リポジトリを扱っていても監視は個別に見られますか
CIステータスバーはセッション単位で表示されるため、リポジトリが異なっていてもセッションを分けていれば混ざりません。プロジェクトやステータスでセッションを絞り込むフィルターも用意されているので、監視対象が増えても目的のセッションを見失いにくい構成になっています。
まとめ
Claude Code DesktopのPR監視機能は、PRを開くだけでCIステータスバーが自動表示され、gh CLIのポーリング結果をセッション内で確認できる仕組みです。Auto-fixはCI失敗時の自動修正、Auto-mergeは全チェック通過後の自動マージを担いますが、Auto-mergeにはリポジトリ側でのauto-merge事前有効化が必須です。PRのマージ・クローズ後はAuto-archiveでセッションを自動整理しておくと、並行して複数のPRを進める運用がしやすくなります。CIを見張る作業そのものから解放されることで、レビューやコメントの返信に時間を回せるようになります。