はじめに
本記事では、WindowsでClaude Codeが'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。というエラーで動作しない場合の確認項目と解決方法を整理しました。
チェックリスト
以下を確認します
- Claude Codeのインストール状態
- PATH環境変数の設定
- Git for Windowsのインストール
- Git Bash環境変数の設定
- PowerShell実行ポリシー
- PowerShell/VSCodeの再起動
1. Claude Codeのインストール状態確認
まず、Claude Codeが正しくインストールされているかを確認します。
npm list -g @anthropic-ai/claude-code
期待する結果：
C:\Users\[ユーザー名]\AppData\Roaming\npm
└── @anthropic-ai/claude-code@1.0.72
エラーの場合： Claude Codeが削除されている可能性があります。
npm install -g @anthropic-ai/claude-code
2. PATH環境変数の確認
Claude Codeの実行ファイルがPATHに含まれているかを確認します。
npm config get prefix
期待する結果：
C:\Users\[ユーザー名]\AppData\Roaming\npm
次に、このパスがシステムのPATHに含まれているかを確認：
$env:PATH -split ';' | Where-Object { $_ -like "*npm*" }
結果が空の場合： PATHにnpmのパスが設定されていません。
解決方法：
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Users\[ユーザー名]\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
現在のセッションでも即座に適用：
$env:PATH += ";C:\Users\[ユーザー名]\AppData\Roaming\npm"
3. Git for Windowsのインストール確認
Claude Code on WindowsはGit Bashに依存しています。
git --version
期待する結果：
git version 2.xx.x.windows.x
エラーの場合： Git for Windowsがインストールされていません。
解決方法：
- Git for Windowsからダウンロード・インストール
- インストール後、PowerShellを再起動
4. Git Bash環境変数の確認
Git Bashのパスが環境変数に設定されているかを確認します。
$env:CLAUDE_CODE_GIT_BASH_PATH
期待する結果：
C:\Program Files\Git\bin\bash.exe
結果が空の場合： 環境変数が設定されていません。
解決方法：
まず、Git Bashの存在を確認：
Test-Path "C:\Program Files\Git\bin\bash.exe"
存在する場合、環境変数を設定：
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_GIT_BASH_PATH', 'C:\Program Files\Git\bin\bash.exe', 'User')
5. PowerShell実行ポリシーの確認
npmスクリプトの実行が許可されているかを確認します。
Get-ExecutionPolicy -Scope CurrentUser
期待する結果：
RemoteSigned
または
Unrestricted
Restrictedの場合： スクリプト実行が制限されています。
解決方法：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
6. PowerShell/VSCodeの再起動
新しいPowerShellウィンドウを開いて確認：
claude --version
期待する結果：
Claude Code v1.0.72
動作確認：
claude
その他
VSCodeとの統合で問題が発生する場合
VSCodeでClaude Code拡張機能を使用している場合：
- VSCodeを完全に再起動
- PATH設定後は必ずVSCodeも再起動
環境変数がGUIで反映されない場合
- Windows設定 → システム → 詳細情報 → システムの詳細設定
- 環境変数ボタンをクリック
- ユーザー環境変数の「Path」に
C:\Users\[ユーザー名]\AppData\Roaming\npmが含まれているかを確認 - 必要に応じて手動で追加