Resumo Rápido: O Claude Code pode ser instalado através de instaladores nativos em macOS, Windows e Linux a partir do site oficial do Claude Code. Os usuários do Windows devem instalar o WSL2 primeiro antes de executar o Claude Code. Após a instalação, autentique-se com sua conta Claude quando o Claude Code abrir uma janela do navegador para você fazer login no primeiro lançamento para começar a codificar com assistência de IA diretamente do seu terminal ou aplicativo desktop.
O Claude Code representa o investimento da Anthropic em ferramentas de desenvolvimento de IA agente. Este assistente de linha de comando lê bases de código, edita arquivos, executa comandos e se integra a fluxos de trabalho de desenvolvimento.
Mas instalá-lo nem sempre é direto. Diferentes plataformas exigem abordagens diferentes. O Windows precisa de configuração adicional. E a documentação, embora abrangente, pode sobrecarregar os novatos.
Este guia corta a complexidade. Ele cobre os requisitos do sistema, etapas de instalação específicas da plataforma, autenticação e verificação — tudo o que é necessário para que o Claude Code funcione corretamente.
Requisitos do Sistema Antes da Instalação
De acordo com a documentação oficial do Claude Code, a ferramenta suporta macOS, Windows e Linux. No entanto, cada plataforma tem pré-requisitos específicos.
Para macOS, os requisitos são mínimos. O sistema precisa do macOS 13.0 ou posterior. Ambos os chips Intel e Apple Silicon funcionam bem.
O Windows apresenta mais complexidade. O sistema operacional deve ser Windows 10 Build 19041 ou posterior, ou Windows 11. Mas aqui está o truque — o Claude Code não roda nativamente no Windows.
O Subsistema do Windows para Linux 2 (WSL2) é obrigatório. Isso cria um ambiente Linux onde o Claude Code realmente opera. Sem o WSL2, a instalação falha.
Usuários de Linux precisam de uma distribuição de 64 bits. A documentação oficial confirma o suporte para Ubuntu, Debian, Fedora e outras distribuições principais. O Alpine Linux e sistemas baseados em musl exigem configuração adicional.
Todas as plataformas precisam de uma conexão de internet estável durante a instalação. Os tamanhos de download variam, mas geralmente ficam entre 50 MB e 500 MB, dependendo do que já está instalado.
| Plataforma | Versão Mínima | Requisitos Especiais |
|---|---|---|
| macOS | 13.0 | Nenhum |
| Windows | 10 Build 19041 ou 11 | WSL2 necessário |
| Linux | Distribuição de 64 bits | Preferencialmente baseado em glibc |
Instalando o Claude Code no macOS
O processo de instalação do macOS usa um instalador nativo. Este é o caminho mais simples entre todas as plataformas.
Primeiro, baixe o instalador do site oficial do Claude Code. A página de download detecta automaticamente o macOS e oferece o pacote apropriado.
Abra o arquivo .dmg baixado. Arraste o aplicativo Claude Code para a pasta Aplicativos. Instalação padrão do macOS — nada incomum aqui.
Alguns usuários encontram um aviso de segurança ao iniciar pela primeira vez. O macOS bloqueia aplicativos de desenvolvedores não identificados por padrão. Clique com o botão direito no aplicativo Claude Code e selecione "Abrir" para ignorar este aviso único.
A ferramenta de linha de comando é instalada automaticamente com o aplicativo desktop. Abra o Terminal e digite `claude --version` para verificar. Se o número da versão aparecer, a instalação foi bem-sucedida.
Verificando a Instalação do macOS
Execute estes comandos para confirmar que tudo funciona:
| `claude --version` `claude --help` |
Ambos os comandos devem retornar saída sem erros. O comando `version` mostra a versão instalada do Claude Code. O comando `help` exibe as opções e comandos disponíveis.
Criar um diretório de teste ajuda a verificar a funcionalidade completa. Navegue até uma pasta de projeto e execute `claude` para iniciar uma sessão interativa. A ferramenta deve inicializar e solicitar autenticação se ainda não estiver logado.
Instalação do Windows com WSL2
A instalação do Windows requer várias etapas. O processo leva mais tempo do que o macOS, mas permanece gerenciável.
O WSL2 deve ser instalado primeiro. Abra o PowerShell como Administrador e execute:
| `wsl --install` |
Este comando instala o WSL2 e o Ubuntu por padrão. O sistema exigirá uma reinicialização. Após reiniciar, o Ubuntu é iniciado automaticamente para completar a configuração inicial.
Crie um nome de usuário e senha Unix quando solicitado. Essas credenciais são separadas das credenciais de login do Windows.
Uma vez que o WSL2 esteja em execução, o processo de instalação do Linux se aplica. Abra o terminal do Ubuntu (instalado com o WSL2) e baixe o instalador do Claude Code para Linux.
Instalando o Claude Code no WSL2
De acordo com a documentação oficial, o comando de instalação baixa e executa o instalador nativo:
| `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash` |
Este script cuida das dependências automaticamente. Ele instala o Node.js, se necessário, configura o binário do Claude Code e as variáveis PATH.
A instalação leva alguns minutos. Barras de progresso e mensagens de status indicam o que está acontecendo. Quando concluído, feche e reabra o terminal para atualizar as variáveis de ambiente.
Testar a instalação segue o mesmo processo do macOS. Execute `claude --version` para verificar.
Processo de Instalação do Linux
Usuários de Linux têm o caminho de instalação mais direto. O instalador nativo funciona diretamente sem camadas adicionais como WSL2.
Baixe e execute o script de instalação:
| `curl -fsSL claude.ai/install.sh | bash` |
Isso baixa o binário do Claude Code, instala dependências e configura o ambiente do shell. O script detecta a distribuição e se ajusta de acordo.
Para sistemas baseados em Ubuntu e Debian, o script configura a instalação. A documentação oficial confirma o suporte para Ubuntu 20.04+, Debian 10+ e outras distribuições.
Considerações sobre Alpine Linux
O Alpine Linux e as distribuições baseadas em musl precisam de etapas adicionais. A documentação oficial observa que esses sistemas exigem configuração manual.
O instalador padrão pode falhar no Alpine. Em vez disso, baixe o binário compatível com musl diretamente da página de releases. Extraia-o para um diretório no PATH do sistema, geralmente /usr/local/bin.
Defina as permissões de execução:
| `chmod +x /usr/local/bin/claude` |
Usuários de Alpine devem verificar a compatibilidade antes de prosseguir. Alguns recursos podem não funcionar exatamente como em distribuições baseadas em glibc.
Autenticação e Configuração da Conta
Após instalar o Claude Code, execute `claude` no seu terminal. No primeiro lançamento, o Claude Code abre uma janela do navegador para você fazer login.
Isso abre a página de autenticação do Claude. Faça login com uma conta Claude existente ou crie uma nova.
O navegador exibe um código de autorização. Copie este código e retorne ao terminal. Cole o código quando solicitado.
A autenticação bem-sucedida armazena as credenciais localmente. Sessões futuras não exigirão login, a menos que as credenciais expirem ou sejam limpas manualmente.
Autenticação de Equipe e Corporativa
De acordo com a documentação oficial de autenticação, equipes que usam Claude para Equipes ou Corporativo têm opções adicionais. Organizações podem configurar login único (SSO) ou autenticação de provedor de nuvem.
A configuração de SSO requer configuração do administrador. Desenvolvedores individuais então se autenticam através do provedor de identidade de sua organização em vez de contas Claude pessoais.
A autenticação de provedor de nuvem funciona para implantações AWS, Google Cloud e Azure. Este método usa credenciais de nuvem existentes em vez de contas Claude separadas.
| Método de Autenticação | Caso de Uso | Complexidade de Configuração |
|---|---|---|
| Conta Pessoal | Desenvolvedores individuais | Simples |
| SSO de Equipe/Corporativo | Organizações | Requer admin |
| Provedor de Nuvem | Usuários AWS/GCP/Azure | Moderada |
Instalação do Aplicativo Desktop
O Claude Code oferece aplicativos de linha de comando e desktop. O aplicativo desktop fornece uma interface gráfica, mantendo a funcionalidade completa do terminal.
Baixe o instalador desktop do site oficial do Claude. A página oferece versões para macOS, Windows e Windows ARM64. Selecione a versão apropriada para o sistema.
A instalação do macOS segue o mesmo processo .dmg descrito anteriormente. Usuários do Windows podem baixar o aplicativo desktop para uma interface gráfica sem a necessidade de configuração do WSL2.
O aplicativo desktop inclui acesso a terminal integrado. Ele pode iniciar sessões do Claude Code sem alternar para aplicativos de terminal externos.
Uma vantagem do aplicativo desktop é a disponibilidade em segundo plano. De acordo com a página de download oficial, o aplicativo "fica pronto em segundo plano" e pode ser acessado de qualquer aplicativo sem trocar de janela ou perder o foco.
Use Get AI Perks para Encontrar Créditos para sua Pilha Claude Code
A instalação é a parte fácil. O custo real geralmente vem de tudo ao redor: infraestrutura, ferramentas de suporte e serviços pagos usados durante a configuração e testes. O Get AI Perks pode ajudar listando créditos e descontos de startups em um só lugar, juntamente com orientações sobre como aplicá-los.
Com o Get AI Perks, você pode:
- Encontrar créditos para ferramentas de nuvem e IA
- Verificar as condições dos benefícios antes de se candidatar
- Evitar perder tempo com ofertas para as quais você pode não se qualificar
- Reduzir o custo de colocar sua configuração em ordem
Visite o Get AI Perks para ver se as ofertas disponíveis correspondem às ferramentas que você planeja usar com o Claude Code.
Extensões de IDE e Integrações
Além da instalação autônoma, o Claude Code se integra a ambientes de desenvolvimento populares. Existem extensões para Visual Studio Code e IDEs JetBrains.
A extensão VS Code é instalada através do marketplace. Procure por "Claude Code" no painel de Extensões e clique em Instalar. A extensão requer que a ferramenta de linha de comando seja instalada primeiro.
Alguns usuários relatam problemas com o arquivo de extensão VS Code empacotado. Se a instalação automática falhar com um erro "End of central directory record signature not found", o arquivo .vsix empacotado pode estar corrompido.
A solução alternativa envolve instalar a extensão manualmente do marketplace do VS Code em vez de depender da versão empacotada da CLI. Isso separa os dois componentes e evita conflitos de instalação.
A integração com JetBrains funciona de maneira semelhante. Instale o plugin do marketplace JetBrains dentro do IntelliJ IDEA, PyCharm, WebStorm ou outros produtos JetBrains.
Verificando o Sucesso da Instalação
A verificação adequada garante que o Claude Code funcione corretamente antes de iniciar as tarefas reais de desenvolvimento.
Verificações básicas verificam a disponibilidade de comandos:
| `claude --help` `claude --version` |
Esses comandos devem ser executados sem erros. O comando `help` lista as opções disponíveis. O comando `version` mostra a versão instalada.
Testes funcionais exigem o início de uma sessão. Crie um diretório de teste:
| `mkdir test-project` `cd test-project` `claude` |
Isso inicializa uma sessão interativa do Claude Code. A ferramenta deve analisar o diretório (vazio neste caso) e apresentar um prompt.
Tente comandos básicos dentro da sessão. Digite `help` para ver as ações disponíveis. Solicite tarefas simples como "criar um arquivo README" ou "explique o que você pode fazer".
Respostas bem-sucedidas indicam instalação adequada. Se ocorrerem erros, eles geralmente estão relacionados à autenticação, conectividade de rede ou dependências ausentes.
Gerenciamento de Atualização e Versão
O Claude Code atualiza automaticamente por padrão. A documentação oficial explica que a ferramenta verifica novas versões e as instala sem intervenção do usuário.
O comportamento de atualização pode ser configurado através das configurações do Claude Code. A documentação oficial cobre a configuração do canal de release e as opções de atualização manual.
Atualizações manuais exigem a execução do script de instalação novamente. O mesmo comando usado para a instalação inicial baixa a versão mais recente:
| `curl -fsSL claude.ai/install.sh | bash` |
É possível instalar versões específicas para teste ou motivos de compatibilidade. A documentação de configuração avançada cobre o fixo de versão e a configuração do canal de release.
Os canais de release incluem estável, beta e noturno. Estável é recomendado para trabalho de produção. Os canais beta e noturno fornecem acesso antecipado a novos recursos, mas podem conter bugs.
Problemas Comuns de Instalação
Vários problemas aparecem frequentemente em discussões da comunidade sobre a instalação do Claude Code.
A configuração do PATH causa muitos problemas. Se o comando `claude` não for encontrado após a instalação, o diretório do binário não está no PATH do sistema.
No macOS e Linux, adicionar o diretório ao PATH geralmente envolve editar ~/.bashrc, ~/.zshrc ou arquivos de configuração semelhantes do shell. O script de instalação geralmente cuida disso automaticamente, mas a verificação manual ajuda a solucionar problemas.
Usuários do Windows no WSL2 podem precisar fechar e reabrir o terminal após a instalação. As variáveis de ambiente não são atualizadas em sessões existentes.
Restrições de rede bloqueiam algumas instalações. Firewalls corporativos ou servidores proxy podem impedir o download do instalador ou a conexão com servidores de autenticação.
A configuração de proxy requer variáveis de ambiente:
| `export HTTP_PROXY=proxy.example.com:8080` `export HTTPS_PROXY=proxy.example.com:8080` |
Erros de permissão ocorrem ao instalar em diretórios protegidos. O instalador precisa de acesso de gravação a /usr/local/bin ou locais equivalentes. Executar com `sudo` resolve isso, mas deve ser evitado, a menos que seja necessário.
Perguntas Frequentes
O Claude Code pode funcionar sem conexão com a internet?
Não. O Claude Code requer conectividade com a internet para funcionar. A ferramenta envia código e consultas para os servidores da Anthropic para processamento. O cache local pode permitir que algumas operações funcionem temporariamente offline, mas a funcionalidade completa requer conexão ativa.
O Claude Code funciona com ferramentas de codificação de IA existentes?
Sim. O Claude Code pode rodar ao lado do GitHub Copilot, Cursor ou outras ferramentas de desenvolvimento de IA. Eles operam independentemente e não entram em conflito. No entanto, usar vários assistentes de IA simultaneamente pode criar confusão sobre qual ferramenta está lidando com qual tarefa.
O WSL2 é necessário para todos os recursos do Windows?
A ferramenta de linha de comando requer WSL2 no Windows. No entanto, o aplicativo desktop roda nativamente no Windows sem WSL2. O aplicativo desktop fornece funcionalidade semelhante através de uma interface gráfica em vez de interação pura de linha de comando.
Quanto custa usar o Claude Code?
Os preços variam com base no uso e no nível de assinatura. Verifique o site oficial do Claude para os preços atuais, pois os custos e as estruturas de planos mudam ao longo do tempo. Alguns recursos exigem assinaturas Claude Pro ou Enterprise.
O Claude Code pode editar arquivos fora do diretório do projeto?
Por padrão, o Claude Code restringe o acesso a arquivos ao diretório do projeto atual por segurança. As configurações podem expandir as permissões, mas isso requer autorização explícita. A documentação de sandboxing cobre o gerenciamento de permissões em detalhes.
Qual é a diferença entre Claude Code e a API Claude?
Claude Code é uma ferramenta de desenvolvimento para assistência interativa de codificação. A API Claude fornece acesso programático para construir aplicações que utilizam as capacidades de IA do Claude. Eles servem a propósitos diferentes — um para desenvolvedores escrevendo código, o outro para aplicações integrando recursos de IA.
A desinstalação remove todos os dados do Claude Code?
A desinstalação remove o binário do aplicativo, mas pode deixar arquivos de configuração e dados em cache. A remoção completa requer a exclusão manual do diretório ~/.claude no macOS e Linux, ou o local equivalente do AppData no Windows.
Primeiros Passos Após a Instalação
Com o Claude Code instalado e verificado, o próximo passo envolve entender como usá-lo de forma eficaz.
A documentação de início rápido recomenda começar com tarefas simples. Navegue até um projeto existente e execute `claude` para iniciar uma sessão interativa.
Peça ao Claude para explicar a estrutura do projeto. Solicite um resumo do que a base de código faz. Essas consultas exploratórias ajudam a entender como a ferramenta interpreta o código.
Tente fazer pequenas alterações. Peça ao Claude para adicionar comentários a funções, criar arquivos de teste simples ou refatorar blocos de código básicos. Essas tarefas demonstram as capacidades de edição sem risco.
A integração com Git funciona automaticamente se o projeto usar controle de versão. O Claude Code pode criar commits, explicar diffs e sugerir melhorias com base nas alterações.
A documentação oficial inclui exemplos de fluxo de trabalho para tarefas de desenvolvimento comuns. Estes cobrem correção de bugs, implementação de recursos, revisão de código e testes automatizados.
O Claude Code é uma ferramenta em evolução. A instalação é apenas a base. Entender suas capacidades, limitações e melhores práticas leva experimentação e prática.
Pronto para instalar o Claude Code? Baixe o instalador apropriado para sua plataforma no site oficial e siga as etapas descritas neste guia. Autentique-se com sua conta Claude, verifique se a instalação funciona corretamente e comece a explorar o desenvolvimento com assistência de IA.
