インストール・起動トラブル

インストールが失敗する

npm install -g でエラーが出る

症状:

npm error code EACCES
npm error syscall mkdir
npm error path /usr/local/lib/node_modules

原因: グローバルインストールに管理者権限が必要な状態になっている。

解決策:

# npmのグローバルディレクトリを変更する（推奨）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# その後改めてインストール
npm install -g @anthropic-ai/claude-code

---

node のバージョンが古い

症状:

npm error engine Unsupported engine
npm error notsup Required: {"node":">=18"}

解決策: Node.jsを18以上にアップデートする。

# nvmを使っている場合
nvm install 20
nvm use 20

# Macの場合（Homebrew）
brew upgrade node

# バージョン確認
node --version

---

※npm: Node.jsのパッケージ管理ツール。`npm install` でライブラリをインストールする。

起動しない・ログインできない

claude コマンドが見つからない

症状:

command not found: claude

解決策:

# インストール先を確認
npm list -g @anthropic-ai/claude-code

# PATHを確認
echo $PATH

# 再インストール
npm install -g @anthropic-ai/claude-code

---

ブラウザが開かない・ログインが完了しない

症状: claude を実行するとブラウザが開くはずが、何も起きない。

解決策:

# APIキーを直接設定する方法（ブラウザ不要）
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# またはログアウトして再ログイン
claude logout
claude

APIキーは Anthropic Console の「API Keys」から取得できます。

---

アップデート後に動かなくなった

解決策:

# 一度アンインストールして再インストール
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

# キャッシュをクリアしてから
npm cache clean --force
npm install -g @anthropic-ai/claude-code

---

※APIキー: APIを利用するための認証情報。外部に漏れると不正利用されるため厳重に管理が必要。※キャッシュ: 一度取得したデータを一時的に保存しておき、同じリクエストへの応答を速くする仕組み。※API: Application Programming Interface の略。外部サービスとプログラム間でデータをやりとりするための接続口。

それでも解決しない場合

1. Node.js と npm のバージョンを確認：node --version npm --version
2. OS・環境を確認（Mac/Windows/Linux、WSLかどうか）
3. エラーメッセージ全文をコピー
4. Anthropic公式コミュニティ に投稿する