Instalar o Claude Code leva menos de 10 minutos: você escolhe entre o terminal (via instalador oficial ou npm), a extensão para VS Code/JetBrains, o aplicativo desktop ou a versão web que roda direto no navegador — e faz login com sua conta do Claude. Este guia cobre os quatro caminhos, do mais simples ao mais completo, com o que fazer quando algo dá errado.

Antes de instalar: o que você precisa

  • Conta do Claude com plano pago (Pro ou Max) ou créditos de API da Anthropic — o Claude Code não funciona no plano gratuito. Valores atuais: confira o site oficial;
  • Sistema: Windows 10/11, macOS ou Linux;
  • Para o método via npm: Node.js 18 ou superior instalado (o instalador nativo dispensa isso).

Se você ainda está decidindo se vale a pena, leia primeiro o guia completo do Claude Code.

Caminho 1 — Sem instalar nada: a versão web ⭐ (mais fácil)

Acesse claude.ai/code no navegador, faça login e pronto: o Claude Code roda na nuvem, sem instalação. É o melhor jeito de experimentar antes de instalar qualquer coisa — e suficiente para muitas tarefas de quem não é desenvolvedor.

Caminho 2 — Terminal (o clássico)

Opção A — instalador nativo oficial (não precisa de Node.js):

  • Windows (PowerShell): irm https://claude.ai/install.ps1 | iex
  • Mac/Linux: curl -fsSL https://claude.ai/install.sh | bash

Opção B — via npm (se você já tem Node.js):

  • npm install -g @anthropic-ai/claude-code

Depois de instalar, abra o terminal na pasta do seu projeto e digite claude. Na primeira vez, ele abre o navegador para você fazer login na sua conta. A partir daí, é conversar.

Caminho 3 — Dentro do editor (VS Code / JetBrains)

Se você já usa o VS Code: instale a extensão oficial “Claude Code” no marketplace de extensões, faça login e o agente aparece num painel lateral, enxergando o projeto aberto. O mesmo vale para a família JetBrains (IntelliJ, PyCharm etc.) via plugin.

Caminho 4 — Aplicativo desktop

A Anthropic também distribui o aplicativo para Windows e Mac, que permite rodar várias sessões em paralelo e é o formato mais confortável para uso diário fora do terminal. Baixe no site oficial da Anthropic.

Primeiro teste (2 minutos)

Crie uma pasta vazia, entre nela e rode claude. Peça algo simples e verificável:

“Crie um arquivo chamado teste.html com uma página simples que mostra ‘Olá, IA Hub’ centralizado e com fundo azul.”

Ele cria o arquivo, você abre no navegador e confere. Funcionou? Instalação ok — agora aplique em algo real: ideias práticas no nosso guia de Claude Code na empresa.

Problemas comuns (e a saída)

  • “claude não é reconhecido como comando” — feche e reabra o terminal. No método npm, confirme que o Node está no PATH (node -v deve responder).
  • Erro de permissão no npm (Mac/Linux) — prefira o instalador nativo (Opção A), que evita o problema de permissões globais do npm.
  • Login não abre — copie o link que aparece no terminal e cole manualmente no navegador.
  • “Credit balance too low” / plano — sua conta não tem plano compatível ativo. Confira a assinatura em claude.ai.

Perguntas frequentes

Qual caminho escolher?

Curioso testando: versão web. Uso diário sem terminal: aplicativo desktop. Desenvolvedor: terminal + extensão do editor (os dois convivem bem).

Funciona offline?

Não — o modelo roda nos servidores da Anthropic. A ferramenta local executa as ações; a inteligência vem da nuvem.

Posso usar no computador da empresa?

Tecnicamente sim, mas confira a política de TI e de dados da sua empresa antes — especialmente sobre quais arquivos a ferramenta pode acessar. Falamos de governança no guia empresarial.

Como aprendo a usar depois de instalar?

A própria Anthropic tem curso oficial gratuito com certificado — inclusive o “Claude Code in Action”, específico da ferramenta.

Leia também