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.
Verificado em 2026-11-13
O que você precisa
- O Claude Code instalado, com
claudeno 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_URLaponta 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_TOKENenvia a chave comoAuthorization: Bearer.ANTHROPIC_API_KEYfunciona no lugar dela e envia a chave comox-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.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudeDeixe 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_MODELeANTHROPIC_DEFAULT_HAIKU_MODEL. Defina-as com IDs comoclaude-opus-5-5,claude-sonnet-5-5eclaude-haiku-5-5. - Mantenha a chave fora do
.claude/settings.jsonde 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.
| Modelo | Entrada | Entrada em cache | Saída | Contexto |
|---|---|---|---|---|
| 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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.50 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 200,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 -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
/logoutpara manter só a chave. ANTHROPIC_API_KEYestá definida mas é ignorada: ela precisa de uma aprovação única. Ative Use custom API key em/config, ou useANTHROPIC_AUTH_TOKEN.
Perguntas frequentes
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