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" — 拡張機能全体の起動ログログに ECONNREFUSED、ETIMEOUT、401 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/CacheCursorでは「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 エディタでよくある問題と解決法も参考にしてみてください。