やりたかったこと
以下のドキュメントに書いてある通り、Claude Codeを30秒で開始したかった。
前提条件
- OS: macOS Sonoma 14.6.1
- シェル: zsh
- Node.js: npmを使用
問題の概要
@anthropic-ai/claude-codeをグローバルインストールしたにも関わらず、ターミナルでclaudeコマンドが認識されない問題に遭遇しました。
npm install -g @anthropic-ai/claude-code
# インストールは成功
claude
# zsh: command not found: claude
試行錯誤の過程
1. 基本的な対処法を試す
- ターミナルの再起動
- 端末の再起動
- claude codeの再インストール
困ったら再起動！という古き良きお作法は効果なし。
2. ネットで調べる
きっと同じように困っている人がいるはず...！ 偉大な先人たちの肩に乗ろう！：
- https://gizin.co.jp/ja/tips/claude-command-not-found-fix
- https://qiita.com/yukaneko/items/6be84d7232a9161a91c6
- https://github.com/anthropics/claude-code/issues/471
...どうやら誰もハマったことのない穴にハマったらしく、いずれも効果なし。
3. 環境の調査
which claude
# 何も出力されない
npm list -g
# claude codeはインストールされていることを確認
/Users/[user]/.npm-global/lib
└── @anthropic-ai/claude-code@1.0.61
ls -la ~/.npm-global/bin
# claudeのショートカットが存在することを確認
total 0
drwxr-xr-x 3 [user] staff 96 7 28 16:30 .
drwxr-xr-x 4 [user] staff 128 6 19 12:47 ..
lrwxr-xr-x@ 1 [user] staff 52 7 28 16:30 claude -> ../lib/node_modules/@anthropic-ai/claude-code/cli.js
うーーーん。パスが通っていないだけっぽい・・・？
nodeのバージョン管理がうまくいってないからか・・・？
4. 古いNode.jsバージョン管理ツールの影響を疑う
ls -la ~/.nodebrew
# v12などの古いバージョンが存在
# nodebrewフォルダを削除してみる
rm -rf ~/.nodebrew
# 効果なし
5. PATHの設定を試す
# ~/.zshrcに以下を書き込む
export PATH="$PATH:~/.npm-global/bin"
source ~/.zshrc
# うまくいかない
解決策
最終的に、エイリアスを設定することで解決しました：
# ~/.zshrcに以下を書き込む
alias claude='~/.npm-global/bin/claude'
source ~/.zshrc
これでclaudeコマンドが正常に動作するようになりました。
余談
この問題をCursorに解決してもらおうとしたところ、Claude CodeではなくClaudeをインストールしてきてしまいました。
違うよ！ClaudeじゃなくてClaude Codeだよ！と教えてあげたらフリーズ。お茶目ですね。
余談その2
この記事はZenn CLIを活用して執筆しました。Zenn CLIの使い方に従ってローカル環境でmarkdownファイルを作成・編集し、プレビュー機能を使って記事の見た目を確認しながら書いています。Zenn CLIを使うことで、お気に入りのエディタで快適に記事を書くことができました。
Discussion