「claudeコマンドが見つかりません」と言われて困っているあなたへ
インストールしたはずなのに、ターミナルでclaudeと打つと「command not found: claude」とか「'claude' is not recognized as an internal or external command」と表示されて、まるでインストールしたこと自体が幻だったかのような気持ちになっていませんか。「ちゃんと手順通りやったのに」「他の人は普通に使えているのに、なんで自分だけ」と落ち込む気持ち、痛いほど分かります。でも安心してください。このエラーは、ClaudeCodeをインストールした人の3割近くが一度は経験する、非常にメジャーなトラブルです。原因は決して難しくなく、「コンピュータがclaudeという命令の置き場所を知らないだけ」というのが正体です。この記事では、Mac、Windows、Linuxの3つのOSすべてに対応した解決手順を、非エンジニアの方が迷わず進められるように順を追って解説します。
結論ファースト：今すぐ試す手順サマリー
「command not found: claude」が出たら、以下を順番に試してください。最初にやるべきは「ターミナルを一度閉じて開き直す」こと。インストール直後はターミナルが新しい設定を読み込んでいないので、再起動するだけで解決することがよくあります。次に、claudeの実体ファイルがちゃんとPCに存在しているか確認します。Macならwhich claude、Windowsならwhere claudeコマンドで居場所を調べられます。ファイルが見つからなければ、そもそもインストールが完了していないので、再インストールが必要です。ファイルはあるのに認識されない場合は、PATH（パス）と呼ばれる設定が原因です。PATHはコンピュータに「コマンドはこのフォルダから探してね」と教える地図のようなもので、これにClaudeCodeの場所が登録されていないと、いくらインストールしてもコマンドは使えません。OSごとにPATH追加の手順は違うので、後述の各セクションを参照してください。それでもダメなら、シンボリックリンクという「ショートカット」を手動で作る方法や、完全な再インストールが最終手段です。
なぜ「command not found」は起きるのか
そもそもなぜインストール済みなのにコマンドが見つからないのか。原因は大きく4つあります。1つ目は「PATHが通っていない」。これがダントツで多い原因です。コンピュータはclaudeと打たれたとき、いきなりPC全体を探すわけではなく、PATHに登録されたフォルダだけを順番にチェックします。だから、ClaudeCodeがインストールされている場所がPATHに含まれていないと、「そんなコマンドありません」と返してくるわけです。2つ目は「インストール自体が中途半端に終わっている」。ネットワーク不良、権限不足、ディスク容量不足などで、見た目はインストールできたように見えても、実は重要なファイルが欠けているケース。3つ目は「ターミナルが古い設定を使っている」。インストール時にPATHは更新されても、それまでに開いていたターミナルにはその変更が反映されません。4つ目は「OSやシェルの違い」。Macは標準でzshというシェル、Linuxはbashが多く、Windowsはコマンドプロンプト、PowerShell、WSLなど複数の選択肢があります。それぞれ設定ファイルの場所が違うため、インストール手順が一つでもズレるとエラーが出ます。
幸いなことに、これらの原因はすべて自分で対処できる範囲です。「壊れた」「ダメになった」のではなく、「コンピュータに教え忘れた」だけなので、教えてあげれば動きます。これから具体的に教え方を見ていきましょう。
エラーメッセージの種類
OSによってエラーメッセージの表記が違うので、まず自分が見ているものを特定しましょう。Mac/Linuxのターミナルではzsh: command not found: claudeまたはbash: claude: command not foundと出ます。Windowsのコマンドプロンプトでは'claude' is not recognized as an internal or external command, operable program or batch file.という長い英語が出ます。PowerShellではclaude : The term 'claude' is not recognized as the name of a cmdlet, function, script file, or operable program.と表示されます。表現は違いますが、意味はどれも「claudeという名前のコマンドが見つかりません」という同じ内容です。どのメッセージが出ても、対処の基本は同じなのでご安心ください。
まず最初に：ターミナルを再起動する
意外と侮れないのが、この単純な対処です。ClaudeCodeをインストールすると、PCのPATH設定が更新されますが、その変更は「新しく開くターミナルから」反映される仕組みになっています。インストール時に開いていたターミナルでそのままclaudeと打っても、古い設定のままなので見つからない、ということがよくあります。
対処は簡単で、今開いているターミナルウィンドウをすべて閉じて、新しく開き直すだけです。Macなら⌘+Qでターミナルアプリを完全に終了させてから再起動、Windowsならコマンドプロンプトやターミナルを×ボタンで閉じてから新しく開きます。それでもダメな場合は、PC自体を再起動してみてください。地味ですが、これで解決するケースは全体の2〜3割を占めます。
Mac編：PATHを通す方法
Macでcommand not found: claudeが出る場合、最も多い原因はzshの設定ファイル（.zshrc）にPATHが追加されていないことです。確認と修正の手順を順に見ていきましょう。
まず、ClaudeCodeの実体がどこにあるかを探します。一般的なインストール先は以下のいずれかです。
ls /usr/local/bin/claude
ls /opt/homebrew/bin/claude
ls ~/.npm-global/bin/claude
どれかが「ファイルがあります」と返してきたら、そのフォルダがインストール先です。返してきたパスから/claudeを除いた部分（たとえば/opt/homebrew/bin）をメモしておきます。次に、これをPATHに追加します。
ターミナルで以下のコマンドを実行してください（/opt/homebrew/binの部分は、上で見つけた実際のパスに置き換えます）。
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
これで.zshrcという設定ファイルに新しいPATHが追記され、すぐに反映されます。source ~/.zshrcは「設定ファイルを今すぐ読み直して」という命令です。実行後、claude --versionと打ってバージョンが表示されれば成功です。
なお、古いMac（macOS Catalina以前）ではbashがデフォルトの場合があります。その場合は.zshrcの代わりに.bash_profileを使ってください。
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
自分がどちらのシェルを使っているか分からない場合は、echo $SHELLと打てば確認できます。/bin/zshと出ればzsh、/bin/bashと出ればbashです。
Windows編：環境変数PATHを編集する方法
WindowsでClaudeCodeのコマンドが認識されない場合、ほとんどはシステムの「環境変数」にClaudeCodeのフォルダが登録されていないのが原因です。手順を見ていきましょう。
まずファイルの実体を探します。コマンドプロンプトで以下のコマンドを試してください。
where claude
「ファイルが見つかりません」と出たら、エクスプローラーで直接探します。一般的なインストール先はC:\Users\あなたの名前\AppData\Roaming\npm\claude.cmdまたはC:\Program Files\Claude\claude.exeです。エクスプローラーでC:\Users\あなたの名前\AppData\Roaming\npmを開いてみて、claude.cmdがあれば、そのフォルダパスをコピーします。
次に環境変数を設定します。Windowsの検索バーに「環境変数」と入力し、「システム環境変数の編集」を開きます。表示されたウィンドウの右下「環境変数」ボタンをクリックし、「ユーザー環境変数」セクションの中から「Path」を選択して「編集」を押します。「新規」ボタンを押して、先ほどコピーしたフォルダパス（例：C:\Users\あなたの名前\AppData\Roaming\npm）を貼り付け、すべてのウィンドウで「OK」を押します。
設定後、開いているコマンドプロンプトやPowerShellをすべて閉じて、新しく開き直してください。claude --versionでバージョンが表示されれば成功です。なお、Windowsでは設定変更後にPC再起動が必要になることもあるので、それでも認識されない場合は再起動を試してください。
WSL（Windows Subsystem for Linux）を使っている場合は、WSL内ではLinux編の手順、Windowsネイティブ側ではこのWindows編の手順を使います。両方使い分けている方は要注意です。
Linux編：シェル設定ファイルへの追記
Linuxの場合、使っているシェル（bashかzshかなど）の設定ファイルにPATHを追加します。多くのディストリビューションではbashが標準です。
まず実体を探します。
which claude
ls /usr/local/bin/claude
ls ~/.local/bin/claude
ls ~/.npm-global/bin/claude
見つかったフォルダをメモし、設定ファイルに追加します。bashなら~/.bashrc、zshなら~/.zshrcです。
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
これでPATHが通り、ターミナルを開き直すかsourceを実行すれば、すぐに使えるようになります。なお、Linuxは権限の関係でグローバルインストール（/usr/local/bin）に書き込めないことが多いので、ユーザーホーム配下にインストールする~/.npm-global方式が推奨です。
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
npm install -g @anthropic-ai/claude-code
この設定を一度すれば、以降のnpmインストールもすべてホーム配下に入るので権限エラーが出にくくなります。
シンボリックリンクを使う方法
PATHの編集が難しい、または何度やっても反映されない場合の代替手段が「シンボリックリンク」です。これは「ショートカット」のようなもので、すでにPATHが通っているフォルダ（たとえば/usr/local/bin）に、ClaudeCodeへのリンクを作ることで間接的に使えるようにします。
Mac/Linuxの場合は次のコマンドです。
sudo ln -s /実際のClaudeCodeのパス/claude /usr/local/bin/claude
たとえば実体が/Users/yamada/.npm-global/bin/claudeにあるなら、
sudo ln -s /Users/yamada/.npm-global/bin/claude /usr/local/bin/claude
となります。sudoはパスワード入力が求められ、管理者権限で実行されます。これでターミナルから普通にclaudeと打てるようになります。
ただしsudoを使う操作はシステムに影響を与える可能性があるので、社内ルールで禁止されていないか、操作内容に自信があるかを確認してから実行してください。不安な場合は社内のエンジニアに相談しましょう。
完全な再インストール
PATHの追加もシンボリックリンクもうまくいかない場合は、いったんアンインストールしてからやり直すのが確実です。npm経由でインストールしている場合の手順は次の通りです。
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
これで一度きれいに削除してから再インストールできます。インストール後はターミナルを開き直し、claude --versionで確認します。
公式インストーラを使った場合は、Macなら/Applications/Claude.appをゴミ箱に入れてから公式サイトから再ダウンロード、Windowsは「設定」→「アプリ」からアンインストールしてから再インストールします。
再インストール時のポイントは、「インストール中に出るメッセージを読み飛ばさない」ことです。途中で「PATHに追加しますか?」と聞かれることがあり、ここで「Yes」を選ばないとまた同じ問題が起きます。
Node.jsのバージョン問題
ClaudeCodeはNode.jsという仕組みの上で動いています。古いバージョンのNode.jsを使っていると、インストールはできても起動できないことがあります。確認方法は次の通りです。
node --version
Node.jsのバージョンが18以上であることを確認してください。18未満だと動作保証外です。古い場合は公式サイトから最新版（LTSと呼ばれる長期サポート版が推奨）をダウンロードして上書きインストールします。
Macでhomebrewを使っている場合は次のコマンドで一発更新できます。
brew upgrade node
更新後、ClaudeCodeも入れ直すと確実です。
それでも解決しないときの最終手段
ここまで試してダメな場合、PC固有のセキュリティソフトがClaudeCodeをブロックしている可能性、社内のIT管理ポリシーで実行ファイルが制限されている可能性、ディスクの容量不足や権限の特殊な問題などが考えられます。これらは個人で切り分けるのが難しいので、社内のエンジニアやIT担当者に相談するのが早道です。相談時には「インストール手順」「出ているエラーメッセージ」「試した対処」を整理して伝えると、解決が早まります。
よくある質問
Q1. インストール直後にclaudeと打っても見つかりません。
ターミナルを一度閉じて開き直してください。それでもダメならPATH設定が反映されていないので、本記事のOS別手順を参照してください。
Q2. PATHって何ですか?
コンピュータがコマンドを探すフォルダのリストです。claudeと打つと、このリストに登録されたフォルダだけを順番に探します。
Q3. 設定ファイル（.zshrcなど）を編集するのが怖いです。
編集前にバックアップを取れば安心です。cp ~/.zshrc ~/.zshrc.backupで複製しておけば、何かあっても元に戻せます。
Q4. sudoって入力していいのですか?
管理者権限で操作する命令なので慎重にすべきですが、シンボリックリンク作成や正規のインストールでは一般的に使われます。社内ルールで禁止されていないか確認してから使ってください。
Q5. Windowsの環境変数編集が怖いです。 既存の値を消さないよう、「編集」ではなく「新規」で追加するようにしてください。誤って削除しなければシステムへの悪影響はありません。
Q6. 複数のNode.jsバージョンを使い分けたいです。 nvm（Node Version Manager）というツールを使うのが標準ですが、設定がやや複雑なのでエンジニアと相談しながら導入することをおすすめします。
Q7. M1/M2/M3 Macで特別な注意点はありますか?
インストール先がIntel Macとは異なります。homebrewは/opt/homebrew、Intelは/usr/local配下が標準です。PATHもこれに合わせて設定してください。
まとめ
「command not found: claude」は、コンピュータが「居場所を知らない」だけのシンプルなエラーです。OSごとに手順は違いますが、本質は「インストール先のフォルダをPATHに登録する」「ターミナルを開き直す」の2点に集約されます。落ち着いて自分のOSのセクションを試し、それでもダメなら再インストール、最後はエンジニアに相談、という順序で進めれば、必ず解決します。今日中に動かせるようになるので、安心して取り組んでみてください。