GitHub Copilot Appを入れたのに、ログインできない、リポジトリが表示されない、Agentが止まるという症状が出ています。
今週は再インストールから始めず、①起動、②GitHub認証、③リポジトリ権限、④組織ポリシー、⑤Agent実行環境、⑥AI Creditsの順に1層ずつ切り分けてください。
初回インストール後にAgent Sessionsを作れない個人開発者、私有リポジトリを扱うチームメンバー、そしてクライアント障害か組織設定かを判断したい管理者向けの記事です。
まず故障箇所を六つに分ける
GitHub Copilot Appが使えない場合、アプリ本体の故障とは限りません。ログイン済みでも対象リポジトリの権限がなければ一覧には出ず、リポジトリが見えてもブランチ保護やGit認証が原因でプッシュできないことがあります。
さらに、企業アカウントでは個人設定より上位のポリシーが優先されます。Agentがコマンドを実行できない場合も、モデルの問題ではなく、作業ディレクトリ、依存関係、承認設定、ネットワーク制限が原因かもしれません。
| 症状 | 最初に確認する場所 | 判断 |
|---|---|---|
| アプリが起動しない | 公式配布元、対応OS、更新状態、OSの安全機能 | アプリ層 |
| ログインできない | ブラウザー認証、アカウント、プロキシ、組織認証 | 認証層 |
| リポジトリが見えない | GitHub権限、所属組織、私有リポジトリのアクセス範囲 | 権限層 |
| クローンやプッシュに失敗する | Git URL、認証情報、ブランチルール | Git層 |
| Agentが命令を実行しない | セッションの実行場所、依存関係、承認、サンドボックス | 実行層 |
| 途中で制限される | モデル、BYOK、AI Credits、レート制限 | 利用量層 |
この順番なら、権限問題に対して何度もアプリを入れ直す無駄を避けられます。
起動とインストールの確認
GitHub Copilot AppはmacOS、Linux、Windowsに対応しています。Copilot BusinessまたはCopilot Enterpriseを組織経由で利用する場合は、管理者によるCopilot CLIポリシーの有効化が前提です。個人プランと組織プランでは、同じ画面でも利用条件が異なります。(GitHub Copilot Appの公式概要)
確認手順は次の通りです。
- GitHubの公式ダウンロードページから取得したアプリか確認します。
- OSのバージョンとアプリの更新状態を確認します。
- 初回起動時にOSの安全機能がアプリを止めていないか確認します。
- 起動直後に表示される警告文を、そのまま保存します。
- 別のユーザーアカウントや別端末で起動できるかを確認します。
最低ハードウェア構成を推測して「性能不足」と決めつけるのは危険です。起動しない段階では、配布元、OSの互換性、ローカルの安全設定、破損した更新状態を先に確認してください。
注意:ログにアクセストークン、リポジトリURL、メールアドレス、組織名が含まれる場合があります。サポートへ送る前に、値を
REDACTEDなどへ置き換えてください。
ログインとアカウント認証
GitHub Copilot Appのログインに失敗したら、何を先に確認すべきですか。
まず同じブラウザーでGitHubへログインし、対象アカウントから目的のリポジトリを開けるか確認します。ブラウザーでも開けないなら、アプリを再認証しても解決しません。
次に、認証画面が個人アカウントになっていないか確認します。組織からCopilotの利用権を割り当てられている場合、個人アカウントにはライセンスがない可能性があります。会社のシングルサインオンや追加認証が必要な環境では、認証画面を閉じずに組織の手順を完了してください。
社内プロキシやVPNを利用している場合は、認証ページだけが遮断されていないかを確認します。切断して試すだけでなく、規則上VPNが必須なら管理者に認証ドメインの許可を確認します。認証画面が開く場合と、認証後にアプリへ戻れない場合では原因が異なります。
GitHub Copilot Appの公式スタートガイドでも、初回起動時は「Sign in to GitHub」から認証し、GitHub Enterpriseを使う場合は対象サーバーを選択する手順になっています。(公式スタートガイド)
リポジトリとGit認証
Copilot Appで私有リポジトリが表示されない場合はどうしますか。
GitHub上で対象リポジトリを直接開き、読み取り権限以上があるか確認します。組織に所属しているだけでは、すべての私有リポジトリへアクセスできるとは限りません。チーム所属、外部コラボレーター状態、リポジトリ単位のアクセス設定を確認してください。
リポジトリは見えるのにクローンできない場合、次を順番に確認します。
- 表示されたリポジトリと、選択したリポジトリが同じか。
- GitのリモートURLが古いアカウントや別組織を指していないか。
- ローカルの認証情報が、現在ログインしているGitHubアカウントと一致しているか。
- クローン先のフォルダーに書き込み権限があるか。
- プッシュ先ブランチに保護ルールやレビュー必須条件がないか。
GitHub Copilot Appでは、既存のローカルフォルダー、GitHub上のリポジトリ、Git URLからプロジェクトを追加できます。GitHub以外のGitホストや、アプリから直接アクセスできない私有リポジトリを使う場合は、Git URLと認証情報を別に用意する必要があります。(Agent Sessionsの公式手順)
つまり、GitHub権限とGit認証は同じものではありません。ブラウザーで閲覧できても、ローカルのGit認証が不正ならクローンやプッシュは失敗します。
組織ポリシーと管理設定
組織アカウントでCopilot Appを使えない場合、CLIポリシーだけを確認すればよいですか。
2026年7月27日以降は、GitHub Copilot Appに独立したポリシーが設定されています。従来のCopilot CLIポリシーだけを確認する旧経路では不十分です。企業または組織の設定で、AI Controls内の「Copilot Clients」からCopilot Appの状態を確認してください。(GitHub Changelogの独立ポリシー告知)
管理者が確認する項目は次の三つです。
- Enterprise側でCopilot Appが「全体で有効」「全体で無効」「組織に委任」のどれになっているか。
- 組織側で、割り当てられたCopilotライセンスとApp利用条件が一致しているか。
managed-settings.jsonでプラグイン、マーケットプレース、承認省略などが制限されていないか。
Copilot AppとCopilot CLIは独立したクライアントポリシーで管理されます。CLIを有効にしてもAppが自動的に許可されるとは限らず、逆も同様です。企業管理設定は、Appへ再ログインするか再起動した時点で反映される場合があります。(GitHub Changelogの管理設定告知)
Agent Sessionsの実行環境
Agentセッションがコマンドを実行しない原因は何ですか。
まず最小の作業で再現してください。新しいブランチまたは一時フォルダーを使い、「READMEの一文を確認する」「テスト一覧を表示する」など、変更範囲の小さい命令から始めます。
次に、実行場所を確認します。GitHub Copilot Appのセッションは、ローカルリポジトリ、新しい作業ツリー、クラウドサンドボックスなどで動かせます。場所が変われば、利用できるファイル、環境変数、依存関係、ネットワーク到達性も変わります。各Agent Sessionsは分離されたワークスペースで動作するため、別セッションで作った依存関係や認証情報を前提にしてはいけません。
次の順で確認します。
- セッションの作業ディレクトリが目的のプロジェクトか確認します。
- 依存関係をインストール済みか確認します。
- 実行ファイルや設定ファイルに読み書き権限があるか確認します。
- ネットワークアクセスや外部APIが必要か確認します。
- コマンド実行前の承認を拒否していないか確認します。
- 高リスク操作を、最小の安全な操作へ分解します。
主ブランチで直接試すのではなく、検証用ブランチで差分とログを確認してください。実行場所を変えた場合は、同じ命令でも結果を単純比較できません。
モデル、BYOK、AI Credits
GitHub Copilot Appに使用制限が表示された場合の確認先はどこですか。
まず選択中のモデルが、個人または組織のポリシーで許可されているか確認します。BYOKを使う場合は、プロバイダーの認証情報、モデル名、利用可能なリージョン、アカウント側の上限を確認してください。キーが正しくても、そのモデルが組織ポリシーで禁止されていれば利用できません。
AI Creditsを使い切った場合は、利用状況ページで当期の消費量を確認します。個人プランではAI usage、BusinessやEnterpriseではCopilot設定のUsageから確認できます。レート制限は一時的な場合があるため、短時間に大量の自動リクエストを送らず、時間を置いて再試行します。(利用制限の公式説明)
AI Creditsはモデルやトークン量によって消費が変わります。公式ドキュメントでは、1 AI Creditは0.01米ドル相当として説明されていますが、実際の利用可否は契約、予算、組織設定によって変わります。
失敗時に残す情報
最後まで解決しない場合は、再インストールより先に最小再現を完成させます。
- アプリのバージョン
- OSと更新状態
- 発生日時とタイムゾーン
- 個人アカウントか組織アカウントか
- 対象リポジトリが公開か私有か
- ローカル、作業ツリー、クラウドのどこで実行したか
- 選択したモデルまたはBYOKの有無
- AI Creditsとレート制限の表示
- エラー本文の原文
- トークンや個人情報を除いたログ
公式のGitHub Copilot App概要、組織ポリシーの管理方法、利用制限の説明を照合すると、クライアント障害、権限不足、ポリシー制限、利用量超過を分けやすくなります。
ローカル環境の権限や常時接続が原因で作業が止まるなら、実行場所を別の開発環境へ移す前に、要件と接続経路を整理してください。VPSSparkのサービス概要やお問い合わせ窓口を確認し、遠隔のMac開発環境が必要なケースだけを比較するのが適切です。自分の端末で完結する軽い作業までレンタル環境へ移す必要はありません。一方、端末のスリープ、社内ネットワーク、ローカル権限、継続稼働がボトルネックなら、手元の環境より遠隔環境のほうが切り分けと再現を安定させやすくなります。
開発環境の見直しに、VPSSparkのクラウドMacを
アプリのログインや権限設定でお困りの際も、整ったMac環境をすぐにご利用いただけます。
手元の端末に左右されず、リモート接続できるMacで開発作業を安定して進められます。