~ / hub / erros / npm EACCES: permission denied
4 out 2026errosguia de solução

npm EACCES: permission denied

Instalação global do npm sem sudo e sem bagunçar o sistema.

1. Significado

npm ERR! Error: EACCES: permission denied, mkdir '/usr/lib/node_modules/typescript'
npm ERR! code EACCES

O npm tentou gravar em uma pasta do sistema (como /usr/lib/node_modules) à qual seu usuário não tem acesso de escrita. Isso acontece em instalações globais (-g) quando o Node foi instalado pelo gerenciador de pacotes do sistema.

2. Por que evitar sudo

sudo npm install -g “funciona”, mas roda scripts de instalação como root e cria arquivos que seu usuário não consegue atualizar depois, gerando novos erros de permissão. Prefira uma das soluções abaixo.

3. Solução recomendada: gerenciar o Node com nvm

# instale o nvm seguindo as instruções oficiais do projeto, depois:
nvm install --lts
nvm use --lts
npm install -g typescript

O nvm instala o Node dentro da sua pasta pessoal, então não há conflito de permissão e fica simples alternar versões entre projetos.

4. Alternativa: mudar o prefixo global do npm

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g typescript

5. Quando nem precisa instalar globalmente

  • Use npx pacote para executar uma ferramenta sem instalar.
  • Instale como devDependency do projeto e chame por npm run ou npx; assim cada projeto fixa sua versão.
  • Se a pasta ~/.npm ou node_modules do projeto ficou com dono root (por um sudo npm antigo), corrija com sudo chown -R $(id -u):$(id -g) ~/.npm e apague o node_modules do projeto antes de reinstalar.
DICA No Windows, o EACCES é mais raro; se aparecer EPERM, feche editores e antivírus que seguram arquivos e tente novamente.

Continue explorando

← erros · npm peer deps · Cannot find module · npm · npm vs pnpm

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →