Resposta rápida: O confronto Pi vs Claude Code se resume a padrões predefinidos versus controle. O Pi é um agente de programação para terminal gratuito e sob licença MIT que vem enxuto, dispensa subagentes, modo de planejamento e pop-ups de permissão, permitindo que você adicione o que quiser por meio de extensões em TypeScript. Já o Claude Code traz esses fluxos de trabalho integrados de fábrica. O Pi custa US$ 0 para instalar; você paga apenas pelo provedor de modelos que conectar.
Uma discussão no Hacker News intitulada “Goodbye Claude, hello Pi” ultrapassou 700 pontos e 430 comentários esta semana — o que é muita gente discutindo sobre um programa de terminal. Se você usa agentes de código diariamente, a pergunta por trás disso é essencial: o seu harness (o programa que envolve o modelo, as ferramentas e o prompt) é algo que você configura ou algo que você simplesmente aceita?
Este guia aborda o que é o Pi, quanto custa, como configurá-lo e traz uma comparação sincera com o Claude Code, incluindo as queixas de ambos os lados daquela discussão. No final, mostramos como executar os dois sem precisar reconstruir seu fluxo de trabalho, já que o Sharkly lista o Pi e o Claude Code como Runtimes no mesmo Computer.
O que é o agente de código Pi?
O Pi é “um harness de agente minimalista e extensível que você pode personalizar como quiser”. Ele roda no seu terminal, lê e edita arquivos, executa comandos e se comunica com o modelo que você escolher. Mario Zechner deu início ao projeto no repositório pi-mono; hoje ele é mantido pela Earendil, e a versão atual no npm é a 1.5.0.
Quatro características definem o projeto:
- Neutro em relação a provedores. O site do Pi lista mais de 15 provedores e centenas de modelos: Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, OpenRouter, Ollama e muito mais. Você pode alternar de modelo no meio da sessão usando
/model. - Propositalmente minimalista. A lista “O que não construímos” no site menciona subagentes, pop-ups de permissão, modo de planejamento, listas de tarefas integradas e bash em segundo plano.
- Extensível em TypeScript. Extensões podem registrar ferramentas, comandos, atalhos, provedores e interfaces de terminal. Habilidades (skills), modelos de prompt e temas são distribuídos como pacotes do Pi via npm ou git.
- Programável via scripts. TUI interativa, modos print e JSON (
pi -p), protocolo RPC via stdin e stdout e um SDK em TypeScript.
As sessões são armazenadas como árvores, permitindo que o comando /tree retorne a um ponto anterior e crie uma ramificação a partir dali. Um participante do HN comentou que “não consegue mais viver sem o /tree”.
O Pi é gratuito?
Sim. O Pi possui licença MIT e custa US$ 0 para instalar. Você paga apenas pelo modelo. O guia de início rápido afirma que você precisa de acesso a um modelo “por meio de um provedor compatível. Pode ser uma assinatura, uma chave de API ou um modelo local”.
Isso oferece três alternativas de custo:
| Route | What you pay | Setup |
|---|---|---|
| Chave de API | Preço por token cobrado pelo provedor | export ANTHROPIC_API_KEY=... then pi |
Assinatura via /login |
Seu plano existente | /login, pick a provider, follow the OAuth flow |
| Modelo local (Ollama, llama.cpp) | Seu hardware | Point Pi at the local server |
Um alerta sobre a opção de assinatura: um usuário que defendia o Claude Code apontou um “potencial banimento por violação dos Termos de Serviço” ao usar uma assinatura em um harness de terceiros. A documentação do Pi não resolve essa questão por você. Leia os termos do seu provedor antes de fazer login com um plano pago ou use uma chave de API, que não apresenta essa ambiguidade.
Como configurar o Pi
A configuração exige apenas dois comandos caso você já tenha o Node.js 22.19 ou mais recente.
# Option 1: the installer (pins dependencies, updates with `pi update`)
curl -fsSL https://pi.dev/install.sh | sh
# Option 2: npm
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# Start it in your project
cd ~/code/my-service
pi
Dentro do Pi, execute /login para conectar um provedor e /model para escolher um modelo. O Pi carrega os arquivos de contexto AGENTS.md e CLAUDE.md, portanto, um repositório já configurado para o Claude Code mantém todas as suas instruções.
Antes de iniciar sua primeira tarefa real, leia a página de segurança do Pi. Ela adverte que o Pi “não solicita aprovação antes de cada chamada de ferramenta” e é executado com as permissões da conta que o iniciou. A documentação destaca que um contêiner, máquina virtual ou sandbox é “geralmente a opção prática mais segura”.
Pi vs Claude Code: uma comparação sincera
O Claude Code é o agente de programação da Anthropic. Ele já vem com subagentes, hooks, MCP, modo de planejamento e um sistema de permissões que solicita confirmação antes de ações arriscadas. O Pi traz um núcleo mais enxuto e parte do princípio de que você adicionará o que precisar.
| Pi | Claude Code | |
|---|---|---|
| Licença | MIT | Proprietária, da Anthropic |
| Modelos | Mais de 15 provedores, modelos locais | Modelos Claude |
| Subagentes | Não integrados; adicione via extensão | Integrados |
| Modo de planejamento | Não integrado | Integrado |
| Avisos de permissão | Nenhum por design; isole com um contêiner | Aprovações configuráveis |
| Personalização | Extensões em TypeScript, pacotes | Hooks, MCP, skills, configurações |
| Uso headless | Print, JSON, RPC, SDK | Modo print, Agent SDK |
Por que os desenvolvedores dizem estar migrando
O artigo que originou a discussão, Goodbye Claude, hello Pi de Caleb, atribui a mudança a “um acúmulo de muitas pequenas frustrações”, e não a um bug isolado. Os motivos apontados:
- Instabilidade de prompts (prompt churn). O autor contabilizou 244 versões do Claude Code este ano e afirma que mais de três quartos delas alteraram o prompt do sistema ou a descrição de ferramentas, o que pode mudar o comportamento do modelo em um ambiente previamente ajustado.
- Sobrecarga de tokens. A descrição padrão da ferramenta Bash consome “quase 3.000 tokens” segundo a contagem do autor, principalmente com instruções sobre git e pull requests.
- Atrito com a IDE. Apenas uma sessão do VS Code conseguia se conectar por vez. O autor resolveu isso no Pi com uma extensão criada em cerca de 20 minutos.
- Escopo. Para o autor, recursos como equipes de agentes e modos de revisão parecem voltados ao consumo corporativo de tokens, e não às necessidades de um único desenvolvedor.
Outros comentaristas mencionaram bugs na renderização do terminal e na rolagem de histórico, além da demora no suporte ao AGENTS.md.
Por que alguns desenvolvedores continuam no Claude Code
A mesma discussão traz contra-argumentos. Um comentarista afirmou que o Pi “exige uma quantidade enorme de adaptações manuais” para alcançar os recursos do Claude Code e classificou as extensões como “praticamente inevitáveis”. Ele também avaliou melhor a compactação e o cache de prompts do Claude Code com os modelos da Anthropic. Outros lembraram que instalar extensões de terceiros significa confiar em códigos que têm acesso aos seus tokens de OAuth.
Há também um argumento financeiro. Um dos participantes prefere continuar no Claude Code devido aos “subsídios absurdos que recebemos” na assinatura, em comparação com o pagamento por token. Se você atingir os limites, o nosso guia sobre os limites de uso do Claude Code explica o que cada plano permite.
Qual deles é ideal para você?
Escolha o Pi se quiser ter total controle sobre o harness, alternar entre modelos livremente, manter o prompt enxuto e estável e se sentir confortável rodando agentes dentro de um contêiner. Escolha o Claude Code se preferir subagentes, modo de planejamento e avisos de aprovação prontos para uso desde o primeiro dia, e se utiliza principalmente modelos Claude. Muitos desenvolvedores optarão por manter os dois, e é aí que entra a próxima seção.
Execute o Pi e o Claude Code lado a lado no Sharkly
Trocar de harness é simples. Trocar o sistema de trabalho ao redor dele, não. Tarefas, contexto, progresso e revisões costumam ficar presos à sessão de um único agente; logo, um novo agente implica um novo fluxo de trabalho.
O Sharkly atua como a camada acima do agente. Você cria uma tarefa, atribui-a a um Agent, e esse Agent é executado em um Computer (um notebook, servidor ou VM que você conecta) por meio de um Runtime (o agente de código instalado nele). A lista de Runtimes em um Computer já inclui o Claude Code, e o Pi agora figura entre os Runtimes compatíveis:
Para testar, instale o Pi no Computer e clique em Detect again na página de detalhes do Computer. A documentação do Sharkly explica os status: um Runtime sinalizado como Not installed precisa que a ferramenta seja instalada, e somente um Runtime Available pode executar as tarefas do Agent.
# On the Computer that runs your agents
curl -fsSL https://pi.dev/install.sh | sh
sharkly computer register --install-token <install-token> # once per Computer
sharkly computer list # confirm it is online
A partir daí, o mesmo quadro de tarefas abastece ambos os agentes. Delegue uma refatoração a um Agent no Claude Code e uma atualização de dependências a um Agent no Pi, revisando os dois resultados em um único lugar. O consumo de modelos permanece no plano ou na chave que cada Runtime já utiliza, pois o Sharkly não comercializa tokens. O plano Free custa US$ 0 para organizações com até 5 pessoas, de acordo com a página de preços (consultada em 9 de novembro de 2026).
Para saber mais sobre como executar vários agentes simultaneamente, consulte nosso artigo sobre como executar múltiplos agentes do Claude Code.
Configurações no mundo real
- Desenvolvedor solo atento aos custos. Pi com um modelo local para tarefas exploratórias; Claude Code para refatorações complexas.
- Equipe com preferências diversas. Alguns engenheiros usando o Pi, outros no Claude Code, com todas as tarefas reunidas em um único quadro para que ninguém precise perguntar “em qual sessão isso estava?”.
- Automação. Os modos JSON e RPC do Pi são ideais para execuções programadas por scripts; direcione os resultados de volta para uma tarefa em vez de deixá-los em um arquivo de log.
Conclusão
O Pi e o Claude Code respondem a perguntas distintas. O Pi desafia o quão enxuto um harness pode ser quando você se dispõe a construir o restante. O Claude Code investiga quanto fluxo de trabalho pode ser entregue pronto para uso. Nenhuma das escolhas precisa ser definitiva. Instale o Pi em um Computer hoje mesmo, atribua a ele uma tarefa de baixo risco no Sharkly e compare o resultado com a mesma tarefa no Claude Code.
Perguntas frequentes
O Pi é melhor que o Claude Code?
Nenhum dos dois vence de forma absoluta. O Pi é mais enxuto, neutro em relação a provedores e extensível; o Claude Code oferece subagentes, modo de planejamento e avisos de aprovação integrados. A melhor escolha depende de você preferir construir seu próprio fluxo de trabalho ou adotar um pronto.
O Pi é de código aberto?
O Pi possui licença MIT, e seu código-fonte está no GitHub sob earendil-works/pi. Os modelos conectados mantêm seus respectivos termos e licenças.
Posso usar minha assinatura do Claude com o Pi?
O comando /login do Pi oferece suporte a assinaturas via OAuth para provedores integrados. Verifique os termos do seu provedor antes de usar um plano de usuário final em um harness de terceiros; o uso de uma chave de API elimina essa dúvida.
O Pi tem suporte ao MCP?
Sim. O site do Pi informa que o MCP agora é integrado de fábrica, mantendo também a compatibilidade com extensões MCP. Versões anteriores não contavam com esse recurso.
O Pi lê o CLAUDE.md?
Sim. A documentação de segurança do Pi lista AGENTS.override.md, AGENTS.md e CLAUDE.md como arquivos de contexto que ele carrega.
É seguro rodar o Pi no meu computador?
O Pi não solicita confirmação antes de cada chamada de ferramenta. Sua documentação recomenda o uso de um contêiner, máquina virtual ou sandbox como o limite prático de segurança mais confiável.
Quem desenvolve o Pi?
Mario Zechner criou o Pi. Atualmente, o projeto é publicado pela Earendil Inc. e mantido por contribuidores.
