Büyük Projede AI Maliyeti: CodeGraph Rehberi (2026)

Yapay zeka ile kod yazan araçların neredeyse hepsinde ortak bir dert var. Büyük bir projede tek bir soru sorduğunuzda bile asistan, arka planda onlarca dosyayı tarayarak cevabı arıyor. Her tarama token demek, token ise doğrudan para demek. CodeGraph tam olarak bu maliyeti çözmek için tasarlanmış, ücretsiz ve açık kaynak bir araçtır. Bu rehberde CodeGraph'in ne olduğunu, nasıl çalıştığını, nasıl kurulduğunu ve gerçek bir testte ne kadar tasarruf sağladığını adım adım anlatacağız.

Konuyu uçtan uca canlı izlemek isterseniz, tüm kurulumu ve karşılaştırma testini YouTube videomuzdan takip edebilirsiniz. Bu yazı boyunca ilgili bölümlere zaman damgalı bağlantılar da vereceğiz.

İçindekiler

• CodeGraph nedir ve hangi sorunu çözer?
• Sorun: Her soruda dosya taramak neden pahalı?
• CodeGraph nasıl çalışır? (4 adımda)
• CodeGraph'in temel özellikleri ve MCP araçları
• CodeGraph kurulumu: birkaç komut yeterli
• Gerçek test: CodeGraph'li ve CodeGraph'siz maliyet karşılaştırması
• CodeGraph ne zaman işe yarar, ne zaman yaramaz?
• Sonuç
• Sıkça Sorulan Sorular (FAQ)

CodeGraph nedir ve hangi sorunu çözer?

CodeGraph, kod tabanınızı önceden tarayıp bir bilgi grafiği (knowledge graph) çıkartan bir araçtır. AI kod asistanınızı daha ucuza ve daha hızlı kullanmanın pratik bir yöntemidir. Temel mantığı şudur: ajan her seferinde sıfırdan kodunuzu taramak yerine, hazır bir harita üzerinden tek sorguyla cevabı bulur.

Bu araç tek bir editöre bağlı değildir. Claude Code, Cursor, Codex CLI ve OpenCode gibi birçok komut satırı aracıyla birlikte çalışır. Hangisini kullanırsanız kullanın, mesaj aynıdır: kod tabanına bir bilgi grafiği ekleyerek daha az token harcayın.

Proje yazıldığı sırada GitHub deposunda yaklaşık 26.000 yıldıza ulaşmıştı ve günün en popüler araçlarından biriydi. Bugün bu sayı 44.000'in üzerine çıktı. Üstelik MIT lisansıyla tamamen açık kaynaktır, yani hem incelemesi hem de kullanımı serbesttir.

Sorun: Her soruda dosya taramak neden pahalı?

AI asistanı her soruda dosya tarar. Grep, glob ve oku gibi işlemlerle ilgili kod parçalarını bulmaya çalışır. Küçük bir projede bu pek sorun olmaz. Ancak büyük bir projede tek bir mimari soru bile asistanı onlarca dosyayı taramaya iter.

İşin daha sinsi tarafı şudur: birçok asistan arka planda explorer alt ajanları çalıştırır. Bu alt ajanlar ek taramalar yaparak görünmeyen bir maliyet üretir. Tarama eşittir token, token eşittir para. Her ekstra tarama hem faturanızı hem de cevabı beklediğiniz süreyi büyütür.

Bu maliyet hiç de küçük değildir. Sektör verilerine göre tipik bir Claude Code oturumu, orta ölçekli bir kod tabanında 10.000 ile 100.000'in üzerinde token tüketebilir. Büyük kod tabanları token'ı ortalamadan üç ila beş kat daha hızlı yakar, çünkü yüklenen her dosya bağlam penceresini doldurur. Opus gibi güçlü modellerde girdi ve çıktı token ücretleri dolar bazlı olduğundan, bu durum özellikle Türk geliştiriciler için orantısal olarak daha ağır bir kalem haline gelir.

İşte CodeGraph bu noktada devreye girer. Asistanın körlemesine dosya taramasını, yapısal tek bir sorguya dönüştürür.

CodeGraph nasıl çalışır? (4 adımda)

CodeGraph dört adımda çalışır ve hepsini tek komutta arka planda halleder. Tree-sitter veya SQLite gibi teknik detayları bilmenize gerek yoktur.

1. Adım: Ayrıştırma. Tree-sitter ile kaynak kod ayrıştırılır. Fonksiyonlar, sınıflar ve metotlar gibi semboller ile çağrı, import ve kalıtım gibi ilişkiler çıkarılır.
2. Adım: Depolama. Her şey yerel bir SQLite veritabanına yazılır. FTS5 tam metin arama sayesinde sembol araması çok hızlı yapılır.
3. Adım: Çözümleme. Referanslar birbirine bağlanır. Fonksiyon çağrıları tanımlarına, import'lar kaynak dosyalara eşlenir, kalıtım zincirleri kurulur.
4. Adım: Otomatik senkron. İşletim sisteminin dosya izleyicisi değişiklikleri yakalar. Siz kod yazdıkça grafik yaklaşık iki saniye gecikmeyle kendini günceller. Ekstra ayar yapmanıza gerek kalmaz.

Bu yapının kalbinde düğümler ve kenarlar vardır. Kodun parçaları düğüm olarak saklanır, aralarındaki "çağırır", "import eder" ve "kalıtır" gibi ilişkiler ise kenar olarak tutulur. Böylece ajan dosya taramak yerine bu grafiğe tek sorgu atıp cevabını anında alır. Bu çalışma mantığını animasyonlu olarak görmek isterseniz, videonun ilgili bölümünden faydalanabilirsiniz.

CodeGraph'in temel özellikleri ve MCP araçları

CodeGraph aslında bir MCP (Model Context Protocol) sunucusudur. Kurulum sihirbazı kullandığınız asistanları otomatik algılar ve yapılandırır. Asistanınıza şu araçları sunar:

• codegraph_explore: Birincil araçtır. "X nasıl çalışır" ya da "X'ten Y'ye akış nasıl gider" gibi yapısal sorularda, ilgili sembolleri ve kaynak kodu tek çağrıda dosya dosya gruplayarak döndürür.
• codegraph_impact: Düzenleme öncesi etki analizidir. Bir fonksiyonu değiştirmeden önce çağıranları, çağrılanları ve etki yarıçapını gösterir. Refactor ve hata düzeltmede kritik bir güvenliktir.
• codegraph_search: FTS5 ile herhangi bir sembolü anında bulur, grep'e gerek bırakmaz.

Bunların yanında öne çıkan birkaç özelliği de şöyle özetleyebiliriz:

• %100 yerel: Veri dışarı çıkmaz, API anahtarı yoktur, harici servis gerektirmez. Tüm grafik tek bir yerel SQLite veritabanında tutulur.
• Gizlilik avantajı: Kodun hiçbir parçası buluta gitmez. KVKK ve kurumsal gizlilik açısından kaynak kodun makinede kalması güçlü bir artıdır.
• 20'den fazla dil: TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Swift ve daha fazlası desteklenir.
• Akıllı bağlam ve etki analizi: Tek çağrıda giriş noktaları, ilgili semboller ve kod parçaları bir arada gelir; bir sembolü değiştirdiğinizde nelerin kırılacağını tek bakışta görürsünüz.

CodeGraph'in birçok komut satırı asistanıyla çalıştığını söylemiştik. Bu araçları nasıl konumlandıracağınız konusunda kararsızsanız, Claude Code, Cursor ve n8n karşılaştırmamıza göz atmanızı öneririz.

CodeGraph kurulumu: birkaç komut yeterli

CodeGraph kurulumu oldukça basittir. Önce bilgisayarınızda Node.js yüklü olması gerekir. Sonrası birkaç komuttan ibarettir.

Bu bölümü canlı izlemek için YouTube videomuzun 03:46 anından başlayabilirsiniz.

1. Adım: Global kurulum. Terminale npm install -g @colbymchenry/codegraph yazarak aracı global olarak yükleyin. Dilerseniz npx @colbymchenry/codegraph ile tek seferlik de çalıştırabilirsiniz.
2. Adım: Projeye geçiş. Kurulumdan sonra çalışmak istediğiniz projenin klasörüne gidin.
3. Adım: Kurulum sihirbazını çalıştırma. Verilen başlatma komutunu yapıştırın. Sihirbaz bilgisayarınızdaki Claude Code, Cursor ve Codex gibi asistanları otomatik algılar ve hepsini tek seferde yapılandırabilir.
4. Adım: İndeksleme. Aracı onayladığınızda kod tabanınızı ayrıştırıp indekslemeye başlar. Videodaki örnekte yaklaşık 240 dosyalık proje saniyeler içinde indekslendi.

Kurulum bittiğinde araç size asistanı yeniden başlatmanızı söyler. Bundan sonra ajanınız ilgili soruları doğrudan grafikten yanıtlamaya başlar. Hermes Agent gibi başka bir ajanı sunucuya kurmayı merak ediyorsanız, Hermes Agent kurulum rehberimizi de inceleyebilirsiniz.

Gerçek test: CodeGraph'li ve CodeGraph'siz maliyet karşılaştırması

Asıl merak edilen soru şudur: bu araç gerçekten para kazandırıyor mu? Bunu test etmek için aynı projenin iki kopyası kullanıldı. Biri CodeGraph'li, diğeri CodeGraph'siz. Her ikisine de tek terminalde aynı prompt verildi ve aynı model (Sonnet 4.6) çalıştırıldı.

Karşılaştırma testini adım adım görmek için YouTube videomuzun 05:54 anından izleyebilirsiniz.

Sonuçlar oldukça açıklayıcıydı. CodeGraph'siz taraf birçok dosyayı tek tek okudu ve arka planda alt ajanlar oluşturdu. CodeGraph'li taraf ise kendi grafiğine tek sorgu atarak cevabı çok daha hızlı getirdi. Maliyet detaylarına şu zaman damgasından ulaşabilirsiniz: usage karşılaştırması.

Bu tek koşumluk testte öne çıkan sayılar şunlardı:

• Toplam maliyet CodeGraph'siz tarafta yaklaşık 0,45 dolar, CodeGraph'li tarafta yaklaşık 0,35 dolardı. Yani tek sorguda bile yaklaşık %22 daha ucuz bir işlem yapıldı.
• Süre olarak CodeGraph'li taraf yaklaşık %46 daha hızlı yanıt verdi.
• Gizli explorer maliyeti dramatik şekilde düştü. CodeGraph'siz tarafta arka plandaki Haiku taraması yaklaşık 0,28 dolar gizli maliyet üretirken, CodeGraph'li tarafta bu kalem yaklaşık 0,06 dolara indi.

Üreticinin paylaştığı resmi benchmark ise yedi açık kaynak deposunda ölçülmüştür. Burada önemli bir gerçek vardır: kazanç projenin büyüklüğüne göre belirgin biçimde değişir.

Proje	Dil	Dosya	Maliyet	Token	Hız	Araç çağrısı
VS Code	TypeScript	~10.000	%18 ucuz	%64 az	%11 hızlı	%81 az
Django	Python	~3.000	%8 ucuz	%60 az	%13 hızlı	%77 az
Tokio	Rust	~790	eşit	%38 az	%18 hızlı	%57 az
OkHttp	Java	~645	%25 ucuz	%54 az	%31 hızlı	%50 az
Alamofire	Swift	~110	%40 ucuz	%64 az	%33 hızlı	%58 az

Tablodan da görüldüğü gibi proje ne kadar büyük ve karmaşıksa kazanç o kadar artar. Üreticinin başlık iddiası ortalama olarak %35 daha ucuz, %46 daha hızlı ve %71 daha az araç çağrısı yönündeydi. Gerçek rakamlar ise deponuza ve sorduğunuz soru tipine göre değişir.

CodeGraph ne zaman işe yarar, ne zaman yaramaz?

CodeGraph sihir değildir, sadece bir haritadır. Doğru model ve doğru soru tipinde işe yarar. Dürüst olmak gerekirse her durumda kazandırmaz.

Şu durumlarda belirgin fayda sağlar:

• Orta ve büyük ölçekli kod tabanlarında, ajanın çok dosya taradığı projelerde.
• "Bu sistem nasıl çalışır" gibi yapısal ve derin sorularda.
• Ajan grafiği doğrudan sorguladığında ve arka plandaki tarama yükü ortadan kalktığında.

Şu durumlarda ise farkı kapanır veya kaybolur:

• Çok küçük projelerde. Birkaç düzine dosyada normal arama zaten yeterlidir.
• Opus gibi güçlü modellerde. Bu modeller zaten verimli gezdiği için aradaki fark daralır.
• Dış servis akışlarında. Örneğin bir ödeme entegrasyonunun dış tarafındaki akış koda statik olarak bağlı olmadığından, ajan yine kodu tarayarak çıkarım yapmaya çalışır.
• İndeks bayatladığında. Büyük düzenlemelerden sonra senkron çalıştırmak veya sunucuyu yeniden başlatmak gerekir.

Token ve bağlam ekonomisi konusunu daha geniş bir çerçevede ele aldığımız token ekonomisi ve ikinci beyin yazımız bu konuda bakış açınızı genişletebilir.

Sonuç

CodeGraph, AI kod asistanlarının en büyük gizli maliyeti olan sürekli dosya taramayı ortadan kaldıran akıllı bir çözümdür. Kod tabanınızı bir bilgi grafiğine dönüştürerek ajanın tek sorguyla cevap bulmasını sağlar. Öne çıkan dört kazanımı şöyle özetleyebiliriz:

• Token maliyetinde belirgin düşüş, özellikle orta ve büyük projelerde.
• Daha hızlı yanıt süresi ve daha az araç çağrısı.
• %100 yerel çalışma sayesinde tam gizlilik ve KVKK uyumu.
• Tamamen ücretsiz, açık kaynak ve çoklu asistan desteği.

Eğer büyük veya orta ölçekli bir projede çalışıyorsanız ve asistanınız her oturumda kodu tekrar tekrar tarıyorsa, CodeGraph'i kurup denemeniz kesinlikle mantıklıdır. Çok küçük projelerde ise kurmak için acele etmenize gerek yoktur. Yapay zeka ve otomasyonu uçtan uca öğrenmek isterseniz, kapsamlı Türkçe eğitimlerimize göz atarak bu araçları projelerinizde verimli şekilde kullanmayı öğrenebilirsiniz.

Sıkça Sorulan Sorular (FAQ)

CodeGraph ücretsiz mi?

Evet, CodeGraph tamamen ücretsiz ve açık kaynaktır. MIT lisansıyla dağıtılır ve kullanmak için herhangi bir abonelik veya API anahtarı gerektirmez.

CodeGraph verilerimi dışarı gönderir mi?

Hayır. CodeGraph %100 yerel çalışır. Tüm grafik tek bir yerel SQLite veritabanında tutulur ve kodunuzun hiçbir parçası buluta gitmez.

CodeGraph sadece Claude Code ile mi çalışır?

Hayır. Claude Code, Cursor, Codex CLI, OpenCode, Gemini CLI ve Hermes Agent gibi birçok MCP uyumlu araçla birlikte çalışır. Hangi asistanı kullanırsanız onunla uyum sağlar.

Küçük projelerde CodeGraph kurmaya değer mi?

Genellikle değmez. CodeGraph en çok orta ve büyük ölçekli, ajanın çok dosya taradığı projelerde belirgin kazanç sağlar. Birkaç düzine dosyalık projelerde normal arama zaten yeterlidir.

CodeGraph hangi programlama dillerini destekler?

TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP ve Swift dahil 20'den fazla programlama dilini destekler. Dili dosya uzantısına göre otomatik algılar.