インストールのあと「command not found」と出る
まずはこれ
まずターミナルを閉じて、新しく開き直してから claude --version を打ちます。それでも出るときは、インストール先のフォルダ(.local/bin)がコマンドを探す場所(PATH)に入っていないので、PATH に入れるコマンドを打ちます。
どんな表示か
インストールのあと claude と打つと、こんな表示が出ることがあります。
| パソコン | 出る表示 |
|---|---|
| Mac | zsh: command not found: claude |
| Windows(PowerShell) | claude : The term 'claude' is not recognized ... |
| Windows(CMD) | 'claude' is not recognized as an internal or external command |
原因の多くは、Claude Code を入れたフォルダが、ターミナルがコマンドを探す場所(PATH)に入っていないことです。
インストールの最後に「Setup notes:」と出ていたら、その下に書いてあるコマンドが、あなたのパソコン用の直し方です。
1. まず、ターミナルを開き直す
インストールしたときに開いていたウィンドウは、古い設定のままです。ターミナルを一度閉じて、新しく開き直し、claude --version と打ちます。番号と「(Claude Code)」が出れば直っています。
2. Mac で直らないとき
まず、ファイルがあるか確かめます。
ls -la ~/.local/bin/claude
ファイルがあるのに動かないなら、PATH に入れるコマンドを打ちます。Mac のはじめの設定(Zsh)なら、次の2行です。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
1行目は何も表示されませんが、それで成功です。そのあと新しいウィンドウを開いて、もう一度 claude --version を打ちます。
3. Windows(PowerShell)で直らないとき
ファイルがあるか確かめます(True と出ればあります)。
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
あるのに動かないなら、次の2行で PATH に入れて、PowerShell を閉じて開き直します。
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
4. それでも直らないとき
- Mac は
which -a claude、Windows はwhere.exe claudeで、Claude Code がいくつ入っているかを見ます。2つ以上あるときは、1つだけ残します - ファイルそのものが無いときは、インストールがうまくいっていません。レッスン2の手順で、もう一度インストールします
- VS Code の拡張機能だけを入れた場合は、ターミナルの
claudeは入っていません