Instalar o Claude Code em 2026: setup, planos e o custo de cada caminho
Instalar o Claude Code leva um comando; o plano e as permissões definem quanto ele custa e o que pode fazer no seu computador.
Em 30 de outubro de 2026, a página de preços da Anthropic lista o plano Ultra, de US$ 200 por mês, sem o limite de cinco horas para contas verificadas e com dez vezes o uso semanal do Pro. O Max ficou em US$ 100, o Pro segue em US$ 20 e o plano gratuito continua sem acesso ao Claude Code. Para instalar o Claude Code, o caminho recomendado pela documentação oficial é o instalador nativo, que dispensa Node.js e se atualiza sozinho.
O Claude Code é o agente de programação da Anthropic: lê e altera arquivos e roda comandos no terminal, a janela em que se digitam ordens ao computador. O passo a passo com telas está no curso Setup Claude Code para leigos e executivos; aqui ficam as mudanças de agosto a outubro, em forma de lista.
Tendências que importam agora no setup do Claude Code
- O Ultra assume o topo das assinaturas individuais. Na tabela consultada em 30 de outubro de 2026, o plano de US$ 200 se chama Ultra e o Max fica em US$ 100, com US$ 100 mensais em créditos de API. Quem esbarra todo dia na janela de cinco horas ganhou um degrau acima.
- A família 5.5 baixou o preço do modelo padrão. O Opus 5.5, lançado em 22 de setembro de 2026, custa US$ 4 por milhão de tokens de entrada e US$ 20 de saída, ante US$ 5 e US$ 25 do Opus 5 (token é a unidade com que a IA mede o texto). Desde a versão 2.1.280, da mesma data, ele é o padrão em todos os planos e na API.
- O degrau barato ficou mais barato. O Sonnet 5.5 chegou em 28 de setembro de 2026 a US$ 2 e US$ 10, e o Haiku 5.5, em 7 de outubro, a US$ 0,10 e US$ 0,50 para pedidos de até 100 mil tokens. Rascunho e triagem cabem nesses modelos.
- O aumento previsto do Sonnet 5 foi cancelado. O preço introdutório de US$ 2 e US$ 10 virou definitivo, e a alta para US$ 3 e US$ 15, marcada para 1º de setembro de 2026, não aconteceu. Planilhas de custo de agosto pedem revisão.
- O modo automático virou ponto de partida. Na versão 2.1.284, de 28 de setembro de 2026, sessões interativas no terminal e no VS Code passaram a começar no modo
auto, que executa tudo com checagens de segurança em segundo plano. Quem quer aprovar cada ação definepermissions.defaultMode. - O
/usagepassou a sugerir economia. O comando atribui o consumo a skills, subagentes e servidores MCP e, desde a versão 2.1.305, de 20 de outubro de 2026, a teclafaplica parte das recomendações.
Como instalar o Claude Code em 30 minutos?
A documentação consultada em outubro de 2026 pede Windows 10 1809, macOS 13 ou Ubuntu 20.04 em diante, quatro gigabytes de memória e internet. O roteiro:
- Assine antes de instalar: crie a conta em claude.ai e escolha o Pro; sem plano pago ou conta de API, o login não libera o uso.
- Windows: abra o PowerShell, sem modo administrador, e rode
irm https://claude.ai/install.ps1 | iex. - macOS, Linux e WSL: rode
curl -fsSL https://claude.ai/install.sh | bash. O WSL, o Linux dentro do Windows, é a opção com sandbox, o isolamento de comandos. - Confira em janela nova: o instalador não mostra progresso. Depois,
claude --versiondevolve o número da versão eclaude doctorfaz o diagnóstico. - Entre: digite
claudedentro da pasta do projeto e autorize no navegador com a conta do plano. - Opcional no Windows: instale o Git for Windows para liberar a ferramenta Bash; sem ele, o Claude Code usa o PowerShell.
WinGet e Homebrew instalam o mesmo programa sem atualização automática; o npm, gerenciador de pacotes do Node.js, exige Node.js 22. Fora do terminal, há o aplicativo Desktop (aba Code), a extensão do VS Code e o plugin da JetBrains.
Quais configurações fazer no primeiro dia?
Instalar não cria arquivo de configuração. O settings.json guarda permissões e modelo em quatro escopos: pessoal (~/.claude/settings.json), projeto compartilhado pelo git, local só seu e gerenciado pela empresa, que prevalece. Cinco ajustes:
- Escreva um
CLAUDE.mdcurto na raiz do projeto: ele entra em toda sessão, e a documentação de custos recomenda menos de 200 linhas. - Bloqueie o que é sensível: regras
denycomoRead(./.env)barram arquivos com senhas e chaves. - Escolha o modo de permissão com Shift+Tab ou fixe
"defaultMode": "default"no arquivo pessoal para aprovar cada ação. - Revise o modelo com
/modele o esforço de raciocínio com/effort; na família 5.5, o padrão émedium. - Conecte só o MCP necessário. MCP é o protocolo que liga o agente a ferramentas externas;
/mcpdesliga os servidores parados.
Em equipe, "autoUpdatesChannel": "stable" entrega versões com cerca de uma semana de uso. O artigo sobre skills e permissões no terminal separa instrução e poder de agir.
Quanto custa usar o Claude Code: assinatura ou crédito de API?
São cobranças separadas. A assinatura tem preço fixo e limites de cinco horas e semanais, divididos entre o chat e o Claude Code; o crédito de API é pago por token. Valores publicados em 30 de outubro de 2026:
| Forma de pagamento | Preço publicado | Limite de uso |
|---|---|---|
| Free | US$ 0 | Sem Claude Code |
| Pro | US$ 20 por mês ou US$ 17 no anual | Janela de cinco horas e teto semanal |
| Max | US$ 100 por mês | Cinco vezes o Pro, mais US$ 100 em créditos de API |
| Ultra | US$ 200 por mês | Sem janela de cinco horas para conta verificada; dez vezes o Pro por semana |
| Team | US$ 25 (Standard) ou US$ 125 (Premium) por assento no mensal | Cota por assento, de 2 a 150 pessoas |
| Enterprise | US$ 20 por assento no anual, mais uso a preço de API | Mínimo de 20 assentos |
| API | Por milhão de tokens: Opus 5.5 a US$ 4 / US$ 20, Sonnet 5.5 a US$ 2 / US$ 10, Haiku 5.5 a US$ 0,10 / US$ 0,50 | Teto definido no console |
Na concorrência, o Codex vem no ChatGPT Go (US$ 8), Plus (US$ 20) e Pro (a partir de US$ 100); o Cursor lista Plus a US$ 8, Premium a US$ 30 e Ultra a US$ 200; o Gemini CLI, desde 18 de junho de 2026, atende só chave de API e licenças corporativas, e as contas individuais foram para o Antigravity CLI. A diferença aparece no limite e no modelo incluído.
A documentação de custos consultada em outubro de 2026 informa que, nas implantações corporativas, o gasto fica perto de US$ 13 por desenvolvedor em dia ativo e entre US$ 150 e US$ 250 por mês, e que 90% dos usuários ficam abaixo de US$ 30 por dia ativo. O artigo sobre LLM FinOps liga esse gasto ao resultado.
Como acompanhar o consumo sem surpresa na fatura
- Rode
/usageao fim do dia na primeira semana;dewalternam entre 24 horas e sete dias. - Leia o valor em dólar como estimativa. Ele é calculado no computador pela tabela pública; a fatura fica no console.
- Use
/clearentre tarefas sem relação. Cada pedido reenvia a conversa inteira. - Defina teto antes de ligar créditos extras:
/usage-creditsabre o limite mensal de gasto. - Na API, crie um espaço de trabalho por área com limite de gasto próprio.
Erros comuns no setup do Claude Code
- Deixar uma
ANTHROPIC_API_KEYno ambiente. Aprovada, a chave substitui a assinatura e o consumo vira cobrança de API. - Colar o comando no terminal errado.
'irm' is not recognizedindica CMD;The token '&&' is not a valid statement separatorindica PowerShell. - Insistir no mesmo terminal. Se
claudenão for encontrado, a pasta do programa ainda não está no PATH, a lista de pastas que o sistema consulta; abra outra janela. - Esquecer o
winget upgrade. WinGet e Homebrew ficam na versão antiga até alguém atualizar. - Começar no Opus em tudo. A documentação cita o Opus esquecido como padrão entre as causas de gasto alto na API; o capítulo sobre modelo e custo do curso de setup traz um exercício de sete dias com o
/usage.
Para delegar trabalho depois do setup, o panorama sobre agentes no terminal e o curso de Claude Code cobrem subagentes e rotinas. Em dados, o artigo sobre Python com IA mostra onde o agente acelera; em texto, o de escrever bem com IA trata da revisão.
Perguntas frequentes
O plano gratuito do Claude dá acesso ao Claude Code?
Não. A documentação consultada em outubro de 2026 exige plano Pro, Max, Ultra, Team ou Enterprise, ou conta de API. O mais barato é o Pro, de US$ 20 por mês.
Qual é o jeito recomendado de instalar o Claude Code no Windows?
O instalador nativo, com irm https://claude.ai/install.ps1 | iex no PowerShell. Ele dispensa Node.js e modo administrador e se atualiza sozinho.
Assinatura e crédito de API são a mesma cobrança?
Não. A assinatura tem preço fixo e limites de uso; a API cobra por token. Com a variável ANTHROPIC_API_KEY definida e aprovada, o Claude Code passa a cobrar pela API.
Fontes
- Anthropic, planos e preços do Claude, consulta em 30 de outubro de 2026.
- Central de ajuda do Claude, uso do Claude Code nos planos individuais, consulta em outubro de 2026.
- Claude Code, instalação e requisitos, consulta em outubro de 2026.
- Claude Code, visão geral das superfícies, consulta em outubro de 2026.
- Claude Code, arquivos de configuração, consulta em outubro de 2026.
- Claude Code, modos de permissão, consulta em outubro de 2026.
- Claude Code, configuração de modelo, consulta em outubro de 2026.
- Claude Code, gestão de custos, consulta em outubro de 2026.
- Claude Code, notas de versão 2.1.280, 2.1.284 e 2.1.305, setembro e outubro de 2026.
- Anthropic, preços da API, consulta em outubro de 2026.
- Anthropic, lançamento do Claude Opus 5.5, 22 de setembro de 2026.
- Anthropic, lançamento do Claude Sonnet 5.5, 28 de setembro de 2026.
- Anthropic, lançamento do Claude Haiku 5.5, 7 de outubro de 2026.
- OpenAI, preços do Codex nos planos do ChatGPT, consulta em outubro de 2026.
- Cursor, planos e preços, consulta em outubro de 2026.
- Equipe do Gemini CLI, fim do atendimento a contas individuais, 18 de junho de 2026.
- Alexandre Caramaschi, curso Setup Claude Code para leigos e executivos, 2026.