メインコンテンツまでスキップ

GitHub Copilot の接続問題を修正する

ヒント

GitHub Copilot の接続問題を解決し、AI アシスト付きコーディングを再開しましょう。

一般的なエラーメッセージ

1. 接続失敗

エラー:拡張機能 'GitHub Copilot' がサーバーに接続できません。
拡張機能の有効化に失敗:Copilot トークンを取得できません

2. 認証失敗

GitHub Copilot がサーバーに接続できません。
GitHub アカウントにサインインしてください。

クイック解決策

1. 再サインイン

  1. コマンドパレットを開く (Ctrl/Cmd + Shift + P)
  2. "Copilot: Sign In" と入力
  3. 認証フローに従う

2. 認証情報のリセット

# Windows
del "%APPDATA%\Code\User\settings.json"

# macOS/Linux
rm ~/.config/Code/User/settings.json

ステップバイステップのトラブルシューティング

1. GitHub 認証の確認

# GitHub 認証ページを開く
github.com/login/device

# デバイスコードを入力
Cursor に表示されているコードを入力

2. ネットワーク接続

# GitHub 接続をテスト
ping github.com

# Copilot API を確認
curl https://copilot.githubusercontent.com

3. 拡張機能の状態

  1. 拡張機能の状態を確認:

    • 拡張機能パネルを開く
    • "GitHub Copilot" を検索
    • バージョンと状態を確認
  2. 拡張機能のリセット:

    # Windows
    rd /s /q "%USERPROFILE%\.vscode\extensions\github.copilot-*"

    # macOS/Linux
    rm -rf ~/.vscode/extensions/github.copilot-*

高度なトラブルシューティング

1. キャッシュのクリア

# Windows
rd /s /q "%APPDATA%\Code\Cache"
rd /s /q "%APPDATA%\Code\CachedData"

# macOS
rm -rf ~/Library/Application\ Support/Code/Cache
rm -rf ~/Library/Application\ Support/Code/CachedData

# Linux
rm -rf ~/.config/Code/Cache
rm -rf ~/.config/Code/CachedData

2. プロキシ設定の確認

settings.json
{
"http.proxy": "http://proxy.example.com:8080",
"http.proxyStrictSSL": true
}

3. デバッグモード

# デバッグログを有効化
1. コマンドパレットを開く
2. "Developer: Set Log Level"
3. "Trace" を選択

一般的な問題と解決策

1. トークンの有効期限切れ

# トークンの強制更新
1. Copilot からサインアウト
2. 認証情報をクリア
3. 再サインイン

2. ネットワーク制限

# 必要なドメイン
copilot.githubusercontent.com
api.github.com
github.com

3. 拡張機能の競合

settings.json
{
"extensions.autoUpdate": false,
"extensions.ignoreRecommendations": true
}

ベストプラクティス

1. 定期的なメンテナンス

# 週次チェック
1. 認証を確認
2. 拡張機能を更新
3. 必要に応じてキャッシュをクリア

2. 設定管理

settings.json
{
"github.copilot.enable": {
"*": true,
"plaintext": false,
"markdown": false
},
"github.copilot.advanced": {
"debug.overrideEngine": "stable",
"debug.testOverrideProxyUrl": null
}
}

3. セキュリティ

# セキュアなトークン保存
1. 認証情報マネージャーを使用
2. 二要素認証を有効化
3. 定期的なトークンのローテーション

Cursor との統合

1. 拡張機能の設定

{
"cursor.github.copilot.enable": true,
"cursor.github.copilot.inlineSuggest.enable": true
}

2. キーボードショートカット

アクションWindows/LinuxmacOS
提案を受け入れるTabTab
次の提案Alt + ]Option + ]
前の提案Alt + [Option + [
インライン表示Alt + \Option + \

トラブルシューティングワークフロー

1. 初期チェック

graph TD
A[開始] --> B{接続確認}
B -->|失敗| C[認証確認]
B -->|成功| D[拡張機能確認]
C --> E[再サインイン]
D --> F[拡張機能更新]

2. 高度な診断

# 診断手順
1. デバッグログを有効化
2. 問題を再現
3. ログを収集
4. エラーを分析

3. 復旧手順

# 段階的な復旧
1. サインアウト
2. キャッシュをクリア
3. 拡張機能を削除
4. Cursor を再起動
5. 拡張機能を再インストール
6. サインイン

予防のヒント

  1. 定期的な更新

    • Cursor を最新に保つ
    • 拡張機能を更新
    • トークンの有効期限を確認
  2. ネットワーク設定

    • プロキシ設定を構成
    • 必要なドメインを許可
    • 接続をテスト
  3. 設定のバックアップ

    # 設定をバックアップ
    cp settings.json settings.backup.json

サポートへの連絡時期

1. 継続的な問題

  • すべての手順を試しても接続が失敗
  • 認証ループ
  • 拡張機能のクラッシュ

2. 必要な情報

# 情報収集
1. Cursor バージョン
2. Copilot バージョン
3. エラーメッセージ
4. デバッグログ

3. サポートチャネル

  • GitHub Issues
  • Cursor サポート
  • コミュニティフォーラム
ヒント

サポートに連絡する前に、基本的なトラブルシューティング手順を必ず試してください!

関連リソース