メインコンテンツへスキップ
見出し画像

【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の順に見れば、止まっている場所を慌てずに絞り込めます。

    最後まで読んでくださって、ありがとうございました。

     
     
    ChatGPT・Claude・Gemini・Grokなど、生成AIを全部使いこなすための実践ノート。実際に使ってつまずいた点と、直し方を記録しています。いまはClaude Codeの使い方から。

    あなたへのおすすめ