Docs/Modelos, planos e execução/Billing e uso

Custo visível,
sem surpresa.

Tokens, custo e limites são informação de primeira classe no MVCode: visíveis na sessão, agregados na CLI e — nos planos — com um paywall honesto que nunca esconde as suas opções.

PlanejadoPlano /billing1 min de leitura

01Uso por sessão

Cada sessão expõe o próprio consumo em três lugares:

Recibo do composer — projeto · branch · tokens correntes, sempre à vista.
Árvore da sessão — tokens, custo estimado e duração por nó, incluindo subagentes.
Painel de contexto — o que ocupa a janela (system, arquivos, mensagens, ferramentas) e o botão de compactar.

02Agregado na CLI

terminal

mvcode stats --days 30
TOKENS       COST        SESSIONS   TOOLS
12.4M        $18.72      86         1.2k
# breakdown por modelo e por projeto
mvcode stats --models 5 --project meu-app

Os números vêm do banco local — funcionam igual para BYOK e planos. Em BYOK, o custo é estimado a partir da tabela pública do provedor.

03Cota dos planos Planejado

Quando os planos gerenciados estiverem ativos, a tela de uso do app mostra a cota em linguagem humana: consumo do ciclo, janela de renovação e histórico. Quando o uso passa de 80%, o app avisa — sem drama, com números.

O que não é exibido

Medidores brutos de provider — contagem crua de tokens do gateway, rate limits internos, custo por request do upstream — não são a interface do plano. O usuário vê capacidade e limites em termos práticos; o detalhe bruto continua disponível para quem opera BYOK via mvcode stats.

04O paywall honesto

Cota esgotada não vira beco sem saída. A tela de limite mostra sempre as quatro saídas, com o custo de cada uma:

01Esperar a renovaçãoO contador mostra exatamente quando a cota renova — em horas, não em "em breve".

02Cair para BYOKSe você tem provedor conectado, a sessão continua nele na hora, sem perder contexto.

03Modelo mais leveO catálogo indica quais modelos permanecem dentro do que resta da cota.

04UpgradePrime, quando disponível — com o delta de preço explícito antes de qualquer cobrança.

Princípio

Nenhuma tela de limite esconde o trabalho já feito, interrompe uma resposta no meio, ou cobra sem confirmação explícita. Limite é estado do produto, não emboscada.

05Faturas e recibos

Assinaturas emitem recibo por ciclo, disponível na área da conta. Dados fiscais e notas seguem o fluxo comercial da Produtora MaxVision — detalhes em suporte.

06Controle de custo em BYOK

Defina variantes leves como padrão e suba de intensidade só quando precisar.
Compacte sessões longas — contexto acumulado é o maior multiplicador de custo.
Use mvcode stats semanalmente; tendência importa mais que o número absoluto.
Restrinja agentes exploratórios a ferramentas de leitura — tool call de explore custa menos que um build errante.