npm install -gのEACCESエラーをsudoなしで直す方法
npm install -g で npm ERR! code EACCES が出たら、npm がグローバルのパッケージを置く場所(/usr/local/lib/node_modules など)に、今のユーザーに書き込む権限がありません。npm の入れ先(prefix)を自分のホームの中に変えるか、nvm で Node.js を自分のホームに入れ直すと、sudo を付けなくても入るようになります。
Linux や macOS のターミナルで、CLI ツール(npm-check-updates、TypeScript の tsc など)を npm install -g でグローバルに入れようとして、権限のエラー(permission denied)で止まったときの原因と直し方です。私は検証環境で、管理者でないユーザーとしてこのエラーを起こし、出たメッセージをそのまま載せました。2つの直し方でエラーが消え、入れたコマンドが動くことも確かめています。
検証環境は Ubuntu 24.04 です。Node.js 22.23.4(npm 10.9.9)の公式バイナリを、管理者の権限で /usr/local に展開しました。比べるために npm 9.9.4 でも同じ操作をしました。nvm は 0.39.7 を使いました。macOS、Windows、Ubuntu の apt で入れた Node.js、sudo を付けて入れる方法、zsh での設定は試していません。コマンドは記事では1つずつ分けて書いていますが、検証では && などでつないで実行したものもあります。
エラーを起こしたコマンドとメッセージ
検証環境では、node と npm は /usr/local/bin にあり、グローバルの入れ先(npm config get prefix)は /usr/local でした。入れる先の /usr/local/lib/node_modules は root の持ち物で、ほかのユーザーは書き込めません。
$ npm config get prefix
/usr/local
$ ls -ld /usr/local/lib/node_modules /usr/local/bin
drwxr-xr-x 2 root root 4096 Oct 20 19:57 /usr/local/bin
drwxr-xr-x 4 root root 4096 Oct 20 19:57 /usr/local/lib/node_modules
この状態で、管理者でないユーザーが npm-check-updates をグローバルに入れると、npm 10.9.9 では次のように出て止まりました(終了コードは 243。最後の行のホームのパスは ~ に置き換えています)。
$ npm install -g npm-check-updates@23.1.1
npm error code EACCES
npm error syscall mkdir
npm error path /usr/local/lib/node_modules/npm-check-updates
npm error errno -13
npm error Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/npm-check-updates'
npm error at async mkdir (node:internal/fs/promises:858:10)
npm error at async /usr/local/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:638:20
npm error at async Promise.allSettled (index 0)
npm error at async [reifyPackages] (/usr/local/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:334:11)
npm error at async Arborist.reify (/usr/local/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:149:5)
npm error at async Install.exec (/usr/local/lib/node_modules/npm/lib/commands/install.js:150:5)
npm error at async Npm.exec (/usr/local/lib/node_modules/npm/lib/npm.js:207:9)
npm error at async module.exports (/usr/local/lib/node_modules/npm/lib/cli/entry.js:74:5) {
npm error errno: -13,
npm error code: 'EACCES',
npm error syscall: 'mkdir',
npm error path: '/usr/local/lib/node_modules/npm-check-updates'
npm error }
npm error
npm error The operation was rejected by your operating system.
npm error It is likely you do not have the permissions to access this file as the current user
npm error
npm error If you believe this might be a permissions issue, please double-check the
npm error permissions of the file and its containing directories, or try running
npm error the command again as root/Administrator.
npm notice
npm notice New major version of npm available! 10.9.9 -> 12.2.2
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.2.2
npm notice To update run: npm install -g npm@12.2.2
npm notice
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-11T19_45_06_708Z-debug-0.log
途中の npm notice の5行は、新しい npm が出ていることの知らせで、このエラーとは関係ありません。エラーのあと、/usr/local/lib/node_modules には npm-check-updates は入っておらず、ncu コマンドも見つかりませんでした。
npm ERR! で始まる形は、npm 9.9.4 で同じ操作をしたときに出ました(終了コードは 243)。中身は上と同じ EACCES のエラーで、目立つ違いは、行頭の書き方と、スタックトレースが2回続けて出ることです。下では、最初の警告と、途中のスタックトレースなどと、最後のログの行を省いています。
$ npx -y npm@9.9.4 install -g npm-check-updates@23.1.1
(npm WARN EBADENGINE の5行は省略)
npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /usr/local/lib/node_modules/npm-check-updates
npm ERR! errno -13
npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/npm-check-updates'
(スタックトレースと、errno などを並べた部分は省略)
npm ERR! The operation was rejected by your operating system.
npm ERR! It is likely you do not have the permissions to access this file as the current user
npm ERR!
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator.
(空行と、ログのファイルを示す最後の行は省略)
最初に出た npm WARN EBADENGINE は、npm-check-updates 23.1.1 が npm 10 以上を求めているという警告で、EACCES とは別のものです。
メッセージの読み方
エラーの最初の4行(code、syscall、path、errno)が、何が起きたかを示しています。syscall mkdir と path /usr/local/lib/node_modules/npm-check-updates は、「npm がこのフォルダーを作ろうとして(mkdir)、OS に断られた」という意味です。errno -13 の 13 は、Linux で「権限がない」を表すエラー番号(EACCES)です。
/usr/local/lib/node_modules になるのは、npm がグローバルのパッケージを {prefix}/lib/node_modules に置くからです。npm の公式ドキュメントにある、フォルダーの説明によると、prefix の既定値は Node.js がインストールされた場所で、多くのシステムでは /usr/local です。コマンド(ncu など)は {prefix}/bin に置かれます。つまり、Node.js を管理者の権限で入れた場所に、管理者でないユーザーが書き込もうとしたのが原因です。
メッセージの最後には「root/Administrator で実行し直す」ことも書かれています。一方、グローバルに入れるときの EACCES の直し方を説明した、npm の公式ドキュメントでは、nvm のようなバージョン管理ツールで npm を入れ直す方法(勧められている方法)と、npm の入れ先を手で変える方法の2つが挙げられています。どちらも sudo を使わずに済む方法です。
直し方1:npm の入れ先を ~/.local に変える
npm の公式ドキュメントの手順に沿って、入れ先を自分のホームの ~/.local に変えました(パッケージの版は固定しました)。この方法は Windows には当てはまらない、と公式ドキュメントに書かれています。
まず npm config set prefix で入れ先を変えます。設定は自分のホームの ~/.npmrc に書かれました(ホームのパスは /home/user に置き換えています)。
$ npm config set prefix ~/.local
$ npm config get prefix
/home/user/.local
$ cat ~/.npmrc
prefix=/home/user/.local
次に、~/.local/bin を PATH に足す行を ~/.profile の最後に書き、読み込み直します。zsh を使っているなら、公式ドキュメントにあるとおり、~/.zprofile に source ~/.profile の行も足します。
$ echo 'PATH=~/.local/bin:$PATH' >> ~/.profile
$ source ~/.profile
これで同じコマンドを実行すると、エラーは出ずに入りました(終了コードは 0)。
$ npm install -g npm-check-updates@23.1.1
added 1 package in 409ms
$ command -v ncu
/home/user/.local/bin/ncu
$ ncu --version
23.1.1
$ ncu -g
All global packages are up-to-date :)
パッケージは ~/.local/lib/node_modules に、コマンドは ~/.local/bin に入り、/usr/local/lib/node_modules には何も増えていませんでした。ログインし直したシェルでも、ncu はそのまま使えました。
なお、Ubuntu 24.04 で新しく作ったユーザーの ~/.profile には、もともと「~/.local/bin があれば PATH に足す」行が入っていました。そのため検証環境では、ログインし直すと PATH に ~/.local/bin が2回並びました。同じ場所が2回並んでも、ncu は問題なく見つかりました。
直し方2:nvm で Node.js を自分のホームに入れ直す
もう一つは、nvm(Node.js のバージョン管理ツール)で、Node.js を自分のホームの中に入れ直す方法です。nvm の README には、nvm はユーザーごとに入れて使うものだと書かれています。今の Node.js や npm を消さずに入れてよいことは、npm の公式ドキュメントに書かれています。
nvm を入れるには、README の install.sh の説明にあるスクリプトを実行するのが公式の手順です。このスクリプトは nvm を ~/.nvm に置き、~/.bashrc などに nvm を読み込む行を足そうとします。私の検証では、直し方1とは別の、まだ何も設定していないユーザーで試しました。このユーザーでも、nvm を入れる前は同じ npm install -g が終了コード 243 で失敗しました。
そこで install.sh は使わずに、検証環境にあった nvm 0.39.7 を ~/.nvm に置き、README の読み込みの行と同じことをする次の2行を手で実行してから、Node.js を入れました。
$ export NVM_DIR=$HOME/.nvm
$ . $NVM_DIR/nvm.sh
$ nvm install 22.23.4
Downloading and installing node v22.23.4...
Downloading https://nodejs.org/dist/v22.23.4/node-v22.23.4-linux-x64.tar.xz...
Computing checksum with sha256sum
Checksums matched!
Now using node v22.23.4 (npm v10.9.9)
Creating default alias: default -> 22.23.4 (-> v22.23.4)
(ダウンロードの進み具合を示す行は省きました。)
nvm で入れた Node.js では、node も npm も、グローバルの入れ先も、自分のホームの中になります(ホームのパスは /home/user に置き換えています)。
$ command -v node npm
/home/user/.nvm/versions/node/v22.23.4/bin/node
/home/user/.nvm/versions/node/v22.23.4/bin/npm
$ npm config get prefix
/home/user/.nvm/versions/node/v22.23.4
nvm で Node.js を入れたあとは、npm install -g はエラーが出ずに入り、ncu も動きました。
$ npm install -g npm-check-updates@23.1.1
added 1 package in 462ms
$ command -v ncu
/home/user/.nvm/versions/node/v22.23.4/bin/ncu
$ ncu --version
23.1.1





