Windows固有の問題

インストール関連

PowerShellでインストールできない

症状:

npm : このシステムではスクリプトの実行が無効になっているため

解決策:

# PowerShellを管理者として起動してから実行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

パスが通らない

症状: インストール成功後も claude コマンドが見つからない。

解決策:

# npmのグローバルパスを確認
npm config get prefix

# 出力されたパスをシステム環境変数のPathに追加
# 例: C:\Users\YourName\AppData\Roaming\npm

「システムのプロパティ」→「環境変数」→「Path」に上記のパスを追加する。

※環境変数: APIキーやデータベース接続情報など、コードに直接書きたくない値をOSやサーバーに設定する仕組み。※npm: Node.jsのパッケージ管理ツール。`npm install` でライブラリをインストールする。

パス・ファイル関連

ファイルパスのバックスラッシュ問題

症状: ファイルを指定したときにエラーが出る。

原因: WindowsはバックスラッシュをパスセパレータとするがClaude Codeはスラッシュを期待することがある。

解決策:

# バックスラッシュの代わりにスラッシュを使う
src/components/Header.tsx ← これを使う
src\components\Header.tsx ← 問題が起きる場合がある

日本語パスが含まれるとエラー

症状: プロジェクトフォルダに日本語が含まれているとうまく動かない。

解決策: プロジェクトは英数字のみのパスに置く。

C:\Projects\my-app   ← OK
C:\プロジェクト\アプリ ← 避ける

WSLを使う場合

WSLのインストール

# PowerShellを管理者として実行
wsl --install

# 再起動後、Ubuntu等のディストリビューションが起動する

WSL上でClaude Codeをインストール

# WSL（Ubuntu）のターミナルで実行
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code
claude

WSLからWindowsのファイルにアクセスする

# Windowsのファイルはこのパスでアクセスできる
cd /mnt/c/Users/YourName/Projects/my-app
claude

Windows Terminal の推奨設定

Claude Codeを快適に使うためにWindows Terminalの設定を調整する。

フォント: Cascadia Code または Nerd Font を使うと表示が崩れにくい。

カラースキーム: One Half Dark を推奨。Claude CodeのUIが見やすくなる。