Windowsで「'claude' は認識されていません」と出る時の直し方

インストールは最後まで終わった。画面にもエラーは出なかった。それなのに、claude と打つとこう返ってくる。

コマンドプロンプトの場合:

'claude' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

英語表示のWindowsでは 'claude' is not recognized as an internal or external command です。

PowerShellの場合:

claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。
    + FullyQualifiedErrorId : CommandNotFoundException

英語表示では claude : The term 'claude' is not recognized as the name of a cmdlet です。

「インストールに失敗したのでは」と思って入れ直したくなりますが、その前に確かめてください。多くの場合、Claude Code本体はもうパソコンの中にあります。Windowsが、それを探しに行く場所を知らないだけです。

Mac・Linuxで claude: command not found が出ている方は、claude: command not found を解決する記事をご覧ください。

原因は2つ

1. インストール先のフォルダがPATHに入っていない

公式のインストーラー（PowerShellの irm https://claude.ai/install.ps1 | iex、またはコマンドプロンプト用の install.cmd）は、本体を次の場所に置きます。

%USERPROFILE%\.local\bin\claude.exe

C:\Users\あなたのユーザー名\.local\bin\claude.exe のことです。

Windowsは、コマンドを打たれると「PATH」という環境変数に並んだフォルダを順に探します。このフォルダがPATHに無いと、claude.exe が置いてあっても「認識されていません」になります。

公式ドキュメントによると、インストーラーはこの状態を見つけると、出力の Setup notes: に Native installation exists but C:\Users\you\.local\bin is not in your PATH. と書きます。直し方も表示しますが、PATHそのものは書き換えません。 インストールが「成功した」のに claude が動かないのは、このためです。

2. npmで入れた古い版が残っている

以前 npm install -g @anthropic-ai/claude-code で入れたことがある場合、npm版と公式インストーラー版の2つが同居していることがあります。片方だけPATHに入っていたり、古い方が先に見つかったりして、「見つからない」「古い版が起動する」の原因になります。公式ドキュメントは、インストールは1つだけにし、%USERPROFILE%\.local\bin\claude.exe のネイティブ版を残すよう勧めています。

確かめ方

PowerShellの場合

まず、本体が置かれているか確かめます。

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

• True: 本体はあります。次へ進んでください。
• False: 公式インストーラーではまだ入っていません。npmなど別の方法でも入れていなければ、インストールからやり直します。

次に、PATHにそのフォルダが入っているか確かめます。

$env:PATH -split ';' | Select-String '\.local\\bin'

C:\Users\あなたのユーザー名\.local\bin が表示されればPATHには入っています。何も表示されなければ、これが原因です。

コマンドプロンプトの場合

本体の確認:

dir "%USERPROFILE%\.local\bin\claude.exe"

claude.exe の一覧が出れば本体はあります。ファイルが見つかりません や 指定されたパスが見つかりません。 なら、まだ入っていません。

PATHの確認:

echo %PATH% | findstr /i "local\bin"

何も表示されなければ、PATHに入っていません。

2つ入っていないかの確認

PowerShellで次を打つと、PATHの中で見つかる claude がすべて並びます。

where.exe claude

2行以上出たら、インストールが重なっています。INFO: Could not find files for the given pattern(s). と出たら、PATHの中には1つもありません。

直し方

ユーザーのPATHに足す（PowerShell）

次の2行を、そのままPowerShellに貼って実行します。今のユーザーのPATHの末尾に %USERPROFILE%\.local\bin を足す命令です。管理者として実行する必要はありません。

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

ユーザーのPATHに足す（画面から）

コマンドプロンプトしか使わない方や、画面で操作したい方はこちらです。

1. スタートメニューで「環境変数」と検索し、「環境変数を編集」を開く
2. 上半分の「ユーザー環境変数」で Path を選び、「編集」を押す
3. 「新規」を押して %USERPROFILE%\.local\bin を入力し、「OK」で閉じる

npmの古い版を消す

where.exe claude で2つ以上見つかった場合は、npm版を消してネイティブ版だけにします。

npm uninstall -g @anthropic-ai/claude-code

古い「ローカルnpm版」（%USERPROFILE%\.claude\local）が残っている場合は、PowerShellで次を実行します。

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

このフォルダだけを消す命令です。%USERPROFILE%\.claude の中の設定（CLAUDE.md や settings.json など）は消えません。

ターミナルを開き直す

ここを飛ばすと、正しく直しても「認識されていません」のままです。

PATHを書き換えても、すでに開いているPowerShellやコマンドプロンプトには反映されません。ウィンドウをすべて閉じて、新しく開き直してください。

VS Codeなどエディタの中のターミナルを使っている場合は、ターミナルのタブだけでなく、エディタそのものを終了して起動し直します。エディタの中のターミナルは、エディタが起動した時点のPATHを引き継いでいるためです。

新しいターミナルで次を打ちます。

claude --version

2.1.211 (Claude Code) のようにバージョン番号が出れば直っています。

それでも動かない時

• [Environment]::GetEnvironmentVariable('PATH', 'User') を実行し、表示された中に .local\bin があるか見てください。無ければ、PATHへの書き込みが保存されていません。「ユーザーのPATHに足す」の2行をもう一度実行します。
• Claude Codeが更新された直後から急に出るようになった場合は、原因が違います。公式のインストールのトラブルシューティングにある、claude.exe をバックアップから戻す手順を見てください。
• claude は起動できるけれど設定まわりが気になる時は、claude doctor を実行すると、インストールの状態と設定の警告をまとめて確かめられます。

まとめ

「認識されていません」は、たいてい「入っていない」ではなく「場所を知らない」です。入れ直す前に、PATHを1行確かめてみてください。

Claude CodeでAI社員を動かす実践の記録を、GIZIN通信で毎週お届けしています →