インストールに失敗した

コマンド / 機能

環境の確認と再インストール

インストールエラーの解決

概要

Claude Code のインストールが失敗する場合の診断と解決方法です。Node.js のバージョン、npm の権限、ネットワークの問題などに対処できます。

設定例

# 前提条件の確認
node --version  # v18.0.0 以上が必要
npm --version   # 最新版を推奨

# Node.js のバージョンが古い場合
# nvm でインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

# npm キャッシュをクリア
npm cache clean --force

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

# 権限エラーの場合
# sudo を使う（非推奨だが簡単）
sudo npm install -g @anthropic-ai/claude-code

# または 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

# ネットワークエラーの場合
# npm レジストリを確認
npm config get registry
# → https://registry.npmjs.org/

# プロキシ設定
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080