Agente de programação Pi vs Claude Code: fluxo de trabalho, permissões e custo total

Pi e Claude Code são ambos agentes de programação de terminal que podem ser apontados para um endpoint escolhido por você, mas não são o mesmo tipo de produto. O Pi é um software com licença MIT que deixa a maior parte da estrutura do agente para extensões; o Claude Code é um software proprietário baseado em um sistema de permissões aplicado e no protocolo Anthropic Messages. Esses dois fatos determinam a comparação mais do que qualquer lista de recursos, porque um deles foi criado para executar quaisquer modelos oferecidos pelo seu endpoint, enquanto a Anthropic documenta que o outro não oferece suporte a isso.

Primeiro, uma desambiguação, pois o nome é conflitante. "Pi" aqui é o agente de programação publicado em pi.dev pela Earendil Inc. — não o Pi da Inflection AI em pi.ai, não a moeda Pi Network e não o Raspberry Pi. Sua CLI é @earendil-works/pi-coding-agent, MIT, versão mais recente 0.86.1 publicada em 20 de setembro de 2026 no registro npm, e seu repositório earendil-works/pi tem licença MIT, não está arquivado e recebeu seu último push em 21 de setembro de 2026 (API do GitHub). O Claude Code é instalado de @anthropic-ai/claude-code, versão mais recente 2.1.278 publicada em 19 de setembro de 2026, e seu LICENSE.md diz integralmente: "© Anthropic PBC. All rights reserved. Use is subject to Anthropic's Commercial Terms of Service". Ambos os clientes são lançados com frequência, portanto trate estes como os números de 21 de setembro de 2026, não como atuais; as verificações da documentação abaixo são datadas de 19 de setembro de 2026.

Qual você deve escolher

Responda a estas perguntas na ordem. A primeira que fornecer uma resposta firme é a decisão.

• Você precisa de regras de permissão nas quais outra pessoa possa confiar? Então use o Claude Code. Sua documentação de permissões define seis modos — default (rotulado como Manual), acceptEdits, plan, auto, dontAsk e bypassPermissions — e afirma que "As regras de permissão são aplicadas pelo Claude Code, não pelo modelo", com regras de permitir, perguntar e negar que você pode versionar ou definir em configurações gerenciadas. A página de segurança do Pi, reescrita na atualização da documentação de 22 de setembro de 2026, diz o oposto em termos claros: "O Pi pode ler, alterar e executar arquivos com as permissões da conta que o iniciou e não pede aprovação antes de cada chamada de ferramenta", e lista a "ausência de um sandbox integrado" entre os comportamentos geralmente fora de seu limite de segurança. Sua página de uso resume a mesma coisa em uma linha: "O Pi não pergunta antes de cada chamada de ferramenta."
• Você precisa executar modelos de mais de um laboratório em um único cliente? Então use o Pi. O esquema de provedores personalizados aceitava openai-completions, openai-responses, anthropic-messages e google-generative-ai quando a documentação listava valores pela última vez, antes da atualização de 22 de setembro de 2026, e seu código-fonte na v0.99.2 despacha dez. A página de gateway da Anthropic diz que ela "não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de nenhum gateway".
• Você quer subagentes, modo de planejamento e tarefas pendentes sem precisar criá-los? Então, Claude Code. Até a atualização da documentação de 22 de setembro de 2026, a página de uso do Pi dizia que "Ele intencionalmente não inclui MCP integrado, subagentes, pop-ups de permissão, modo de planejamento, tarefas pendentes ou bash em segundo plano"; a atualização removeu essa frase, e o MCP não faz mais parte da lista — desde a v0.99.0, a página de MCP do Pi diz que ele "se conecta a servidores do Model Context Protocol por stdio ou HTTP transmitível e disponibiliza suas ferramentas e recursos para o modelo". Subagentes, modo de planejamento e tarefas pendentes ainda não são integrados na v0.99.2; o repositório os disponibiliza apenas como extensões de exemplo.
• O próprio agente precisa estar aberto? Então, Pi: MIT no npm e no repositório, com possibilidade de fork e acionável por outro processo por meio de --mode rpc. A licença do Claude Code reserva todos os direitos.
• Você precisa do aplicativo para desktop, da interface web ou do Remote Control? Então, Claude Code, e não por meio do seu próprio endpoint. Sua visão geral diz que "A maioria das interfaces exige uma assinatura do Claude ou uma conta do Anthropic Console. A CLI do Terminal, o VS Code e o JetBrains também são compatíveis com provedores terceirizados", e a aba de desktop acrescenta que é necessária uma assinatura paga. Remote Control é o caso separado: a referência de variáveis de ambiente da Anthropic afirma que "A partir da v2.1.196, o Remote Control fica desativado quando isso aponta para um host diferente de api.anthropic.com".

Nada disso determina qual deles escreve código melhor. Nenhuma comparação controlada entre os dois foi realizada para esta página, e nada abaixo deve ser interpretado como tal.

Lado a lado

Linhas extraídas do guia de início rápido do Pi, das páginas de uso e segurança e da documentação de visão geral, permissões e custos do Claude Code, em 19 de setembro de 2026; as linhas de permissões e MCP do Pi foram verificadas novamente em 1º de outubro de 2026 contra o Pi v0.99.2.

O modelo de execução é a verdadeira diferença

A lista de omissões do Pi costumava parecer uma especificação, e não recursos ausentes: até a atualização da documentação de 22 de setembro de 2026, sua página de uso nomeava seis coisas que a maioria dos compradores presume que todo agente tenha — MCP integrado, subagentes, pop-ups de permissão, modo de planejamento, tarefas pendentes e bash em segundo plano — e dizia que ele os deixava de fora de propósito. A atualização removeu essa frase e, uma semana depois, a v0.99.0 trouxe um dos seis: o MCP agora é uma extensão integrada que carrega por padrão, configurada com pi mcp add ou um arquivo mcp.json. O restante da lista ainda descreve a v0.99.2. Se seu fluxo de trabalho depende de uma etapa de planejamento antes das edições ou de um aviso de permissão ao qual você possa responder não, o Pi pede que você crie ou instale isso, e não que o configure.

O Claude Code está no extremo oposto. As regras são avaliadas pelo cliente, a negação tem precedência e um hook PreToolUse não pode substituir uma regra de negação — portanto, elas sobrevivem ao que quer que o prompt ou CLAUDE.md diga, que é o que as torna úteis para uma organização, e não apenas para um desenvolvedor. O conceito mais próximo do Pi, confiança no projeto, é mais restrito por sua própria descrição: "A confiança no projeto controla se o Pi carrega a maioria das configurações e recursos fornecidos por uma pasta de trabalho. Ela impede que uma pasta carregue silenciosamente extensões executáveis antes que você as aprove." A mesma página é explícita sobre o limite: "A confiança no projeto não limita o que as chamadas de ferramentas podem acessar ou afetar."

Nenhuma das duas abordagens está errada, mas apenas uma responde a uma pergunta de auditoria. Resolva isso antes de comparar preços: a configuração não consegue fechar essa lacuna.

Apontando cada cliente para seu próprio endpoint

Esta é a segunda diferença estrutural, e ela funciona no sentido oposto. O Claude Code usa uma variável de ambiente e uma família de protocolos; o Pi usa um arquivo JSON e os quatro protocolos que documentava até 22 de setembro de 2026 — e o código-fonte aceita mais.

A coluna do Claude Code vem de sua referência de variáveis de ambiente e do guia de compatibilidade com gateways, verificados em 19 de setembro de 2026. Vale explicar a linha "desativa", porque cada item é um recurso perdido silenciosamente, e não um erro que você vê. Um ANTHROPIC_BASE_URL que não seja de primeira parte desativa a pesquisa de ferramentas MCP por padrão, reativada com ENABLE_TOOL_SEARCH=true se o proxy encaminhar blocos tool_reference; a partir da v2.1.196, o Remote Control fica desativado quando essa variável aponta para qualquer lugar diferente de api.anthropic.com; a transmissão granular de ferramentas fica desativada por padrão; e a descoberta de modelos exige ativação, com CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 enviando GET /v1/models?limit=1000 em um tempo limite de três segundos, tratando qualquer redirecionamento como falha e mantendo apenas entradas cujo ID contenha claude ou anthropic. Duas verificações ignoram totalmente a variável e chamam api.anthropic.com diretamente — a verificação de disponibilidade do modo rápido e a verificação de segurança de domínio do WebFetch — portanto, uma rede que bloqueie esse host as interrompe mesmo enquanto a inferência funciona.

A linha da credencial importa para o faturamento, não apenas para a autenticação. A página de gateway da Anthropic é explícita: enquanto uma credencial de gateway está ativa, "a credencial substitui o login da assinatura nessa sessão, e os limites de uso da assinatura não se aplicam", e esse tráfego é cobrado por token de quem possui a credencial. Definir apenas a URL base não faz isso — um login salvo do claude.ai continua sendo a credencial ativa e seus limites ainda se aplicam.

# Claude Code: two environment variables, and whatever answers at that
# origin has to speak the Anthropic Messages API.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin only, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...              # replaces the subscription

# Pin models Kunavo serves: Claude Code's default and its opus alias are the
# newest Opus, and if Kunavo does not serve it yet, the first request 404s.
# The sonnet alias asks for Sonnet 5.5, which Kunavo does not serve: unpinned,
# /model sonnet, opusplan's execution phase and sonnet subagents all 404.
# Opus 5.5 needs Claude Code v2.1.280 or later (run `claude update`).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

A origem não tem /v1: clientes no estilo Anthropic acrescentam /v1/messages por conta própria, portanto https://api.kunavo.com/v1 gera solicitações para /v1/v1/messages e um 404. Consulte a página da URL base e o guia de configuração do Claude Code. Mais uma consequência específica do Kunavo: esta API não oferece a rota /v1/messages/count_tokens, e o guia de compatibilidade do Claude Code diz que os endpoints de contagem de tokens são os únicos opcionais — sem ele, "o Claude Code recorre a uma estimativa baseada em caracteres do uso do contexto", portanto /context mostra contagens aproximadas.

A versão do Pi para o mesmo trabalho é um arquivo e, como aceita APIs no formato OpenAI, pode usar a rota que o Claude Code não oferece:

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

Observe o /v1 final. Um provedor openai-completions espera https://api.kunavo.com/v1. Para o formato anthropic-messages, a documentação do Pi nunca resolveu a questão: até a atualização da documentação de 22 de setembro de 2026, a documentação de modelos do Pi mostrava as duas grafias em seus próprios exemplos — https://proxy.example.com/v1 nos cabeçalhos personalizados e um https://proxy.example.com simples na compatibilidade com Anthropic Messages — e a atualização removeu ambas sem resolver a questão; portanto, se a primeira chamada retornar 404, esta é a linha a alterar. Mais duas armadilhas específicas do Pi, que o código-fonte do Pi (v0.99.2) ainda define embora a documentação atualizada não as detalhe: o bloco cost de um modelo personalizado assume zero em todas as categorias de tarifa, portanto um provedor adicionado por você informa $0 no rodapé, que o Pi documenta como o custo da sessão, até você inserir as tarifas; e contextWindow e maxTokens assumem silenciosamente 128.000 e 16.384, portanto defina ambos para a janela publicada na página do modelo no catálogo. A precedência das credenciais é documentada e vale conhecer quando uma chave antiga vence: desde a atualização, a página de modelos do Pi diz que usa "primeiro um --api-key em tempo de execução, depois uma credencial auth.json armazenada, um apiKey de models.json e, por fim, as variáveis de ambiente do provedor ou credenciais de nuvem disponíveis no ambiente".

Planos e cobranças por token na mesma página

Nenhum dos clientes cobra por si só; portanto, toda a diferença de custo está na camada que você compra. O Pi não tem nada para comprar: ele é licenciado sob MIT, e o pi.dev não publica nenhum plano, nível, assento ou serviço hospedado. O Claude Code pode ser instalado gratuitamente e então precisa obter acesso de algum lugar.

Todos os valores dos planos da Anthropic foram obtidos de claude.com/pricing em 19 de setembro de 2026. Duas lacunas honestas: a página Max não publica um preço separado para o nível 20x, portanto qualquer "$200 para Max 20x" que você leia em outro lugar não vem dessa página; e o valor do assento premium realmente difere entre a página de preços e a visão geral da implantação empresarial, que mostra "Teams: $150/assento (Premium) com PAYG disponível". Nenhuma das duas questões é resolvida aqui — verifique o valor que o checkout efetivamente cotar para você. Nenhuma página da Anthropic encontrada nesta verificação publica horas, mensagens ou contagens de tokens para Pro, Max 5x ou Max 20x; portanto, nenhum valor de uso aparece nesta página.

Quanto custam os tokens

Coloque os dois clientes no mesmo endpoint e eles pagarão a mesma tarifa por token; o que difere entre eles é quanto contexto cada um reenvia a cada etapa, o que depende muito mais do seu repositório do que da ferramenta e não foi medido aqui.

A tabela abaixo é uma aritmética ilustrativa de tokens, não um custo de tarefa medido nem um limite de cobrança. Suponha um dia útil de uso do agente: 12 turnos, cada um enviando 60.000 tokens de entrada não armazenados em cache e recebendo 3.000 tokens de saída, totalizando 720.000 tokens de entrada e 36.000 de saída, sem leituras de cache, gravações de cache, imagens ou cobranças de ferramentas. As tarifas do Kunavo são renderizadas a partir do catálogo ativo; a coluna do fornecedor é claude.com/pricing, verificada em 19 de setembro de 2026.

Leia as linhas, e não a classificação. Claude Sonnet 5 aparece com o mesmo valor nas duas colunas, portanto, para esse modelo, a rota não é uma questão de preço; Claude Opus 5 é onde as duas colunas se separam. Dimensione pelos seus próprios dias úteis antes de tratar qualquer valor como orçamento — e observe que isso pressupõe nenhum armazenamento em cache, a maior omissão isolada. A própria página de custos da Anthropic afirma que a vida útil do cache de prompts "é de uma hora em uma assinatura e cai para cinco minutos quando você passa a usar créditos de uso; com uma chave de API ou provedor de nuvem, são cinco minutos por padrão", portanto a forma de pagamento altera a taxa de acertos do cache e, consequentemente, a cobrança. As cobranças de cache do Kunavo estão documentadas em caching; não foi testado se o PI_CACHE_RETENTION=long do Pi alcança este endpoint.

Como referência publicada, e não como aritmética, a documentação de custos da Anthropic informa que "Em implantações empresariais, o custo médio é de cerca de $13 por desenvolvedor por dia ativo e $150–250 por desenvolvedor por mês, com custos abaixo de $30 por dia ativo para 90% dos usuários", com processos em segundo plano normalmente abaixo de $0,04 por sessão. Esse é o valor da Anthropic para o Claude Code em seu próprio faturamento; não existe valor equivalente para o Pi, porque ninguém publica um. O valor do catálogo do Kunavo é um piso de cobrança, não um teto — quando o upstream informa sua cobrança, a fatura é o maior entre o custo do catálogo e o custo do upstream multiplicado pelo markup aplicável, como explica o faturamento — e a recarga mínima é de $10 em crédito pré-pago, um mínimo de financiamento, não uma taxa de tarefa nem uma assinatura.

A questão da assinatura que ninguém pode resolver por você

Ambos os clientes podem ser usados com login de um plano Claude, e três fontes oficiais descrevem de maneira diferente o que isso faz. Elas são citadas aqui com suas datas, sem resolução, porque resolvê-las externamente seria um palpite.

Nenhuma página da Anthropic menciona especificamente o Pi, e a permissão do artigo de login é discricionária, não uma garantia. O único ponto em que as três concordam é a direção: uma credencial de API é a rota preferida pela Anthropic para um cliente de terceiros e, no Claude Code, uma credencial de gateway remove completamente a assinatura da sessão. Verifique Configurações e depois Uso na sua própria conta antes de encaminhar trabalho pago por um plano. Limites do plano Claude aborda o lado da assinatura, e Preços do Pi detalha as quatro formas de pagar pelo Pi.

Quanto realmente custa mudar entre eles

Menos do que as listas de recursos sugerem, em uma direção. O contexto do repositório é transferido sem alterações: o Pi carrega AGENTS.md ou CLAUDE.md dos diretórios atual e pai, com ~/.pi/agent/AGENTS.md para instruções globais, portanto um repositório já configurado para o Claude Code não precisa de edições para ser lido pelo Pi. O uso com scripts também tem um equivalente nos dois lados — claude -p e pi -p, com o Pi acrescentando --mode json e --mode rpc para integração com processos.

O que não é transferido é a maior parte da seção sobre o modelo de execução: regras de permissão, definições de subagentes e modo de planejamento não têm um equivalente integrado no Pi para migração — o repositório os disponibiliza apenas como extensões de exemplo — e as interfaces desktop e web não têm nenhum deles. Os servidores MCP são a exceção desde a v0.99.0: para uma entrada do Claude Code, a página de MCP do Pi diz: "Copie a entrada mcpServers existente." No sentido inverso, uma extensão do Pi não tem equivalente no Claude Code para instalar. Nenhuma estimativa de horas ou dias para a mudança é oferecida aqui, porque não há base para uma — execute uma tarefa real e delimitada em cada um antes de transferir trabalho agendado.

Se você estiver fazendo uma lista mais ampla, Pi vs OpenCode e OpenCode vs Claude Code cobrem os dois pares adjacentes, e Alternativas ao Claude Code separa primeiro a questão da ferramenta da questão do faturamento. Para o endpoint em si, o guia de configuração do Claude Code é a referência de configuração publicada, e criar uma conta Kunavo fornece uma chave para testar uma tarefa.

Perguntas frequentes

A documentação e os preços dos planos foram verificados em 19 de setembro de 2026 e reconfirmados em 21 de setembro de 2026: as páginas de início rápido, uso, modelos, provedores e segurança do pi.dev; as páginas de visão geral, permissões, custos, variáveis de ambiente, gateway e compatibilidade com gateways do code.claude.com; claude.com/pricing; e dois artigos de suporte em support.claude.com. Os números de versão, o arquivo de licença de anthropics/claude-code e a API do GitHub para earendil-works/pi foram consultados novamente 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 do anthropic-messages foram verificados novamente na página de modelos em 1º de outubro de 2026, assim como os padrões de modelos personalizados no código-fonte da v0.99.2. No mesmo dia, após o Pi v0.99.0 trazer MCP integrado, suas páginas de segurança, uso, MCP e configurações e a visão geral da documentação foram relidas para as afirmações sobre sandbox, permissões, confiança no projeto e recursos omitidos; a lista de APIs foi conferida com o código-fonte da v0.99.2; e a linha sobre uso adicional foi conferida com o aviso do terminal nesse código-fonte. As tarifas de tokens do Kunavo são renderizadas a partir do catálogo ativo e todo valor em dólar aqui é aritmética ilustrativa de tokens, não um custo de tarefa medido. Nenhum dos clientes foi testado em tempo de execução contra o Kunavo, e nenhuma comparação de qualidade, velocidade ou benchmark entre eles foi realizada.