​
Problemas comuns de instalação

​
Problemas de permissão no Linux

Ao instalar o Claude Code com npm, você pode encontrar erros de permissão se seu prefixo global do npm não tiver permissão de escrita (por exemplo, /usr ou /usr/local).

​
Solução recomendada: Criar um prefixo npm com permissão de escrita para o usuário

A abordagem mais segura é configurar o npm para usar um diretório dentro da sua pasta home:

# Primeiro, salve uma lista dos seus pacotes globais existentes para migração posterior
npm list -g --depth=0 > ~/npm-global-packages.txt

# Crie um diretório para seus pacotes globais
mkdir -p ~/.npm-global

# Configure o npm para usar o novo caminho do diretório
npm config set prefix ~/.npm-global

# Nota: Substitua ~/.bashrc por ~/.zshrc, ~/.profile ou outro arquivo apropriado para seu shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Aplique a nova configuração do PATH
source ~/.bashrc

# Agora reinstale o Claude Code no novo local
npm install -g @anthropic-ai/claude-code

# Opcional: Reinstale seus pacotes globais anteriores no novo local
# Veja ~/npm-global-packages.txt e instale os pacotes que deseja manter

Esta solução é recomendada porque:

  • Evita modificar as permissões do diretório do sistema
  • Cria um local limpo e dedicado para seus pacotes npm globais
  • Segue as melhores práticas de segurança

​
Recuperação do Sistema: Se você executou comandos que alteraram a propriedade e permissões dos arquivos do sistema ou similares

Se você já executou um comando que alterou as permissões do diretório do sistema (como sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usr) e seu sistema agora está quebrado (por exemplo, se você vê sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit set), você precisará executar etapas de recuperação.

Método de Recuperação Ubuntu/Debian:

  1. Durante a reinicialização, mantenha SHIFT pressionado para acessar o menu GRUB

  2. Selecione “Opções avançadas para Ubuntu/Debian”

  3. Escolha a opção do modo de recuperação

  4. Selecione “Ir para prompt de shell root”

  5. Remonte o sistema de arquivos como gravável:

    mount -o remount,rw /

  6. Corrija as permissões:

    # Restaure a propriedade root
chown -R root:root /usr
chmod -R 755 /usr

# Garanta que /usr/local seja de propriedade do seu usuário para pacotes npm
chown -R SEU_USUARIO:SEU_USUARIO /usr/local

# Configure o bit setuid para binários críticos
chmod u+s /usr/bin/sudo
chmod 4755 /usr/bin/sudo
chmod u+s /usr/bin/su
chmod u+s /usr/bin/passwd
chmod u+s /usr/bin/newgrp
chmod u+s /usr/bin/gpasswd
chmod u+s /usr/bin/chsh
chmod u+s /usr/bin/chfn

# Corrija a configuração do sudo
chown root:root /usr/libexec/sudo/sudoers.so
chmod 4755 /usr/libexec/sudo/sudoers.so
chown root:root /etc/sudo.conf
chmod 644 /etc/sudo.conf

  7. Reinstale os pacotes afetados (opcional, mas recomendado):

    # Salve a lista de pacotes instalados
dpkg --get-selections > /tmp/installed_packages.txt

# Reinstale-os
awk '{print $1}' /tmp/installed_packages.txt | xargs -r apt-get install --reinstall -y

  8. Reinicie:

    reboot
Método Alternativo de Recuperação com USB Live:

Se o modo de recuperação não funcionar, você pode usar um USB live:

  1. Inicialize a partir de um USB live (Ubuntu, Debian ou qualquer distribuição Linux)

  2. Encontre sua partição do sistema:

    lsblk

  3. Monte sua partição do sistema:

    sudo mount /dev/sdXY /mnt  # substitua sdXY pela sua partição do sistema

  4. Se você tiver uma partição boot separada, monte-a também:

    sudo mount /dev/sdXZ /mnt/boot  # se necessário

  5. Faça chroot no seu sistema:

    # Para Ubuntu/Debian:
sudo chroot /mnt

# Para sistemas baseados em Arch:
sudo arch-chroot /mnt

  6. Siga os passos 6-8 do método de recuperação Ubuntu/Debian acima

Após restaurar seu sistema, siga a solução recomendada acima para configurar um prefixo npm com permissão de escrita para o usuário.

​
Problemas do atualizador automático

Se o Claude Code não conseguir atualizar automaticamente, pode ser devido a problemas de permissão com seu diretório de prefixo global npm. Siga a solução recomendada acima para corrigir isso.

Se você preferir desabilitar o atualizador automático, você pode usar:

claude config set -g autoUpdaterStatus disabled

​
Permissões e autenticação

​
Prompts de permissão repetidos

Se você se encontrar aprovando repetidamente os mesmos comandos, você pode permitir que ferramentas específicas sejam executadas sem aprovação:

# Permitir que npm test seja executado sem aprovação
claude config add allowedTools "Bash(npm test)"

# Permitir que npm test e qualquer um de seus subcomandos sejam executados sem aprovação
claude config add allowedTools "Bash(npm test:*)"

​
Problemas de autenticação

Se você estiver experimentando problemas de autenticação:

  1. Execute /logout para sair completamente
  2. Feche o Claude Code
  3. Reinicie com claude e complete o processo de autenticação novamente

Se os problemas persistirem, tente:

rm -rf ~/.config/claude-code/auth.json
claude

Isso remove suas informações de autenticação armazenadas e força um login limpo.

​
Desempenho e estabilidade

​
Alto uso de CPU ou memória

O Claude Code é projetado para trabalhar com a maioria dos ambientes de desenvolvimento, mas pode consumir recursos significativos ao processar bases de código grandes. Se você estiver experimentando problemas de desempenho:

  1. Use /compact regularmente para reduzir o tamanho do contexto
  2. Feche e reinicie o Claude Code entre tarefas importantes
  3. Considere adicionar diretórios de build grandes aos seus arquivos .gitignore e .claudeignore

​
Comandos travando ou congelando

Se o Claude Code parecer não responder:

  1. Pressione Ctrl+C para tentar cancelar a operação atual
  2. Se não responder, você pode precisar fechar o terminal e reiniciar
  3. Para problemas persistentes, execute o Claude com log detalhado: claude --verbose

​
Obtendo mais ajuda

Se você estiver experimentando problemas não cobertos aqui:

  1. Use o comando /bug dentro do Claude Code para reportar problemas diretamente à Anthropic
  2. Verifique o repositório GitHub para problemas conhecidos
  3. Execute /doctor para verificar a saúde da sua instalação do Claude Code

Was this page helpful?

Tutoriais do Claude CodeUso do computador (beta)