インストールのあと「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 は入っていません

くわしくは、このレッスンで