Claude Code e API da Anthropic: guia para começar

O Claude Code é o agente de programação da Anthropic: você descreve o que quer em português, e ele lê o projeto, edita os arquivos e roda os comandos. Instala com uma linha no terminal e exige plano pago ou conta no Console. Já a API da Anthropic é a forma de colocar o Claude dentro dos seus próprios sistemas, com cobrança por uso.

Este guia mostra como instalar o Claude Code, criar a chave da API, estimar o custo e quando usar a extensão do Chrome, as Skills e o MCP. Se você ainda está conhecendo a ferramenta, comece por o que é o Claude AI.

Claude Code: o que é e para quem serve

Diferente do chat, o Claude Code trabalha diretamente na sua pasta de projeto. Ele enxerga o código inteiro, altera vários arquivos, roda testes e cria commits. Funciona em cinco lugares, todos com o mesmo motor: terminal, VS Code, JetBrains, app de computador e web (claude.ai/code).

Para quem serve:

• Desenvolvedores e equipes de produto.
• Quem tem algum conhecimento técnico e precisa de scripts, integrações ou pequenos sistemas internos.
• Empresas com um site ou sistema próprio que precisa de manutenção.

Para quem não serve: se você não vai revisar o que está sendo gerado, não coloque o resultado em produção. Quem não programa e quer delegar tarefas de escritório deve olhar o Claude Cowork, que usa a mesma abordagem sem terminal.

Como instalar o Claude Code

Requisitos (documentação oficial): macOS 13 ou superior, Windows 10 1809 ou superior, Ubuntu 20.04 ou superior, Debian 10 ou superior, ou Alpine 3.19 ou superior; 4 GB de RAM e internet.

1. Abra o terminal e rode o comando do seu sistema.

No macOS, no Linux ou no WSL:

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

No Windows, pelo PowerShell:

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

2. Abra uma nova janela do terminal e confira a instalação:

claude --version

3. Entre na pasta do projeto e inicie:

cd meu-projeto
claude

4. Faça login no navegador quando for pedido, usando sua assinatura ou conta do Console.

Prefere não usar terminal? O app de computador já inclui o Claude Code, na aba Code, com assinatura paga. Também há instalação por Homebrew (brew install --cask claude-code) e WinGet (winget install Anthropic.ClaudeCode), mas nesses casos as atualizações são manuais por padrão.

Primeiros pedidos que valem o teste

Comece em um projeto de teste ou em uma branch separada:

• “Explique a estrutura deste projeto em dez linhas.”
• “Crie um script que lê este CSV de leads e remove os telefones duplicados.”
• “Este erro aparece ao salvar o formulário. Encontre a causa e proponha a correção.”

Coloque as regras do projeto em um arquivo CLAUDE.md, na raiz. O Claude Code lê esse arquivo no início de cada sessão, então ele é o lugar certo para padrões de código e decisões técnicas.

Quanto custa usar o Claude Code

Dá para pagar pela assinatura ou por token. A página de custos do Claude Code cita uma média, em implantações corporativas, de cerca de US$ 13 por desenvolvedor por dia ativo e US$ 150 a US$ 250 por mês, com 90% dos usuários abaixo de US$ 30 por dia ativo.

Esses números são de empresas e variam muito com o modelo e o tamanho do código. Para ter um retrato próprio, faça um piloto com poucas pessoas. Os comandos /usage e /clear ajudam a acompanhar o consumo e a limpar o contexto entre tarefas. A comparação entre assinaturas está em preços e planos do Claude.

API da Anthropic: para que serve

A API permite que o seu sistema mande um texto ao Claude e receba a resposta, sem ninguém abrir o chat. É o que está por trás de:

• Um agente de IA que atende pelo WhatsApp, junto da API oficial do WhatsApp.
• Um fluxo no n8n que classifica e-mails ou lê notas fiscais.
• Um recurso dentro do seu sistema, como resumir o histórico do cliente no CRM.

Claude Console: como criar a conta e a API key

O Claude Console é o painel de quem usa a API. O endereço atual é platform.claude.com (o antigo console.anthropic.com redireciona para lá).

1. Crie a conta em platform.claude.com.
2. Adicione créditos em Billing. A API funciona no pré-pago, com cartão. Os créditos vencem em um ano e não são reembolsáveis. Novos usuários recebem uma pequena quantia para testar.
3. Gere a chave em Settings > API keys (platform.claude.com/settings/keys).
4. Guarde a chave como variável de ambiente, nunca dentro do código:

export ANTHROPIC_API_KEY="sua-chave-aqui"

5. Faça a primeira chamada:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 500,
    "messages": [
      {"role": "user", "content": "Resuma em uma frase o que é um CRM."}
    ]
  }'

Três cuidados básicos: crie uma chave por projeto, defina limite de gastos por workspace e, se uma chave vazar, revogue-a imediatamente.

Quanto custa a API do Claude

A cobrança é por token, um pedaço de texto. Pela documentação da Anthropic, 1 milhão de tokens equivale a cerca de 555 mil palavras nos modelos atuais. Preços por milhão de tokens em novembro de 2026, conforme a tabela oficial:

Exemplo de cálculo com 2.000 tokens de entrada e 500 de saída por conversa, sem descontos.

Veja o exemplo acima no modelo Sonnet 5.5: cada conversa consome 2.000 × US$ 2/milhão + 500 × US$ 10/milhão, ou US$ 0,009. Mil conversas custam US$ 9, ou cerca de R$ 49 com o dólar a R$ 5,48, antes de IOF. Conversas reais variam muito, principalmente quando o agente carrega documentos ou usa ferramentas.

Para reduzir a conta:

• Lote (Batch): 50% de desconto para trabalhos sem pressa.
• Cache de prompt: instruções e documentos repetidos custam bem menos na leitura.
• Modelo certo por tarefa: use Haiku na triagem e um modelo maior só no que for difícil. O guia dos modelos do Claude ajuda nessa escolha.

Busca na web pela API custa US$ 10 por mil buscas, além dos tokens.

Claude in Chrome: a extensão do navegador

O Claude in Chrome (também procurado como “Claude for Chrome”) é a extensão que deixa o Claude ler páginas, clicar, digitar e preencher formulários no navegador. É útil quando um sistema não tem API, como um portal de fornecedor ou um CRM antigo, situação em que muitas empresas usariam um robô de RPA.

Está nos planos pagos e, segundo o guia oficial, funciona só no Google Chrome: outros navegadores baseados em Chromium e celulares não têm suporte.

Como instalar a extensão:

1. Abra a página do Claude na Chrome Web Store e clique em Adicionar ao Chrome.
2. Faça login com sua conta do Claude.
3. Fixe a extensão pelo ícone de quebra-cabeça.
4. Conceda as permissões pedidas e abra o painel lateral pelo ícone do Claude.

Antes de soltar a extensão no dia a dia:

• Use um perfil do Chrome separado, sem banco, governo ou sistemas de saúde. A própria Anthropic recomenda isso.
• Prefira o modo manual, que aprova cada ação, nas primeiras tarefas.
• Interrompa se ele abrir sites inesperados ou pedir dados sensíveis. Páginas podem conter instruções maliciosas, e a Anthropic diz que o risco diminuiu, mas não é zero.

Skills: ensinar processos ao Claude

Skills são pastas com instruções e, se preciso, arquivos e scripts que ensinam o Claude a fazer uma tarefa do seu jeito. O centro é um arquivo SKILL.md, com nome, descrição e o passo a passo. O Claude só carrega o conteúdo completo quando o pedido combina com a descrição, o que economiza contexto.

Um exemplo simplificado para uma imobiliária:

---
name: proposta-locacao
description: Monta propostas de locação no padrão da imobiliária
---
1. Peça: imóvel, valor, garantia e prazo.
2. Use o modelo em modelo-proposta.docx.
3. Nunca altere as cláusulas de reajuste.
4. Termine com uma lista do que falta conferir.

Como usar:

• No app: disponíveis em todos os planos, mas exigem a execução de código ativada. Comece em Configurações > Capacidades e depois vá em Personalizar > Skills. Já vêm prontas Skills de Excel, Word, PowerPoint e PDF. As suas próprias são enviadas como .zip.
• No Claude Code: coloque a pasta em ~/.claude/skills/ (pessoal) ou .claude/skills/ (do projeto).
• Na API: envie pela API de Skills e referencie o ID na chamada.

Uma Skill pode rodar código, então a orientação oficial é instalar só de fontes confiáveis e revisar scripts e conexões externas antes de ativar.

MCP: conectar o Claude às suas ferramentas

O MCP (Model Context Protocol) é um padrão aberto para conectar ferramentas de IA a sistemas e dados externos. Pense nele como uma tomada padronizada: com um servidor MCP, o Claude consegue ler o Drive, abrir tickets ou consultar seu banco de dados.

• No app: os conectores ficam em Personalizar > Conectores. Conectores personalizados por MCP remoto estão em todos os planos, com limite de um no Free. Em Team e Enterprise, o proprietário da conta adiciona, e cada pessoa conecta o próprio acesso.
• No Claude Code: o comando é claude mcp add --transport http <nome> <url>, e os conectores adicionados no claude.ai também aparecem por lá.

Conectores personalizados podem não ser verificados pela Anthropic. Conecte apenas servidores em que você confia e dê o menor acesso possível, de preferência somente leitura no início.

Qual ferramenta usar em cada caso

As ferramentas se combinam. Uma não exclui a outra.

Se o seu objetivo final é um agente que atende clientes, o caminho completo está em como criar um agente de IA. E se preferir que alguém faça a integração e cuide da operação, a opsmigo constrói esses agentes para empresas de serviço.