Claude Code: o guia completo

O que o Claude Code realmente é

O Claude Code não é uma janela de chat com um botão de código. É um ciclo de agente: você descreve um resultado, ele inspeciona o repositório, propõe um plano, edita arquivos, executa seus testes, lê as falhas e repete o processo — pedindo permissão antes de qualquer ação destrutiva. Ele é distribuído como um pacote npm (@anthropic-ai/claude-code, atualmente 2.1.296), um instalador nativo, uma extensão para VS Code / JetBrains, um aplicativo desktop e uma versão web que roda em ambientes isolados hospedados pela Anthropic.

Nos bastidores, cada interação é uma chamada à Messages API que leva toda a conversa até aquele momento. Esse único fato explica a maior parte do que as pessoas pesquisam sobre ele: por que é poderoso, por que consome tantos tokens, por que os limites de requisições atrapalham e por que um backend de API mais barato ou com preço fixo muda tanto a experiência.

Configure o gateway em duas linhas

O Claude Code lê as variáveis de ambiente padrão da Anthropic. Defina a URL base para este gateway e use uma chave do seu painel; nada mais muda.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Execute /status dentro do Claude Code para confirmar a URL base com a qual ele está se comunicando, e /model para escolher um modelo. Todos os modelos oferecidos pelo gateway estão disponíveis — consulte o guia de modelos para ver a lista atual.

Os guias

• Instalação — npm, instalador nativo, Windows/WSL e correção de uma instalação com problemas.
• referência da CLI — flags, comandos de barra, modo sem interface e formatos de saída.
• Preços e limites — quanto custa na API, no Pro/Max e neste gateway.
• Agent SDK — controle do Claude Code de forma programática com Python ou TypeScript.
• Skills e plugins — o que são skills, o marketplace e como criar as suas.
• GitHub — o GitHub App, a Action e @claude em pull requests.
• Web, desktop e IDE — onde o Claude Code roda além do terminal.
• Modelos — o modelo padrão, a troca de modelos e as substituições por nível.
• Erros — 500, 400, 429, 529, falhas de autenticação e o que cada uma significa.
• Código aberto? — o que é e o que não é, e as alternativas abertas.
• Tutorial — uma primeira sessão real: CLAUDE.md, modo de planejamento, permissões e compactação.
• Para estudantes — a maneira legítima mais barata de usá-lo enquanto aprende.
• Automação de QA — geração de testes, o ciclo de execução e correção, execuções sem interface em CI e Playwright.
• Subagentes, Hooks, MCP — os três pontos de extensão, cada um com exemplos funcionais.
• vs Cursor e vs Codex e OpenCode — comparações honestas e como usá-los em conjunto.
• Ecossistema — claude-code-router, SuperClaude, caveman, linhas de status e as listas awesome.
• VS Code, OpenRouter, Limites de requisições — a extensão e seus erros, o uso de outros backends e o significado de "limite de requisições atingido".

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.