Claude CodeがVSCodeをクラッシュさせる問題の真相：Windows 11で発生するBunランタイムバグを徹底解説

Claude code is crashing VSCode? Claude Code

Claude CodeがVSCodeをクラッシュさせる問題の真相：Windows 11で発生するBunランタイムバグを徹底解説

Claude Code拡張機能を使用するとVSCodeがクラッシュするという報告がWindows 11ユーザーから多数上がっています。実はこの問題、単なる設定ミスではなく、Claude Codeが内部で使用している「Bunランタイム」のバグが原因であることが判明しています。本記事では、GitHub Issueでの議論や開発者のコメントをもとに、問題の詳細と確実な解決策を徹底解説します。

この記事のポイント

  • v2.0.29以降のClaude CodeはBunランタイムを使用しており、Windows 11でセグメンテーションフォルトが発生する
  • 最後に安定動作するバージョンはv2.0.28（Node.jsランタイム使用）
  • Bun開発者自身がnpm版の使用を推奨している
  • 回避策として、npm経由でのインストールまたはv2.0.28へのダウングレードが有効

問題の本質：Bunランタイムの切り替えが原因

なぜv2.0.29からクラッシュするようになったのか

Claude Codeは、v2.0.28まではNode.jsをランタイムとして使用していました。しかし、v2.0.29からパフォーマンス向上を目的としてBun（高速なJavaScriptランタイム）に切り替えられました。この変更がWindows 11環境で重大な問題を引き起こしています。

GitHub Issue #11201によると、Bunランタイムがシェルスナップショットの作成やファイルI/O操作中にセグメンテーションフォルト（メモリ違反）を起こし、拡張機能がクラッシュするのです。

具体的なエラーメッセージ

クラッシュ時には以下のようなエラーが表示されます：

panic(main thread): Segmentation fault at address 0x113
oh no: Bun has crashed. This indicates a bug in Bun, not your code.
Exit Code: 3 (SIGQUIT/Abort)

重要なのは「This indicates a bug in Bun, not your code」というメッセージです。これはBun自体のバグであり、ユーザーの設定ミスではないことを明確に示しています。

影響を受ける環境

確認されている環境

項目 詳細
OS Windows 11 Enterprise (Build 26100以降)
VSCode バージョン1.105.1以降
Claude Code v2.0.29 〜 v2.0.75（現在も継続中）
最後の安定版 v2.0.28（Node.jsランタイム）

この問題は2025年11月7日に最初に報告され、2025年12月末時点でも完全には解決していません。Bunのバージョンが1.3.1から1.3.5にアップデートされていますが、根本的な修正には至っていません。

Bun開発者からの公式コメント

Bunの作者であるJarred Sumner氏自身がGitHub Issueにコメントしており、以下のように述べています：

「現時点ではnpm版（npm install -g @anthropic-ai/claude-code）の使用を推奨します。Bun v1.3.2でいくつかの修正を行いましたが、この問題が完全に解決したかは、以前のバージョンで再現できるまで保証できません。」

つまり、開発者自身がBun版の使用を推奨しておらず、npm版への切り替えを勧めているのです。

確実な解決策

方法1: npm版のClaude Codeを使用する（推奨）

最も確実な解決策は、Bunでバンドルされたバージョンではなく、npm経由でNode.js版をインストールすることです：

# Bunバンドル版をアンインストール（必要に応じて）
# VSCode拡張機能も一旦削除

# npm経由でグローバルインストール
npm install -g @anthropic-ai/claude-code

# バージョン確認
claude --version

この方法でインストールしたClaude Codeは、Node.jsランタイムで動作するため、Bunのバグの影響を受けません。

方法2: VSCode拡張機能をv2.0.28にダウングレード

VSCode内で拡張機能を使い続けたい場合は、v2.0.28へのダウングレードが有効です：

# 1. VSCodeで拡張機能メニューを開く
# 2. Claude Code拡張機能をアンインストール
# 3. VSCode Marketplaceからv2.0.28のVSIXをダウンロード
# 4. コマンドパレット（Ctrl+Shift+P）から「Install from VSIX」を選択
# 5. ダウンロードしたVSIXファイルを選択

ダウングレード後は自動更新を無効にすることを忘れずに：

  1. VSCodeの設定を開く（Ctrl+,）
  2. 「extensions.autoUpdate」で検索
  3. 「false」に設定

方法3: WSLを使用する

Windowsネイティブ環境での問題を回避するため、WSL（Windows Subsystem for Linux）内でClaude Codeを使用する方法もあります。Linux環境ではBunランタイムの問題が発生しにくいことが報告されています。

その他のVSCode関連トラブルと対策

Extension Hostのメモリ問題

Claude Codeのクラッシュは、Bunランタイムの問題以外にも、VSCodeのExtension Hostのメモリ制限が原因の場合があります。Extension Hostは約2〜3GBのメモリ制限があり、これを超えるとプロセスが強制終了されます。

対策：
– 不要な拡張機能を無効化してメモリを確保
– VSCodeの設定でextensions.experimental.affinityを調整
– 大規模なプロジェクトでは、必要なファイルのみを開く

Git Bash検出エラー

Windows環境では「Claude Code on Windows requires git-bash」というエラーが表示される場合があります。これはClaude CodeがGit Bashを正しく検出できていないことが原因です。

対策：
1. Git for Windowsを再インストール
2. 環境変数PATHにGit Bashのパスを追加
3. VSCodeをGit Bash統合ターミナルで起動

IDE検出の失敗

VSCodeの統合ターミナルからClaude Codeを起動すると「No available IDEs detected」エラーが出る場合があります。

対策：
– 外部ターミナル（Windows Terminal等）からClaude Codeを起動
– VSCodeのcodeコマンドがPATHに通っているか確認

知っておくと便利なTips

  • ログの確認方法: VSCodeで「ヘルプ」→「Toggle Developer Tools」→「Console」タブでエラーログを確認できます。問題報告時に有用な情報が得られます。

  • クリーンインストール: 問題が解決しない場合、~/.claudeフォルダを削除してクリーンな状態から再設定すると改善することがあります。ただし、設定や履歴は失われます。

  • GitHub Issueの活用: 同様の問題に直面している場合、GitHub Issue #11201をウォッチしておくと、修正状況をリアルタイムで追跡できます。

  • ターミナル版の併用: VSCode拡張機能に問題がある場合でも、ターミナル版のClaude Codeは正常に動作することが多いです。claudeコマンドを直接使用することで作業を継続できます。

今後の展望

Anthropic社とBun開発チームは、この問題の解決に取り組んでいます。考えられる対応として：

  1. 短期的: Bunランタイムのアップデート（1.3.6以降での修正）
  2. 中期的: Windows版のみNode.jsランタイムに戻す
  3. 長期的: クラッシュ時にBunからnpm版へ自動フォールバックする機構の実装

いずれにせよ、現時点ではnpm版の使用が最も安定しており、業務に支障をきたしている場合は速やかに切り替えることをお勧めします。

まとめ

Claude CodeのVSCodeクラッシュ問題は、v2.0.29以降で採用されたBunランタイムのバグが原因です。これはユーザーの設定ミスではなく、Bun自体の問題であることが開発者によって確認されています。

最も確実な解決策はnpm経由でのインストール（npm install -g @anthropic-ai/claude-code）です。Bun開発者自身がこれを推奨しており、Node.jsランタイムで安定動作します。VSCode拡張機能を使い続けたい場合は、v2.0.28へのダウングレードが有効です。

問題が解決するまでは、GitHub Issueをウォッチして最新情報を追い、修正版がリリースされたら速やかにアップデートすることをお勧めします。

📎 元記事: https://www.reddit.com/r/ClaudeAI/comments/1q9bccy/claude_code_is_crashing_vscode/

参考リンク:
– GitHub Issue #11201: Segmentation fault crash on Windows 11
– Claude Code Troubleshooting Guide

コメント

タイトルとURLをコピーしました