ANTIGRAVITY LABEN
記事一覧/Editor View
Editor View/2026-04-10中級

VS Code・Cursor のAI拡張機能が動かないとき—認証エラーと応答停止を切り分ける

VS CodeやCursorでAI拡張機能が動かない・認証エラーが出る・応答が返らない問題を、エラー別に原因と解決手順をステップバイステップで解説します。

troubleshooting88error11fix8vscode4cursor9ai-extensionauthentication4

VS Code・CursorのAI拡張機能が突然動かなくなる問題

VS CodeやCursorでAI拡張機能を使っている最中に、突然コード補完が止まる、認証エラーが表示される、リクエストがタイムアウトする——こうしたトラブルは、開発者のワークフローを大きく妨げます。

GitHub Copilot、Codeium、Continue、Tabnine、Amazon CodeWhispererなど、主要なAI拡張機能すべてに共通する対処法を網羅しています。

よくある症状と原因の分類

AI拡張機能が正常に動作しない場合、症状は大きく4つのカテゴリに分けられます。

認証・ライセンス系のエラーとして、「Sign in required」と繰り返し表示される、トークンの期限切れで再認証を求められる、組織のSSO認証が通らないといった問題があります。

接続・通信系のエラーでは、「Failed to connect to server」や「Request timed out」のメッセージが出る、プロキシ環境下でAPIに接続できない、ファイアウォールによるブロックなどが該当します。

拡張機能の動作不良として、インライン補完が表示されなくなる、チャット機能が応答しない、拡張機能がクラッシュして再起動を繰り返すケースがあります。

環境・設定の競合では、複数のAI拡張機能が干渉し合う、VS Codeのアップデート後に動作しなくなる、設定ファイルの破損などが原因になります。

認証エラーの解決手順

認証関連のトラブルは最も頻繁に報告される問題です。以下の手順で段階的に解決できます。

Step 1: 認証トークンのリフレッシュ

まず、VS Codeのコマンドパレットから認証状態をリセットします。

# VS Code のコマンドパレットで実行
# Ctrl+Shift+P (Windows/Linux) / Cmd+Shift+P (Mac)
 
# GitHub Copilot の場合
> GitHub Copilot: Sign Out
> GitHub Copilot: Sign In
 
# Codeium の場合  
> Codeium: Sign Out
> Codeium: Provide Authentication Token
 
# 認証キャッシュの手動削除(Mac)
rm -rf ~/Library/Application\ Support/Code/User/globalStorage/github.copilot*
# 認証キャッシュの手動削除(Windows)
# %APPDATA%\Code\User\globalStorage\github.copilot* を削除
 
# 認証キャッシュの手動削除(Linux)
rm -rf ~/.config/Code/User/globalStorage/github.copilot*

Step 2: 組織SSO認証の確認

GitHub Copilotを組織ライセンスで使用している場合、SSOトークンの再認証が必要なことがあります。

# GitHub CLIで組織のSSO状態を確認
gh auth status
 
# 出力例:
# github.com
#   ✓ Logged in to github.com as username
#   ✓ Token: ghp_****
#   ✗ Token is not authorized for SSO organization: your-org
 
# SSO認証の再実行
gh auth refresh -h github.com --scopes "copilot"

ブラウザが開いてSSO認証フローが始まります。組織の管理者がCopilotのシートを割り当てていることも確認してください。

Step 3: ライセンス状態の確認

# GitHub Copilotのサブスクリプション状態をAPIで確認
curl -H "Authorization: Bearer $(gh auth token)" \
  https://api.github.com/copilot_internal/v2/token 2>/dev/null | \
  python3 -c "import sys,json; d=json.load(sys.stdin); print(f'Expires: {d.get(\"expires_at\",\"N/A\")}')"
 
# 期待する出力:
# Expires: 2026-04-10T20:00:00+00:00
# → 有効期限が過去の日付なら、サブスクリプションの更新が必要

接続エラーの解決手順

Step 1: ネットワーク接続の診断

AI拡張機能のバックエンドAPIに正常に到達できるかを確認します。

# GitHub Copilot のエンドポイント確認
curl -sI https://copilot-proxy.githubusercontent.com/v1/engines | head -5
# 期待する出力: HTTP/2 401 (認証なしでも到達できればOK)
 
# Codeium のエンドポイント確認
curl -sI https://server.codeium.com | head -5
 
# プロキシ設定の確認
echo "HTTP_PROXY: ${HTTP_PROXY:-not set}"
echo "HTTPS_PROXY: ${HTTPS_PROXY:-not set}"
echo "NO_PROXY: ${NO_PROXY:-not set}"

Step 2: VS Codeのプロキシ設定

企業ネットワークやVPN環境では、VS Codeのプロキシ設定が正しくないとAI拡張機能が通信できません。

// settings.json に追加
{
  "http.proxy": "http://proxy.example.com:8080",
  "http.proxyStrictSSL": false,
  "http.proxyAuthorization": null,
  "github.copilot.advanced": {
    "debug.overrideProxyUrl": "http://proxy.example.com:8080"
  }
}

Step 3: ファイアウォールの許可設定

以下のドメインへのアクセスを許可する必要があります。

  • copilot-proxy.githubusercontent.com(GitHub Copilot)
  • api.github.com(GitHub認証)
  • server.codeium.com(Codeium)
  • api.tabnine.com(Tabnine)
  • *.amazonaws.com(CodeWhisperer)
# 各エンドポイントへの疎通確認スクリプト
for host in copilot-proxy.githubusercontent.com api.github.com server.codeium.com api.tabnine.com; do
  if curl -sI --connect-timeout 5 "https://$host" > /dev/null 2>&1; then
    echo "✅ $host — 接続OK"
  else
    echo "❌ $host — 接続失敗(ファイアウォールまたはDNSを確認)"
  fi
done
 
# 期待する出力:
# ✅ copilot-proxy.githubusercontent.com — 接続OK
# ✅ api.github.com — 接続OK
# ✅ server.codeium.com — 接続OK
# ✅ api.tabnine.com — 接続OK

拡張機能の動作不良を直す

Step 1: 拡張機能の再インストール

拡張機能の内部キャッシュが破損している場合、クリーンな再インストールが最も確実です。

# VS Code CLI でAI拡張機能を一度アンインストール
code --uninstall-extension github.copilot
code --uninstall-extension github.copilot-chat
 
# 拡張機能のキャッシュを削除(Mac)
rm -rf ~/.vscode/extensions/github.copilot-*
rm -rf ~/Library/Application\ Support/Code/CachedExtensionVSIXs/github.copilot*
 
# 再インストール
code --install-extension github.copilot
code --install-extension github.copilot-chat
 
# VS Code を完全に再起動(ウィンドウの閉じ直しではなく)
# Mac: Cmd+Q → 再度開く
# Windows: タスクマネージャーで Code プロセスを終了 → 再度開く

Step 2: 出力ログの確認

拡張機能の詳細なエラーログを確認することで、原因を特定できます。

VS Code メニュー:
  表示 → 出力 → ドロップダウンから拡張機能名を選択
 
確認すべきチャンネル:
  - "GitHub Copilot" — API通信ログ
  - "GitHub Copilot Chat" — チャット機能のログ  
  - "Extension Host" — 拡張機能全体の起動ログ

ログに ECONNREFUSEDETIMEOUT401 Unauthorized などのキーワードがあれば、それぞれ接続エラー、タイムアウト、認証エラーを示しています。

Step 3: Cursorでの追加対処

Cursorは独自のAIバックエンドを持つため、VS Codeとは異なる対処が必要な場合があります。

# Cursor の設定リセット(Mac)
rm -rf ~/Library/Application\ Support/Cursor/User/globalStorage/cursor*
rm -rf ~/Library/Application\ Support/Cursor/Cache
 
# Cursor の設定リセット(Windows)
# %APPDATA%\Cursor\User\globalStorage\cursor* を削除
# %APPDATA%\Cursor\Cache を削除
 
# Cursor の設定リセット(Linux)
rm -rf ~/.config/Cursor/User/globalStorage/cursor*
rm -rf ~/.config/Cursor/Cache

Cursorでは「Settings → Models」から使用モデルを切り替えることで、特定モデルのAPIエラーを回避できる場合もあります。

複数AI拡張機能の競合を解消する

Step 1: 競合の診断

複数のAI補完拡張機能を同時に有効にすると、補完候補の表示が不安定になったり、レスポンスが極端に遅くなることがあります。

// settings.json で補完プロバイダーの優先順位を明示
{
  // GitHub Copilot をメイン補完に
  "editor.inlineSuggest.enabled": true,
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": false
  },
  // Tabnine のインライン補完を無効化(チャットのみ使用)
  "tabnine.experimentalAutoImports": false,
  // Codeium のインライン補完を無効化
  "codeium.enableCodeLens": false
}

Step 2: 拡張機能のプロファイル分け

VS Codeのプロファイル機能を使い、用途に応じてAI拡張機能を切り替えるのが最も安定した運用方法です。

# Copilot用プロファイルの作成
# コマンドパレット: > Profiles: Create Profile
# → 名前: "AI - Copilot"
# → GitHub Copilot のみ有効
 
# Codeium用プロファイルの作成  
# → 名前: "AI - Codeium"
# → Codeium のみ有効
 
# プロファイルの切り替え
# コマンドパレット: > Profiles: Switch Profile

解決できたかの確認方法

対処を行った後、以下の手順で正常動作を検証してください。

# 1. VS Code の Developer Tools でエラーがないか確認
# Ctrl+Shift+I (Windows/Linux) / Cmd+Opt+I (Mac)
# Console タブでエラーがないことを確認
 
# 2. 拡張機能のステータスバー確認
# - GitHub Copilot: 右下にCopilotアイコンが表示され、回転していないこと
# - Codeium: 右下に "Codeium: Connected" と表示されること
 
# 3. 補完テスト(任意の .js ファイルで)
# function fibonacci( と入力 → インライン補完が表示されること
 
# 4. チャットテスト(Copilot Chat / Cursor Chat)
# "Hello, can you explain what this file does?" → 応答が返ること

予防策:再発を防ぐベストプラクティス

日頃から以下を心がけることで、AI拡張機能のトラブルを未然に防げます。

拡張機能の自動更新を有効にする: "extensions.autoUpdate": true を設定し、常に最新バージョンを使用します。ただしメジャーアップデート直後は不安定な場合があるため、チームで段階的に展開するのが安全です。

VS Codeのバージョンを最新に保つ: AI拡張機能はVS Codeの最新APIに依存していることが多く、古いバージョンでは互換性の問題が起きやすくなります。

ネットワーク環境の変更時に再認証する: VPN接続の切り替え、オフィス↔自宅の移動など、ネットワーク環境が変わった際には認証トークンの再発行を行うと安定します。

定期的なキャッシュクリア: 月に一度、拡張機能のキャッシュをクリアすることで、蓄積したゴミデータによる不具合を防止できます。

AI開発環境の構築全般について体系的に

全体を振り返って

VS CodeやCursorでAI拡張機能が動かなくなった場合、まず症状を「認証エラー」「接続エラー」「動作不良」「拡張機能の競合」の4つに分類し、対応する解決手順を順番に試すのが効率的です。多くの場合、認証トークンのリフレッシュと拡張機能の再インストールで解決します。

より複雑なケースでは、ネットワーク設定の見直しや拡張機能のプロファイル分けが有効です。日頃から定期的なキャッシュクリアと自動更新を心がけることで、トラブルの再発を防ぐことができます。

Antigravityへの移行を検討している方は、VS Code × Antigravity 移行・連携ガイドAntigravity エディタでよくある問題と解決法も参考にしてみてください。

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

Tips & 活用術2026-04-10
AI APIの429エラー・認証失敗・タイムアウトを解決する完全トラブルシューティングガイド
OpenAI・Gemini・Claude APIで発生する429 Rate Limit・認証エラー・タイムアウトの原因と対処法をStep by Stepで解説。再発防止のベストプラクティスも紹介します。
AIツール2026-06-17
LM Studio が起動しない・モデルが読み込まれない時の直し方【Mac/Windows・2026年版】
LM Studioが起動しない、モデルが読み込まれない、APIサーバーが応答しないなど、よくあるエラーの原因と解決手順をMac・Windows別に詳しく解説します。
AIツール2026-06-17
PyTorch・CUDAインストールエラーの直し方 — torch.cuda.is_available()がFalse・バージョン不一致の解決【2026】
PyTorchやCUDAのインストールが失敗する原因を解説し、バージョン不一致・依存関係エラー・GPUが認識されない問題をStep by Stepで解決します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →