Claude Code CLI: Programação com IA · Capítulo 5 de 23 · 17 min
Instalar o Claude Code e fazer o primeiro acesso sem o TI
Três comandos deixam o Claude Code pronto na sua máquina, com login feito e a forma de pagamento escolhida.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.
Instalar o Claude Code leva três comandos e não exige ajuda do TI. A ferramenta vem num instalador nativo oficial: um binário próprio para o seu sistema (o programa já pronto para rodar, como um aplicativo baixado), que não depende de Node.js. Esse é o caminho recomendado pela Anthropic hoje. O instalador baixa o binário, coloca o Claude Code no PATH do sistema (a lista de lugares onde o computador procura programas) e configura a atualização automática em segundo plano (por padrão no canal latest, que recebe as novidades assim que saem; um canal estável, cerca de uma semana atrás, pode ser escolhido em /config).
Primeiro, rode o instalador nativo do seu sistema operacional. Escolha apenas o comando correspondente
# macOS, Linux ou WSL:
curl -fsSL https://claude.ai/install.sh | bash# Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex# Windows (Prompt de Comando / CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdEm seguida, confira se a instalação deu certo
# Verifique a versão instalada:
claude --version
# Saída esperada (exemplo):
# 2.1.x (a série atual em agosto de 2026)
# Para atualizar manualmente a qualquer momento:
claude updateNa primeira vez que abrir o Claude Code, faça login
# Dentro de uma pasta qualquer, rode:
claude
# Na primeira execução, o Claude Code abre o navegador para você
# entrar com sua conta Claude.ai. Depois de autorizar, volte ao terminal.
# Para trocar de conta mais tarde, use /login dentro da sessão.Existe ainda o método antigo por npm (npm install -g @anthropic-ai/claude-code). Ele continua funcionando, mas hoje é legado e exige o Node.js 22 ou superior instalado. Só compensa se você já mantém um ambiente Node e prefere gerenciar o Claude Code como um pacote npm. Se for esse o seu caso, o guia de Setup na seção Educação mostra como instalar o Node.js; para o instalador nativo, você não precisa dele.
Existem duas formas de pagar pelo uso do Claude Code
- Assinatura Claude.ai: o Plano Pro (US$ 20/mês, ou US$ 17/mês no plano anual) para uso moderado ou o Plano Max (a partir de US$ 100/mês, em dois níveis) para uso intenso usam a cota da sua conta. Valores de agosto de 2026; confira em claude.com/pricing.
- Chave de API (API Key): pagamento por uso, ideal para quem prefere pagar apenas pelo que consome.
Se você optar pela chave de API
# Acesse o console da Anthropic:
https://console.anthropic.com/
# Vá em "API Keys" e crie uma nova chave.
# Copie a chave gerada.
# Configure a variável de ambiente:
# Windows (PowerShell):
$env:ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"
# Mac/Linux:
export ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"Nunca compartilhe sua API Key. Ela é como a senha do seu acesso à IA: quem tiver sua chave pode gastar seu crédito. Não cole em prints, mensagens, repositórios públicos nem em código versionado.
Para quem está começando, o Plano Pro (US$ 20/mês) costuma ser a escolha mais simples: você faz login uma vez e o Claude Code funciona automaticamente, sem precisar gerenciar chaves. A API por consumo compensa quando você quer pagar exatamente pelo que usa.
Com o login feito, faça um primeiro teste que já entrega algo útil: pedir ao Claude Code um inventário de uma pasta sua de trabalho. A tarefa é só de leitura, então confirma que ele enxerga seus arquivos sem risco nenhum. Suponha uma oficina mecânica que guarda orçamentos e notas na mesma pasta há anos: o inventário mostra, numa tabela, quantos arquivos há de cada tipo e quais parecem duplicados.
Rode o pedido abaixo numa pasta real. Se a resposta trouxer a tabela com nome, tipo, tamanho e data, e a pasta continuar exatamente como estava, a instalação está completa.
Execute 'claude --version' no terminal: deve aparecer um número de versão, como 2.1.x. Em seguida, execute 'claude' e confirme que a interface interativa abre sem mensagem de erro.
A versão publicada em 23 de setembro de 2026 é a 2.1.281. O número passou a importar. O Opus 5.5, novo modelo padrão, só vira padrão a partir da 2.1.280; numa versão anterior, a sessão continua abrindo no padrão antigo. Se claude --version mostrar um número menor, rode claude update antes de qualquer outra coisa.
Planos pagos do Claude em 23 de setembro de 2026
| Plano | Preço | Para quem |
|---|---|---|
| Pro | US$ 20 por mês, ou US$ 17 por mês no plano anual (US$ 200 pagos de uma vez) | Uso diário moderado |
| Max | A partir de US$ 100 por mês, com 5 ou 20 vezes o uso do Pro | Quem trabalha com o Claude o dia todo |
| Team, assento padrão | US$ 20 por assento no plano anual, US$ 25 no mensal | Times de 2 a 150 pessoas |
| Team, assento premium | US$ 100 por assento no anual, US$ 125 no mensal, com 5 vezes o uso do assento padrão | Quem, dentro do time, usa o dia todo |
| Enterprise | US$ 20 por assento no anual, mais o uso cobrado a preço de API | Empresas grandes |
A tabela de recursos da página de preços marca o Claude Code como incluído no Pro e nos dois níveis do Max. No Team e no Enterprise, confirme com o administrador o tipo de assento que você recebeu.
Quando a cota acaba no meio do trabalho, entram os créditos de uso: um saldo extra, pago à parte da assinatura, como a recarga de um celular pré-pago. O comando /usage-credits abre essa tela no navegador; em Team e Enterprise, quem não tem acesso ao faturamento manda o pedido ao administrador pelo próprio terminal. Três recursos de setembro saem desse saldo, e não da cota do plano: o modo rápido (/fast), o Code Review gerenciado e, em alguns planos e assentos, o Fable.
Pense no dono de uma oficina no plano Pro que liga o modo rápido para fechar um orçamento antes de o cliente chegar. A resposta sai mais depressa. A conta vai para os créditos de uso, fora da mensalidade de US$ 20. Rode claude --version e depois /usage: acertou quando a versão for 2.1.280 ou maior e o /usage mostrar quanto da cota do plano você já consumiu.
Três fatos de instalação encurtam a conversa com o TI. O instalador nativo é o caminho recomendado nos três sistemas e se atualiza sozinho em segundo plano. No Windows 10 (versão 1809 ou mais nova), o Claude Code roda direto no PowerShell ou no CMD, sem WSL (o Linux embutido no Windows, como um apartamento dentro da casa) e sem conta de administrador. E o pacote npm, desde a versão 2.1.198, exige Node.js 22 ou superior. O plano gratuito do Claude não inclui o Claude Code: a conta precisa ser Pro, Max, Team, Enterprise ou do Console.
Qual comando usar em cada tela
| Onde você está | Como reconhecer | Comando de instalação |
|---|---|---|
| macOS, Linux ou WSL | App Terminal, com o nome do seu usuário no começo da linha | curl -fsSL https://claude.ai/install.sh | bash |
| Windows, PowerShell | A linha começa com PS C:\Users\ | irm https://claude.ai/install.ps1 | iex |
| Windows, Prompt de Comando (CMD) | A linha começa com C:\Users\, sem o PS | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| Mac que já usa Homebrew | O comando brew responde no terminal | brew install --cask claude-code |
| Windows que já usa WinGet | O comando winget responde no terminal | winget install Anthropic.ClaudeCode |
A mensagem The token '&&' is not a valid statement separator avisa que o comando do CMD foi colado no PowerShell; 'irm' is not recognized avisa o contrário. Requisitos: macOS 13, Windows 10 1809, Ubuntu 20.04 ou Debian 10 em diante, 4 GB de memória e internet.
Instalar e conferir em cinco passos, sem chamar o TI
Reserve quinze minutos e um notebook com internet. Nenhum passo pede senha de administrador.
Passo 1: Abra o terminal certo
No Windows, abra o menu Iniciar, digite PowerShell e abra o aplicativo. No Mac, abra o Terminal.
Deu certo quando: a janela mostra uma linha começando com PS C:\Users\ no Windows, ou com o nome do seu usuário no Mac.
Erro comum: abrir o Prompt de Comando e colar nele o comando do PowerShell.
Passo 2: Cole o comando da linha da tabela que corresponde à sua tela
Um comando só. O download leva de um a três minutos.
Deu certo quando: o instalador termina sem mensagem de erro e devolve o cursor.
Erro comum: rodar como administrador ou com sudo; nenhum dos dois é necessário.
Passo 3: Feche o terminal, abra outro e digite claude --version
A janela nova já enxerga o caminho do programa recém-instalado.
Deu certo quando: aparece um número de versão seguido de (Claude Code).
Erro comum: insistir na janela antiga, que responde que o comando claude não existe.
Passo 4: Rode claude doctor
É o check-up da instalação: lê tudo e não muda nada.
Deu certo quando: o relatório não aponta erro, e cada aviso vem com a correção sugerida.
Erro comum: ignorar um aviso de configuração e tropeçar nele na primeira tarefa real.
Passo 5: Digite claude e faça o login no navegador
Entre com a conta do plano pago. No Windows sem o Git for Windows, o Claude Code usa o PowerShell no lugar do Bash, sem diferença para quem não programa.
Deu certo quando: o navegador confirma a autorização e o terminal abre a conversa.
Erro comum: entrar com uma conta do plano gratuito, que não dá acesso ao Claude Code.
No fim você tem: o Claude Code instalado, diagnosticado e ligado à conta certa, pronto para a primeira delegação.
Rode claude doctor hoje e de novo depois de cada atualização grande. Acertou quando o relatório sair sem erro e claude --version mostrar o mesmo número no seu notebook e no do colega que vai usar a ferramenta com você; se os números divergirem, claude update iguala os dois.
O Claude Code tem hoje três telas de uso, e todas leem as mesmas configurações, skills e servidores MCP: o terminal, a extensão do VS Code e o app Claude Desktop. Desde a versão 2.1.285, de 29 de setembro de 2026, o comando claude --desktop abre o app desktop já na pasta em que você está. Na extensão do VS Code, a versão 2.1.286, de 30 de setembro, trouxe os favoritos: você salva uma resposta do Claude e a mantém num painel lateral.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Para um time de marketing, a escolha da tela segue o tipo de arquivo. Quem edita o site, a landing page ou os textos guardados num repositório ganha com o VS Code, porque vê cada alteração lado a lado antes de aceitar. Quem trabalha com planilhas, PDFs e relatórios fica bem no app desktop. O terminal continua sendo o caminho das automações.
Instale a extensão pelo marketplace do VS Code procurando por Claude Code. Acertou quando o ícone de faísca do Claude aparecer na barra do editor, no canto superior direito, com um arquivo aberto, e a primeira conversa abrir na mesma conta do terminal.
Perguntas frequentes deste capítulo
Preciso instalar o Node.js antes do Claude Code?
Como sei se a instalação deu certo no Windows?
Ao instalar e usar o Claude Code, meus arquivos vão todos para a nuvem?
Pro, Max ou API key: qual escolher para um uso moderado?
Preciso do WSL para instalar o Claude Code no Windows?
O que faço se o comando claude não for reconhecido depois da instalação?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoSetup Completo: do zero ao Claude Code
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Instalar o Claude Code e fazer o primeiro acesso sem o TI”.
- CursoAgentes de código para executivossugerido pelo grafo3 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “Agentes de código para executivos”.
- CursoMCP para quem decidesugerido pelo grafo7 capítulos de “Claude Code CLI: Programação com IA” usam conceitos apresentados em “MCP para quem decide”.
O mesmo assunto em outros cursos
- Setup Completo: do zero ao Claude CodeInstale o Claude Code e dê a primeira ordemExaminar conexões de Instale o Claude Code e dê a primeira ordem
- Setup de Vibecoding no MacInstalar o Claude CodeExaminar conexões de Instalar o Claude Code
- MCP com Chrome: Automação com IAInstalar a extensão no seu Chrome e religar quando ela cairExaminar conexões de Instalar a extensão no seu Chrome e religar quando ela cair
- Vídeo com IA: Claude Code, Codex e ElevenLabsMontar a bancada de vídeo com IA mesmo sem nunca ter usado o terminalExaminar conexões de Montar a bancada de vídeo com IA mesmo sem nunca ter usado o terminal
Voltar ao capítulo anterior: Trocar o clique pelo comando e usar o terminal na gestão
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Claude Code CLI: Programação com IA
- 03Ver o que os executivos já delegam ao Claude, com números
- 04Trocar o clique pelo comando e usar o terminal na gestão
- 05Instalar o Claude Code e fazer o primeiro acesso sem o TI
- 06Fazer a primeira delegação ao Claude e ver o arquivo nascer
- 07Manter modelo e custo sob controle com os comandos de barra