Claude Code API sem assinatura

Você pode usar a Claude Code API sem assinatura no terminal local escolhendo um Provider cobrado por API em vez de um plano Claude.ai. A Anthropic oferece Console API, cloud providers e LLM gateways além de Pro, Max, Team e Enterprise.

Com a OmniaKey, carregue saldo pré-pago, crie uma API key e entregue ao Claude Code uma Base URL compatível com Anthropic e um bearer token. Não há assinatura recorrente, mas cada request é cobrado.

Claude Code exige assinatura?

Não no workflow local de terminal.

ANTHROPIC_AUTH_TOKEN tem prioridade sobre ANTHROPIC_API_KEY e OAuth salvo. Claude Code on the Web sempre usa credenciais de assinatura; variáveis API não substituem essa superfície.

Configurar Claude Code pay-as-you-go na OmniaKey

1. Instalar Claude Code

Siga o setup oficial e confirme:

claude --version

2. Carregar saldo e criar key

Adicione saldo à OmniaKey e crie uma chave no dashboard de API Keys. Use uma key por máquina ou ambiente e nunca a publique.

3. Definir Base URL e bearer token

export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude

$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude

Consulte o guia de API key do Claude Code e o setup Claude Code da OmniaKey.

4. Verificar o caminho de cobrança

/status

Faça uma request read-only pequena e confirme o usage no dashboard. Apenas ANTHROPIC_BASE_URL não substitui uma credencial de assinatura. Se ANTHROPIC_API_KEY também estiver definida, confirme o caminho antes de usar:

unset ANTHROPIC_API_KEY

Quanto custa Claude Code por uso?

Claude Code é um agent loop; repository, context, cache, thinking, retry, MCP e sessões paralelas alteram a conta.

Tarifas OmniaKey verificadas em 18 de setembro de 2026 (USD por milhão de tokens). Confira o catálogo de modelos antes de definir o orçamento:

Os exemplos excluem cache writes, modifiers de contexto longo, retries e turns adicionais.

Quando a cobrança por API faz sentido

Use pay-as-you-go para uso ocasional, saldo compartilhado entre tools, keys revogáveis em máquinas/CI ou routing explícito entre modelos. Assinatura pode ser melhor para uso diário pesado, Web ou funções exclusivas. Meça sua carga antes de escolher.

Controlar o gasto

Leia a guia para reduzir tokens do Claude Code, com contexto, saída de tools, effort e custo por tarefa aceita.

Começar pelo modelo certo

Use Claude Sonnet 5 como padrão equilibrado, Claude Haiku 4.5 para tarefas estreitas e repetíveis, e Claude Opus 5 quando a ambiguidade ou o custo do erro justificarem. A guia de modelos detalha o routing.

Limpar contexto antigo entre tarefas independentes

Conversas longas reenviam mais contexto. Renomeie sessões que deseja guardar e use /clear antes de uma tarefa sem relação.

Desativar tools que não usa

Mantenha apenas os MCP necessários, filtre logs grandes e reduza a saída antes que ela entre no contexto.

Medir o custo da tarefa aceita

Meça uma correção integrada, review aceita ou feature que passou nos checks, incluindo retries e correção humana. Consulte a guia de billing transparente.

Erros comuns

Definir só ANTHROPIC_BASE_URL

A URL muda o destino, não necessariamente a credencial. Defina ANTHROPIC_AUTH_TOKEN e confira /status.

Adicionar /v1

Use https://api.omniakey.com, não https://api.omniakey.com/v1. O Claude Code acrescenta o path Messages.

Misturar credenciais

ANTHROPIC_AUTH_TOKEN tem prioridade. Mantenha um caminho de cobrança por shell/job.

Esperar que o produto Web use a key

Claude Code on the Web usa credenciais de assinatura. Esta configuração é para CLI local.

Entender “sem assinatura” como “sem pagamento”

API billing exige saldo, key ativa e limites suficientes.

Medir uma tarefa completa

O preço por token é apenas o ponto de partida. Um agent pode reler contexto, chamar várias tools ou exigir correção humana antes de o resultado ser aceito.

Para comparar rotas de forma reproduzível, mantenha o mesmo commit, prompt, modelo, permissões, tools e comando de aceitação. Registre:

• model ID e protocolo;
• input sem cache, cache writes e cache reads;
• output e esforço de raciocínio;
• chamadas de tools e retries;
• tempo decorrido e uso do saldo;
• aprovação em review independente.

O custo aceito inclui tentativas falhas e tempo de correção. Guarde os resultados com o commit e repita a medição quando mudar a configuração.

Comece com uma tarefa pequena e somente leitura, confira o uso no dashboard e só então aumente a complexidade. Um limite de gasto protege o orçamento, mas não substitui a redução de contexto e retries.

FAQ

Posso usar Claude Code sem Pro ou Max?

Sim. A CLI local pode usar Console API, cloud provider ou gateway com credenciais e saldo válidos.

O uso da API é grátis sem assinatura?

Não. As chamadas são medidas na conta API ou gateway.

A API key consome meu allowance de assinatura?

Não quando a credencial API/gateway pretendida está ativa. Confira /status e o dashboard.

Funciona no Claude Code on the Web?

Não. A superfície Web usa credenciais de assinatura.

Quais variáveis usar na OmniaKey?

ANTHROPIC_AUTH_TOKEN é enviado como Authorization: Bearer; use ANTHROPIC_BASE_URL=https://api.omniakey.com. Sem /v1.

Fontes verificadas

• Anthropic: Claude Code authentication
• Anthropic: manage Claude Code costs
• Anthropic: connect Claude Code to an LLM gateway
• Anthropic: Claude API pricing
• OmniaKey Claude Code API key guide

Fatos verificados em 18 de setembro de 2026. Autenticação, disponibilidade e tarifas podem mudar; confira fontes primárias e catálogo live antes de usar.

Related English references: Claude Sonnet 5 (English), Claude Haiku 4.5 (English), and Claude Opus 5 (English).