Resumo Rápido: O Claude Code CLI é instalado através de um único comando que baixa e configura a ferramenta automaticamente. No macOS e Linux, use o script de shell oficial da documentação da Anthropic, enquanto os usuários do Windows executam comandos do PowerShell ou WSL. Após a instalação, autentique-se com sua chave de API para começar a usar o assistente de codificação de IA do Claude no seu terminal.
Claude Code é uma ferramenta de codificação agente que vive no seu terminal e entende todo o seu codebase. De acordo com a documentação oficial do Claude Code, ele pode ler arquivos, executar comandos, editar código e integrar-se com ferramentas de desenvolvimento através de conversas em linguagem natural.
Mas começar requer uma instalação adequada. Aqui está tudo o que é necessário para instalar o Claude Code CLI e configurá-lo corretamente.
Requisitos do Sistema Antes da Instalação
Antes de instalar o Claude Code, verifique se o sistema atende aos requisitos básicos. De acordo com a documentação oficial de configuração avançada, remova esta frase completamente.
Verifique a instalação do Node.js abrindo um terminal e executando:
| node –version |
Se o Node.js não estiver instalado ou a versão for inferior a 18, baixe-o do site oficial do Node.js. A versão de Suporte de Longo Prazo (LTS) funciona perfeitamente para o Claude Code.
Além do Node.js, o sistema precisa de requisitos básicos: macOS 13.0 ou superior para usuários de Mac, Windows 10 ou superior para sistemas Windows e a maioria das distribuições Linux modernas funcionam sem problemas. Uma conta Claude da Anthropic também é necessária para autenticação após a instalação.
Instalando Claude Code no macOS e Linux
O processo de instalação para macOS e Linux usa um único comando de shell que cuida de tudo automaticamente. Este método é documentado no guia oficial de início rápido do Claude Code.
Abra o Terminal e execute o script de instalação:
| curl -fsSL claude.ai/install.sh | bash |
O script baixa o binário do Claude Code, o coloca no diretório correto e configura o PATH automaticamente. Todo o processo geralmente é concluído em menos de um minuto.
Para usuários de macOS que preferem o Homebrew, existe um método de instalação alternativo, embora não esteja oficialmente documentado nas fontes principais. O método curl continua sendo a abordagem recomendada de acordo com a documentação oficial.
Verificando a Instalação
Após a conclusão da instalação, verifique se o Claude Code está acessível:
| claude –version |
Este comando deve exibir o número da versão instalada. Se um erro aparecer indicando "comando não encontrado", a configuração do PATH precisa ser ajustada.
De acordo com a documentação oficial de solução de problemas, problemas de PATH são o problema de instalação mais comum. A correção envolve adicionar o diretório de instalação do Claude ao arquivo de configuração do shell.
Instalando Claude Code no macOS e Linux
O processo de instalação para macOS e Linux depende do npm (Node Package Manager). De acordo com a documentação oficial, você deve ter o Node.js 18+ instalado em seu sistema antes de prosseguir. Ao contrário das ferramentas CLI tradicionais que usam scripts de shell, o Claude Code é instalado globalmente através do seu terminal para garantir que todas as dependências sejam tratadas corretamente.
Abra seu Terminal e execute o seguinte comando para instalar o pacote:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Nota: A variável de ambiente CLAUDE_CODE_RELEASE_ALPHA=1 é atualmente necessária durante a fase beta/alfa pública para reconhecer o status de prévia da ferramenta.
Este comando baixa o pacote do registro oficial do npm e vincula o executável `claude` ao diretório `bin` global do seu sistema. Embora alguns usuários possam tentar encontrar fórmulas do Homebrew, o método npm é o único caminho de instalação oficialmente suportado e documentado.
Verificando a Instalação
Após a conclusão da instalação, verifique se a CLI está corretamente mapeada para seu ambiente executando:
| claude –version |
Este comando deve exibir o número da versão atual (por exemplo, 0.2.9). Se você encontrar um erro "comando não encontrado", geralmente significa que seu diretório npm global não está no PATH do seu sistema.
De acordo com a documentação oficial de solução de problemas, você pode corrigir isso identificando seu prefixo npm com `npm config get prefix` e garantindo que a pasta `/bin` resultante seja adicionada ao seu arquivo .zshrc ou .bashrc.
Instalando Claude Code no Windows
A instalação do Windows oferece duas abordagens principais: instalação nativa via PowerShell ou usando o Subsistema do Windows para Linux (WSL). A documentação oficial recomenda o PowerShell para a maioria dos usuários.
Método de Instalação PowerShell
Abra o PowerShell como Administrador (clique com o botão direito no menu Iniciar e selecione "Windows PowerShell (Admin)"). Execute este comando:
| irm claude.ai/install.ps1 | iex |
O script do PowerShell cuida do download, instalação e configuração do PATH automaticamente. Após a conclusão, feche e reabra o PowerShell para garantir que as atualizações do PATH entrem em vigor.
Método de Instalação WSL
Desenvolvedores que já usam WSL podem instalar o Claude Code usando o método Linux. Abra o terminal WSL e execute o mesmo comando curl usado para Linux:
| curl -fsSL claude.ai/install.sh | bash |
A abordagem WSL funciona idêntica às instalações nativas do Linux. Uma vantagem: o WSL fornece um ambiente mais parecido com Unix que corresponde às configurações de servidores de produção.
De acordo com a documentação oficial de solução de problemas, usuários de WSL ocasionalmente encontram problemas de conectividade de rede. Se a instalação travar, verifique se o WSL pode acessar redes externas e se as regras de firewall não estão bloqueando o tráfego.
Encontre Créditos de Claude e Ferramentas de IA em um Só Lugar
Instalar o Claude Code CLI é um passo. Pagar por ferramentas de IA a longo prazo é outro. Get AI Perks reúne créditos de startups e descontos de software para ferramentas de IA e nuvem em um só lugar. Ele oferece aos fundadores acesso a mais de 200 vantagens, incluindo ofertas da Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom e outras. A plataforma também mostra as condições das vantagens e guias para reivindicar cada oferta.
Procurando Créditos Claude ou Anthropic?
Verifique Get AI Perks para:
- encontrar créditos e descontos de ferramentas de IA em um só lugar
- revisar as condições das vantagens antes de aplicar
- acessar guias para reivindicar ofertas de startups
👉 Visite Get AI Perks para navegar pelas vantagens disponíveis de Claude, Anthropic e outros softwares de IA.
Autenticação e Configuração Inicial
Após a instalação, o Claude Code requer autenticação antes que possa funcionar. A ferramenta usa chaves de API da Anthropic para verificar o acesso.
Inicie o processo de autenticação executando:
| claude |
Na primeira vez que este comando for executado, o Claude Code solicitará autenticação. De acordo com o guia oficial de início rápido, isso abrirá uma janela do navegador para fazer login na conta Anthropic.
Após o login através do navegador, a CLI recebe um token de autenticação automaticamente. Este token é armazenado localmente e persiste entre as sessões, portanto, autenticações repetidas não são necessárias.
Configurando Configurações de Nível de Projeto
O Claude Code suporta configuração em vários níveis de acordo com a documentação oficial de configurações. Os níveis de configuração mais comuns são:
| Escopo | Localização | Caso de Uso |
|---|---|---|
| Usuário | Diretório ~/.claude/ | Preferências pessoais em todos os projetos |
| Projeto | .claude/ no repositório | Configuração compartilhada pela equipe |
| Local | .claude/settings.local.json | Substituições específicas da máquina |
Para configuração inicial, a configuração de nível de usuário é suficiente. As configurações de nível de projeto se tornam importantes ao trabalhar com equipes que compartilham padrões de codificação.
Iniciando sua Primeira Sessão Claude Code
Com a instalação e autenticação concluídas, inicie o Claude Code executando o comando sem argumentos:
| claude |
Isso inicia o modo interativo onde o Claude responde a solicitações em linguagem natural. A documentação oficial descreve o modo interativo como a principal maneira de usar o Claude Code para tarefas de desenvolvimento.
Tente um comando de teste simples:
| Mostre-me a estrutura deste projeto |
O Claude Code analisa o diretório atual e fornece uma visão geral da estrutura do codebase. Isso demonstra que a instalação está funcionando corretamente e o Claude tem acesso para ler arquivos.
Comandos Essenciais para Uso Diário
Além do modo interativo, o Claude Code suporta vários padrões de comando documentados na referência da CLI:
| Padrão de Comando | Propósito | Exemplo |
|---|---|---|
| claude | Iniciar sessão interativa | claude |
| claude "tarefa" | Executar tarefa única | claude "corrigir os erros de lint" |
| claude -p "consulta" | Consulta rápida sem sessão | claude -p "o que esta função faz" |
O padrão de tarefa única é particularmente útil para pipelines de CI/CD e scripts de automação onde uma sessão interativa não é apropriada.
Solução de Problemas Comuns de Instalação
Mesmo com scripts de instalação automatizados, problemas ocasionalmente ocorrem. A documentação oficial de solução de problemas cobre os problemas mais frequentes.
Erros de Comando Não Encontrado
Se o terminal exibir "comando não encontrado: claude" após a instalação, a configuração do PATH não foi concluída corretamente. Para macOS e Linux, adicione manualmente o local do binário do Claude ao arquivo de configuração do shell.
Para usuários bash, edite `~/.bashrc` ou `~/.bash_profile` e adicione:
| export PATH=”$HOME/.local/bin:$PATH” |
Para usuários zsh (padrão no macOS moderno), edite `~/.zshrc` com a mesma linha. Após salvar, recarregue a configuração com `source ~/.zshrc` ou abra uma nova janela do terminal.
Problemas de Rede e Firewall
Redes corporativas e firewalls restritivos às vezes bloqueiam o script de instalação. De acordo com a documentação de solução de problemas, se a instalação travar ou retornar HTML em vez de executar, o acesso à rede aos servidores da Anthropic pode estar bloqueado.
A solução alternativa envolve baixar o script de instalação separadamente:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Esta abordagem fornece mais visibilidade sobre o que está falhando se ocorrerem erros durante o download ou a execução.
Problemas Específicos do WSL
Usuários do Windows executando WSL às vezes encontram problemas de conectividade entre o subsistema Linux e o Windows. A documentação oficial menciona que as regras de firewall podem precisar ser ajustadas para permitir o tráfego do WSL.
Se o Claude Code for instalado com sucesso, mas não conseguir alcançar os servidores da Anthropic para autenticação, verifique se o firewall do Windows permite o acesso à rede WSL. O guia de solução de problemas fornece comandos específicos do PowerShell para configurar regras de firewall.
Atualizando Claude Code
O Claude Code recebe atualizações regulares com novos recursos e melhorias. De acordo com a documentação oficial, as atualizações são instaladas usando o mesmo comando da instalação inicial.
Execute o script de instalação novamente:
| curl -fsSL code.anthropic.com/install.sh | sh |
O script detecta a instalação existente e a atualiza para a versão mais recente. Nenhuma configuração ou autenticação é perdida durante o processo de atualização.
Verifique a versão atual antes e depois de atualizar:
| claude –version |
O changelog na documentação oficial do Claude Code lista todas as alterações entre as versões, o que ajuda a determinar se uma atualização introduz recursos relevantes para fluxos de trabalho específicos.
Próximos Passos Após a Instalação
Com o Claude Code instalado e funcionando, a exploração de recursos avançados se torna possível. A documentação oficial descreve várias áreas que valem a pena investigar:
- Skills e personalização: De acordo com a documentação oficial de skills, o Claude Code suporta skills personalizadas definidas em arquivos Markdown dentro do diretório `.claude/skills/`. Essas skills estendem as capacidades do Claude com comandos e fluxos de trabalho específicos do projeto.
- Protocolo de Contexto do Modelo (MCP): A integração do MCP permite que o Claude Code se conecte a ferramentas e serviços externos. Isso transforma o Claude em um hub que pode acessar bancos de dados, APIs e outros recursos de desenvolvimento.
- Colaboração em equipe: Arquivos de configuração de nível de projeto no diretório `.claude/` podem ser enviados para controle de versão, compartilhando as configurações do Claude Code em equipes de desenvolvimento inteiras.
- A documentação oficial fornece guias detalhados para cada uma dessas áreas, baseando-se na instalação básica coberta aqui.
Perguntas Frequentes
Preciso de uma assinatura paga do Claude para usar o Claude Code CLI?
O Claude Code requer uma conta Claude da Anthropic, mas o nível de assinatura específico necessário depende do uso. De acordo com a documentação oficial, a autenticação é necessária, mas os detalhes de preços devem ser verificados no site oficial da Anthropic, pois os planos mudam ao longo do tempo.
Posso instalar o Claude Code sem privilégios de administrador?
No macOS e Linux, o Claude Code é instalado no diretório home do usuário por padrão e não requer acesso de administrador. Usuários do Windows podem precisar de privilégios de administrador para o método de instalação do PowerShell, embora as instalações do WSL não exijam acesso de admin.
O Claude Code funciona offline?
Não. O Claude Code é uma ferramenta movida a IA que se comunica com os servidores da Anthropic para processar solicitações. De acordo com a documentação oficial, uma conexão ativa com a internet é necessária para que o Claude analise código e gere respostas.
Como desinstalo o Claude Code?
A documentação oficial de configuração avançada explica que a desinstalação envolve a remoção do binário e dos arquivos de configuração. No macOS e Linux, exclua o diretório `~/.claude` e remova a modificação do PATH dos arquivos de configuração do shell. Usuários do Windows devem remover o diretório de instalação e limpar a variável de ambiente PATH.
O Claude Code pode acessar todo o meu sistema de arquivos?
Por padrão, o Claude Code opera dentro do diretório de trabalho atual e seus subdiretórios. De acordo com a documentação oficial de permissões, o acesso pode ser restringido ainda mais usando configurações de sandbox nos arquivos de configuração. O Claude sempre pede confirmação antes de executar operações potencialmente destrutivas.
Qual é a diferença entre Claude Code CLI e Claude Desktop?
O Claude Code CLI roda no terminal e se concentra em fluxos de trabalho de desenvolvimento com acesso direto ao sistema de arquivos e execução de comandos. O Claude Desktop é um aplicativo independente com uma interface gráfica. Ambas as ferramentas servem a casos de uso diferentes, com a CLI otimizada para desenvolvedores que preferem fluxos de trabalho baseados em terminal.
Com que frequência devo atualizar o Claude Code?
As atualizações podem ser instaladas sempre que conveniente. O changelog oficial documenta novos recursos e correções de bugs. Para equipes, coordenar atualizações garante que todos usem versões compatíveis, embora o Claude Code mantenha a compatibilidade retroativa com arquivos de configuração entre versões.
Conclusão
Instalar o Claude Code CLI leva apenas alguns minutos, independentemente do sistema operacional. Os scripts de instalação automatizados cuidam da configuração, configuração do PATH e colocação do binário sem intervenção manual.
Após a instalação e autenticação, o Claude Code se torna um poderoso assistente de codificação de IA acessível de qualquer terminal. Comandos em linguagem natural permitem que os desenvolvedores escrevam código, corrijam bugs e automatizem tarefas sem sair da linha de comando.
Pronto para experimentar o desenvolvimento assistido por IA? Execute o comando de instalação para sua plataforma e comece sua primeira sessão Claude Code hoje mesmo. A documentação oficial em code.claude.com fornece guias abrangentes para recursos avançados assim que a configuração básica for concluída.
