発生した問題
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」 には、その環境に合わせた正解が書いてありました。
見落とさずにチェックするのが、結局一番の近道でした！