AI Agent Token Maliyeti Nasıl %99 Azaltılır

codebase-memory-mcp: Kod Tabanınızı Kalıcı Bir Bilgi Grafiğine Dönüştürün

TL;DR: codebase-memory-mcp, deponuzu kalıcı bir bilgi grafiğine indeksler. Böylece kodlama aracınız yapısal soruları arama yapıp dosya okumak yerine doğrudan grafikten yanıtlar. Projenin ölçümünde beş yapısal sorgu grafik üzerinden yaklaşık 3.400 jeton, dosya dosya keşifte ise yaklaşık 412.000 jeton tüketti: %99,2 azalma. C ile yazılmıştır; çalışma zamanı veya API anahtarı gerektirmeyen tek bir yerel ikili olarak dağıtılır, 160’tan fazla dili kapsar ve tamamen makinenizde çalışır. 1 Eylül 2026 itibarıyla 41.536 yıldızı vardır ve MIT lisanslıdır. 2026’da kurulmaya değer beş açık kaynaklı yapay zeka ajan aracından biri olarak bu listede öne çıkıyor.

Apidog'u bugün deneyin

Bir fonksiyonun nerede çağrıldığını ajana sorduğunuzu düşünün. Ajan arama yapar, birkaç dosya okur, başka bir desenle tekrar arar ve daha fazla dosya okur. Sonunda doğru yanıtı verse bile bağlamını kaynak kodla doldurup on binlerce jeton harcar. Takip sorusunda ise aynı keşfi baştan yapar.

Uzun oturumlarda limitlerin tükenmesinin ve yanıt kalitesinin düşmesinin önemli nedenlerinden biri budur: dosya içeriğiyle dolu bağlam penceresinde akıl yürütmeye daha az yer kalır. codebase-memory-mcp bu iki sorunu aynı yaklaşımla çözer.

Ne işe yarar?

Araç, deponuzu şu yapıların kalıcı bir bilgi grafiğine ayrıştırır:

• Fonksiyonlar ve sınıflar
• Çağrı zincirleri
• HTTP rotaları
• Çapraz hizmet bağlantıları
• Mimari ilişkiler

Ayrıştırma, tree-sitter AST analiziyle 160’tan fazla dilde çalışır. Hibrit LSP katmanı ise README’de yaklaşık on çekirdek dil ve aile için semantik tip çözünürlüğü sağlar:

• Python
• TypeScript ve JavaScript, JSX ve TSX dahil
• PHP
• C#
• Go
• C ve C++
• Java
• Kotlin
• Rust
• Perl

Bu ayrım önemlidir. AST analizi, save adlı bir metodun çağrıldığını söyleyebilir; tip çözünürlüğü ise bu metodun hangi sınıfa ait olduğunu da belirler.

Sonuç, arama ve çağrı zinciri takibinden etki analizine kadar 15 MCP aracı olarak sunulur:

• Mimari genel bakış
• İndeks kapsamı kontrolleri
• Cypher sorguları
• Ölü kod tespiti
• Çapraz hizmet HTTP bağlantıları
• ADR yönetimi

Model Context Protocol kullanan herhangi bir istemci bu sunucudan yararlanabilir. Proje; Claude Code, Codex, Cursor, Windsurf, OpenCode, Gemini CLI, Aider ve Kilocode dahil 45 desteklenen ajan yüzeyini listeliyor.

Ölçümler

İki bağımsız ölçüm seti var.

Projenin kendi ölçümünde beş yapısal sorgu:

• Grafik üzerinden yaklaşık 3.400 jeton
• Dosya dosya grep keşfiyle yaklaşık 412.000 jeton

Bu, aynı yanıtlar için %99,2 azalma veya yaklaşık 120 kat daha az jeton anlamına geliyor.

Akademik sürüm olan Codebase-Memory: LLM Kod Keşfi için Tree-Sitter Tabanlı Bilgi Grafikleri (MCP Aracılığıyla), 31 gerçek dünya deposunda değerlendirildi ve şu sonuçları raporluyor:

• %83 yanıt kalitesi
• 10 kat daha az jeton
• Dosya dosya keşfe kıyasla 2,1 kat daha az araç çağrısı

120x ile 10x arasındaki farkı doğru yorumlamak önemli. 120x, grafiğin en güçlü olduğu beş yapısal sorguya ait en iyi senaryodur. 10x ise 31 depo üzerindeki daha geniş karışımı temsil eder ve günlük kullanıma daha yakındır. Planlama yaparken 10x’i temel alın; daha yüksek tasarrufu avantaj olarak görün.

Hız da etkileyici:

• Linux çekirdeği: 75.000 dosyada 28 milyon satır, yaklaşık üç dakikada
• Ortalama depo indeksleme süresi: milisaniyeler
• Yapısal sorgu yanıtı: bir milisaniyenin altında

Boru hattı, LZ4 sıkıştırma, bellekte SQLite ve birleşik Aho-Corasick desen eşleştirme kullanır. Sistem RAM önceliklidir ve indeksleme tamamlandıktan sonra belleği serbest bırakır.

Bu sayıların mümkün olmasının temel nedenlerinden biri C ile yazılmış olmasıdır. Aynı nedenle kurulacak bir çalışma zamanı da yoktur.

Kurulum

macOS ve Linux

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

Windows

Projenin önerdiği adımlar:

Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
notepad install.ps1        # önce okuyun
Unblock-File .\install.ps1
.\install.ps1

Kurulum seçeneklerinden bazıları:

• --skip-config: Yalnızca ikiliyi kurar, ajan yapılandırması yapmaz.
• --dir=: Özel kurulum konumu belirtir.

Yükleyici, kurulu kodlama ajanlarını otomatik olarak algılar ve belgelenmiş MCP girişlerini yazar. İstemcinin desteklemesine bağlı olarak talimatlar, beceriler ve yaşam döngüsü kancaları da eklenir.

macOS’ta karantina nitelikleri kaldırılır ve ikili geçici olarak imzalanır. Bu nedenle manuel xattr veya codesign işlemi gerekmez.

Kurulumdan sonra aracınızı yeniden başlatın ve projeyi indekslemesini isteyin.

İlk gün ayarlanabilecek yapılandırmalar

Yeni projeleri ilk bağlantıda otomatik indekslemek için:

codebase-memory-mcp config set auto_index true
codebase-memory-mcp config set auto_index_limit 50000

Dahil edilen grafik görselleştirme arayüzünü başlatmak için:

codebase-memory-mcp --ui=true --port=9749

localhost:9749, bilgi grafiğini 3D olarak gösterir. Bu arayüz:

• İlk bakışta fark edilmeyen yapıları görmeyi
• İndeksin beklenen dosyaları kapsadığını doğrulamayı
• Mimari ilişkileri hızlıca incelemeyi

kolaylaştırır.

Birden fazla depo üzerinde çalışıyorsanız:

codebase-memory-mcp config set auto_watch false

Bu ayar, bir oturumun projesini arka plan izleyicisine kaydetmesini önler.

Yoklama iş parçacığını tamamen kapatmak için:

codebase-memory-mcp config set watcher_enabled false

watcher_enabled daemon başlatılırken bir kez okunur. Bu ayarı değiştirdikten sonra daemon’u yeniden başlatın.

Çalıştırmadan önce kontrol edilmesi gerekenler

Proje iki önemli konuyu açıkça belgeliyor.

Microsoft Defender uyarısı

Microsoft Defender, bazı sürüm ikililerini Trojan:Script/Wacatac.B!ml olarak işaretleyebilir. Proje bunu bilinen bir yanlış pozitif olarak tanımlıyor ve tipik olarak yaklaşık 62 motordan 61’inin temiz sonuç verdiğini belirtiyor.

Aynı tespit ailesinin şu projeleri de etkilediği aktarılıyor:

• GitHub CLI
• llama.cpp
• Godot
• Microsoft’un Go araç zinciri

Her sürüm yayınlanmadan önce VirusTotal’da taranıyor ve sürüm notları sonuçlara bağlantı veriyor. Bu, küçük ve imzasız yerel ikililerle ilgili bilinen sezgisel tespit problemine karşı şeffaf bir yaklaşım.

Kod ve ajan yapılandırması erişimi

Araç kod tabanınızı okur ve ajan yapılandırma dosyalarınıza yazar. Bu, aracın temel görevidir ve proje bunu gizlemiyor.

Güvenlik açısından:

• Kaynak kodu MIT lisanslıdır.
• Sürümler OpenSSF Scorecard ve SLSA seviye 3 kaynakları taşır.
• İşleme tamamen yereldir.
• Proje kendi başına ağ isteği yapmadığını belirtir.
• Arka planda güncelleme kontrolü yapmaz.
• Güncellemeler çalışan süreçten değil, ikilinin yanındaki kurulum betiğinden gelir.

Her iki durumda da doğru yaklaşım şudur: Kurulum betiğini Bash’e göndermeden önce okuyun. “Yalnızca yerel” iddiası sizin için kritikse bunu ayrıca doğrulayın. Yıldız sayısı popülerlik göstergesidir; denetim değildir.

Neden ilk kurulacak araç bu olmalı?

Mevcut ajan araçlarının çoğu çalışma biçiminizi değiştirir:

• Persona’lar istem yazma şeklinizi değiştirir.
• Paralel çalışma ağaçları iş organizasyonunuzu değiştirir.
• Web erişimi araştırma akışınızı değiştirir.

codebase-memory-mcp ise iş akışınıza yeni bir alışkanlık eklemeden her oturumu daha ucuz ve verimli hale getirir. Kurarsınız, projeyi indekslersiniz ve ajanınızın grep-dosya okuma döngülerinde bağlam tüketmesi azalır.

Kalite etkisi de en az maliyet düşüşü kadar önemlidir. Dosya okuyarak 400.000 jeton harcayan bir ajan, problemin kendisini düşünmek için daha az alana sahip olur. Ayrıca oturumun başında okuduklarını hatırlama performansı düşebilir. Grafikten kısa ve yapısal yanıtlar almak bağlamı serbest bırakır.

Aynı ilke, araçların ajana döndürdüğü yanıtlar için de geçerlidir. Şişirilmiş API yanıtlarının ajan iş akışlarında pahalı hale gelmesiyle ilgili bu incelemede aynı dinamik açıklanıyor.

Günlük kullanımda en değerli araçlar

15 aracı tek tek öğrenmeniz gerekmez; ajan uygun aracı seçer. Bilmeniz gereken, hangi soruların artık ucuz olduğudur.

Etki analizi

Bir fonksiyon imzasını değiştirmeden önce şunu sorun:

Bu değişiklik neyi bozabilir?

Grafik, depo genelindeki çağrıları hızlıca izler. Grep tabanlı keşif ise dinamik dağıtımı ve dolaylı çağrıları kaçırabilir. Böylece “muhtemelen güvenli” düşüncesi somut bir etki listesine dönüşür.

Çağrı zinciri takibi

Bir kod parçasına yürütmenin nasıl ulaştığını gösterir. Bilinmeyen depolarda, giriş noktasını bulmak için art arda dosya okumaktan çok daha verimlidir.

Mimari genel bakış

Ajanın tüm dosya ağacını okumasına gerek kalmadan yapısal bir harita üretir. Yeni bir kod tabanına uyum sağlamak ve salt okunur keşif yapmak için idealdir.

Ölü kod tespiti

Hiçbir yerden çağrılmayan kodları bulur. Temizleme sprintinden önce çalıştırarak tartışmayı ölçülebilir hale getirebilirsiniz.

Çapraz hizmet HTTP bağlantısı

Bir hizmetteki çağrıyı başka bir hizmetteki işleyiciye kadar izler. Mikro hizmet depolarında, tek bir depoyu anlayan ajanla sistemi anlayan ajan arasındaki farkı yaratabilir.

Cypher sorguları

Hazır araçların kapsamadığı özel sorular için grafiği doğrudan sorgulamanızı sağlar.

Pratik değişiklik, istemlerinize yansır. Daha önce 50.000 jeton ve iki dakika maliyeti olduğu için sormadığınız sorular artık neredeyse ücretsizdir:

• “Bunu hangi kod çağırıyor?”
• “Bu uç nokta için istek yolu nasıl görünüyor?”
• “Bu imzayı değiştirirsem hangi servisler etkilenir?”

Araç, merakın ekonomisini değiştirir. Bu da tek bir özellikten daha değerlidir.

Grafiğin bildikleri ve bilmedikleri

Bu aracın sınırlarını anlamadan ona aşırı güvenmemelisiniz.

Grafik kodunuzdan oluşturulur; kodunuzun yapısını bilir. Örneğin çapraz hizmet HTTP bağlantısı, bir hizmetteki çağrıyı diğerindeki işleyiciye bağlayabilir.

Ancak grafik API sözleşmesinin tamamını bilemez. Şunları kaynak koddan güvenilir biçimde çıkaramayabilir:

• /v1/invoices/{id} için idempotentlik anahtarı tekrar kullanıldığında dönen özel 409 hata zarfı
• status alanının tam olarak beş geçerli değeri
• Sayfalama imlecinin ofset değil opak bir değer olması
• Bir alanın kullanım dışı bırakılması ve gelecek çeyrekte kaldırılacak olması

Bunlar çoğunlukla uygulama değil, sözleşme bilgisidir. Bu nedenle ajan yapısal hafızası mükemmel olsa bile API sözleşmesini tahmin edebilir; tahmin edilen şekle göre istemci yazar ve kendi icat ettiği sahte veriye göre test eder. Her şey hazırlık ortamına kadar yeşil kalabilir.

Bu nedenle Apidog ve codebase-memory-mcp birbirinin alternatifi değil, tamamlayıcısıdır:

• Grafik “nerede?” sorusunu yanıtlar: Hangi işleyici, hangi çağrı zinciri ve bu imza değişirse ne bozulur?
• Şartname “ne?” sorusunu yanıtlar: Gerçek şemalar, durum kodları ve hata zarfları.
• Mock veriler şartnameden üretilir: Ajanın sahte olduğunu fark etmeyebileceği hata dalları da dahil.
• Sözleşme testleri CI’da başarısız olur: Uygulama ve sözleşme ayrıştığında sorun üretimde değil, CI’da görünür.

OpenAPI şartnamenizi ajan araçları olarak kullanmak, API değişiklikleri yapay zeka ajanlarını bozduğunda ne olduğunu ve ajanlar için API araç şemalarının nasıl tasarlanacağını ayrıca inceleyebilirsiniz.

Özetle:

• codebase-memory-mcp kaynak kodundan yapısal hafıza çıkarır.
• Apidog, API’nin ne vaat ettiğini şartname, mock ve testlerle sabitler.

Ajanlarınız kimsenin yazmadığı API şekillerine karşı istemci üretiyorsa Apidog’u indirin. Ayrıca yapay zeka ajanları çağında hâlâ bir API aracına ihtiyaç olup olmadığını değerlendirebilirsiniz.

Kodun hafızası, işin hafızası değildir

İkinci sınır organizasyoneldir.

İndeks, tek bir makinede ve tek bir hesap altında bir önbellek dizininde yaşar. Yerel Claude Code, Codex ve OpenCode oturumları arasında koordinasyon daemon’u aracılığıyla paylaşılır; ancak bu paylaşım makinenin sınırında kalır.

Daha önemlisi, grafik kod tabanının hafızasıdır; işin hafızası değildir. Örneğin:

• Tekrar deneme yardımcısının ödeme istemcisini çağırdığını söyleyebilir.
• Ancak geri çekilmenin neden Temmuz’da değiştiğini bilemez.
• Kararı kimin verdiğini veya hangi alternatiflerin değerlendirildiğini bilmez.
• Değişikliğin incelenip incelenmediğini göstermez.

Bu bilgiler kaybolmuş terminal oturumlarında kalabilir.

Sharkly, görevi istem yerine kalıcı bir kayıt haline getirerek bu boşluğu tamamlar:

• İşler görev olarak yaşar; ajan çıktıları ve yanıtlanan yorumlar göreve geri akar.
• Bir Ajan; talimatları, çalışma zamanını, becerileri, depoları ve ortamı kaydedilmiş bir yapılandırmadır.
• Çalıştırma sizin bağladığınız Bilgisayar üzerinde gerçekleşir. Bu bir dizüstü, sunucu veya konteyner olabilir.
• İndeks makineye özel olduğu için doğru Bilgisayarı seçmek, sıcak bir grafikle üç dakikalık soğuk başlangıç arasındaki farkı yaratır.
• Depo çalışmaları görev başına ayrı çalışma ağaçlarında yürütülür; paralel görevler çakışmaz.
• Bekleyenler listesindeki görev çalıştırma başlatmaz; önce iş hazırlanır.
• Alanlar, projeler, sprintler, görevler ve Jira senkronizasyonu ekiplerin zaten bildiği yapıyı korur.

Kod hafızası ve iş hafızası birlikte daha güçlüdür: biri ajana deponun ne yaptığını hatırlatır, diğeri ekibe ajanların ne yaptığını hatırlatır.

Sıkça Sorulan Sorular

Cursor, Codex ve OpenCode ile çalışır mı?

Evet. Bir MCP sunucusu olduğu için MCP destekleyen istemcilerle çalışır. Proje 45 ajan yüzeyini listeliyor ve yükleyici sisteminizde bulunan istemcileri otomatik algılıyor. API çalışmaları için ayrıca Cursor ve Copilot’taki API istemcilerine bakışa göz atabilirsiniz.

Kodum makinemden çıkar mı?

Hayır. İşleme tamamen yereldir. Proje kendi başına ağ isteği yapmadığını ve arka planda güncelleme kontrol etmediğini belirtiyor. Yine de bunu yalnızca beyana dayanarak kabul etmek yerine, MIT lisanslı kaynak koddan doğrulayabilirsiniz.

%99 jeton indirimi her depo için gerçekçi mi?

Hayır. %99,2; grafiğin en güçlü senaryosu olan beş yapısal sorgunun ölçümüdür. 31 depo üzerindeki akademik ölçüm 10 kat daha az jeton ve 2,1 kat daha az araç çağrısı rapor ediyor. Planınızı 10x tasarrufa göre yapın; yapısal soruların yoğun olduğu işlerde daha yüksek sonuç bekleyebilirsiniz.

Ne kadar büyük bir depoyu işleyebilir?

Belirtilen sınır durumda Linux çekirdeği, 28 milyon satır ve 75.000 dosyayla yaklaşık üç dakikada indeksleniyor. Otomatik indeksleme sınırı 50.000 dosya olarak yapılandırılabilir. Tipik uygulama depoları milisaniyeler içinde indekslenir.

Defender neden uyarı veriyor?

Küçük ve imzasız yerel ikililer için bilinen bir makine öğrenimi yanlış pozitifidir. Proje bu durumu belgeliyor, yaklaşık 62 motordan 61’inin temiz sonuç verdiğini belirtiyor ve sürüm başına VirusTotal sonuçlarına bağlantı veriyor. Aynı tespit ailesi GitHub CLI ve Microsoft’un Go araç zincirini de etkiliyor.

Bu araç kod okumayı tamamen ortadan kaldırır mı?

Yapısal sorular için büyük ölçüde evet. Ancak davranış, uç durumlar ve niyet için kaynak kodu yine okumalısınız. API’nin ne döndürdüğünü anlamak içinse kaynak koddan çıkarım yapmak yerine gerçek bir sözleşmeye ihtiyacınız vardır.

Sonuç

codebase-memory-mcp, 2026 ajan araçları dalgasındaki en gösterişsiz ama en yüksek getirili araçlardan biri:

• İş akışınızı değiştirmez.
• Yeni bir alışkanlık gerektirmez.
• Tek bir yerel ikili olarak kurulur.
• Ajanın grep ve dosya okuma döngülerinde harcadığı jetonları büyük ölçüde azaltır.
• Birden fazla ajan aynı anda çalıştığında, Orca örneğinde olduğu gibi daha fazla değer üretir.

Kurun, projenizi indeksleyin, auto_index ayarını yapın ve grafik görüntüleyiciyi bir kez açın.

Sınırları da unutmayın: Grafik kodunuzun nerede olduğunu bilir, API’nizin ne vaat ettiğini değil. Bu boşluğu Apidog bir şartname, mock ve test paketiyle kapatır. Ayrıca grafik deponuzu hatırlar; iş kararlarını değil. Bu ikinci boşluğu ise Sharkly, görevi istem yerine kalıcı bir kayıt haline getirerek doldurur.

Kodun mükemmel hatırlanması güçlü bir temeldir. Ancak neyin doğru olduğunu ve neden o kararı aldığınızı bilmek aynı şey değildir.