Preços do agente de programação Pi: o software é gratuito, mas os tokens não

O agente de programação Pi não custa nada para instalar: é um software licenciado sob MIT, sem plano nem preço por assento. Cada dólar gasto no Pi corresponde a tokens de modelo, comprados por meio de quatro tipos de rota. São elas o gateway Radius da própria Earendil, uma conta conectada por /login — a documentação de provedores do Pi listava sete até uma atualização de 22 de setembro de 2026, entre eles Claude Pro/Max, ChatGPT Plus/Pro via Codex e OpenRouter — uma chave de API direta do fornecedor ou qualquer endpoint compatível com OpenAI ou Anthropic que você mesmo adicione a ~/.pi/agent/models.json. A cobrança difere o bastante para que “quanto custa o Pi” não tenha um único número.

Esta página trata do agente de programação para terminal publicado em pi.dev pela Earendil Inc. Não se trata do Pi da Inflection AI (pi.ai), da moeda Pi Network, do Raspberry Pi nem do Oh My Pi, um agente de programação separado, licenciado sob MIT, de outro autor. Nenhum dos preços deles se aplica aqui.

Preços do agente de programação Pi: o que cada camada cobra

Fontes verificadas em 18 e novamente em 21 de setembro de 2026: o repositório do Pi (MIT, não arquivado), o site oficial, a documentação de provedores do Pi para as sete rotas /login, e o FAQ do Radius. A atualização da documentação do Pi de 22 de setembro de 2026 removeu essa lista de sete; a página de provedores agora diz “Use /login [provider] para ver os métodos compatíveis com um provedor” (relida em 1º de outubro de 2026). O Radius também afirma ser “atualmente um serviço de código fechado”.

Vale dedicar uma frase a uma armadilha de nomenclatura, pois ela afeta silenciosamente o que você instala. O Pi passou de badlogic/pi-mono e do escopo npm @mariozechner para earendil-works/pi e @earendil-works em 7 de maio de 2026; 0.74.0 foi a primeira versão sob o novo escopo, 0.73.1 a última sob o nome antigo, e os pacotes antigos foram descontinuados, mas não retirados. Tutoriais de terceiros e mecanismos de resposta ainda fornecem a linha de instalação obsoleta. A atual é npm install -g --ignore-scripts @earendil-works/pi-coding-agent, versão mais recente 0.86.1, publicada no registro em 20 de setembro de 2026 quando verificado em 21 de setembro de 2026.

A rota de assinatura é onde os orçamentos saem do controle

Se você já paga pelo Claude Pro ou Max, a escolha óbvia é entrar com ele. O Pi informa o que isso realmente faz. Até a atualização da documentação de 22 de setembro de 2026, a documentação de provedores do próprio Pi dizia: “O uso por harnesses de terceiros consome uso adicional e é cobrado por token, não pelos limites do plano Claude.” A atualização removeu essa frase e deixou apenas uma configuração, warnings.anthropicExtraUsage, para “Avisar quando a autenticação por assinatura Anthropic puder usar uso adicional pago”; o próprio aviso, no código-fonte do Pi na v0.99.2, ainda diz que o uso por harnesses de terceiros “consome uso adicional e é cobrado por token, não pelos limites do seu plano Claude”. Um usuário que recebeu o aviso de terminal do Pi no mesmo sentido registrou a issue #3670; um bot a fechou automaticamente, e o mantenedor respondeu que a Anthropic não permite usar a cota do plano dessa forma, embora tenha observado que o login por assinatura ainda é útil para uso adicional. Considere o Pi literalmente: a assinatura não é o orçamento do Pi, mas um pré-requisito para uma cobrança separada por token. O próprio artigo do Agent SDK da Anthropic atualmente diz o contrário para aplicativos de terceiros — desde uma atualização de 15 de junho de 2026, afirma que o uso deles “ainda consome os limites de uso da sua assinatura” — portanto verifique Settings > Usage depois de uma sessão curta, em vez de confiar isoladamente em qualquer uma das frases.

O lado da Anthropic concorda quanto ao dinheiro. O centro de ajuda informa que os créditos de uso são cobrados pelas tarifas padrão da API e são ativados em Settings > Usage no aplicativo web. Um artigo separado sobre pacotes de uso publica os descontos dos pacotes de uso pré-pagos:

O mesmo artigo limita as compras de pacotes a $2,000 por mês nos planos individuais Pro e Max e a $3,000 por mês no plano Team, e afirma que preços e planos estão sujeitos a alterações. Ele é datado de 18 de maio de 2026; o artigo sobre uso adicional é datado de 10 de agosto de 2026.

Os dois artigos descrevem saldos e superfícies diferentes, então leia ambos, não apenas um. O artigo sobre pacotes diz que o saldo de um pacote de uso “se aplica ao Claude, Claude Desktop, Claude Mobile (iOS e Android), Claude Code, Cowork e produtos de terceiros que usam sua conta Claude”. O artigo sobre uso adicional diz que “os créditos de uso se aplicam tanto às conversas do Claude quanto ao uso do terminal Claude Code” e não aborda harnesses de terceiros em nenhum sentido — uma ausência, não uma exclusão. A consequência de cobrança afirmada pelos dois artigos é a que importa para um orçamento: por token, pelas tarifas padrão da API.

Também vale conhecer o histórico da política por trás dessa string de aviso, embora seja de segunda mão: a VentureBeat informou em 13 de maio de 2026 que a Anthropic havia bloqueado ferramentas de agentes de terceiros da cobrança de assinaturas Claude em 4 de abril de 2026, depois reativado a rota por trás de um pool separado de créditos mensais do Agent SDK cobrado pelas tarifas da API, que não acumula e não pode recorrer à franquia geral da assinatura quando se esgota. O próprio artigo do Agent SDK da Anthropic supera esse relato: anunciou um crédito mensal do Agent SDK para 15 de junho de 2026 e, em seguida, abriu com uma atualização no mesmo dia pausando a alteração — o crédito não está disponível, e o Agent SDK, claude -p e o uso por aplicativos de terceiros continuam contando contra os limites de uso do plano. Leia os mecanismos da VentureBeat como histórico, não como termos atuais, e verifique Settings > Usage na sua própria conta antes de direcionar trabalho pago por essa rota.

Tarifas do Radius lado a lado com os mesmos modelos na Kunavo

O Radius é a única rota aqui cujo preço é definido pela própria Earendil. Sua tabela de modelos publica tarifas por milhão de tokens e afirma claramente que “a disponibilidade e os preços dos modelos podem mudar”. O FAQ informa que as recargas são cobradas pelos preços de tabela mais as taxas do processador de pagamentos, sem publicar um percentual, portanto não é possível calcular externamente um total do Radius. A tabela abaixo compara suas tarifas publicadas com as tarifas do catálogo ativo da Kunavo para os mesmos três modelos Claude e com o preço de tabela do próprio fornecedor do modelo.

Os valores do Radius foram lidos em sua própria documentação em 18 de setembro e permaneciam inalterados em 21 de setembro de 2026; os valores da Kunavo são exibidos a partir do catálogo ativo. Observe um mecanismo do Radius que altera uma cobrança mais do que uma tabela de tarifas: para seus modelos escalonados, “o nível é selecionado a partir do total de tokens de entrada da solicitação e se aplica à solicitação inteira” — sua linha gpt-5.4 passa de $2.50 / $15.00 para $5.00 / $22.50 quando uma solicitação ultrapassa 272,000 tokens de entrada. Uma conversa longa com um agente, portanto, muda de preço em uma única etapa, em vez de gradualmente.

Um mês calculado, em números

Suponha um mês, um modelo, 6,000,000 de tokens de entrada não armazenados em cache e 600,000 tokens de saída, sem leituras de cache, gravações de cache nem cobranças por imagens ou ferramentas. Isso representa aproximadamente o formato de um trabalho diário constante com agente em um repositório, não uma tarefa medida.

Estas são estimativas ilustrativas de tokens sob as premissas acima, não custos de uma tarefa medida nem um teto para uma cobrança. A coluna do Radius também exclui a taxa não publicada do processador de pagamentos nas recargas. Leia as duas colunas linha a linha, não como um veredito: quando chegam ao mesmo número, a escolha depende de algo além do preço; quando divergem, a diferença é um motivo para definir o preço do modelo específico que você pretende executar, em vez de escolher uma rota e presumir o restante.

Duas ressalvas do lado da Kunavo pertencem à mesma estimativa. O valor do catálogo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável, como explica o guia de cobrança. E a recarga mínima é $10 de crédito pré-pago, que é o dinheiro necessário para abrir uma conta financiada, não uma taxa de tarefa ou uma assinatura. As cobranças de cache são separadas e estão documentadas em cache.

A tarifa listada mais barata não é a tarefa concluída mais barata

Essas são duas afirmações diferentes, e confundi-las é como uma rota barata fica cara. Um modelo menor, a um terço do preço por milhão, ainda custa mais no total se precisar de três tentativas para uma alteração que um modelo mais forte conclui de uma vez. Decida primeiro pela rota e depois pelo modelo:

• Radius quando você quiser o caminho integrado ao Pi: OAuth por /login, uma tabela de tarifas publicada e metadados de custo que o Pi já sabe exibir. O FAQ informa que BYOK está disponível para clientes empresariais.
• Uma chave direta do fornecedor quando você quiser os próprios recursos, suporte e termos do fornecedor e precisar de apenas uma família de modelos.
• Uma assinatura existente somente depois de ler a seção acima. Ela é um pré-requisito para uso adicional por token, não uma franquia incluída para o Pi.
• Um gateway compatível como a Kunavo quando a tarifa por token do modelo escolhido for o fator decisivo e você estiver disposto a configurar manualmente um provedor personalizado.
• Inferência local quando o hardware já for seu e o modelo realmente lidar com seu fluxo de trabalho com ferramentas. O Pi documenta Ollama, vLLM e LM Studio como provedores personalizados.

Depois, meça. A documentação de uso do Pi descreve um rodapé TUI com uso de tokens/cache, custo, uso de contexto e modelo atual, e /session como imprimindo o arquivo de sessão, ID, mensagens, tokens e custo — desde que o custo esteja configurado, que é a ressalva da próxima seção. Execute a mesma tarefa limitada em dois candidatos antes de migrar trabalho agendado.

Apontando o Pi para seu próprio endpoint

O Pi não documenta nenhuma variável de ambiente genérica para base URL. Não há ANTHROPIC_BASE_URL nem OPENAI_BASE_URL entre as variáveis documentadas — desde a atualização da documentação de 22 de setembro de 2026, a única entrada de endpoint é AZURE_OPENAI_BASE_URL, na página de provedores; a atualização removeu AWS_ENDPOINT_URL_BEDROCK_RUNTIME, que a documentação mostrava como uma variável padrão do AWS SDK para um proxy Bedrock — portanto um endpoint personalizado é configurado em ~/.pi/agent/models.json. Esse arquivo é recarregado sempre que você abre /model, então você pode editá-lo durante a sessão. Até a mesma atualização, o Pi documentava exatamente quatro protocolos de rede para ele: openai-completions, openai-responses, anthropic-messages e google-generative-ai. A página de modelos atualizada não lista nenhum — mostra openai-completions em um exemplo e descreve o caso como “Um endpoint compatível com OpenAI, Anthropic ou Google” — e o código-fonte do Pi na v0.99.2 define o campo como uma string livre e o encaminha para qualquer uma das dez implementações integradas correspondentes, as quatro mais mistral-conversations, azure-openai-responses, openai-codex-responses, bedrock-converse-stream, google-vertex e pi-messages. Apenas as quatro foram documentadas para um provedor personalizado, e nenhuma das outras seis foi testada aqui. A Kunavo oferece as três primeiras das quatro; não possui uma rota Google Generative AI, portanto esse quarto tipo não tem equivalente na Kunavo.

A configuração abaixo foi escrita a partir da documentação de modelos do Pi — e, quando a atualização da documentação de 22 de setembro de 2026 removeu um detalhe, do código-fonte do Pi na v0.99.2 — e dos endpoints documentados da Kunavo. Ela não foi executada aqui contra a Kunavo. O guia de integração do Pi da Kunavo é a referência de configuração publicada para este cliente; ele usa a rota compatível com OpenAI, não coloca esta rota anthropic-messages em um bloco para copiar e colar e também não foi testado em tempo de execução. Trate o bloco abaixo como um ponto de partida para verificação, mantenha sua rota funcional disponível e espere fazer ajustes.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": [
            "text",
            "image"
          ],
          "cost": {
            "input": 1.4,
            "output": 7,
            "cacheRead": 0.14,
            "cacheWrite": 1.75
          }
        }
      ]
    }
  }
}

Quatro observações sobre esse bloco, cada uma uma armadilha real:

1. A URL base é a origem, sem /v1. Clientes no estilo Anthropic acrescentam /v1/messages por conta própria, então https://api.kunavo.com/v1 produz solicitações para /v1/v1/messages e um 404 — consulte a página sobre base URL. A própria documentação do Pi nunca resolveu isso: até a atualização da documentação de 22 de setembro de 2026, um exemplo anthropic-messages usava uma https://proxy.example.com somente com a origem e outro usava https://proxy.example.com/v1, e a atualização removeu ambos sem resolver a questão. Se sua primeira chamada retornar 404, esta é a linha que você deve alterar. Um provedor compatível com OpenAI usa a convenção oposta, https://api.kunavo.com/v1 com api definido como openai-completions.
2. O bloco cost não é opcional na prática. O código-fonte do Pi (v0.99.2) o define por padrão como todos os valores zero — a documentação atualizada já não informa isso — portanto um provedor adicionado por você informa $0 no rodapé e em /session até que as tarifas sejam digitadas. Os provedores integrados e o Radius obtêm suas tarifas de um catálogo; o seu não. Os números acima são exibidos a partir do catálogo atual da Kunavo, com a tarifa de leitura de cache da tabela de cache e gravações de cache do Claude a 1.25× da entrada.
3. Defina os limites de contexto e de saída. A mesma fonte define por padrão um contexto de 128,000 tokens e um máximo de 16,384 tokens de saída para um modelo personalizado. Adicione contextWindow e maxTokens correspondentes ao modelo escolhido, ou o Pi gerenciará a conversa por um limite que o endpoint nunca impôs.
4. Deixe as flags de compatibilidade Anthropic inalteradas no início. Seus valores padrão agora estão no código-fonte do Pi (v0.99.2), e não na documentação, e nem todos apontam na mesma direção. supportsEagerToolInputStreaming e supportsLongCacheRetention têm como padrão true — o Pi envia eager_input_streaming por ferramenta, a menos que você defina o primeiro como false porque um backend rejeita o campo — enquanto supportsStrictTools, allowEmptySignature e supportsMidConvoEffort têm como padrão false. Até a atualização da documentação de 22 de setembro de 2026, o Pi alertava que o último desses recursos pertence apenas a um transporte Anthropic Messages fiel, não a APIs que apenas imitam o formato; a página de modelos atualizada substitui isso por uma regra única para todos: as configurações de compatibilidade “devem descrever diferenças verificadas no comportamento de solicitação ou resposta do endpoint. Não as ative apenas porque um endpoint anuncia compatibilidade com OpenAI ou Anthropic”. Não foi testado quais desses recursos a Kunavo aceita, portanto o bloco acima não define nenhum deles.

Mais um mecanismo que vale a pena conhecer: apiKey aceita $ENV_VAR, um !shell-command cujo stdout é usado, ou um literal. Ele não precisa carregar o arquivo e, desde a atualização da documentação de 22 de setembro de 2026, a página de modelos do Pi publica a ordem em que as credenciais são resolvidas: "primeiro um --api-key de runtime, depois uma credencial auth.json armazenada, um apiKey de models.json e, por fim, as variáveis de ambiente do provedor ou as credenciais de nuvem disponíveis no ambiente". Até que o Pi consiga resolver alguma credencial, a mesma página informa que os modelos personalizados são carregados de models.json, mas "permanecem indisponíveis em /model".

Se preferir seguir uma página de configuração publicada em vez de adaptar este bloco, comece pelo guia de integração do Pi; se ainda estiver escolhendo um cliente, Pi vs OpenCode compara os dois agentes, e o índice de integrações lista todos os clientes com um guia de configuração do Kunavo. Quando estiver pronto para calcular o preço de uma tarefa real, crie uma conta do Kunavo e execute uma alteração limitada no modelo que você selecionou.

Perguntas frequentes

Documentação do Pi, Radius e Anthropic verificada em 18 de setembro e reverificada em 21 de setembro de 2026. Após a atualização da documentação do Pi em 22 de setembro de 2026, a ordem das credenciais e os exemplos de URL base de anthropic-messages foram reverificados na página de modelos em 1º de outubro de 2026, e os valores padrão de modelos personalizados no código-fonte da versão v0.99.2. No mesmo dia, a linha de uso adicional foi reverificada na página de configurações do Pi e no aviso do terminal no código-fonte da versão v0.99.2; a lista de rotas de /login e as variáveis de endpoint na página de provedores; a lista de api e as orientações sobre flags de compatibilidade na página de modelos, com o despacho de api e os valores padrão das flags no código-fonte; e o próprio índice de integrações deste site. As tarifas do Kunavo e todos os totais desta página são renderizados a partir do catálogo ao vivo e representam aritmética ilustrativa de tokens, não custos medidos de tarefas. Nenhum teste de execução do Pi com o Kunavo foi realizado.