Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

バンドルされたSDKにハードコードされたビルドパスが含まれていた（createRequire ポリフィルバグ）ことが原因で、Windows上でVS Code拡張機能がアクティブにならない問題を修正しました。

原文（英語） ​

Fixed VS Code extension failing to activate on Windows due to a hardcoded build path in the bundled SDK (createRequire polyfill bug)

概要 ​

Windows環境でClaude CodeのVS Code拡張機能をインストールしたにもかかわらず、拡張機能がアクティブにならない（起動しない）という問題がありました。これはClaude Code SDKに含まれていた createRequire のポリフィル実装にハードコードされたビルドパスが含まれていたことが原因でした。Windowsのファイルパス形式（バックスラッシュ区切り）と Unix形式（スラッシュ区切り）の違いが問題を引き起こしていました。この修正により、WindowsでもVS Code拡張機能が正常に起動します。

基本的な使い方 ​

修正後は、WindowsのVS CodeでClaude Code拡張機能が正常にアクティブになります。

# VS CodeでClaude Code拡張機能を確認する手順
1. VS Codeを開く
2. 拡張機能パネルを開く（Ctrl+Shift+X）
3. "Claude Code" を検索
4. インストール済みの場合、"有効" と表示されることを確認

# 拡張機能がアクティブになった証拠
# - ステータスバーにClaude Codeのアイコンが表示される
# - コマンドパレット（Ctrl+Shift+P）で "Claude Code" コマンドが利用可能

実践例 ​

VS Code拡張機能のインストールと確認 ​

# Windows環境でのVS Code拡張機能インストール手順

# 方法1: VS Code内からインストール
# 1. Ctrl+Shift+X で拡張機能パネルを開く
# 2. "Claude Code" を検索
# 3. "インストール" をクリック

# 方法2: コマンドラインからインストール
code --install-extension anthropic.claude-code

# インストール後の確認
# 修正前(2.1.130以前): 拡張機能が "アクティブ化に失敗しました" と表示
# 修正後(2.1.131以降): 拡張機能が正常に起動する

拡張機能のトラブルシューティング ​

# 問題が発生している場合の確認手順

# 1. 拡張機能のログを確認
# VS Codeメニュー: ヘルプ > 開発者ツールの切り替え
# コンソールでエラーメッセージを確認

# 2. 拡張機能を再インストール
# Ctrl+Shift+X → Claude Code → アンインストール
# VS Codeを再起動
# 再インストール

# 3. VS Codeのバージョン確認
code --version
# 推奨: 最新バージョンのVS Codeを使用

# 4. Windowsのパス設定確認
# 環境変数 PATH にNode.jsのパスが含まれているか確認
node --version
npm --version

VS Code拡張機能の主な機能 ​

# Claude Code VS Code拡張機能で使えること

# 1. インライン補完
# コードを書きながらAIによる補完候補を取得

# 2. コードレビュー
# 選択したコードを右クリック → "Claude Codeでレビュー"

# 3. チャットパネル
# サイドバーのClaude Codeアイコン → チャットで質問

# 4. コマンドパレット統合
# Ctrl+Shift+P → "Claude Code: " でコマンド一覧

# Windowsでの使用例
# コードを選択してCtrl+Shift+P
# "Claude Code: Explain Code" → 選択したコードの説明を取得

環境変数の設定（Windows） ​

powershell
# Windows PowerShellでの環境変数設定

# ANTHROPIC_API_KEYの設定
$env:ANTHROPIC_API_KEY = "sk-ant-api03-..."

# 永続的な設定（ユーザー環境変数）
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_API_KEY",
    "sk-ant-api03-...",
    [System.EnvironmentVariableTarget]::User
)

# 設定後VS Codeを再起動して拡張機能をアクティブ化

注意点 ​

  • この問題はWindows環境固有のものです。macOS（Darwin）およびLinuxでは発生しません。
  • createRequire ポリフィルはNode.jsモジュールシステムとの互換性のために使用されていますが、Windowsのファイルパス形式との不整合が原因でした。
  • VS Code拡張機能のアクティベーションエラーは通常、出力パネル（Ctrl+Shift+U）の「拡張機能ホスト」チャンネルで確認できます。
  • この修正はv2.1.131で適用されました。npm update -g @anthropic-ai/claude-code でClaude Codeをアップデートしてください。

関連情報 ​