Funes Kodlama Ajanı Belleği: Claude Code + Codex Kurulumu

Bir geliştirici, parser’ın neden değiştirildiğini kanıtlamak için saatler harcayabilir; ancak sonraki görev başka bir ajanla başladığında bu akıl yürütme kolayca kaybolur. Funes, ajan oturumlarını yerel olarak indeksler, kaynak ve provenans bilgisiyle birlikte orijinal kanıtları getirir. Claude Code, Codex, pi ve Hermes arasında aynı belleği paylaşmayı da mümkün kılar. Yine de kritik sınır şu: Funes geçmişi bulur; eski bir kararın bugün hâlâ geçerli olup olmadığına yine ajan karar verir.

Bu rehberde pratik bir Claude Code → Codex kurulumu, yalnızca yerel bellek kullanımı, isteğe bağlı Hugging Face senkronizasyonu, genel MCP istemcileri ve geri çağrılan geçmişin güvenilir kalmasını sağlayan kontroller ele alınıyor.

Kuruluma başlamadan önce bellek sınırını belirleyin

Funes’ı değerlendiriyorsanız veya hassas depolarla çalışıyorsanız yerel bellekle başlayın. Aynı geçmişi başka bir makinede ya da ekip genelinde kullanmanız gerektiğinde Hugging Face veri kümesine bağlanın.

Funes güvenlik politikasına göre ayrıştırma, parçalara bölme, embedding oluşturma ve yeniden sıralama işlemleri varsayılan olarak yerel ortamda gerçekleşir. Veriler makineden funes push komutuyla veya oturum sınırında yayın yapan paylaşılan bellek entegrasyonuyla çıkar. Hub destekli bellek bir veri kümesi deposu olduğundan, ilk push işleminden önce görünürlük ayarını mutlaka kontrol edin.

İlk deneme için local kullanın. Bağlantıyı daha sonra funes add <agent> <memory> komutunu yeniden çalıştırarak değiştirebilirsiniz.

Funes’ı kurun ve ilk indeksi oluşturun

Resmî Funes deposu, platformu algılayan, etiketlenmiş bir binary indiren, sürüm checksum’ını doğrulayan ve çalıştırılabilir dosyayı varsayılan olarak ~/.local/bin altındaki PATH üzerine yerleştiren bir shell kurucusu sunuyor:

curl -fsSL https://huggingface.co/buckets/huggingface/funes/resolve/install.sh | sh

funes komutu hemen bulunamıyorsa yeni bir shell açın ve ardından kurulumu kontrol edin:

funes status

Depoda Linux x86_64, Linux aarch64 ve macOS Apple Silicon için etiketlenmiş binary’ler listeleniyor. Platformunuz listede yoksa, hazır kurucunun bunu desteklediğini varsaymak yerine projenin kaynaktan derleme talimatlarını izleyin.

Beş dakikada başlangıç kurulumu

Hatırlanmasını istediğiniz ajan oturumlarının zaten bulunduğu ortamda şu komutu çalıştırın:

funes add claude

Claude Code için bu komut ilk indeksi oluşturabilir, okuma araçlarını kaydedebilir, entegrasyon otomasyonunu kurabilir ve tamamlanan turları indekslemeyi sürdürebilir. İlk tarama metin önceliklidir ve onaydan sonra yaklaşık bir dakika sürdüğü belgelenmiştir. Büyük tool çıktılarından önce düzyazıya ve akıl yürütmeye öncelik verir. (Funes kurulum belgeleri)

Ardından durumu inceleyin:

funes status

Claude oturumlarını elle başlatmanız veya yenilemeniz gerekiyorsa şu komutu kullanın:

funes index --harness claude

Bir yol belirtilmediğinde funes index, Claude, Codex, pi ve Hermes için ~/.claude/projects ve ~/.codex/sessions dahil standart oturum konumlarını tarayabilir. --harness claude seçeneğiyle taramayı Claude Code ile sınırlandırabilirsiniz. İndeksleme rehberinde, yol belirtilmeyen yenilemeler için yaklaşık 60 saniyelik, metin öncelikli bir bütçe de açıklanıyor; eski oturumlar ve büyük tool çıktıları daha sonraki geçişlerde işlenebilir.

Funes indekslemeyi artımlı gerçekleştirir; bu nedenle komutu yeniden çalıştırmak daha önce yazılmış parçalar için embedding işlemini tekrarlamaz. Açıkça belirtilen transcript yolları ve Hub trace depoları, yolsuz indekslemedeki bütçeyi kullanmak yerine tamamen indekslenir. (İndeksleme ayrıntıları)

Funes’ı Claude Code’a bağlayın

Yerel bir Claude Code belleği için şu komutu kullanın:

funes add claude local
funes status

local seçeneğini yazmayabilirsiniz; varsayılan değer zaten budur. Terminalde bir HF token’ı mevcutsa Funes, kullanıcıya ait bir <user>/funes-memory deposunu yapılandırmayı önerebilir. Yalnızca yerel bir pilot yapıyorsanız bu istemi reddedin.

Claude entegrasyonu yalnızca hook kullanan bir eklentiyle ayrı bir MCP kaydından oluşur. Funes, Claude Code’un settings.json dosyasını değiştirmez; otomasyon tamamlanan turları indeksler, paylaşılan bellek yapılandırması ise oturum sınırlarında yayınlama işlemini ekler. (Otomasyon davranışı)

Kurulumun çalışıp çalışmadığını yalnızca yükleme çıktısına bakarak değil, bilinen bir geçmiş kararı sorgulayarak test edin:

Find the previous decision about the streaming parser. Use Funes recall if the repository history does not explain it, and cite the session you used.

İyi bir sonuç önceki bir bölüme işaret eder, hangi oturumdan geldiğini belirtir ve eski bir denemeyle mevcut depo durumunu birbirinden ayırır.

Entegrasyonu, saklanan verileri silmeden kaldırmak için şu komutu çalıştırın:

funes remove claude

Kaldırma belgelerine göre bu komut Funes bağlantılarını kaldırır; yerel bellek, orijinal transcript’ler, cache’ler ve yayınlanmış bellek korunur.

Aynı belleği Codex’e de bağlayın

Claude Code çalışır duruma geldikten sonra Codex’i aynı yerel belleğe ekleyin:

funes add codex local
funes status

Hub destekli ortak bir bellek için her iki ajanda da aynı depo tanımlayıcısını kullanın:

funes add claude <org>/<repo>
funes add codex <org>/<repo>

Codex tarafında kolayca gözden kaçan bir güven adımı var. Funes hook’larını ~/.codex/hooks.json dosyasına yazar. Codex içinde /hooks komutunu çalıştırın, Funes girişlerini inceleyin ve onaylayın. Hook’lar güvenilir olarak işaretlenene kadar Codex bunları çalıştırmaz; dolayısıyla yeni turlar indekslenmez ve bellek yayınlanmaz. Belgelenen bağlı bellek iş akışı Codex 0.151.0 gerektirir. (Codex otomasyon gereksinimleri)

Gerçek bir ajanlar arası devir testi yapın

Bir oturumda bulunan, diğerinde bulunmayan ayırt edici bir kararı kullanın:

1. Claude Code’da parser kararını bulun ve tartışmadan ayırt edici bir terim not edin.
2. İndeksleme ve sınır otomasyonunun çalışabilmesi için oturumu sonlandırın.
3. Codex’te bu terim hakkında soru sorun ve önceki akıl yürütmeyi isteyin.
4. Yanıtın kaynak harness olarak Claude’u gösterdiğini ve orijinal oturuma ya da tura işaret ettiğini doğrulayın.

Kanıtı doğrudan terminalden de inceleyebilirsiniz:

funes recall "why did we switch away from the streaming parser"

recall, üretilmiş bir özet yerine sıralanmış pasajlar döndürür. Her sonuç kaynak bilgilerini ve otomatik oluşturulmuş bir get komutunu içerir; çevredeki turlara ihtiyaç duyduğunuzda bu komutu kopyalayın.

Codex hiçbir sonuç döndürmüyorsa sürümü, /hooks güven durumunu, funes status çıktısını ve Claude oturumunun entegrasyondan önce oluşturulup oluşturulmadığını kontrol edin. Ardından ilk tartışmadan ayırt edici bir terim kullanarak yeniden deneyin.

pi, Hermes veya başka bir MCP istemcisini bağlayın

Funes, Claude Code ve Codex’in yanı sıra pi ve Hermes’i de doğrudan destekler. Pi extension event’lerini, Hermes ise shell hook’larını kullanır; Hermes’in tur başına indeksleme özelliği beta olarak belgelenmiştir. (Desteklenen ajan ayrıntıları)

Bu dört ajan dışında MCP uyumlu bir istemci kullanıyorsanız Funes’ı yerel bir stdio sunucusu olarak çalıştırın:

{
  "mcpServers": {
    "funes": {
      "command": "funes",
      "args": ["mcp"]
    }
  }
}

Sunucuyu paylaşılan belleğe bağlamak için mcp sonrasına depoyu ekleyin:

{
  "mcpServers": {
    "funes": {
      "command": "funes",
      "args": ["mcp", "<org>/<repo>"]
    }
  }
}

MCP belgelerinde recall, get ve status araçları açıklanıyor. funes mcp salt okunurdur; oturumları indekslemez veya veri yayınlamaz. Bu işler için funes index, funes push ya da desteklenen bir funes add entegrasyonu kullanılmalıdır.

Tek bir MCP çağrısında belirtilen bellek, sunucu seviyesindeki bağlantının önüne geçer. İkisi de belirtilmezse Funes yerel belleği kullanır.

Kanıtı kaybetmeden geri çağırma yapın

Funes üç farklı iş akışı sunar:

Belgelenen recall varsayılanları 8 sonuç, yeniden sıralanan 30 sonuçluk aday havuzu, 30 günlük güncellik yarı ömrü ve 1 komşu parçadır. (Recall seçenekleri ve varsayılanlar)

Güvenilir bir hata ayıklama döngüsü şöyle ilerler:

1. funes recall komutunu hata, bileşen adı veya karar ifadesiyle çalıştırın.
2. Tam turu görmek için oluşturulan get komutunu izleyin.
3. Geri getirilen kararı mevcut branch ile karşılaştırın.
4. Değişikliği yapın veya deneyi çalıştırın.
5. Sonucu kullanarak yeniden recall yapın; böylece bir sonraki oturum bu bilgiyi bulabilir.

funes ask daha sınırlı bir akış sunar. Önce geri çağırma yapılır, ardından seçilen pasajlar ve sorunuz Claude veya Codex’e verilerek tek bir yanıt üretilir. Alt ajan herhangi bir tool, stdin veya MCP sunucusu almaz; eşleşme kötüyse yeniden arama da yapamaz. Geri getirme işlemi yerel olsa da soru ve hatırlanan pasajlar, seçilen ajan için yapılandırılmış sağlayıcıya gönderilir. Bu nedenle ask belgeleri, sağlayıcıya göndermek istemeyeceğiniz içerikler için funes recall kullanılmasını öneriyor.

Belleği güvenilir ve işler durumda tutun

Funes kaynak pasajlarını ve provenans bilgisini korur; ancak geçmişteki her geçici çözümün bugün hâlâ geçerli olup olmadığına karar veremez.

“Kodlama ajanları için bellek sıkıcı bir altyapı olduğunda işler çok daha az tuhaflaşır: yerel indeks, kesin provenans ve varsayılan olarak gizlilik.” — @TheArtemisHunts on X

Küçük bir üretim kontrol listesi

Funes indeksleme sırasında kimlik bilgilerini maskeler ve yayınlamadan önce fail-closed TruffleHog taraması kullanır. Push belgelerine göre tarayıcı bulunamazsa yayınlama engellenir. Canlı bir kimlik bilgisi uzak veri kümesine ulaştıysa hemen yenileyin; daha sonraki bir commit’i temizlemek depo geçmişini silemez.

Hugging Face token’larında en az yetki ilkesini uygulayın: yayın yapan makineler için write kapsamı, yalnızca recall yapan ekip üyeleri veya makineler için read-only kapsamı kullanın. Aynı uzak belleğe yazan iki makine yarış durumuna da girebilir; otomasyon belgeleri makineler arası serileştirme garantisi vermiyor.

Pratik seçim

Tüm entegrasyonları aynı anda kurmak yerine aşağıdaki başlangıç seçeneklerinden birini tercih edin:

Funes kodlama ajanı belleği hakkında sık sorulanlar

Funes yerel mi çalışır?

Funes, belleği varsayılan olarak yerel ortamda işler ve saklar. Önceliği yerel kullanımdır; otomatik olarak yalnızca yerel demek değildir: push işlemleri, paylaşılan bellek hook’ları ve ask verileri yerel süreç dışına gönderebilir.

Funes, Claude Code ve Codex ile çalışıyor mu?

Evet. funes add, Claude Code ve Codex’in yanı sıra pi ve Hermes’i de destekler. Codex bellek bağlantısı 0.151.0 sürümünü ve güvenilir hook’ları gerektirir.

Funes oturumları otomatik olarak indeksler mi?

funes add sonrasında desteklenen entegrasyonlar tur başına indeksleme otomasyonunu kurar. İlk başlangıç taramasının bir sınırı vardır; bu nedenle eski oturumlar ve büyük tool çıktıları daha sonraki geçişlerde işlenebilir.

Claude Code ve Codex arasında tek bir belleği nasıl paylaşırım?

Hem funes add claude hem de funes add codex komutlarında aynı <org>/<repo> argümanını kullanın. Funes çalışma indeksini yerel ortamda tutar ve paylaşılan veri kümesini oturum sınırlarında yayınlar.

Funes güncelliğini yitirmiş bir kararı getirirse ne yapmalıyım?

funes recall ile sonucu inceleyin, oluşturulan get komutuyla bağlamı genişletin ve harekete geçmeden önce kararı mevcut branch ile karşılaştırın. İlk arama isabetli değilse sorguyu farklı ifade edin.

funes ask verileri makinemde mi tutar?

Geri getirme ve yeniden sıralama yerel olarak yapılır; ancak ask, soruyu ve hatırlanan pasajları yapılandırılmış Claude veya Codex sağlayıcısına gönderir. Hassas kanıtlar için recall kullanın.

Belleği silmeden Funes’ı kaldırabilir miyim?

Evet. funes remove claude, funes remove codex, funes remove pi ve funes remove hermes entegrasyon bağlantılarını kaldırır; indekslenmiş bellek ve kaynak transcript’ler korunur.