Coding Plan: Planos de assinatura e faturamento
📚 Navegação da série: O artigo anterior 05 Integrando modelos de terceiros / modelos nacionais ensinou como integrar DeepSeek, Kimi e GLM ao Claude Code. Este artigo vai colocar as contas em dia — Qual plano assinar, como o dinheiro é gasto, como consultar o uso e como economizar.
Na documentação oficial, há um número que pode assustar à primeira vista: em implantações corporativas, cada desenvolvedor queima, em média, cerca de 13 dólares por dia ativo, o que representa entre 150 e 250 dólares por mês (fonte: documentação oficial de costs). Treze dólares por dia é um bom dinheiro; num mês, é uma pequena fortuna — e essa é apenas a "média".
Eu mesmo paguei caro quando conectei o Claude Code à API oficial (faturamento por uso) logo no início: trabalhei a semana inteira sem nenhum alerta de uso configurado. No fim de semana, ao abrir a fatura no Console, estava um pouco acima de $40 — não é muito dinheiro, mas eu não conseguia explicar como foi gasto: Qual conversa custou mais? Escolhi o modelo errado ou acumulei muito contexto? Foi uma confusão total.
Este artigo visa esclarecer essas contas. Entender a lógica de faturamento é muito mais importante do que procurar cegamente por planos mais baratos — no mesmo plano, quem sabe usar faz durar o mês todo, quem não sabe atinge o limite em três dias.
Ao terminar de ler este artigo, você obterá:
- Uma tabela de comparação entre "Faturamento por uso vs Assinatura oficial vs Coding Plan nacional", para saber qual rota escolher.
- Entendimento da unidade de faturamento do Claude Code (tokens) e onde exatamente o dinheiro está sendo gasto.
- Vários comandos (
/usagepara verificar o uso,/usage-creditspara definir um limite,/statuspara verificar a configuração) para ficar de olho nas suas despesas. - Um conjunto de hábitos de economia comprovados: fazer a mesma tarefa gastando uma quantidade bem menor de tokens.
01 Primeiro, entenda: Pelo que você está pagando?
Para começar: O Claude Code em si é gratuito; o que você paga é a "capacidade de processamento do modelo".
O Claude Code é apenas uma ferramenta de linha de comando que roda no terminal, e baixá-la não custa nada. O que realmente custa dinheiro é o grande modelo por trás dele — cada vez que você faz uma pergunta, ele lê um arquivo ou escreve código, esse conteúdo precisa ser enviado ao modelo para processamento, e esse volume de processamento é a unidade faturável.
Analogia: O Claude Code é o táxi, o modelo é a quilometragem. Entrar no táxi é de graça, e o carro também é cedido a você, mas quando ele começa a andar, cada quilômetro rodado custa dinheiro no taxímetro — quanto mais você pergunta, maiores os arquivos que ele tem que ler e mais tempo ele passa "pensando", mais longa é a "quilometragem".
Esta "quilometragem" é medida numa unidade chamada token. Analogia: os tokens são as "palavras calculadas". O modelo divide o texto em pequenos pedaços para contar — segundo o glossário da plataforma da Anthropic, para o Claude, 1 token representa cerca de 3,5 caracteres em inglês, embora o número exato varie conforme o idioma (a proporção para o chinês não é fixa); o que você envia conta como "tokens de entrada", e o que ele retorna como "tokens de saída", que são cobrados separadamente, sendo os de saída normalmente mais caros.
Veja alguns cenários que você encontra todo dia e perceba como os tokens se acumulam:
- Pedir a ele para "ler este arquivo de 2000 linhas e alterá-lo" — o arquivo inteiro é enviado como tokens de entrada.
- Uma conversa contínua chega à 50ª mensagem — as 49 mensagens anteriores são reenviadas a cada vez como contexto (essa é a maior parte do gasto, e o hábito de usar o
/clearensinado na seção 05 aborda isso diretamente). - Ativar o pensamento estendido (extended thinking) e deixá-lo "pensar" por um longo tempo antes de agir — o processo de pensamento conta como tokens de saída.
Portanto, o valor gasto tem pouco a ver com o "número de perguntas que você faz", e muito a ver com "quanto contexto você insere a cada vez" — esse é o principal ponto para economizar.
💡 Resumo em uma frase: A ferramenta é gratuita, você paga pela capacidade de processamento do modelo calculada em tokens — entrada + saída + pensamento, tudo custa dinheiro.
02 Qual dos três caminhos escolher: Faturamento por uso / Assinatura Oficial / Coding Plan Nacional
Sabendo que pagamos pelos tokens, a próxima pergunta é: Por que canal pagamos esse dinheiro? As três principais opções são listadas na tabela abaixo.
| Opção | Como é cobrado | Custo Mensal (referência) | Para quem é adequado | Principais Armadilhas |
|---|---|---|---|---|
| Faturamento por uso oficial (API / Console) | Por uso de token, paga o quanto usa | Variável, usuários intensivos podem gastar $150–250+ | Quem quer usar o modelo nativo oficial, com uso estável | Fatura variável, pode estourar o orçamento; exige cartão internacional (dólar) |
| Assinatura oficial (Pro / Max / Team) | Mensalidade fixa, inclui uma certa cota | Fixo (veja o pricing oficial) | Alta frequência de uso, deseja despesas fixas, quer usar os modelos oficiais | Pagamento internacional, precisa de VPN; a cota tem limites |
| Coding Plan Nacional (China) (Ark, Bailian, Spark, etc.) | Mensalidade fixa, ferramentas múltiplas compartilham cota | Baixo, frequentemente há promoções no primeiro mês | Usuários chineses, sensíveis a custos, abertos a modelos nacionais | Não é o Claude; a cota obedece às regras do provedor; preços variam bastante |
Essas três opções não se tratam de "qual é a melhor", mas de "quem você é". Adicionando dois pontos além da tabela:
Os dois caminhos oficiais — O faturamento por uso usa o modelo Claude nativo (nível 1 em programação), é o mais flexível, mas a fatura varia (aqueles obscuros $40 do início). A assinatura tem a menor carga mental, sendo o plano Max ótimo para uso intenso, mas exige pagamentos internacionais + VPN. Os valores exatos devem sempre ser verificados em claude.com/pricing, pois não os definimos aqui de forma fixa.
O Coding Plan Nacional (específico para a China) é atualmente a opção mais viável para desenvolvedores chineses. O Ark da Volcengine, o Bailian da Alibaba e o Spark da iFlytek lançaram "Coding Plans" — serviços de assinatura projetados especificamente para ferramentas de programação com IA, com taxas mensais fixas e muito mais baixos que o faturamento por uso, compatíveis com o Claude Code. Eles integram o Qwen, Kimi, GLM, DeepSeek, Doubao, MiniMax, e ferramentas múltiplas (Cursor, Cline, etc.) compartilham uma única cota.
⚠️ Os preços das promoções dos Coding Plans chineses mudam frequentemente. Informações online sobre "primeiro mês por 9.9 / 49.9" referem-se a preços de eventos específicos, que mudam ou saem do ar a qualquer momento. Este artigo não cita valores específicos, vá diretamente para as páginas de promoção dos fornecedores para conferir os preços atuais.
A forma de conectar (Base URL, ANTHROPIC_MODEL) já foi explicada no artigo anterior, então não vamos repetir. Mas há uma grande armadilha de faturamento que deve ser destacada, e a próxima seção é dedicada a ela.
💡 Resumo em uma frase: Para uso oficial nativo, escolha assinatura ou faturamento por uso; para economizar na China, escolha Coding Plan — pense primeiro em quem você é antes de escolher, não olhe apenas para o preço.
03 A armadilha de faturamento do Coding Plan: Base URL errada = desperdício de dinheiro
Isso merece uma seção própria porque muita gente cai nessa armadilha — compram o Coding Plan, mas no fim do mês recebem uma fatura extra. A causa raiz: O mesmo fornecedor geralmente tem dois Base URLs diferentes, um para a cota da assinatura e outro para faturamento por uso, e eles são muito parecidos. Tomando o Volcengine Ark como exemplo:
| Base URL | Qual dinheiro gasta | Uso |
|---|---|---|
https://ark.cn-beijing.volces.com/api/coding | ✅ Consome a cota da assinatura Coding Plan | Use este ao conectar o Claude Code |
https://ark.cn-beijing.volces.com/api/v3 | ❌ Não usa a assinatura, é cobrado separadamente por uso | Chamadas normais de API |
Viu a diferença? É apenas uma palavra de diferença: coding e v3. Você comprou a assinatura, achando que teria uma taxa mensal fixa que seria o limite, mas na hora de configurar as mãos escorregaram e você preencheu /api/v3. A cota da assinatura permaneceu intocada, mas todas as chamadas foram cobradas por uso, gerando um custo extra no final do mês. O Bailian da Alibaba funciona de forma semelhante — a Chave exclusiva do Coding Plan (começando com sk-sp-) não é intercambiável com a Chave de faturamento por uso comum (começando com sk-), e misturá-las causará problemas da mesma forma.
Portanto, ao conectar a um Coding Plan chinês, lembre-se de duas regras de ferro: O Base URL deve conter a palavra coding; e use a API Key exclusiva da assinatura, não a API Key de faturamento por uso. Os endereços exatos do Ark ou Bailian e os prefixos de Key dependem de regras privadas desses fornecedores terceirizados e mudam conforme seus ajustes, portanto, consulte sempre as documentações / consoles oficiais para informações atualizadas antes de começar.
Se você configurar o Volcengine Ark incorretamente como v3, e checar habitualmente o /usage naquela noite, vai notar que "a cota da assinatura não se moveu, mas os números estão aparecendo no faturamento por uso no Console", e deve corrigir rapidamente para coding. Este tipo de armadilha é difícil de detectar a olho nu na configuração, mas fácil de flagrar prestando atenção no uso.
💡 Resumo em uma frase: Comprar o plano ≠ Usar o plano — Escolha a Base URL com
coding, use a Key exclusiva da assinatura e verifique imediatamente após configurar, caso contrário seu dinheiro vai escoar silenciosamente por outra torneira.
04 Como consultar o uso: Três comandos para ficar de olho na sua carteira
Gastar dinheiro sem verificar o uso é o mesmo que dirigir de olhos vendados. O Claude Code possui comandos integrados para que você saiba sempre onde o dinheiro está sendo gasto, vamos detalhar cada um:
/usage: O painel de uso mais abrangente (o mais usado)
Na caixa de diálogo, digite diretamente:
/usageA seção de Sessão (Session) no topo exibe o uso detalhado de tokens para a sessão atual, algo parecido com isto (fonte: documentação oficial de costs):
Total cost: $0.55
Total duration (API): 6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes: 0 lines added, 0 lines removedAs quatro linhas são: custo total estimado, duração real do processamento da API, tempo total com a janela aberta, e número de linhas de código alteradas. Após concluir uma tarefa, acostume-se a digitar isso para ter uma ideia dos gastos dessa interação. Porém, há um aviso oficial importante:
Os valores em dólares no bloco Session são estimativas locais a partir do número de tokens, e podem divergir da fatura real. O faturamento oficial deve ser verificado na página de uso do Claude Console. (Fonte: documentação oficial de costs)
Se você estiver usando os planos oficiais Pro / Max / Team / Enterprise, o /usage mostrará um bloco adicional com os detalhes da cota de uso — detalhando o consumo recente por skills, subagentes, plugins e cada servidor MCP e a proporção de cada um. É possível alternar entre "últimas 24 horas / 7 dias" pressionando d / w. Atenção que isso é um valor aproximado derivado do histórico da sessão local e não inclui o uso de outros dispositivos ou do claude.ai. (Fonte: documentação oficial de costs)
/usage-credits: Defina um limite mensal (ferramenta antidesperdício)
Essa funcionalidade é exclusiva dos planos Pro / Max oficiais (Fonte: documentação oficial de costs):
/usage-creditsEle permite que você defina um limite máximo de gastos mensais. Ao chegar nesse valor, o Claude Code o alertará e perguntará se você quer "aumentar o limite ou remover a restrição" diretamente via linha de comando. Modificar este limite exige ter acesso de faturamento (billing access) na conta.
Para novatos, é altamente recomendável usar esse comando logo de cara e definir um limite — por exemplo, definir um limite de 20 dólares por mês, assim ele irá pará-lo quando atingir, o que é muito melhor do que se assustar com a conta no fim do mês. A minha confusão com aqueles $40 ocorreu exatamente porque eu não conhecia esse comando na época.
Há também o /status, que abre a aba Status nas configurações e exibe informações sobre a version, model, account e connectivity (versão, modelo, conta, conectividade), conforme descrito na documentação oficial de comandos. A documentação oficial de integrações de terceiros recomenda: "utilize /status para confirmar que suas definições de proxy e gateway estão sendo aplicadas corretamente" — esta é exatamente a sua primeira etapa após configurar, digite-o e certifique-se de que o modelo e a conectividade estão corretos antes de começar a trabalhar.
| Comando | Cenário Adequado | Observações |
|---|---|---|
/usage | Consultar os tokens da sessão atual e custo estimado | O valor é estimado; veja o faturamento oficial no Console |
/usage-credits | Definir um limite mensal para evitar contas altíssimas | Disponível apenas nos planos Pro / Max oficiais |
/status | Verificar a versão, modelo, conta e conectividade | O primeiro passo para validar a configuração da integração |
💡 Resumo em uma frase:
/usagepara checar detalhes,/usage-creditspara impor um limite,/statuspara conferir a configuração — Esses três comandos trancam bem a sua carteira.
05 O segredo da economia: Faça o mesmo trabalho gastando menos tokens
Trocar para um plano mais barato é uma solução fraca; aprender a usar a ferramenta é a solução forte. Retornando à frase da Seção 01: O quanto você gasta está altamente correlacionado a quanto contexto você insere. Portanto, a essência para economizar é: não permita que o modelo leia informações inúteis, nem o deixe devanear por caminhos desnecessários. As dicas abaixo são extraídas da documentação oficial e focam no que traz resultados mais imediatos para iniciantes.
Primeiro, limpe o contexto com /clear entre diferentes tarefas. Este é o hábito mais recompensador.
/clearAntigamente eu deixava uma única janela aberta do início ao fim do dia. Resolvia um bug de manhã e criava uma feature nova à tarde no mesmo contexto, apenas por preguiça de mudar. O problema é a acumulação de contexto: toda nova pergunta à tarde reenviava tudo que foi discutido de manhã, duplicando o consumo de tokens sem necessidade. Ao olhar para o /usage, percebi que cada requisição da tarde estava visivelmente mais cara do que as da manhã. Aqui está a explicação oficial:
Use
/clearpara recomeçar ao mudar para um trabalho não relacionado. O contexto obsoleto desperdiça tokens em todas as mensagens subsequentes.
Crie esse hábito: Ao finalizar uma tarefa isolada, digite imediatamente /clear. Ao mudar para um assunto não relacionado, nunca continue o assunto em uma conversa antiga. Só com essa ação, os gastos longos caem vertiginosamente.
Segundo, escolha o modelo certo, não use um canhão para matar moscas. O princípio oficial é que "o Sonnet é excelente para a maioria das tarefas de programação e custa menos que o Opus, guardando o Opus para arquiteturas complexas e raciocínio de múltiplas etapas" (Fonte: documento de costs). Traduzindo: Alterar código no dia a dia, escrever funções e debugar bugs pequenos podem ser perfeitamente resolvidos pelo Sonnet; apenas "refatorar o módulo inteiro" deve justificar usar o comando /model para Opus. Sub-tarefas ainda menores podem ser direcionadas ao modelo Haiku nas configurações de subagentes, por um preço ainda menor. Deixe no Sonnet por padrão e mude apenas umas duas ou três vezes por semana.
Terceiro, use o Plan Mode para tarefas difíceis primeiro. Pressione Shift+Tab para entrar, deixe que ele analise a base de código primeiro e apresente um plano de solução para que você aprove antes dele codificar. O refazimento por ter seguido o rumo errado queima muito dinheiro. Isso acontece bastante: pedimos uma alteração vaga num arquivo, e ele vai lá e reescreve 7 ou 8 arquivos com a ideia toda errada; e pronto, esses tokens foram jogados no ralo.
Quarto, seja bem detalhista nas instruções. Quanto mais vago você for, mais arquivos ele precisará escanear para adivinhar a sua real intenção, e com isso mais tokens são consumidos. Comparação na documentação oficial: "Melhore esta base de código" irá varrer um mar de arquivos, enquanto dizer "Adicione validação de entrada na função de login no auth.ts" irá trabalhar de forma eficiente apenas nos arquivos pertinentes.
Use esta tabela como sua "cábula" (guia) de economia na lateral de seu monitor:
| Mau Hábito ❌ | Bom Hábito ✅ | O que isso poupa |
|---|---|---|
| Usar uma única sessão o dia inteiro | Usar /clear entre tarefas | Evita reenvio de contextos desatualizados |
| Manter Opus ativo o tempo todo | Sonnet no dia-a-dia, Opus nas horas difíceis | Preço unitário menor |
| Partir pra codificação logo que tem uma ideia abstrata | O Plan Mode (Planejamento) para atividades difíceis | Menos refação, evita buscas desnecessárias |
| "Ajudar-me a melhorar meu código" | "Adicionar filtro nas validações em auth.ts na função login" | Escaneamento em menos arquivos soltos |
Uma curiosidade para o seu conhecimento (Fonte: documentação oficial de costs): Em modo ocioso o Claude Code também vai requerer ligeiro uso a tokens — por exemplo, quando prepara os resumos para sessões em segundo plano após usar o comando claude --resume. Mas a quantidade é minúscula, geralmente menos de $0.04 por sessão, então não se preocupe.
💡 Resumo em uma frase: Economizar não é mudar para um pacote barato, mas sim limpar sempre com
/clear, usar o Sonnet no geral, usar planejamento em tarefas complexas e dar instruções claras — quanto menor o contexto, menor a fatura.
06 Mão na massa: Três passos para checar seus gastos semanais
Apenas olhar e não praticar não serve para nada. Você pode realizar esta sequência de comandos agora mesmo, e estabelecer sua percepção de uso em cinco minutos.
Pré-requisito: Claude Code já deve estar instalado e configurado (assinatura oficial ou Coding Plan). No diretório do projeto, inicie:
cd path/to/your_project
claudePrimeiro passo: Verificar se a configuração da porta está correta.
/statusA aba Status abrirá nas configurações, mostrando version, model, account, connectivity (versão, modelo, conta e conectividade) conforme a documentação de comandos. O mais importante é confirmar se o modelo e a conectividade estão corretos, caso contrário sua integração falhou.
A própria Base URL não aparece na saída do /status, você deve verificar as variáveis de ambiente que escreveu: Usuários do Coding Plan devem confirmar que ANTHROPIC_BASE_URL contém a palavra coding (ex: .../api/coding), e não algo como /api/v3 de endereço por volume. Se estiver errado, retorne à etapa de variáveis do artigo 05 para corrigir, e reabra o terminal.
Segundo passo: Faça uma pergunta qualquer para ver quanto gasta. Peça um favor simples:
Diga-me quais arquivos existem no diretório atual e explique rapidamente para que serve este projeto.Após ele responder, digite:
/usageEspera-se que o bloco Session no topo seja assim:
Total cost: $0.0X
Total duration (API): Xs
Total duration (wall): Xs
Total code changes: 0 lines added, 0 lines removedGuarde este número. Este é o custo para "fazer uma pergunta simples + ler o diretório" — com essa base, no futuro você conseguirá detectar imediatamente quando uma conversa estiver queimando dinheiro anormalmente.
Terceiro passo: Definir limite mensal (Para usuários Pro / Max oficiais).
/usage-creditsSiga os prompts para definir um limite aceitável. Quando atingi-lo, ele avisará antes de gastar, agindo como um seguro para a sua carteira.
Usuários do Coding Plan Nacional: O comando
/usage-creditsaplica-se à cota oficial, e pode não valer para o pacote do seu fornecedor — cotas e limites devem ser baseados no console do fornecedor, mas hábitos como/usagee/clearcontinuam vitais.
Realizando esses três passos, você passará do "gasto cego" para o "controle de quanto gastou e limitação".
💡 Resumo em uma frase:
/statuscheca portas →/usagecria métricas →/usage-creditsdefine limites, cinco minutos para retomar o controle das despesas.
07 Resumo
Este artigo explicou tim-tim por tim-tim o que envolve o "dinheiro" no Claude Code.
| O que você aprendeu | Pontos Chave |
|---|---|
| Por que paga | A ferramenta é grátis, o custo é o processamento do modelo medido em tokens |
| Qual opção escolher | Original oficial → assinatura/uso; Economia na China → Coding Plan |
| As armadilhas dos planos nacionais | Base URL deve ter coding, a Key deve ser exclusiva |
| Como ver o consumo | /usage verifica detalhes, /usage-credits define limite, /status verifica configuração |
| Como economizar | /clear com frequência, Sonnet como base, planejar primeiro os casos complexos, instruções claras |
Se puder lembrar-se de apenas uma coisa: O dinheiro gasto está altamente relacionado com "quanto contexto você insere", e não com "quantas perguntas você faz". Entendendo isso, as técnicas para economizar deduzem-se por si só — entender a lógica da fatura, verificar gastos da vez, definir limites mensais, fazer as tarefas de maneira econômica, você agora tem todas elas.
⚠️ Novamente uma ênfase na exatidão: Os preços, promoções e regras de cota de pacotes podem variar, verifique os preços oficiais em claude.com/pricing ou páginas de fornecedores nacionais; O comportamento de /usage-credits pode depender das diretrizes oficias de costs, que podem ser atualizadas (use claude --version para ver a versão).
Agora que já entendemos as contas e escolhemos nosso pacote, o próximo artigo é 07 "A Primeira Utilização: Executando o Primeiro Exemplo" — Ligar o Claude Code e, a partir de um projeto real em pequena escala, exercitar todo o ciclo de "pensar → agir → observar" na prática. Chega de preparativos, é hora de ir para a ação.