Rode o Claude Code com a sua própria chave de API

Defina duas variáveis de ambiente e o Claude Code roda com a sua chave UplinkSwitch. Mesma ferramenta, mesmos modelos, preços ao vivo.

Obter chave

Verificado em 2026-11-13

O que você precisa

  • O Claude Code instalado, com claude no seu PATH.
  • Uma chave UplinkSwitch do console, com saldo carregado. O crédito é pré-pago a partir de $10, com cartão, WeChat Pay, Apple Pay, Google Pay ou cripto.

Duas variáveis

  • ANTHROPIC_BASE_URL aponta o Claude Code para o UplinkSwitch. Cole com o /v1. O gateway aceita o caminho que o Claude Code monta a partir dela.
  • ANTHROPIC_AUTH_TOKEN envia a chave como Authorization: Bearer. ANTHROPIC_API_KEY funciona no lugar dela e envia a chave como x-api-key. Defina uma, não as duas.
  • Uma requisição que leva duas chaves diferentes é recusada com um 400.
  • A URL base sozinha não basta. Sem uma das variáveis de chave, o Claude Code continua usando um login salvo do claude.ai.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

Deixe fixo no settings.json

Adicione as duas variáveis em ~/.claude/settings.json, dentro de env, e elas valem para todos os projetos. .claude/settings.local.json vale para um projeto.

  • Mais três variáveis nomeiam os modelos por trás dos aliases: ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL e ANTHROPIC_DEFAULT_HAIKU_MODEL. Defina-as com IDs como claude-opus-5-5, claude-sonnet-5-5 e claude-haiku-5-5.
  • Mantenha a chave fora do .claude/settings.json de um projeto. Esse arquivo é feito para ser commitado e compartilhado.
  • Quando um export do shell e um arquivo de configurações definem a mesma variável, o arquivo de configurações vence.
  • A extensão do VS Code lê as credenciais de uma configuração própria, claudeCode.environmentVariables, nas configurações de usuário do VS Code.

Escolha do modelo

Os aliases opus, sonnet e haiku apontam para o que as três variáveis de modelo nomearem. Definir a do Haiku também move para esse modelo o trabalho em segundo plano, como os títulos de sessão. Troque dentro de uma sessão com /model, na inicialização com claude --model claude-opus-5-5, ou por uma sessão com ANTHROPIC_MODEL.

O Claude Code fala o formato de API da Anthropic, e aqui todos os modelos de chat são servidos nele, incluindo GPT, Gemini, DeepSeek, Kimi e os builds sem censura. Qualquer ID de chat da lista de modelos funciona nas mesmas variáveis e é respondido como uma resposta Messages, incluindo chamadas de ferramenta.

Quanto custa o Claude Code nesta chave

A tabela mostra os modelos Claude por milhão de tokens, ao vivo do catálogo, ao lado do preço de tabela publicado pela Anthropic. Todos os modelos Claude da chave estão na página de preços da API do Claude.

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 pela tarifa de cache, uma fração da tarifa de entrada. O cache dura cinco minutos por padrão, então um turno depois de uma pausa mais longa paga uma vez a tarifa de entrada pelo contexto inteiro.

O custo que o Claude Code mostra é uma estimativa dele, pelo preço de tabela da Anthropic. O que você pagou está na página Uso do console.

ModeloEntradaEntrada em cacheSaídaContexto
Claude Fable 5.2claude-fable-5.2Anthropic$4.00Preço de tabela $8.00$0.10Preço de tabela $0.20$20.00Preço de tabela $40.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00Preço de tabela $10.00$2.00Preço de tabela $0.25$30.00Preço de tabela $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716Preço de tabela $4.00$0.1455Preço de tabela $0.20$9.70Preço de tabela $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20Preço de tabela $2.00$0.075Preço de tabela $0.10$3.00Preço de tabela $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582Preço de tabela $0.10$0.01Preço de tabela $0.01$0.1455Preço de tabela $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00Preço de tabela $10.00$0.30Preço de tabela $1.00$15.00Preço de tabela $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80Preço de tabela $5.00$0.16Preço de tabela $0.50$7.50Preço de tabela $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20Preço de tabela $2.00$0.12Preço de tabela $0.20$3.00Preço de tabela $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80Preço de tabela $5.00$0.16Preço de tabela $0.50$7.50Preço de tabela $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80Preço de tabela $5.00$0.16Preço de tabela $0.50$7.50Preço de tabela $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80Preço de tabela $5.00$0.16Preço de tabela $0.50$7.50Preço de tabela $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80Preço de tabela $3.00$0.18Preço de tabela $0.30$9.00Preço de tabela $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60Preço de tabela $1.00$0.06Preço de tabela $0.10$3.00Preço de tabela $5.00200,000

USD por milhão de tokens

Confira se funciona

Envie uma mensagem pequena. Com -i, o curl imprime os headers da resposta: x-uplink-request-id identifica a requisição e x-uplink-charge é quanto ela custou em USD.

Depois rode claude. A requisição aparece no console em segundos. Dentro do Claude Code, /status mostra uma linha Anthropic base URL com o endereço do UplinkSwitch e uma linha com o nome da variável de chave que você definiu. Se a linha da base URL não aparecer, a variável não chegou à sessão.

curl
curl -i https://api.uplinkswitch.com/v1/messages \
  -H "Authorization: Bearer sk-uplink-live-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'

Erros e correções

  • invalid_api_key (401): a chave está errada ou foi revogada, ou está em uma variável que o Claude Code não leu. Confira o /status.
  • insufficient_balance (402): recarregue no console. monthly_limit_reached (402) significa que a chave atingiu o limite mensal de gasto definido para ela.
  • model_not_found (404): o ID não está na lista de modelos. Procure erros de digitação nas variáveis de modelo.
  • O Claude Code pede login embora o teste com curl funcione: defina a chave em um export do shell ou em ~/.claude/settings.json. Um arquivo de configurações de projeto só vale depois da configuração inicial e do prompt de confiança.
  • Um aviso na inicialização cita duas fontes de credencial: um login salvo e a variável estão ativos ao mesmo tempo. Rode /logout para manter só a chave.
  • ANTHROPIC_API_KEY está definida mas é ignorada: ela precisa de uma aprovação única. Ative Use custom API key em /config, ou use ANTHROPIC_AUTH_TOKEN.

Perguntas frequentes

Sim. Aqui todos os modelos de chat são servidos no formato da Anthropic, então um ID de GPT, Gemini, DeepSeek ou de um modelo sem censura funciona nas variáveis de modelo e é respondido como uma resposta Messages, incluindo chamadas de ferramenta.

Sim. A entrada em cache é cobrada pela tarifa de cache. No registro de uma requisição, uma contagem de tokens de leitura de cache acima de zero significa que o cache funcionou.

O Remote Control e o ditado por voz precisam de um login do claude.ai, então ficam desligados enquanto uma variável de chave está definida. A busca de ferramentas MCP fica desligada em um host que não é da Anthropic, e definir ENABLE_TOOL_SEARCH=true a liga.

Remova ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN do ambiente, e apague as duas do settings.json se você as colocou lá.

A página Uso do console mostra o que você pagou. Para uma requisição, procure pelo ID dela. O registro lista tokens de entrada, tokens de leitura de cache, tokens de saída e a cobrança em USD, e chega ao log em cerca de um minuto.

O crédito é pré-pago a partir de $10 no console, com cartão, WeChat Pay, Apple Pay, Google Pay ou cripto, sem assinatura. Cada recarga trava seus preços por 30 dias.

Crie uma chave para o Claude Code

Duas variáveis, pré-pago a partir de $10, sem assinatura, com preços travados por 30 dias a cada recarga.

Obter chave
Join on Telegram