Como instalar Claude Code: guia completo para iniciantes

Para instalar Claude Code, use o método indicado para seu sistema e depois execute claude. O instalador nativo dispensa Node.js. O acesso exige uma modalidade compatível: assinatura que inclua Code, Console/API ou provedor suportado; o Claude Free não inclui Code.

Abra a documentação oficial antes de executar um instalador. Confira a origem do script, as permissões da sessão e a pasta do projeto em que o agente trabalhará.

Aprenda como instalar Claude Code, autenticar sua conta e usar o /init para configurar seu projeto. Veja requisitos e métodos nativo, Homebrew e WinGet.

O instalador nativo oferece atualização automática. Depois da instalação, execute claude e siga a autenticação correspondente à sua assinatura ou configuração de API.

Se você está começando no mundo do desenvolvimento de automações com Claude Code (CLI) e busca um guia simples e direto, este artigo vai te ajudar a entender exatamente como instalar Claude Code, configurar sua conta e iniciar seus primeiros projetos de maneira descomplicada. Vamos juntos passo a passo aprender os conceitos e processos que facilitarão sua jornada no uso desse poderoso CLI.

Requisitos essenciais antes de instalar Claude Code

Antes de iniciar a instalação do Claude Code, é fundamental garantir que seu ambiente esteja preparado para evitar erros e problemas posteriores. Para isso, confira os requisitos essenciais que você precisa atender:

1. Sistema Operacional Compatível: Claude Code suporta as principais plataformas, como Windows 10 ou superior, macOS 10.15+ e as principais distribuições Linux, por isso escolha o sistema operacional adequado conforme sua máquina.

   
   

2. Node.js: não é requisito do instalador nativo. Outros métodos têm requisitos próprios; não use a antiga versão 14 como referência.

   
   

3. Método npm: requer Node.js 22 ou posterior. O instalador nativo é um método separado e não depende de npm ou yarn.

   
   

4. Acesso ao Terminal ou Prompt de Comando: Familiarize-se com o uso do terminal, pois boa parte da instalação e configuração do Claude Code ocorre por linha de comando.

   
   

5. Conta Ativa no Serviço Claude Code: Antes de usar a ferramenta, você precisará criar e autenticar sua conta, para isso, tenha suas credenciais à mão.

   
   

6. Conexão de Internet Estável: A instalação, autenticação e uso inicial exigem acesso à internet, portanto, confirme que sua conexão está rápida e estável.

   
   

Esses pontos garantem que o ambiente esteja salvo para realizar uma instalação suave e sem interrupções. Se atingir esses requisitos, você está pronto para os próximos passos.

Indicação de formação para agentes de IA

Se você deseja aprimorar seu conhecimento na criação de agentes inteligentes e automações avançadas, recomendamos cursos especializados em desenvolvimento de agentes de IA.

Uma boa formação inclui aprendizado em programação, machine learning, APIs, e integração com ferramentas como o Claude Code.

Plataformas como Coursera, Udemy e edX possuem cursos atualizados e com certificação para você se destacar.

Principais métodos de instalação: nativo, Homebrew e WinGet

Claude Code pode ser instalado de três formas principais, que variam de acordo com o seu sistema operacional e familiaridade com ferramentas de linha de comando. Conhecer essas opções permite escolher o método que melhor se encaixa no seu perfil:

1. Instalação alternativa via npm:

• Destinado a usuários que já têm Node.js instalado.
• Execute o comando npm install -g @anthropic-ai/claude-code ou yarn global add @anthropic-ai/claude-code para instalar globalmente.
• Método universal que funciona no Windows, macOS e Linux.

1. Homebrew (para macOS):

• Homebrew é um gerenciador de pacotes popular no macOS.
• Execute brew install claude-code para baixar e instalar diretamente.
• Simplifica a instalação e futuras atualizações.

1. WinGet (para Windows 10 e superior):

• WinGet é o gerenciador de pacotes padrão no Windows.
• Você pode instalar através do comando winget install claude-code no terminal PowerShell.
• Automatiza downloads e instaladores.

Independente do método escolhido, após a instalação, é bom confirmar a versão instalada com claude-code --version para garantir que tudo está correto. Isso mostra que a ferramenta está pronta para ser usada. Escolha a forma que mais se adequa ao seu sistema e preferência.

Veja o tutorial em vídeo para instalação e configuração do Claude Code

Para quem prefere um passo a passo visual, confira este vídeo tutorial detalhado que mostra desde a instalação até o uso dos principais comandos do Claude Code.

Link do vídeo: https://www.youtube.com/watch?v=exemplo

Este conteúdo oferece dicas exclusivas e demonstrações práticas para você acompanhar e tirar dúvidas na hora.

Primeiros passos após a instalação do Claude Code

Após instalar o Claude Code, é importante realizar algumas etapas iniciais para garantir que sua configuração esteja funcionando e que você possa começar seus projetos com segurança:

• Verificação da instalação: Execute o comando claude-code --version no terminal para confirmar que a ferramenta está instalada corretamente e acessível.

  
  

• Atualização: Caso já tenha uma versão anterior do Claude Code, vale a pena rodar npm install -g @anthropic-ai/claude-code@latest (se instalou via npm) para garantir que está usando a versão mais nova.

  
  

• Acesso à ajuda: Use claude-code --help para acessar a lista de comandos disponíveis, opções e exemplos básicos.

  
  

• Configuração inicial do usuário: Configure as preferências básicas que a ferramenta solicita, como diretórios padrão para salvar projetos, idioma e temas, dependendo da versão e suporte.

  
  

• Ambiente de desenvolvimento: Abra o editor de código de sua preferência junto com o terminal para facilitar a manipulação dos arquivos do projeto Claude Code.

  
  

Esses passos iniciais tornam seu workflow mais organizado e preparado para a criação rápida e eficiente dos seus agentes, fluxos ou códigos automatizados.

Como autenticar e configurar sua conta no Claude Code

Depois de instalar Claude Code, autenticar sua conta é o próximo passo fundamental para usufruir de todos os recursos disponíveis e garantir que sua identidade está vinculada ao CLI corretamente:

• Gerar Token ou API Key: No painel web da Claude Code, acesse a seção de configurações da sua conta para obter seu token de acesso ou API key.

  
  

• Comando de autenticação: No terminal, execute claude-code auth login e siga as instruções para inserir seu token ou realizar login via navegador.

  
  

• Confirmar autenticação: Use claude-code auth status para verificar se a autenticação foi concluída com sucesso.

  
  

• Configurações adicionais: Ajuste parâmetros como ambientes (desenvolvimento, produção), armazenamento local de tokens e preferências pessoais no arquivo de configuração do Claude Code.

  
  

• Segurança: Evite compartilhar suas credenciais e opte por métodos seguros para armazenamento, como variáveis ambientais.

  
  

Com a conta autenticada, você terá acesso autorizado para criar, modificar e gerenciar seus projetos com confiança total.

Hospedagem recomendada para seus projetos Claude Code

Para hospedar seus projetos desenvolvidos com Claude Code, recomendamos a Hostinger, um serviço de hospedagem confiável, com bom custo-benefício e suporte dedicado.

A Hostinger oferece planos que suportam Node.js, integrações com bancos de dados e backup automático, facilitando o deploy e manutenção dos seus agentes e aplicações.

Acesse https://www.hostinger.com/ para conhecer os planos e vantagens.

Comandos iniciais e uso do /init para novos projetos

Com o Claude Code instalado e autenticado, iniciar um novo projeto é simples e direto. Um comando útil muito comum para começar é o /init, que cria a base inicial do seu projeto.

• Criando um projeto novo: No terminal, digite claude-code /init para gerar a estrutura básica de arquivos necessária.

  
  

• Configuração do projeto: Durante o processo, você poderá informar nome do projeto, linguagem preferida, e outras opções customizáveis conforme o template do Claude Code.

  
  

• Explorar arquivos gerados: Com a estrutura criada, abra os arquivos no editor de sua escolha para começar a codificar ou configurar os agentes.

  
  

• Comandos úteis para seguir:

  
  

• claude-code status para verificar o estado do projeto

  
  

• claude-code run para executar o código ou automações criadas

  
  

• Dicas para iniciantes:

  
  

• Leia a documentação oficial para cada comando

  
  

• Teste comandos em pequenos scripts para entender o comportamento

  
  

• Utilize ambientes virtuais separados para evitar conflitos

  
  

Essas ações iniciais ajudam a desenvolver seus agentes e projetos de forma organizada e facilitam o processo de aprendizado no Claude Code.

Quais são os requisitos para instalar o Claude Code na minha máquina?

Verifique o sistema operacional e o método de instalação na documentação. Python não é um requisito geral; permissões e dependências variam conforme o método.

Como faço para instalar o Claude Code utilizando Homebrew no macOS?

Abra o Terminal e execute o comando: brew install claude-code. Aguarde a conclusão da instalação. Após isso, você pode verificar se está tudo certo rodando claude-code --version.

Como configuro meu projeto após instalar o Claude Code pela primeira vez?

Após instalar, execute o comando claude-code /init no Terminal. Siga as instruções para autenticar sua conta Claude e configurar as opções iniciais do seu projeto, como idioma, pasta de trabalho e preferências de integração.

Curso de Claude Code gratuito!

Aprenda os fundamentos do Claude Code enquanto você cria um projeto, curso 100% prático e gratuito. Assista em:

Conclusão

Com este guia completo, você já tem tudo para começar sua jornada com o Claude Code: desde a instalação, passando pela autenticação e configuração, até os primeiros comandos para iniciar seus projetos.

Aproveite os recursos indicados, como cursos e serviços de hospedagem, para potencializar seus resultados.

Não deixe de explorar a documentação oficial e praticar os comandos para dominar essa poderosa ferramenta de automação CLI.

Instalação pelo instalador nativo (o jeito recomendado pela Anthropic):

Esse é o método oficial recomendado e o mais tranquilo pra quem tá começando

Ele não exige Node.js e já vem com atualização automática, então tu não precisa de PC da Nasa nem de setup complicado

No macOS ou Linux, roda no terminal:

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

No Windows, abre o PowerShell e roda:

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

Depois é só chamar o comando claude que ele inicia a sessão. Simples assim

Confira o acesso da sua assinatura ou configure Console/API ou um provedor suportado. Claude Free não inclui Claude Code.

Diagnóstico da instalação: se algo não rodou como esperado, usa o comando de diagnóstico. Dentro da sessão do claude tu roda /doctor, ou, sem abrir sessão, roda claude doctor no terminal pra checar a instalação e a configuração

No vídeo ‘Claude Code: Tutorial COMPLETO para Iniciantes (Do Zero ao Projeto)’ eu instalo a ferramenta junto contigo, do zero, e mostro na tela cada passo do começo ao primeiro projeto rodando.

Uma coisa que dá pra afirmar depois de fazer isso na prática: a maioria não trava na instalação em si, e sim em achar que o Claude Code só vive no terminal. Não é bem assim.

Depois de instalar, dá pra integrar no VS Code e usar sem ficar preso na linha de comando (ótimo pra quem tem medo de terminal), e ainda tem uma terceira forma menos comum, que é rodar pelo navegador conectando um repositório do GitHub.

No vídeo eu passo por essas três formas de uso pra tu escolher a que combina com o teu fluxo. Bora ver na prática?

Perguntas frequentes

Como instalar o Claude Code pelo terminal?

O método recomendado é o instalador nativo. No macOS ou Linux, roda: curl -fsSL https://claude.ai/install.sh | bash. No Windows, pelo PowerShell: irm https://claude.ai/install.ps1 | iex. Se preferir gerenciador de pacote, no macOS dá pra usar brew install --cask claude-code e no Windows winget install Anthropic.ClaudeCode. Depois de instalado, o comando é claude.

Preciso pagar pra usar o Claude Code?

É necessário ter uma modalidade de acesso compatível: assinatura com Code, Console/API ou provedor suportado. O plano Free do Claude não inclui Code; a cobrança depende da modalidade.

Preciso instalar o Node.js pra usar o Claude Code?

O instalador nativo dispensa Node.js. Para qualquer método alternativo, consulte os requisitos atuais em vez de assumir uma versão mínima.

Como faço login no Claude Code?

Execute claude e siga o fluxo da sua assinatura ou conta Console. A autenticação por chave ou provedor tem configuração própria; consulte a documentação oficial.

Como confiro a versão instalada e atualizo o Claude Code?

Confira com claude --version. O instalador nativo atualiza automaticamente; Homebrew e WinGet usam seus gerenciadores para atualizar. Use claude doctor para diagnóstico e confira o método que instalou.

O que o comando /init faz no Claude Code?

Dentro da sessão, o /init analisa o projeto que já existe na pasta e gera um arquivo CLAUDE.md inicial, com build, testes e padrões do projeto. Esse arquivo vira o contexto persistente da ferramenta. Ele não cria um scaffold novo nem pergunta nome ou linguagem do projeto.

Leia também

• Como instalar o Claude Code: passo a passo para começar do zero
• Melhores skills do Claude Code: quais valem a pena instalar?

Fontes e documentação

Informações conferidas em 12 de outubro de 2026. Recursos e preços podem mudar.

• Instalação e primeiros passos oficiais
• Acesso nos planos do Claude