発生した問題

Claude Codeをインストールしたのに、ターミナルで「claude」と打っても以下のエラーが出て実行できない。

zsh: command not found: claude

zsh: no such file or directory: claude

原因の切り分け

主な原因は以下の2つ。

1. PATHが通っていない：ターミナルがClaudeの場所を知らない。
2. 既存のエイリアスと競合している：過去に設定した「間違った別名」が優先されている。

解決手順1：インストール場所の確認とPATH設定

インストール時のログを確認すると、以下のように表示されていた。

✔ Claude Code successfully installed!                                           
                                                                                
  Version: 2.1.27                                                               
                                                                                
  Location: ~/.local/bin/claude                                                 
                                                                                
                                                                                
  Next: Run claude --help to get started                                        
                                                                                
⚠ Setup notes:                                                                  
  • Native installation exists but ~/.local/bin is not in your PATH. Run:       
                                                                                
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Location と Setup notes を確認してみると、インストール場所が「~/.local/bin/claude」で、この場所をターミナルに教えてあげるために、.zshrc（設定ファイル）に追記する必要があるということが分かった。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

解決手順2：競合するエイリアスの削除

もし以前に間違ったエイリアスを設定してしまっていた場合、いくらPATHを通してもエラーが出る。

現在のエイリアスを確認

alias claude

間違った設定があれば削除

unalias claude

※ .zshrc 内に直接書き込んでいる場合は、ファイルを開いて該当行を削除する必要がある。

補足：.zshrcの場所と操作方法

設定ファイルの基本操作をまとめておきます。

ファイルの場所 : 「~/.zshrc」（ホームディレクトリ直下の隠しファイル）
編集コマンド : 「nano ~/.zshrc」または「vim ~/.zshrc」
設定の即時反映 : 「source ~/.zshrc」
場所の確認 : 「ls -a ~」で隠しファイルを含めて確認可能

おわりに

インストール時のログにある 「Location」 と 「Setup notes」 には、その環境に合わせた正解が書いてありました。

見落とさずにチェックするのが、結局一番の近道でした！