Claude Code実行時の「Extension Not Found」エラーと対処方法
症状
Claude Codeでコード実行を試みると、以下のようなエラーメッセージが表示される場合があります。
Extension Not Found
このエラーは、コード実行機能に必要なシステムコンポーネントが正常に認識されていない状態を示しています。特に初回実行時や環境変更後に発生することが多いです。
想定される原因
このエラーが発生する主な原因は以下の通りです。
1. Claude Code拡張機能の初期化遅延
Claude Codeの拡張機能がまだ完全に読み込まれていない場合、実行環境が検出できません。これは初回アクセス時やシステムの再起動直後に見られやすい現象です。
2. ブラウザキャッシュの不整合
ブラウザのキャッシュに古い設定情報が残っていると、新しい拡張機能の状態を認識できず、エラーが発生することがあります。
3. セッション情報の失効
コード実行環境とのセッションが切れている場合、新規セッション確立時に拡張機能が見つからないというエラーが報告されます。
4. ネットワーク接続の不安定性
実行環境との通信に遅延がある場合、拡張機能の検出に失敗する可能性があります。
切り分け手順
問題を特定するため、以下の順序で確認してください。
ステップ1: ページ再読み込みの実施
まず、最も簡単な解決方法から試します。
- Claude Codeの画面を開いたブラウザタブで「F5」キーを押す、または⌘+Rを実行
- ページの完全読み込みが完了するまで待機（通常30秒～1分）
- 再度コード実行を試みる
このステップで解決することが多いため、必ず実施してください。
ステップ2: ブラウザキャッシュクリア
ページ再読み込みで改善しない場合、キャッシュをクリアします。
Chrome/Edge/Brave の場合：
- Ctrl+Shift+Delete（Windows）または ⌘+Shift+Delete（Mac）を入力
- 「キャッシュされた画像とファイル」のみをチェック
- 「全期間」を選択して削除
- ブラウザを再起動
Safari の場合：
- Safari メニュー → 履歴を削除
- 「全履歴」を選択して削除
- ブラウザを再起動
ステップ3: ネットワーク接続確認
通常のWebサイト閲覧は正常でも、実行環境との通信に問題がないか確認します。
- ブラウザの開発者ツールを開く（F12）
- 「Network」タブを選択
- Claude Codeで再度実行を試みる
- エラーレスポンスの詳細（HTTP ステータスコード、タイムアウト）を確認
- HTTP 503/504 → サーバー側の一時的な問題
- タイムアウト → ネットワーク接続の不安定性
- その他のエラー → キャッシュやセッション周りの問題
ステップ4: 別ブラウザでテスト
特定のブラウザでのみエラーが発生するかを確認します。
- 別のブラウザ（例：ChromeでエラーならFirefoxで試す）でClaudeにアクセス
- 同じコードで実行を試みる
- エラーの再現性を確認
特定ブラウザでのみ発生する場合、そのブラウザの拡張機能競合が疑われます。
対処方法
以下を優先度順に実施してください。
優先度1: 基本的なリセット（成功率：約70%）
方法A: ハードリフレッシュ
Windows: Ctrl+Shift+R
Mac: ⌘+Shift+R
ブラウザキャッシュを完全に無視してページを再読み込みします。これにより拡張機能の再初期化が強制されます。
方法B: プライベートウィンドウでのテスト
- 新規プライベートウィンドウ/シークレットウィンドウを開く
- Claude Codeにアクセス
- 同じコードで実行を試みる
プライベートウィンドウではキャッシュが使用されないため、純粋な環境で動作確認ができます。成功した場合、メインウィンドウのキャッシュ削除で解決します。
優先度2: ブラウザ設定の確認（成功率：約20%）
JavaScript実行状況の確認
- ブラウザ設定を開く
- プライバシー/セキュリティ → サイト設定
- JavaScriptが「許可」になっているか確認
- Anthropic（claude.ai）がブロックリストに登録されていないか確認
サードパーティクッキーの確認
- クロスサイトトラッキング防止が有効な場合、実行環境との通信が制限される可能性があります
- Claude.aiをサイト例外に追加することで改善する場合があります
優先度3: セッションのリセット（成功率：約5%）
複数のアカウントやセッションが競合している場合の対処方法です。
- すべてのClaudeタブを閉じる
- ブラウザを完全に終了
- 5分待機
- ブラウザを起動し、claude.aiに再度ログイン
- コード実行を試みる
この待機時間により、サーバー側のセッションがクリアされます。
それでも解決しないとき
以下のケースは環境やアカウント側の問題が疑われます。
ケース1: 複数環境でエラー発生
- Windows、Mac、スマートフォンなど複数の端末・環境で同じエラーが出ている
- → Claude アカウント側またはネットワーク経路の問題の可能性が高い
- → Claude公式のサポートフォームへの報告を推奨
ケース2: 特定のコード実行のみエラー
- 特定の言語（Python、JavaScriptなど）のみエラーになる
- 特定の操作（ファイル操作、外部API呼び出しなど）でエラーになる
- → 実行環境の制限やセキュリティ設定が関係している可能性
- → コード内容を簡素化して段階的にテストすることを推奨
ケース3: エラーメッセージに追加情報がある
- 「Extension Not Found: [specific-module]」という形式の詳細エラー
- → 出力されたモジュール名とともにClaudeに問い合わせ
参考リンク
- Claude公式ドキュメント: https://claude.ai
- GitHub Claude Issues: https://github.com/anthropics (公式のissue tracker)
※本記事は既知のエラーパターンに基づき整理しています。Anthropic公式からの公開情報がない場合は「※公式未確認」と明記しています。エラーメッセージの詳細やブラウザのコンソールログをClaudeに報告することで、より具体的なサポートが可能になります。