
【2026年11月版】Claude Codeの「command not found」。claudeが動かないときに見る3つのこと
Macでインストールを終えてターミナルにclaudeと入力したのに、返ってきたのは「zsh: command not found: claude」の一行。Claude Code(クロードコード)のプログラムが見つからないという意味です。インストールできていても出ることがあり、その場合は置き場所が、パソコンが探す場所の一覧(PATH)に入っていません。見ることは3つです。
この記事は2026年11月5日に公式の説明を確認して書いています。今後、内容が変わる可能性があります。
claudeが見つからないときに見たい3つのこと
新しいウィンドウを開き、バージョンを表示させる
それでも出たら、claudeのファイルがあるかを見る
ファイルがあれば、置き場所がPATHに入っているかを見る

新しいウィンドウを開き、バージョンを表示させる
インストール後、ターミナルの新しいウィンドウを開き、次の1行を入力します。
claude --version
正しくインストールされていれば、「2.1.211 (Claude Code)」のようなバージョン番号が出ます。
インストールに使ったウィンドウでは、PATHが古いままのことがあります。そのため、公式も新しいウィンドウで試すよう案内しています。
私なら、設定を変えずに試せるので、ほかの方法より先にウィンドウを開き直します。
それでも出たら、claudeのファイルがあるかを見る
Macでは、インストーラーがclaudeを「~/.local/bin/claude」に置きます。ファイルがあるかは、次の1行で分かります。
ls -la ~/.local/bin/claude
ファイルの一覧が出たら、claudeは入っている
「No such file or directory」と出たら、この場所には入っていない
Homebrewなど、別の方法でインストールした覚えがなければ、インストールし直します。
VS Codeの拡張機能だけを入れた場合も、この場所にファイルはありません。ターミナルで使うには、ターミナル用のインストールが別に必要です。

ファイルがあれば、置き場所がPATHに入っているかを見る
claudeの置き場所がPATHに入っていない場合、インストーラーは出力の「Setup notes:」の下に次のメッセージを出します。
Native installation exists but ~/.local/bin is not in your PATH.
直し方も出ますが、それだけではPATHは変わりません。入っているかは、次の1行で見られます。
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
「/Users/you/.local/bin」のような行が出れば、PATHに入っています。何も出ない場合、Macで標準のZshを使っているなら、次の2行を入力します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
1行目は新しいウィンドウ用に設定を保存する行で、うまくいっても何も表示されません。2行目は今のウィンドウに反映します。
私なら、2行を入力したあとも、新しいウィンドウでclaude --versionを試します。次に開くウィンドウでも直っているかを見たいからです。

3つを押さえれば、一行のエラーから止まっている場所を絞り込める
新しいウィンドウを開き、バージョンを表示させる
それでも出たら、claudeのファイルがあるかを見る
ファイルがあれば、置き場所がPATHに入っているかを見る
次にcommand not foundと出ても、ウィンドウ、ファイル、PATHの順に見れば、止まっている場所を慌てずに絞り込めます。
最後まで読んでくださって、ありがとうございました。