Windows版 Claude Code を irm でインストールして「claude is not recognized」を直すまで
こんにちは！
公式PowerShellインストーラー(irm https://claude.ai/install.ps1 | iex)で Claude Code を入れたのに、claude --version を叩くと「The term 'claude' is not recognized as a name of a cmdlet...」と怒られるときがあります
これは Anthropic 公式 GitHub にも報告されている 既知のバグで、インストーラーが PATH の追加を忘れています。実際にインストール作業をやって詰まったので、最短の解決手順をまとめます。
環境
- Windows 11
- PowerShell 7.x(コードは PowerShell 5.1 / Windows PowerShell でも同じ)
- Anthropic アカウント(Pro / Max / Team / Enterprise いずれか)
前提:Git for Windows を入れておく
Claude Code は Windows ネイティブで動く時、内部で Git Bash を使います。入っていないとインストール後の動作で問題が出るので、先に確認しましょう
git --version
エラーが返るなら winget で入れます
winget install Git.Git --source winget
インストール後は PowerShell を一度閉じて開き直すこと。git が PATH に通ります。
ステップ1:公式インストーラーで Claude Code を入れる
PowerShell(管理者権限は不要)で以下を実行します
irm https://claude.ai/install.ps1 | iex
成功すると以下のようなメッセージが出ます
Setting up Claude Code...
✓ Claude Code successfully installed!
Version: 2.x.x
Location: C:\Users\<ユーザー名>\.local\bin\claude.exe
Next: Run claude --help to get started
ここで claude --help を叩きたくなりますが、たぶん動きません。
ステップ2:エラーを確認する
claude --version
claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
このエラーが出たら、原因はほぼ確実に PATH 未追加です。
ステップ3:claude.exe の存在を確認する
念のため、本当にインストールされているかを確認します
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
True が返ってくれば、ファイルは存在します。あとは PATH に通すだけです。
ステップ4:PATH に追加する
ユーザー環境変数の PATH に ~\.local\bin を永続的に追加します
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)
このコマンドは「次回以降のセッションで反映」する設定なので、現在のセッションでも使いたい場合は次のコマンドも実行します
$env:PATH = "$env:PATH;$env:USERPROFILE\.local\bin"
ステップ5:動作確認
claude --version
バージョンが表示されたら成功です。
それでもダメなら、PowerShell のウィンドウを完全に閉じて開き直してください。タブを閉じるだけでは反映されないことがあります。それでもダメなら Windows を再起動。
ステップ6:初回起動と認証
claude
ブラウザが開いて OAuth 認証フローに入ります。Anthropic アカウント(Pro / Max など)でサインインすれば、トークンが ~\.claude\session.json に保存されて、以降は再ログイン不要になります。
トラブルシューティング
Get-Command で実体を確認
PowerShell がどの claude.exe を見ているか確認したい時は、
Get-Command claude | Format-List
複数の場所にインストールされていないかは以下で確認します
Get-Command claude -All
winget 版と公式インストーラー版の併存
winget install Anthropic.ClaudeCode と irm の両方を試している場合、両方インストールされていて古いほうが優先されているケースがあります。これも公式 GitHub に上がっているバグです。
不要なほうを削除
# winget版を消したい場合
winget uninstall Anthropic.ClaudeCode
自己診断コマンド
困ったらこれを叩くと、インストール状態・バージョン・認証・Git・PATH の問題をまとめて検出してくれます
claude doctor
なぜこうなるのか
irm https://claude.ai/install.ps1 | iex は claude.exe を C:\Users\<ユーザー名>\.local\bin\ に配置しますが、このフォルダを PATH に追加する処理が現状のインストーラーに含まれていません。インストーラー自体も「Setup notes」という黄色い警告で気づいてはいるのですが、自動修正してくれないので、ユーザー側で手動対応が必要、というのが現状です。
Anthropic 側の Issue として登録済みなので、いずれ修正されるはずですが、それまでは手動対応する必要があります。
まとめ:最短コマンド集
詰まったとき用に、ここまでの流れをまとめておきます
# 1. インストール
irm https://claude.ai/install.ps1 | iex
# 2. 実体確認
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
# 3. PATH追加(永続)
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)
# 4. PATH追加(現セッション)
$env:PATH = "$env:PATH;$env:USERPROFILE\.local\bin"
# 5. 動作確認
claude --version
これでダメなら PowerShell を閉じて開き直し、それでもダメなら Windows 再起動。ほぼこれで通ります。
