Preciso de conta no claude.ai ou de assinatura para usar o Claude Code com API key?

Não. Com ANTHROPIC_AUTH_TOKEN definida, as requisições levam essa credencial e não o login do claude.ai, e os limites de uso da assinatura não se aplicam. Sua conta fica na RelaySwitch, é aberta com um e-mail, e cada turno é debitado do saldo pré-pago.

ANTHROPIC_BASE_URL precisa terminar com /v1?

As duas formas são aceitas. Os exemplos deste site usam https://api.relayswitch.io/v1. O Claude Code acrescenta /v1/messages ao final desse endereço, e o gateway trata o /v1 repetido.

As variáveis estão definidas; por que o Claude Code ainda pede login?

As variáveis não chegaram a esse processo. Um editor aberto pelo Dock ou pelo menu Iniciar não lê o export feito no terminal. Escreva as duas variáveis no bloco env de ~/.claude/settings.json, depois execute /status e veja se a linha Anthropic base URL aparece.

Quanto custa uma sessão de programação?

Depende do modelo e do tamanho do contexto. A maior parte da entrada em uma sessão de programação é contexto reenviado, cobrado pelo preço de entrada em cache, então o custo é definido sobretudo pelo preço de cache e pelo preço de saída. A tabela desta página traz os preços atuais por milhão de tokens, e o custo real aparece no recibo de cada requisição.

Como pagar sem cartão de crédito?

Recarregue com USDT, USDC, BTC, ETH, SOL no console, a partir de $10. Cartão, incluindo Apple Pay e Google Pay, também é aceito. O saldo é registrado em dólares americanos, não expira, e não há assinatura.

Como sei que quem responde é mesmo o Claude?

Cada modelo recebe o mesmo prompt de teste uma vez por dia e a resposta é comparada com os resultados anteriores; o resultado fica aberto em https://api.relayswitch.io/v1/proof, sem API key. Cada requisição também tem um recibo assinado que registra o id do modelo, os tokens cobrados e o custo.

Verificado em 2026-11-12

Claude Code com API key pré-paga

O Claude Code lê o endereço do endpoint em ANTHROPIC_BASE_URL e a credencial em ANTHROPIC_AUTH_TOKEN. Aponte as duas para a RelaySwitch e cada turno é debitado por token do saldo pré-pago que você recarrega com cartão ou cripto. A mesma chave dá acesso a 13 modelos Claude.

01Duas formas de login no Claude Code, e a que se usa aqui

O Claude Code tem duas identidades. A primeira faz login com a conta claude.ai pelo /login e consome a cota da assinatura. A segunda usa uma API key e é cobrada por token. As duas podem estar configuradas na mesma máquina, mas cada sessão usa apenas uma delas.

Esta página trata da segunda. Com ANTHROPIC_AUTH_TOKEN definida, as requisições levam essa credencial e não o login do claude.ai, então você não precisa de conta no claude.ai nem de conta no desenvolvedor do modelo. Sua conta fica na RelaySwitch e é aberta com um e-mail.

02Duas variáveis de ambiente no macOS, Linux e WSL

Teste primeiro no terminal que já está aberto. Troque o valor da chave pela sua API key, que começa com sk-relay-, e execute claude.

ANTHROPIC_BASE_URL define para onde as requisições são enviadas. Os exemplos deste site usam https://api.relayswitch.io/v1; com ou sem /v1 no final, o endereço é aceito.
ANTHROPIC_AUTH_TOKEN envia a chave como Authorization: Bearer. ANTHROPIC_API_KEY também funciona e é enviada como x-api-key, mas no modo interativo precisa ser aprovada uma vez. Use só uma das duas: uma requisição com duas chaves diferentes é recusada com status 400.
A Base URL sozinha não basta. Sem uma das variáveis de chave, o Claude Code continua usando o login do claude.ai que está salvo.

bash

1export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"

2export ANTHROPIC_AUTH_TOKEN="sk-relay-..."

3claude

03Windows PowerShell

O Claude Code roda nativamente no Windows, então o WSL não é obrigatório. No PowerShell, as mesmas duas variáveis são escritas com a sintaxe abaixo.

powershell

1$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"

2$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."

3claude

04Para ficar salvo: settings.json e VS Code

Variáveis definidas no terminal valem só para aquela janela. Para que valham em todos os projetos e em todas as formas de abrir o Claude Code, escreva as duas no bloco env de ~/.claude/settings.json (no Windows: %USERPROFILE%\.claude\settings.json). Se a mesma variável existir no terminal e nesse arquivo, prevalece a do arquivo.

Não guarde a chave no .claude/settings.json do projeto, porque esse arquivo é feito para entrar no commit. A extensão do VS Code lê a própria configuração, claudeCode.environmentVariables, nas configurações de usuário do VS Code. O aplicativo desktop não lê essas duas variáveis de ambiente.

O passo a passo completo, com exemplos do conteúdo dos arquivos, está no guia do Claude Code (em inglês).

05Como confirmar que as requisições passam mesmo pela sua chave

Teste primeiro sem o Claude Code: envie uma requisição pequena direto ao endpoint Messages. Uma resposta 200 com JSON indica que o endereço e a chave estão corretos.

Depois execute claude, envie uma mensagem e digite /status. Deve aparecer uma linha Anthropic base URL apontando para a RelaySwitch e uma linha Auth token com o nome da variável que você definiu. Se a linha da base URL não aparecer, a variável não chegou àquela sessão. A requisição aparece na página Usage do console em poucos segundos.

bash

1curl -i https://api.relayswitch.io/v1/messages \

2 -H "Authorization: Bearer sk-relay-..." \

3 -H "anthropic-version: 2023-06-01" \

4 -H "content-type: application/json" \

5 -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'

06Escolha do modelo: opus, sonnet, haiku

O comando /model alterna entre três aliases. Qual alias aponta para qual id é definido por ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL e ANTHROPIC_DEFAULT_HAIKU_MODEL; as três aceitam qualquer id de Claude da tabela abaixo. Para uma única sessão, use ANTHROPIC_MODEL ou claude --model seguido do id.

A diferença de custo vem principalmente do preço de saída e do preço de entrada em cache. Um padrão econômico: sonnet para o trabalho do dia a dia, passando para um modelo mais caro só quando o sonnet falha repetidamente em resolver o problema.

Ids de GPT, Gemini ou DeepSeek também respondem no Claude Code, porque o gateway traduz a requisição Messages para o formato desses modelos. Mas a Anthropic não dá suporte ao Claude Code com modelos que não são Claude, então o tool use neles pode ser menos fluido.

Modelo	Desenvolvedor	Entrada	Saída	Contexto
Claude Fable 5.1claude-fable-5.1	Anthropic	$6.00	$30.00	1,000,000
Claude Fable 5.2claude-fable-5.2	Anthropic	$4.00	$20.00	1,000,000
Claude Fable 5claude-fable-5	Anthropic	$3.00	$15.00	1,000,000
Claude Opus 5.5claude-opus-5-5	Anthropic	$2.716	$9.70	1,000,000
Claude Sonnet 4.6claude-sonnet-4-6	Anthropic	$1.80	$9.00	1,000,000
Claude Opus 4.6claude-opus-4-6	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.7claude-opus-4-7	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.8claude-opus-4-8	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 5claude-opus-5	Anthropic	$1.80	$7.50	1,000,000
Claude Haiku 4.5claude-haiku-4-5	Anthropic	$0.60	$3.00	200,000
Claude Sonnet 5claude-sonnet-5	Anthropic	$1.20	$3.00	1,000,000
Claude Sonnet 5.5claude-sonnet-5-5	Anthropic	$1.20	$3.00	1,000,000
Claude Haiku 5.5claude-haiku-5-5	Anthropic	$0.0582	$0.1455	1,000,000

USD por milhão de tokens

07Cache, custo e limites por chave

O Claude Code envia a conversa inteira a cada turno e a marca para o prompt cache. Os tokens lidos do cache são cobrados pelo preço de entrada em cache, que é menor que o preço de entrada. Por padrão o cache dura cinco minutos, então o primeiro turno depois de uma pausa longa paga uma vez o preço de entrada por todo o contexto.

O valor de custo que o Claude Code mostra é uma estimativa própria, baseada nos preços oficiais da Anthropic. O que foi de fato debitado fica registrado na página Usage do console e no recibo de cada requisição.

Um agente de programação envia muitas requisições em sequência e, se algo der errado, o saldo é consumido depressa. Crie uma chave só para o Claude Code e dê a ela um orçamento em dólares e um limite de gasto diário: ao atingir o limite, o gateway responde 402 e só essa chave deixa de funcionar, enquanto o restante do saldo da conta fica intacto. A mesma chave pode receber uma allowlist de modelos. A criação da chave está explicada na página Claude API key.

Perguntas frequentes

Preciso de conta no claude.ai ou de assinatura para usar o Claude Code com API key?: Não. Com ANTHROPIC_AUTH_TOKEN definida, as requisições levam essa credencial e não o login do claude.ai, e os limites de uso da assinatura não se aplicam. Sua conta fica na RelaySwitch, é aberta com um e-mail, e cada turno é debitado do saldo pré-pago.
ANTHROPIC_BASE_URL precisa terminar com /v1?: As duas formas são aceitas. Os exemplos deste site usam https://api.relayswitch.io/v1. O Claude Code acrescenta /v1/messages ao final desse endereço, e o gateway trata o /v1 repetido.
As variáveis estão definidas; por que o Claude Code ainda pede login?: As variáveis não chegaram a esse processo. Um editor aberto pelo Dock ou pelo menu Iniciar não lê o export feito no terminal. Escreva as duas variáveis no bloco env de ~/.claude/settings.json, depois execute /status e veja se a linha Anthropic base URL aparece.
Quanto custa uma sessão de programação?: Depende do modelo e do tamanho do contexto. A maior parte da entrada em uma sessão de programação é contexto reenviado, cobrado pelo preço de entrada em cache, então o custo é definido sobretudo pelo preço de cache e pelo preço de saída. A tabela desta página traz os preços atuais por milhão de tokens, e o custo real aparece no recibo de cada requisição.
Como pagar sem cartão de crédito?: Recarregue com USDT, USDC, BTC, ETH, SOL no console, a partir de $10. Cartão, incluindo Apple Pay e Google Pay, também é aceito. O saldo é registrado em dólares americanos, não expira, e não há assinatura.
Como sei que quem responde é mesmo o Claude?: Cada modelo recebe o mesmo prompt de teste uma vez por dia e a resposta é comparada com os resultados anteriores; o resultado fica aberto em https://api.relayswitch.io/v1/proof, sem API key. Cada requisição também tem um recibo assinado que registra o id do modelo, os tokens cobrados e o custo.

Páginas relacionadas

Duas variáveis e depois é só executar claude

Crie uma API key no console, recarregue a partir de $10 com cartão ou cripto, e o Claude Code roda no seu saldo pré-pago.

Modelos Obter API key