Hızlı yanıt: Pi ile Claude Code arasındaki fark, temel olarak varsayılan ayarlar ile tam kontrol arasındaki tercihe dayanıyor. Pi; alt ajanları (sub-agents), plan modunu ve izin pencerelerini atlayan, sade bir yapıyla gelen ve istediğiniz özellikleri TypeScript uzantıları olarak eklemenize olanak tanıyan, MIT lisanslı ve ücretsiz bir terminal kodlama ajanıdır. Claude Code ise bu iş akışlarını yerleşik olarak sunar. Pi'yi kurmak tamamen ücretsizdir ($0); yalnızca bağladığınız model sağlayıcısının ücretini ödersiniz.
Bu hafta Hacker News'te “Goodbye Claude, hello Pi” başlıklı bir tartışma konusu 700 puanı ve 430 yorumu aştı; bu da bir terminal programı için epey geliştiricinin tartıştığı anlamına geliyor. Her gün kodlama ajanları kullanıyorsanız, bu tartışmanın ardındaki soru oldukça kritik: Kullandığınız harness (modeli, araçları ve prompt'u bir araya getiren program) sizin yapılandırdığınız bir şey mi, yoksa olduğu gibi kabullenmek zorunda kaldığınız bir sistem mi?
Bu rehber; Pi'nin ne olduğunu, maliyetini, nasıl kurulacağını ve ilgili tartışma konusundaki iki tarafın da dile getirdiği eleştiriler dahil olmak üzere Claude Code ile dürüst bir karşılaştırmasını kapsıyor. Sharkly hem Pi'yi hem de Claude Code'u aynı Computer üzerinde Runtime olarak listelediğinden, rehberin sonunda iş akışınızı sıfırdan kurmak zorunda kalmadan her ikisini nasıl birlikte çalıştırabileceğiniz de anlatılıyor.
Pi kodlama ajanı nedir?
Pi, “kendi ihtiyaçlarınıza göre uyarlayabileceğiniz minimal ve genişletilebilir bir ajan harness'ı” olarak tanımlanıyor. Terminalinizde çalışır; dosyaları okuyup düzenler, komutları çalıştırır ve seçtiğiniz modelle iletişim kurar. Projeyi Mario Zechner pi-mono deposunda başlattı; artık Earendil bünyesinde yer alıyor ve güncel npm sürümü 1.5.0.
Onu tanımlayan dört temel özellik bulunuyor:
- Sağlayıcıdan bağımsız (Provider neutral). Pi web sitesi 15'ten fazla sağlayıcıyı ve yüzlerce modeli listeliyor: Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, OpenRouter, Ollama ve daha fazlası. Oturumun ortasında
/modelkomutuyla model değiştirebilirsiniz. - Bilinçli olarak yalın. Sitedeki “Geliştirmediklerimiz” listesinde alt ajanlar, izin pencereleri, plan modu, yerleşik yapılacaklar listeleri ve arka planda çalışan bash süreçleri yer alıyor.
- TypeScript ile genişletilebilir. Eklentilerle yeni araçlar, komutlar, kısayollar, sağlayıcılar ve terminal kullanıcı arayüzleri kaydedebilirsiniz. Beceriler (skills), prompt şablonları ve temalar, npm veya git üzerinden Pi paketleri olarak dağıtılır.
- Betiklerle yönetilebilir (Scriptable). Etkileşimli TUI, yazdırma ve JSON modları (
pi -p), stdin ve stdout üzerinden çalışan bir RPC protokolü ve bir TypeScript SDK'sı sunar.
Oturumlar ağaç yapısı olarak saklanır; bu sayede /tree komutu önceki bir noktaya dönmenizi ve oradan yeni dallar oluşturmanızı sağlar. Bir Hacker News yorumcusu, “/tree olmadan yaşayamayacağını” belirtti.
Pi ücretsiz mi?
Evet. Pi, MIT lisanslıdır ve kurulumu tamamen ücretsizdir. Yalnızca kullandığınız model için ödeme yaparsınız. Hızlı başlangıç kılavuzunda, modele erişimin “desteklenen bir sağlayıcı üzerinden sağlanması gerektiği; bunun bir abonelik, API anahtarı veya yerel bir model olabileceği” belirtiliyor.
Bu da karşınıza üç maliyet seçeneği çıkarıyor:
| Yöntem | Ödediğiniz tutar | Kurulum |
|---|---|---|
| API anahtarı | Sağlayıcının token başına fiyatlandırması | export ANTHROPIC_API_KEY=... ardından pi |
/login ile abonelik |
Mevcut abonelik planınız | /login çalıştırın, bir sağlayıcı seçin ve OAuth akışını izleyin |
| Yerel model (Ollama, llama.cpp) | Yalnızca kendi donanımınız | Pi'yi yerel sunucuya yönlendirin |
Abonelik yöntemiyle ilgili önemli bir uyarı: Claude Code'u savunan bir yorumcu, bir aboneliğin üçüncü taraf bir harness içinde kullanılması durumunda “hizmet şartlarının (ToS) ihlali nedeniyle olası bir hesap kapatma riski” bulunduğuna dikkat çekti. Pi'nin belgeleri bu konuyu sizin adınıza netleştirmiyor. Ücretli bir planla giriş yapmadan önce sağlayıcınızın kullanım şartlarını okuyun ya da bu tür bir belirsizlik taşımayan API anahtarını tercih edin.
Pi nasıl kurulur?
Node.js 22.19 veya daha yeni bir sürüme sahipseniz kurulum iki komuttan ibarettir.
# 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
Pi içinde bir sağlayıcıya bağlanmak için /login, bir model seçmek içinse /model komutunu çalıştırın. Pi, AGENTS.md ve CLAUDE.md bağlam dosyalarını otomatik olarak yükler; böylece Claude Code için zaten yapılandırılmış bir depo mevcut talimatlarını korur.
İlk gerçek görevinize başlamadan önce Pi'nin güvenlik sayfasını mutlaka okuyun. Dokümantasyonda Pi'nin “her araç çağrısından önce onay istemediği” ve kendisini başlatan hesabın izinleriyle çalıştığı belirtiliyor. Belgelerde bir container, sanal makine (VM) veya korumalı alanın (sandbox) “genellikle en güçlü pratik çözüm” olduğu ifade ediliyor.
Pi ile Claude Code karşılaştırması: Dürüst bir değerlendirme
Claude Code, Anthropic'in kodlama ajanıdır. Alt ajanlar (sub-agents), kancalar (hooks), MCP, plan modu ve riskli eylemlerden önce onay isteyen bir izin sistemi ile birlikte gelir. Pi ise daha yalın bir çekirdekle gelir ve ihtiyaç duyduğunuz şeyleri sizin eklemenizi bekler.
| Pi | Claude Code | |
|---|---|---|
| Lisans | MIT | Tescilli (Anthropic) |
| Modeller | 15'ten fazla sağlayıcı, yerel modeller | Claude modelleri |
| Alt ajanlar | Yerleşik değil; eklentiyle eklenebilir | Yerleşik |
| Plan modu | Yerleşik değil | Yerleşik |
| İzin onayları | Tasarım gereği yok; container ile izole edilir | Yapılandırılabilir onaylar |
| Özelleştirme | TypeScript eklentileri, paketler | Kancalar (hooks), MCP, beceriler (skills), ayarlar |
| Arayüzsüz (Headless) kullanım | Yazdırma (Print), JSON, RPC, SDK | Yazdırma modu, Agent SDK |
Geliştiriciler neden geçiş yaptıklarını söylüyor?
Tartışmanın arkasındaki yazı olan Caleb'in Goodbye Claude, hello Pi başlıklı makalesi, tek bir hatayı değil “birçok küçük hayal kırıklığının birikmesini” gerekçe gösteriyor. Öne çıkan detaylar şunlar:
- Prompt istikrarsızlığı (Prompt churn). Yazar, Claude Code'un bu yıl 244 sürüm çıkardığını ve bunların dörtte üçünden fazlasının sistem prompt'unu veya araç açıklamalarını değiştirdiğini, bunun da hassas şekilde ayarlanmış bir sistemde model davranışını değiştirebileceğini belirtiyor.
- Gereksiz token yükü (Token overhead). Yazarın tespitine göre varsayılan Bash aracı açıklaması —çoğunlukla git ve pull request'lerle ilgili kısımlar yüzünden— “neredeyse 3.000 token” tutuyor.
- IDE uyumsuzlukları. Aynı anda yalnızca tek bir VS Code oturumu bağlanabiliyordu. Yazar, bu sorunu Pi'de yaklaşık 20 dakikada yazdığı bir eklentiyle çözdü.
- Kapsam karmaşası. Ajan ekipleri ve inceleme modları, yazara göre tek bir geliştiriciden ziyade kurumsal düzeydeki token tüketimini artırmaya yönelik görünüyor.
Diğer yorumcular ise terminal render ve geri kaydırma (scrollback) hatalarına ve AGENTS.md desteğinin geç gelmesine değindi.
Bazı geliştiriciler neden Claude Code'da kalıyor?
Aynı tartışma konusunda karşı görüşler de yer alıyor. Bir yorumcu, Pi'nin Claude Code'un yeteneklerine ulaşması için “muazzam miktarda ince ayar ve geliştirme gerektiğini” belirterek eklentileri “neredeyse kaçınılmaz” olarak nitelendirdi. Aynı kullanıcı, Claude Code'un Anthropic modelleri üzerindeki sıkıştırma (compaction) ve prompt önbellekleme (prompt caching) performansını daha başarılı bulduğunu aktardı. Diğerleri ise üçüncü taraf eklentiler kurmanın, OAuth token'larınızı görebilecek bir koda güvenmek anlamına geldiğine dikkat çekti.
Maliyet tarafında da güçlü bir argüman var. Bir yorumcu, token başına ödeme yapmaya kıyasla abonelikte “sunulan inanılmaz sübvansiyonlar” nedeniyle Claude Code kullanmaya devam ettiğini belirtiyor. Limitlere takılıyorsanız, Claude Code kullanım limitleri rehberimiz her planın sunduğu sınırları ayrıntılarıyla ele alıyor.
Hangisi sizin için daha uygun?
Harness'ın kontrolünün tamamen sizde olmasını, modeller arasında dilediğiniz gibi geçiş yapabilmeyi, prompt'u küçük ve kararlı tutmayı istiyorsanız ve ajanları bir container içinde çalıştırmaktan çekinmiyorsanız Pi'yi seçin. Alt ajanların, plan modunun ve onay pencerelerinin ilk günden hazır şekilde çalışmasını istiyorsanız ve zaten ağırlıklı olarak Claude modellerini kullanıyorsanız Claude Code'u tercih edin. Pek çok geliştirici her ikisini birden kullanmaya devam edecek; sıradaki bölüm de tam olarak burada devreye giriyor.
Sharkly ile Pi ve Claude Code'u yan yana çalıştırın
Harness değiştirmek kolaydır; ancak etraflarındaki çalışma sistemini değiştirmek öyle değildir. Görevler, bağlam, ilerleme durumu ve incelemeler genellikle tek bir ajanın oturumunda yer alır; bu yüzden yeni bir ajan, yeni bir iş akışı anlamına gelir.
Sharkly, ajanın bir üst katmanında yer alır. Bir görev oluşturup bunu bir Agent'a atarsınız; söz konusu Agent da bağladığınız bir Computer (dizüstü bilgisayar, sunucu veya sanal makine) üzerinde, orada kurulu olan bir Runtime (kodlama ajanı) aracılığıyla çalışır. Bir Computer üzerindeki Runtime listesi halihazırda Claude Code'u içerir ve Pi de desteklenen Runtime'lar listesinde yer alır:
Denemek için Pi'yi Computer üzerine kurun, ardından Computer detay sayfasındaki Detect again seçeneğini kullanın. Sharkly belgeleri bu durumları açıklar: Not installed olarak işaretlenmiş bir Runtime için aracın kurulması gerekir; Agent görevlerini yalnızca Available durumundaki bir Runtime çalıştırabilir.
# 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
Buradan itibaren aynı görev panosu her iki ajanı da besler. Claude Code üzerindeki bir Agent'a kod refaktörü görevi, Pi üzerindeki bir Agent'a bağımlılık güncelleme görevi verip ardından her iki sonucu tek bir yerden inceleyebilirsiniz. Sharkly token satmadığı için model kullanımı, her bir Runtime'ın halihazırda kullandığı plan veya anahtar üzerinden devam eder. Fiyatlandırma sayfasına göre (9 Kasım 2026 itibarıyla kontrol edilmiştir), Ücretsiz plan 5 kişiye kadar olan organizasyonlar için 0 dolardır.
Aynı anda birden fazla ajan çalıştırma hakkında daha fazla bilgi için birden fazla Claude Code ajanının nasıl çalıştırılacağını anlatan rehberimize göz atabilirsiniz.
Gerçek dünya kullanım senaryoları
- Maliyet odaklı bireysel geliştirici: Keşifsel çalışmalar için yerel bir modelle Pi; zorlu refaktör işlemleri için Claude Code.
- Farklı tercihlere sahip ekipler: Bazı mühendisler Pi'de, bazıları Claude Code'da; kimsenin “bu hangi oturumdaydı?” diye sormaması için tüm görevler tek bir panoda.
- Otomasyon: Pi'nin JSON ve RPC modları betik tabanlı çalıştırmalar için son derece uygundur; sonuçları bir log dosyası yerine doğrudan bir göreve yönlendirebilirsiniz.
Sonuç
Pi ve Claude Code farklı sorulara yanıt veriyor. Pi, kalanını kendiniz inşa etmeye istekliyseniz bir harness'ın ne kadar yalın olabileceğini araştırıyor. Claude Code ise bir iş akışının ne kadarının kullanıma hazır olarak sunulabileceğini soruyor. İki tercih de kalıcı olmak zorunda değil. Bugün bir Computer'a Pi kurun, Sharkly üzerinden ona düşük riskli bir görev atayın ve sonucu Claude Code üzerindeki aynı görevle karşılaştırın.
SSS
Pi, Claude Code'dan daha mı iyi?
İkisinin de mutlak bir üstünlüğü yok. Pi daha yalındır, sağlayıcıdan bağımsızdır ve genişletilebilir; Claude Code ise alt ajanlar, plan modu ve onay pencereleriyle birlikte gelir. Hangi tercihin daha iyi olduğu, kendi iş akışınızı kendiniz mi kurmak istediğinize yoksa hazır bir akışı mı benimsemek istediğinize bağlıdır.
Pi açık kaynaklı mı?
Pi, MIT lisanslıdır ve kaynak kodları GitHub'da earendil-works/pi altında yer alır. Bağladığınız modeller ise kendi lisans ve şartlarını korur.
Claude aboneliğimi Pi ile kullanabilir miyim?
Pi'nin /login komutu, yerleşik sağlayıcılar için OAuth aracılığıyla abonelikleri destekler. Bireysel bir planı üçüncü taraf bir harness içinde kullanmadan önce sağlayıcınızın şartlarını kontrol edin; API anahtarı kullanmak bu tür soru işaretlerini ortadan kaldırır.
Pi, MCP'yi destekliyor mu?
Evet. Pi'nin web sitesinde MCP'nin artık yerleşik olarak sunulduğu, ayrıca MCP eklentilerinin de desteklenmeye devam ettiği belirtiliyor. Önceki sürümlerde bu özellik bulunmuyordu.
Pi, CLAUDE.md dosyasını okur mu?
Evet. Pi'nin güvenlik belgelerinde AGENTS.override.md, AGENTS.md ve CLAUDE.md dosyaları, yüklenen bağlam dosyaları arasında listelenmektedir.
Pi'yi dizüstü bilgisayarımda çalıştırmak güvenli mi?
Pi her araç çağrısından önce onay istemez. Belgelerinde, en güçlü pratik sınırlandırma olarak bir container, sanal makine (VM) veya korumalı alan (sandbox) önerilmektedir.
Pi'yi kim geliştirdi?
Pi, Mario Zechner tarafından geliştirildi. Proje günümüzde Earendil Inc. ve topluluk katkıcıları tarafından yayımlanmaktadır.
