Claude Codeでcommand not foundの対処法をお探しですね。
広告
Claude Codeで「command not found: claude」が出る時のPATH設定と解決策【Mac/Win対応】
話題のAIコーディングアシスタント「Claude Code」をインストールしたのに、ターミナルで実行しようとすると「command not found: claude」って表示されて困っていませんか？ちゃんと手順通りにやったはずなのに動かないと、「あれ、自分の設定ミスった？」って不安になりますよね。
でも安心してください。
このエラーのほとんどは、パソコンが「claude」というコマンドをどこで探せばいいか分からない、いわゆる「PATHが通ってない」状態が原因なんです。
この記事では、Mac、Linux、Windowsそれぞれの環境で、正しいPATHの設定方法とエラーの解決手順を、初心者の方にも分かりやすく説明していきます。
黒い画面の操作に慣れてない人でも、順番に進めていけば必ず解決できるので、一緒に確認していきましょう！
Claude Codeが見つからない「command not found」って何？
ターミナルに「zsh: command not found: claude」とか「bash: claude: command not found」って表示されるのは、システムが「claudeっていう命令は受け取ったけど、実行ファイルがどこにあるか分からないよ！」って言ってる状態です。
普通、アプリをインストールすると、その実行ファイルはパソコンの中の特定のフォルダに保存されます。
でも、ターミナルはパソコン中のすべてのフォルダを勝手に探してくれるわけじゃないんです。
あらかじめ「このフォルダの中にコマンドが入ってるから探してね」って指定された場所（これがPATHです）だけをチェックします。
Claude Codeのインストール自体は成功していても、その保存場所がPATHに含まれてないと、ターミナルは実行ファイルを見つけられず、「見つかりません」ってエラーを返しちゃうんですね。
この問題は、Claude Codeを「ネイティブインストール（curlコマンドとかを使う方法）」した時や、Node.jsのパッケージマネージャー「npm」でインストールした時によく起こります。
インストーラーはファイルをダウンロードして配置するところまではやってくれるんですが、シェル（zshとかbashとか）の設定ファイルにPATHを追加する作業は、自動でやってくれなかったり、権限の問題で失敗することがあるんです。
だから解決策はシンプルで、「Claude Codeがどこにあるか」を確認して、その場所を「ターミナルが探すべき場所リスト（PATH）」に手動で追加してあげればOK。
これはエンジニアが環境構築する時によくぶつかる壁みたいなもので、システムが壊れてるわけじゃないので安心してくださいね。
【Mac・Linux・WSL】zsh/bashでのPATH設定のやり方
MacやLinux、それからWindows上のWSL（Windows Subsystem for Linux）を使ってる場合、多くの人は「zsh」か「bash」っていうシェルを使ってると思います。
まずは、Claude Codeの実体がどこにインストールされたか確認するところから始めましょう。
公式の推奨手順でネイティブインストールした場合、実行ファイルは通常、ホームディレクトリの中の隠しフォルダ `~/.local/bin` に置かれることが多いです。
インストールが終わった時に「Location: ~/.local/bin/claude」とか「Setup notes」って表示されてたはずなんですが、これを見逃してる人が結構います。
もしこの場所にファイルがあるなら、ホームディレクトリにある設定ファイル（`.zshrc` か `.bashrc`）に、このパスを登録する必要があります。
具体的な手順はこんな感じです。
まずターミナルで `ls ~/.local/bin/claude` を実行して、ファイルがちゃんとあるか確認します。
ファイルが見つかったら、使ってるシェルに合わせて設定ファイルを編集しましょう。
今のMacの標準であるzshを使ってる場合は、以下のコマンドを実行してPATHを追加します。
“`bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc“`
このコマンドは、「ホームディレクトリの.local/binをPATHに追加する」っていう設定を `.zshrc` ファイルの最後に書き込んで、さらに `source` コマンドでその設定を今開いてるターミナルにすぐ反映させるものです。
もしnpm経由でインストールした場合は、保存場所が違う可能性があるので、`npm bin -g` コマンドとかで場所を確認して、適切なパスを設定してください。
設定が終わったら必ず `claude –version` って打ち込んで、バージョン情報が表示されたら設定完了です！
【Windows】PowerShell環境での環境変数設定と注意点
WindowsでPowerShellやコマンドプロンプトを使ってる場合も、基本的な考え方は同じなんですが、設定する場所が「環境変数」っていうWindowsのシステム設定画面になります。
Windowsでネイティブインストールした場合、Claude Codeの実行ファイル（claude.exe）は `%USERPROFILE%\.local\bin` っていうフォルダに置かれることが多いです。
でも、Windowsのインストーラーが自動で環境変数を更新してくれないことや、更新されてても再起動するまで反映されないことがあります。
まずはエラーが出た状態でPCを再起動してみるのも一つの手ですが、それでも直らない場合は手動で環境変数を編集しましょう。
手動で設定する手順はこうです。
まず、Windowsキーを押して「環境変数」って検索して、「システム環境変数の編集」か「環境変数を編集」を開きます。
開いたウィンドウの中に「ユーザー環境変数」っていう項目があるので、その中の「Path」を選んで「編集」ボタンをクリックします。
リストが表示されたら「新規」をクリックして、以下のパスを追加してください。
* `%USERPROFILE%\.local\bin`
* または具体的には `C:\Users\あなたのユーザー名\.local\bin`
ここで重要なのが、環境変数を変更した後は、すでに開いてるPowerShellやコマンドプロンプトには設定が反映されないってことです。
必ず全部のターミナルウィンドウを一度閉じてから、新しく起動し直してください。
あと、Windows版のClaude Codeは、一部の機能で「Git for Windows」に含まれる「Git Bash」が必要になる場合があります。
もし「git-bashが見つからない」みたいな別のエラーが出たら、Git for Windowsがちゃんとインストールされてるか確認して、Gitのパスも同じように環境変数に通しておく必要があります。
Windows環境はLinux系に比べてパスの扱いがちょっと複雑になりがちなので、一つずつ確実に確認していくのが解決への近道です。
それでも動かない時にチェックすべきこと
上の設定をやってもまだ「command not found」とか別のエラーが出る場合、原因は単純なPATHの設定漏れじゃない可能性があります。
よくあるのが、Node.jsのバージョン管理ツール（nvm、fnm、voltaなど）を使ってることによる「パスの競合」や「読み込み順序の問題」です。
例えば、nvmを使ってる場合、Node.jsやnpmでインストールしたツール（Claude Code含む）のパスは、nvmが管理してる特定のバージョンごとのフォルダに紐付けられます。
もしターミナル起動時にnvmの初期化処理が正しく行われてないと、npmで入れたはずのコマンドが見えなくなっちゃうんです。
この場合は、シェルの設定ファイル（.zshrcなど）で、nvmの初期化スクリプトが正しく書かれてるか、そしてそれがPATHの設定より前に読み込まれてるかを確認する必要があります。
あと、普段Visual Studio Code（VS Code）とかのエディタ上の統合ターミナルを使ってる場合、OS標準のターミナルとは環境変数の読み込み方が違うことがあります。
例えば、「デスクトップのターミナルではclaudeコマンドが動くのに、VS Codeのターミナルでは動かない」っていう現象です。
これはVS Codeが起動した時点での環境変数をキャッシュしてることが原因なので、PATHを通した後はVS Code自体を完全に再起動（ウィンドウを閉じるだけじゃなくて、アプリを終了）させる必要があります。
さらに、過去に間違ったエイリアス（別名定義）を設定しちゃってる可能性もあります。
`alias claude` ってコマンドを打ってみて、意図しない設定が表示されたら `unalias claude` で削除すると正常に動くようになることもあります。
それでも解決しない場合は、一度アンインストールしてから、公式ドキュメント推奨のネイティブインストール手順を最初からやり直してみるのも有効な方法です。
焦らず一つずつ試していけば、必ず動くようになりますよ！
広告
