Como usar o Claude Code sem cartão de crédito internacional
A assinatura oficial do Claude exige cartão estrangeiro, e é aí que muita gente para na porta. Este guia compara quatro rotas viáveis por custo, atrito e risco, e depois percorre a rota de pagamento por uso em CNY, com estimativas de custo por nível de uso.
Resposta curta
O Claude Code é um cliente, e o cliente é grátis. O que você paga é o modelo atrás dele. Isso divide "usar o Claude Code" em dois problemas bem diferentes:
- Comprar o serviço da Anthropic: assinatura ou API. Exige cartão estrangeiro.
- Apontar o cliente para um modelo em outro lugar: o cliente é grátis, você paga por token em CNY.
Este guia trata do segundo tipo, mais a parte do primeiro tipo que realmente bloqueia as pessoas.
Quatro rotas comparadas
| Rota | Barreira | Estrutura de custo | Indicada para |
|---|---|---|---|
| Assinatura oficial (Pro / Max) | Cartão de crédito internacional | Mensalidade fixa, uso com teto | Uso estável, precisa de todos os recursos oficiais |
| API oficial, pagamento por uso | Cartão internacional + câmbio | USD por milhão de tokens | Uso em picos irregulares |
| Gateway em CNY + cliente | Recarga a partir de ¥10 | CNY por milhão de tokens | A maioria dos desenvolvedores fora dos EUA |
| Modelo aberto auto-hospedado | Uma GPU que rode o modelo | Energia elétrica | Dados que não podem sair da empresa; GPU ociosa disponível |
Se você tem cartão internacional e depende muito de entrada de imagem ou de WebSearch, a assinatura oficial continua sendo o menor atrito. Nos outros casos, a terceira rota costuma custar uma ordem de grandeza menos.
Rota três: pagamento por uso em CNY
Step 1 · Cadastre-se e recarregue
Os saldos são em CNY, a partir de ¥10. As recargas têm bônus: 3% em ¥200, 8% em ¥1000. Comece pequeno, faça o loop funcionar e só depois escale.
Step 2 · Crie uma API key
Crie uma key ks- no painel. Use uma key por projeto, assim dá para revogar um projeto sem mexer no resto.
Step 3 · Configure o Claude Code
export ANTHROPIC_BASE_URL="https://api.kimiseek.app"
export ANTHROPIC_AUTH_TOKEN="ks-your-key"
export ANTHROPIC_MODEL="deepseek-v4-pro-0813"
claudeOu coloque no arquivo de configuração para não exportar de novo em cada shell:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.kimiseek.app",
"ANTHROPIC_AUTH_TOKEN": "ks-your-key",
"ANTHROPIC_MODEL": "deepseek-v4-pro-0813"
}
}Step 4 · Use um modelo mais barato para trabalho leve
Mensagem de commit e correção de typo não merecem o modelo mais caro:
export ANTHROPIC_BASE_URL="https://api.kimiseek.app"
export ANTHROPIC_AUTH_TOKEN="ks-your-key"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
claudeComo estimar o custo
A fórmula de cobrança é direta:
# All rates below are CNY per 1,000,000 tokens.
cost_cny = (
(input_tokens - cached_input_tokens) * input_rate
+ cached_input_tokens * cached_input_rate
+ output_tokens * output_rate
) / 1_000_000
# Example: 1,000,000 uncached input tokens at CNY 4.5 / million,
# with no output tokens, cost CNY 4.5.O uso do Claude Code tem uma propriedade marcante: a entrada é muito maior que a saída. Cada turno reenvia o context window, então a conta é dominada pela entrada. É exatamente por isso que um preço de entrada em cache a um décimo da entrada importa tanto.
Estimativa grosseira com as tarifas off-peak do DeepSeek V4 Pro (entrada ¥4.5, cache ¥0.45, saída ¥13.5 por milhão de tokens):
| Nível de uso | Entrada por dia | Saída por dia | Custo mensal, off-peak |
|---|---|---|---|
| Leve (1–2 horas por dia) | ~0.3M | ~0.03M | ~¥40–60 |
| Moderado (tempo integral) | ~1.5M | ~0.15M | ~¥200–300 |
| Intenso (context longo, multi-agent) | ~5M | ~0.5M | ~¥650–900 |
No deepseek-v4.1-flash (¥1 de entrada, ¥4 de saída em off-peak) o perfil moderado cai para algumas dezenas de yuan por mês.
Três variáveis mexem na conta real:
- Peak custa o dobro. As tarifas de peak são exatamente o dobro das de off-peak, então agendar trabalho em off-peak corta a conta pela metade.
- Taxa de acerto do cache. Quanto mais acertos, menor o custo — mas a taxa é decidida no upstream.
- Tamanho do context. Context longo não aumenta o preço unitário, mas toda requisição reenvia tudo, então o dinheiro vai embora em entrada repetida.
Estas são estimativas, não orçamento fechado. Os preços atualizados vêm da página de preços, que lê a configuração do catálogo de modelos direto.
Notas fiscais e compra corporativa
- Recargas e consumo aparecem no painel, item a item por chamada, para conciliação.
- Para notas fiscais ou compras corporativas, fale com o suporte para confirmar o procedimento. Valide a integração com uma recarga pequena antes de comprar em volume.
- Use uma key por projeto para conseguir separar a conta por key.
Avisos de risco (leia esta parte)
Estes atalhos parecem baratos e custam mais:
- Contas compartilhadas / assinatura rachada: viola os termos, risco de ban a qualquer momento, e o seu código passa pela conta de outra pessoa.
- Serviços de recarga de terceiros: um estranho entra na sua conta, e keys vazadas geram conta para você.
- Keys compartilhadas de origem desconhecida: igual ao acima, mais o fato de você não saber quando ela vai ser revogada.
O caminho correto é sem glamour: sua conta, sua key, pagando pelo que usa. Uso pequeno pede recarga pequena — o mínimo de ¥10 existe exatamente para isso.
Versões e verificação
- Claude Code: 2.x; Codex CLI: 0.154.0 (configuração no guia do Codex)
- Verificado em: 2026-10-26
- Fonte de preços: o catálogo de modelos (CNY por milhão de tokens, faixas peak e off-peak); os percentuais de bônus de recarga seguem o painel
Perguntas frequentes
¥10 basta para testar?
Basta. Configurar o cliente e verificar a cadeia de tool calls em um modelo barato costuma custar bem menos de ¥1. O que gasta de verdade é refatoração com context longo.
O pagamento por uso pode estourar de repente?
Não. O saldo é pré-pago, então para quando acaba e não fica negativo. Para mais segurança, dê uma key a cada projeto e controle a recarga por key.
Por que a entrada custa tanto mais que a saída na minha conta?
Porque um agent reenvia o context window a cada turno. Uma conversa com 100K de context cobra 100K de entrada mesmo que só emita 500 tokens de saída. É também por isso que a entrada em cache a um décimo do preço pesa tanto.
Empresas conseguem nota fiscal?
Para solicitar uma nota fiscal, fale com o suporte para confirmar as condições, os dados necessários e o procedimento antes de fazer uma compra corporativa.