Source: https://aiprimetech.io/pt/claude-code/ [Início](/pt/) › [Claude Code](/pt/claude-code/) [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/) Última atualização: 11 de outubro de 2026 # Claude Code: o guia completo O Claude Code é a ferramenta de programação com agentes da Anthropic: um programa de terminal (e, desde o fim de 2025, um aplicativo web, um aplicativo desktop e uma extensão para IDE) que lê seu repositório, planeja, edita arquivos, executa comandos e abre pull requests. Estes guias abordam sua instalação, como usá-lo bem, quanto custa e como configurá-lo para usar um gateway, para que a conta deixe de ser sua preocupação. ## TLDR - Instale com npm, com o instalador nativo ou com o aplicativo desktop — cinco minutos no macOS, Linux, Windows ou WSL. - A cobrança pela API é por token, e sessões longas reenviam toda a conversa a cada interação — é por isso que o custo aumenta. - Duas variáveis de ambiente (ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY) o direcionam para este gateway: os mesmos modelos, créditos com 7.69231× o valor nominal ou um plano ilimitado com preço fixo a partir de $1. - Skills, plugins, subagentes, servidores MCP e a GitHub Action continuam funcionando — o gateway fica na camada abaixo da ferramenta, não dentro dela. ## 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". ## Experimente gratuitamente primeiro Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE) ## Perguntas frequentes O Claude Code é gratuito? A instalação da ferramenta em si é gratuita. O uso é cobrado por meio de uma assinatura Claude Pro/Max ou por token pela API. Neste gateway, você pode usá-lo com créditos pagos conforme o uso ou com um plano ilimitado de preço fixo.O Claude Code funciona com outro endpoint de API? Sim. Ele respeita ANTHROPIC_BASE_URL, portanto qualquer endpoint compatível com a Anthropic funciona. É exatamente assim que ele se conecta a este gateway — sem modificações, sem wrapper.Qual modelo o Claude Code usa? Por padrão, o modelo atual do nível Sonnet; você pode trocar com /model ou com a flag --model e substituir cada nível usando variáveis de ambiente. O guia de modelos lista o que este gateway oferece atualmente. ## Execute o Claude Code no gateway Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/) 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. ## Mais guias do Claude Code [Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)