Claude CodeのnpmインストールでERRORが出た時の対処法

Claude CodeのnpmインストールでERRORが出た時の対処法

Claude Codeを入れようとしてnpm installを実行すると、EACCESだとかpermission deniedみたいなエラーが出ることってありますよね。自分も何度か経験しました。これらは権限周りの問題なので、正しく対処すれば確実に解決します。この記事では、実際に僕が詰まったパターンを3つ、それぞれの解決手順を説明していきます。

エラーの種類と原因

EACCES エラー

グローバルパッケージをインストールするとき、/usr/local/lib/node_modulesみたいなシステムディレクトリへ書き込む権限がないときに出ます。

permission denied エラー

ローカルのnode_modulesディレクトリで権限が足りなかったり、既に壊れたディレクトリがあるときに発生します。

node_modules パス問題

nvm、nodenvみたいな複数のバージョン管理ツールを一緒に使ってると、パスの優先度がズレて古いバージョンを参照してしまうことがあります。

対処方法：ステップバイステップ

ステップ1：現在の環境確認

まずNode.jsとnpmのバージョン、それからどこにインストールされているのかを確認しましょう。

node --version
npm --version
which node
which npm

npmの設定も見ておきます：

npm config get prefix
npm config get cache

ここでprefixが/usr/localや/usrだと、システムディレクトリに直接インストールされてる状態。これが権限エラーの大もとなんです。

ステップ2：推奨解決法 - ローカルプレフィックス設定

一番安全で確実な方法は、npmのプレフィックスをホームディレクトリ配下に変更することです。

mkdir ~/.npm-global
npm config set prefix ~/.npm-global

PATHに追加します：

export PATH=~/.npm-global/bin:$PATH