Configuração avançada

Requisitos do sistema, instalação específica da plataforma, gerenciamento de versão e desinstalação do Claude Code.

Esta página cobre requisitos do sistema, detalhes de instalação específicos da plataforma, atualizações e desinstalação. Para um guia passo a passo de sua primeira sessão, consulte o guia de início rápido. Se você nunca usou um terminal antes, consulte o guia de terminal.

Requisitos do sistema

Claude Code é executado nas seguintes plataformas e configurações:

• Sistema operacional:
  • macOS 13.0+
  • Windows 10 1809+ ou Windows Server 2019+
  • Ubuntu 20.04+
  • Debian 10+
  • Alpine Linux 3.19+
• Hardware: 4 GB+ de RAM, processador x64 ou ARM64
• Rede: conexão com a internet obrigatória. Consulte configuração de rede.
• Shell: Bash, Zsh, PowerShell ou CMD.
• Localização: países suportados pela Anthropic

Dependências adicionais

• ripgrep: geralmente incluído com Claude Code. Se a busca falhar, consulte solução de problemas de busca e descoberta.

Instalar Claude Code

Para instalar Claude Code, use um dos seguintes métodos:

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Você também pode instalar com apt, dnf, ou apk no Debian, Fedora, RHEL e Alpine.

Após a conclusão da instalação, abra um terminal no projeto em que deseja trabalhar e inicie Claude Code:

claude

Claude Code abre uma sessão interativa em seu terminal.

Se você encontrar algum problema durante a instalação, consulte Solucionar problemas de instalação e login.

Configurar no Windows

Você pode executar Claude Code nativamente no Windows ou dentro do WSL. Escolha com base em onde seus projetos estão localizados e quais recursos você precisa:

Opção 1: Windows nativo

Execute o comando de instalação a partir do PowerShell ou CMD. Você não precisa executar como Administrador. Instalar Git for Windows é opcional. Ele habilita a ferramenta Bash fornecendo Git Bash.

Se você instalar a partir do PowerShell ou CMD apenas afeta qual comando de instalação você executa. Seu prompt mostra PS C:\Users\SeuNome> no PowerShell e C:\Users\SeuNome> sem o PS no CMD. Se você é novo no terminal, o guia de terminal orienta cada etapa.

Após a instalação, inicie claude a partir de qualquer terminal.

• Sem Git for Windows, Claude Code executa comandos shell através da ferramenta PowerShell.

• Com Git for Windows, Claude Code usa Git Bash para a ferramenta Bash. Se Claude Code não conseguir encontrar Git Bash, defina o caminho em seu arquivo settings.json:

  {
    "env": {
      "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
    }
  }
  

Quando Git for Windows está instalado, a ferramenta PowerShell está disponível ao lado do Bash: ativada por padrão para contas claude.ai e Console, e habilitada com CLAUDE_CODE_USE_POWERSHELL_TOOL=1 em sessões do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Defina como 0 para desativar a ferramenta. Consulte ferramenta PowerShell para configuração e limitações.

Opção 2: WSL

Abra sua distribuição WSL e execute o instalador Linux a partir das instruções de instalação acima. Você instala e inicia claude dentro do terminal WSL, não a partir do PowerShell ou CMD.

Alpine Linux e distribuições baseadas em musl

Instalar Claude Code no Alpine e outras distribuições baseadas em musl/uClibc requer bash e curl para o comando de instalação, e libgcc, libstdc++ e ripgrep em tempo de execução. O Alpine não inclui bash ou curl por padrão, portanto o comando de instalação documentado falha com um erro not found até que você os instale. Instale esses pacotes usando o gerenciador de pacotes da sua distribuição e defina USE_BUILTIN_RIPGREP=0.

Este exemplo instala os pacotes necessários no Alpine:

apk add bash curl libgcc libstdc++ ripgrep

No Alpine, ripgrep está no repositório community. Se apk relatar que o pacote está faltando, adicione o repositório community a /etc/apk/repositories, usando sua versão do Alpine:

echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

Execute apk update para atualizar o índice de pacotes e tente novamente o comando apk add.

Em seguida, defina USE_BUILTIN_RIPGREP como 0 em seu arquivo settings.json:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Verificar sua instalação

Após a instalação, confirme que Claude Code está funcionando:

claude --version

Uma instalação funcionando imprime um número de versão como 2.1.211 (Claude Code).

Se isso falhar com command not found ou outro erro, consulte Solucionar problemas de instalação e login.

Para uma verificação mais detalhada de sua instalação e configuração, execute claude doctor:

claude doctor

claude doctor imprime diagnósticos de instalação e configurações somente leitura sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e quaisquer avisos com correções sugeridas.

Autenticar

Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console. O plano gratuito do Claude.ai não inclui acesso ao Claude Code. Você também pode usar Claude Code com um provedor de API de terceiros como Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

Após a instalação, faça login executando claude e seguindo os prompts do navegador. Se a variável de ambiente ANTHROPIC_API_KEY estiver definida, Claude Code solicita uma vez que você aprove a chave em vez de abrir um navegador. Consulte Autenticação para todos os tipos de conta e opções de configuração de equipe.

Atualizar Claude Code

As instalações nativas são atualizadas automaticamente em segundo plano. Você pode configurar o canal de lançamento para controlar se recebe atualizações imediatamente ou em um cronograma estável com atraso, ou desabilitar atualizações automáticas completamente. As instalações do Homebrew, WinGet e gerenciador de pacotes Linux requerem atualizações manuais por padrão.

Atualizações automáticas

Claude Code verifica atualizações na inicialização e periodicamente durante a execução. As atualizações são baixadas e instaladas em segundo plano, depois entram em vigor na próxima vez que você inicia Claude Code.

Execute claude doctor para ver o resultado da tentativa de atualização mais recente.

No macOS e Linux, o instalador nativo gerencia o inicializador em ~/.local/bin/claude como um symlink para ~/.local/share/claude/versions/. Se você substituir esse inicializador com seu próprio script ou symlink, a auto-atualização e claude update o deixam no lugar: novas versões ainda são instaladas no diretório versions/, e seu inicializador decide qual versão é executada. Antes da v2.1.207, o auto-atualizador substituía um inicializador personalizado nesse caminho com seu próprio symlink a cada atualização.

Com um inicializador personalizado, Claude Code também mantém todas as versões instaladas no disco porque não consegue determinar qual versão o inicializador precisa. claude doctor relata um inicializador que o instalador nativo não criou.

Para permitir que Claude Code gerencie o inicializador novamente, remova ~/.local/bin/claude e execute claude update.

Se uma instalação global do npm não conseguir fazer auto-atualização porque o diretório global do npm não é gravável, Claude Code mostra um aviso único na inicialização, e claude doctor lista as correções disponíveis. Consulte erros de permissão durante a instalação para obter detalhes.

Configurar canal de lançamento

Controle qual canal de lançamento Claude Code segue para atualizações automáticas e claude update com a configuração autoUpdatesChannel:

• "latest", o padrão: receba novos recursos assim que forem lançados
• "stable": use uma versão que normalmente tem cerca de uma semana de idade, pulando lançamentos com regressões importantes

Configure isso via /config → Canal de atualização automática, ou adicione-o ao seu arquivo settings.json:

{
  "autoUpdatesChannel": "stable"
}

Para implantações empresariais, você pode impor um canal de lançamento consistente em toda a sua organização usando configurações gerenciadas.

As instalações do Homebrew escolhem um canal pelo nome do cask em vez dessa configuração: claude-code rastreia estável e claude-code@latest rastreia mais recente.

Fixar uma versão mínima

A configuração minimumVersion estabelece um piso. As atualizações automáticas em segundo plano e claude update recusam instalar qualquer versão abaixo desse valor, portanto mudar para o canal "stable" não faz downgrade se você já estiver em um build "latest" mais recente.

Mudar de "latest" para "stable" via /config solicita que você escolha ficar na versão atual ou permitir o downgrade. Escolher ficar define minimumVersion para essa versão. Mudar de volta para "latest" limpa isso.

Adicione-o ao seu arquivo settings.json para fixar um piso explicitamente:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Em configurações gerenciadas, isso impõe um mínimo em toda a organização que as configurações de usuário e projeto não podem substituir.

O pino minimumVersion apenas restringe atualizações. Para fazer Claude Code recusar iniciar fora de um intervalo de versão, use as configurações gerenciadas requiredMinimumVersion e requiredMaximumVersion em vez disso. As atualizações também respeitam o teto requiredMaximumVersion. Consulte requiredMinimumVersion e requiredMaximumVersion.

Desabilitar atualizações automáticas

Defina DISABLE_AUTOUPDATER como "1" na chave env do seu arquivo settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Em uma instalação nativa ou npm, confirme que a alteração entrou em vigor executando claude doctor e verificando se a linha Auto-updates mostra disabled (set by env: DISABLE_AUTOUPDATER) em vez de enabled.

DISABLE_AUTOUPDATER apenas interrompe a verificação em segundo plano; claude update e claude install ainda funcionam. Para bloquear todos os caminhos de atualização, incluindo atualizações manuais, defina DISABLE_UPDATES em vez disso. Use isso quando você distribuir Claude Code através de seus próprios canais e precisar que os usuários permaneçam na versão que você fornece.

Atualizar manualmente

Para aplicar uma atualização imediatamente sem aguardar a próxima verificação em segundo plano, execute:

claude update

Quando uma atualização é instalada, o comando relata Successfully updated from <old version> to version <new version>. Se você já estiver na versão mais recente, ele relata Claude Code is up to date (<version>). As instalações gerenciadas pelo Homebrew, WinGet ou apk relatam Claude is up to date! em vez disso.

Opções avançadas de instalação

Essas opções são para fixação de versão, gerenciadores de pacotes Linux, npm e verificação da integridade do binário.

Instalar uma versão específica

O instalador nativo aceita um número de versão específico ou um canal de lançamento (latest ou stable). O canal que você escolhe no momento da instalação se torna seu padrão para atualizações automáticas. Consulte configurar canal de lançamento para mais informações.

Para instalar a versão mais recente (padrão):

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Para instalar a versão estável:

curl -fsSL https://claude.ai/install.sh | bash -s stable

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Para instalar um número de versão específico:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

Para confirmar qual versão foi instalada, execute claude --version: o comando imprime a versão exata que você passou, como 2.1.89 (Claude Code).

Instalar com gerenciadores de pacotes Linux

Claude Code publica repositórios apt, dnf e apk assinados. Cada repositório oferece dois canais: stable oferece uma versão que é tipicamente cerca de uma semana antiga, pulando lançamentos com regressões maiores, e latest oferece cada lançamento assim que é lançado. Os comandos abaixo configuram o canal stable, que se adequa à maioria dos usuários; cada aba também mostra a URL do repositório latest. As instalações do gerenciador de pacotes não são atualizadas automaticamente através do Claude Code; as atualizações chegam através do seu fluxo de trabalho de atualização do sistema normal.

Todos os repositórios são assinados com a chave de assinatura de lançamento do Claude Code. Antes de confiar na chave, verifique-a conforme descrito em cada aba.

sudo apt install curl gnupg

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc

gpg --show-keys /etc/apt/keyrings/claude-code.asc

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

Instalar com npm

Você também pode instalar Claude Code como um pacote npm global. A partir da v2.1.198, o pacote npm requer Node.js 22 ou posterior. Em uma versão mais antiga do Node.js, npm imprime um aviso EBADENGINE durante a instalação em vez de falhar; a instalação é concluída e claude ainda funciona, já que o pacote baixa um binário nativo que não usa seu Node.js em tempo de execução.

npm install -g @anthropic-ai/claude-code

O pacote npm instala o mesmo binário nativo que o instalador autônomo. npm puxa o binário através de uma dependência opcional por plataforma como @anthropic-ai/claude-code-darwin-arm64, e uma etapa postinstall o vincula no lugar. O binário claude instalado não invoca Node em si.

As plataformas de instalação npm suportadas são darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 e win32-arm64. Seu gerenciador de pacotes deve permitir dependências opcionais. Consulte solução de problemas se o binário estiver faltando após a instalação.

Para atualizar uma instalação npm, execute npm install -g @anthropic-ai/claude-code@latest. Evite npm update -g, que respeita o intervalo semver da instalação original e pode não movê-lo para a versão mais recente.

Integridade binária e assinatura de código

Cada lançamento publica um manifest.json contendo checksums SHA256 para cada binário de plataforma. O manifesto é assinado com uma chave GPG da Anthropic, portanto verificar a assinatura no manifesto verifica transitivamente cada binário que ele lista.

Verificar a assinatura do manifesto

As etapas 1-3 requerem um shell POSIX com gpg e curl. No Windows, execute-as no Git Bash ou WSL. A etapa 4 inclui uma opção PowerShell.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

gpg --fingerprint security@anthropic.com

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

gpg --verify manifest.json.sig manifest.json

sha256sum claude

shasum -a 256 claude

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

Assinaturas de código de plataforma

Além do manifesto assinado, os binários individuais carregam assinaturas de código nativas da plataforma onde suportado.

• macOS: assinado por "Anthropic PBC" e autenticado pela Apple. Verifique com codesign --verify --verbose ./claude.
• Windows: assinado por "Anthropic, PBC". Verifique com Get-AuthenticodeSignature .\claude.exe.
• Linux: os binários não são individualmente assinados com código. Se você baixar diretamente do bucket claude-code-releases ou usar o instalador nativo, verifique a integridade com a assinatura de manifesto acima. Se você instalar com apt, dnf ou apk, seu gerenciador de pacotes verifica assinaturas automaticamente usando a chave de assinatura do repositório.

Desinstalar Claude Code

Para remover Claude Code, siga as instruções para seu método de instalação. Se claude ainda for executado depois, você provavelmente tem uma segunda instalação ou um alias de shell residual de um instalador mais antigo. Consulte Verificar instalações conflitantes para encontrá-lo e removê-lo.

Instalação nativa

Remova o binário Claude Code e os arquivos de versão:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Instalação do Homebrew

Remova o cask do Homebrew que você instalou. Se você instalou o cask estável:

brew uninstall --cask claude-code

Se você instalou o cask mais recente:

brew uninstall --cask claude-code@latest

Instalação do WinGet

Remova o pacote WinGet:

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Remova o pacote e a configuração do repositório:

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

Remova o pacote npm global:

npm uninstall -g @anthropic-ai/claude-code

Remover arquivos de configuração

A extensão VS Code, o plugin JetBrains e o aplicativo de desktop também escrevem em ~/.claude/. Se algum deles ainda estiver instalado, o diretório será recriado na próxima vez que for executado. Para remover Claude Code completamente, desinstale a extensão VS Code, o plugin JetBrains e o aplicativo de desktop antes de excluir esses arquivos.

Para remover as configurações e dados em cache do Claude Code:

# Remover configurações de usuário e estado
rm -rf ~/.claude
rm ~/.claude.json

# Remover configurações específicas do projeto (execute a partir do diretório do seu projeto)
rm -rf .claude
rm -f .mcp.json

# Remover configurações de usuário e estado
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Remover configurações específicas do projeto (execute a partir do diretório do seu projeto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force