Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Instalar Claude Code

Prefere uma interface gráfica? O aplicativo de desktop permite que você use Claude Code sem o terminal. Baixe-o para macOS ou Windows.Novo no terminal? Consulte o guia de terminal para instruções passo a passo.
To install Claude Code, use one of the following methods: 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çãoRequerSandboxingQuando usar
Windows nativoGit for Windows recomendado; PowerShell usado se ausenteNão suportadoProjetos e ferramentas nativas do Windows
WSL 2WSL 2 habilitadoSuportadoCadeias de ferramentas Linux ou execução de comando em sandbox
WSL 1WSL 1 habilitadoNão suportadoSe 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 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.
As instalações do Homebrew, WinGet, apt, dnf e apk não são atualizadas automaticamente por padrão; veja abaixo para optar por Homebrew e WinGet. Para atualizar o Homebrew manualmente, execute brew upgrade claude-code ou brew upgrade claude-code@latest, dependendo de qual cask você instalou. Para WinGet, execute winget upgrade Anthropic.ClaudeCode. Para gerenciadores de pacotes Linux, consulte os comandos de atualização em Instalar com gerenciadores de pacotes Linux.Para que Claude Code execute o comando de atualização para você no Homebrew ou WinGet, defina CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE como 1. Claude Code então executa a atualização em segundo plano quando uma nova versão está disponível e mostra um prompt de reinicialização em caso de sucesso. A atualização visa apenas o pacote Claude Code e não afeta outro software que você tenha instalado.No WinGet, a atualização pode falhar enquanto Claude Code está em execução porque o Windows bloqueia o executável. Nesse caso, Claude Code mostra o comando manual em vez disso. apt, dnf e apk continuam a exigir uma atualização manual porque esses comandos precisam de privilégios elevados.Problema conhecido: Claude Code pode notificá-lo sobre atualizações antes que a nova versão esteja disponível nesses gerenciadores de pacotes. Se uma atualização falhar, aguarde e tente novamente mais tarde.O Homebrew mantém versões antigas no disco após atualizações. Execute brew cleanup periodicamente para recuperar espaço em disco.

​
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
Para instalar a versão estável: 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Para instalar um número de versão específico: 
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

​
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.

​
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. 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.
NÃO use sudo npm install -g pois isso pode levar a problemas de permissão e riscos de segurança. Se você encontrar erros de permissão, consulte solução de problemas de erros de permissã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.
1

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
2

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"
3

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.
4

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
As assinaturas de manifesto estão disponíveis para lançamentos de 2.1.89 em diante. Lançamentos anteriores publicam checksums em manifest.json sem uma assinatura destacada.

​
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

​
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

​
npm

Remova o pacote npm global: 
npm uninstall -g @anthropic-ai/claude-code

​
Remover arquivos de configuração

Remover arquivos de configuração excluirá todas as suas configurações, ferramentas permitidas, configurações do servidor MCP e histórico de sessã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