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. Em Windows nativo, Git for Windows é recomendado; Claude Code volta para PowerShell quando Git Bash está ausente. Configurações WSL não requerem Git for Windows.
- 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
To install Claude Code, use one of the following methods:
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
winget install Anthropic.ClaudeCode
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
Após a conclusão da instalação, abra um terminal no projeto em que deseja trabalhar e inicie Claude Code:
claude
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 | Requer | Sandboxing | Quando usar |
|---|---|---|---|
| Windows nativo | Git for Windows recomendado; PowerShell usado se ausente | Não suportado | Projetos e ferramentas nativas do Windows |
| WSL 2 | WSL 2 habilitado | Suportado | Cadeias de ferramentas Linux ou execução de comando em sandbox |
| WSL 1 | WSL 1 habilitado | Não suportado | Se WSL 2 não estiver disponível |
Opção 1: Windows nativo com Git Bash
Instale Git for Windows e execute o comando de instalação a partir do PowerShell ou CMD. Você não precisa executar como Administrador.
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 do PowerShell, CMD ou Git Bash. Quando Git Bash está instalado, Claude Code o usa internamente para executar comandos independentemente de onde você o iniciou. Se Claude Code não conseguir encontrar sua instalação do Git Bash, defina o caminho em seu arquivo settings.json:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
Claude Code também pode executar PowerShell nativamente no Windows. Quando Git Bash está instalado, a ferramenta PowerShell está sendo lançada progressivamente como uma opção adicional: defina CLAUDE_CODE_USE_POWERSHELL_TOOL=1 para aceitar ou 0 para recusar. 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
O instalador nativo no Alpine e outras distribuições baseadas em musl/uClibc requer libgcc, libstdc++ e ripgrep. Instale-os 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 libgcc libstdc++ ripgrep
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
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
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 Vertex AI ou Microsoft Foundry.
Após a instalação, faça login executando claude e seguindo os prompts do 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.
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.
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.
Desabilitar atualizações automáticas
Defina DISABLE_AUTOUPDATER como "1" na chave env do seu arquivo settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
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
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
Instalar com gerenciadores de pacotes Linux
Claude Code publica repositórios apt, dnf e apk assinados. Substitua stable por latest para o canal contínuo. 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.
Para Debian e Ubuntu. Para usar o canal contínuo, altere ambas as ocorrências de stable na linha deb: o caminho da URL e o nome do suite.
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
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
Verifique a impressão digital da chave GPG antes de confiar nela: gpg --show-keys /etc/apt/keyrings/claude-code.asc deve relatar 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.
Para atualizar mais tarde, execute sudo apt update && sudo apt upgrade claude-code.
Para Fedora e RHEL:
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
dnf baixa a chave na primeira instalação e solicita que você confirme a impressão digital. Verifique se ela corresponde a 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE antes de aceitar.
Para atualizar mais tarde, execute sudo dnf upgrade claude-code.
Para Alpine Linux:
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
Verifique a chave baixada com sha256sum /etc/apk/keys/claude-code.rsa.pub, que deve relatar 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6.
Para atualizar mais tarde, execute apk update && apk upgrade claude-code.
Instalar com npm
Você também pode instalar Claude Code como um pacote npm global. O pacote requer Node.js 18 ou posterior.
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.
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.
Baixar e importar a chave pública
A chave de assinatura de lançamento é publicada em uma URL fixa.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Exiba a impressão digital da chave importada.
gpg --fingerprint security@anthropic.com
Confirme que a saída inclui esta impressão digital:
31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE
Baixar o manifesto e a assinatura
Defina VERSION para o lançamento que você deseja verificar.
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"
Verificar a assinatura
Verifique a assinatura destacada contra o manifesto.
gpg --verify manifest.json.sig manifest.json
Um resultado válido relata Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".
gpg também imprime WARNING: This key is not certified with a trusted signature! para qualquer chave recém-importada. Isso é esperado. A linha Good signature confirma que a verificação criptográfica passou. A comparação de impressão digital na Etapa 1 confirma que a chave em si é autêntica.
Verificar o binário contra o manifesto
Compare o checksum SHA256 do seu binário baixado com o valor listado em platforms.<platform>.checksum em 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-releasesou 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.
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