【npm】コマンド「npm install -g aws-cdk」で「EACCES: permission denied」エラーが出た場合

概要

CDK CLIを最新版にアップグレードしようと思い、

npm install -g aws-cdk

上記コマンドを実行したら以下のエラーに。

$ npm install -g aws-cdk
npm ERR! code EACCES
npm ERR! syscall rename
npm ERR! path /usr/local/lib/node_modules/aws-cdk
npm ERR! dest /usr/local/lib/node_modules/.aws-cdk-kzzr8ey1
npm ERR! errno -13
npm ERR! Error: EACCES: permission denied, rename '/usr/local/lib/node_modules/aws-cdk' -> '/usr/local/lib/node_modules/.aws-cdk-kzzr8ey1'
npm ERR! [Error: EACCES: permission denied, rename '/usr/local/lib/node_modules/aws-cdk' -> '/usr/local/lib/node_modules/.aws-cdk-kzzr8ey1'] {
npm ERR! errno: -13,
npm ERR! code: 'EACCES',
npm ERR! syscall: 'rename',
npm ERR! path: '/usr/local/lib/node_modules/aws-cdk',
npm ERR! dest: '/usr/local/lib/node_modules/.aws-cdk-kzzr8ey1'
npm ERR! }
npm ERR!
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 ERR! A complete log of this run can be found in:
npm ERR! /Users/xxxx/.npm/_logs/2025-08-06T08_34_21_313Z-debug-0.log

原因と解決方法

これは、グローバルnpmパッケージのインストール権限がないために発生しているエラー。

sudoを使ってインストールすると解決しました。

sudo npm install -g aws-cdk