【解決済み】Claude Codeインストール後「claudeコマンドが見つからない」問題の対処法【Mac・ターミナル編】

1まとめ：この記事でわかること

• Claude Codeをインストールしたのにターミナルでclaudeコマンドが動かない原因
• .bashrcや.zshrcファイルが無いときの対応方法
• PATH設定をちゃんと通して、即解決する手順

この記事は、2025年4月時点でのMac環境（zsh）向けに書かれています。
参照元：DigitalOcean 他

2【背景】Claude Codeをインストールしたのに動かない？

最近、Anthropicがリリースした開発者向けツール「Claude Code」をインストールしてワクワクしていたのに、 ターミナルでclaudeコマンドを打ったら、

と表示される…。そんな悲しい経験をした人、多いのでは？

実はこれ、インストール自体は成功しているのに、コマンドのパスがターミナルに認識されていないだけなんです！

そしてさらにやっかいなのが、Mac環境だと、そもそも.bashrcや.zshrcが存在してない場合があるという点。 この場合、自分でちょっとした設定を追加してあげる必要があります。

3【原因】PATHが通ってない＋設定ファイルがない

Claude Codeはnpm経由でインストールするので、実行ファイルは基本的に~/.npm-global/binなどに置かれます。 しかし、このディレクトリをターミナル側が認識していないと、当然ながらコマンドは使えません。

さらに、PATHを追加するために編集するべき設定ファイル（.bashrcや.zshrc）が、そもそも無い場合もあります。

4【解決方法】手順まとめ

ここからは、実際に私が試して成功した解決方法をまとめます！

① ホームディレクトリに隠しファイルがあるか確認

まずはターミナルで以下を実行してみましょう。

これで.bashrcや.zshrcがあるか確認できます。無ければ次へ！

② .zshrc（もしくは.bashrc）を作成

ファイルが無い場合は、自分で作っちゃいましょう。

（bash派の人はtouch ~/.bashrc）

③ ファイルを編集してPATHを追加

続いて、テキストエディタでファイルを開きます。

そして、次の一行を追加！

編集したら、Ctrl + X → Y → Enterで保存＆終了。

④ 設定をすぐ反映させる

ファイルを作っただけではダメ。今のターミナルに反映させる必要があります。

これでOK！

⑤ claudeコマンドが使えるかチェック

改めてターミナルで：

これでエラーが出なければ成功です！！🎉

5【もしうまくいかない時は？】

• npm config get prefixで、グローバルインストール先を確認する
• ちゃんと設定したパスにclaudeファイルがあるか確認する
• それでもダメなら、ターミナルを再起動してみる

6【まとめ】最初に環境を整えておこう！

今回の「claudeコマンドが使えない」問題は、 突き詰めると「シェルの環境設定ファイルが存在しない」＋「PATH未設定」が原因でした。

Claude Codeだけでなく、npmでグローバルインストールしたツールをターミナルから叩くときには、 最初にPATH周りをちゃんと確認するクセをつけておくと、今後めちゃくちゃ楽になります。

7【あとがき】ちょっとハマったけど、いい勉強になった！

最初は「インストール成功って出たのにコマンド打てないの、何で！？」って焦りましたが（笑）、 実際に調べてみると、Macのターミナル環境が思った以上に初期状態だっただけでした。

今回のトラブルも、冷静に一つずつ原因を探れば解決できる！ これを読んでくれているあなたも、もし同じ状況なら落ち着いて対処してみてくださいね。

それではまた！🚀

もしこの情報が役に立ったら、ぜひシェアしてください！ さらに詳しいnpmトラブルシューティング記事も今後アップ予定です📚！