Context Mode nedir? Kodlama ajanının bağlam penceresini rahatlatmak: kurulum, araçlar, lisans

Kodlama ajanın (Claude Code, Cursor, Codex gibi) büyük bir log, API yanıtı ya da sayfa görüntüsüyle çalışacağında Context Mode veriyi bir alt süreçte tutar, bağlam penceresine (modelin aynı anda görebildiği metin) yalnız sonuç girer; ham veri yerel bir arama dizininde saklanır. Ayrıca düzenlenen dosyaları, görevleri ve kararları kaydeder ve sohbet sıkıştırılınca ilgili kısmı geri getirir. Üreticinin ölçümüne göre tasarruf %98'e varıyor. Yerel sürüm ücretsiz; lisansı Elastic License 2.0: kaynak kodu açık ama tam açık kaynak değil, barındırılan hizmet olarak sunulamaz. Aynı şirketin ayrıca ücretli bir bulut hizmeti var.

Ne yapar: Büyük araç çıktılarını ajanın bağlamı dışında tutar
Ücretsiz: Yerel sürüm ücretsiz, hesap yok
Lisans: Elastic License 2.0: tam açık kaynak değil
Nerede: Claude Code, Gemini CLI, VS Code Copilot, Cursor, Codex ve diğerleri
Gerekli: Node.js 22.5+ ya da Bun
Veri: Yerelde kalır; Insight bağlanırsa gider
Sürüm: 1.0.169 (29 Haziran 2026)

Context Mode ne işe yarar? Hangi sorunu çözer?

Kodlama ajanı bir araç çağırdığında (tarayıcı görüntüsü, GitHub issue listesi, log dosyası) çıktının tamamı bağlam penceresine girer. README'nin örneklerinde bir Playwright sayfa görüntüsü 56 KB, 20 GitHub issue 59 KB tutuyor; yarım saat sonra bağlamın %40'ı gitmiş oluyor. Bağlam dolunca ajan sohbeti sıkıştırır ve hangi dosyayı düzenlediğini, hangi görevin yarıda kaldığını unutur. Context Mode iki tarafı da hedefliyor: ham veriyi bağlamın dışında tutmak ve sıkıştırmadan sonra kaldığı yeri geri getirmek.

MCP, asistanın kendi dışındaki bir servise ya da bilgisayarındaki bir programa bağlanmasını sağlayan ortak bağlantı biçimi. Bu sunucu köprünün ortasında durur: asistan isteği ona iletir, o da hedefe sorar ve cevabı geri getirir.

SenAjana büyük bir iş verirsin

AsistanClaude Code, Gemini CLI, Cursor, Codex

Context ModeBilgisayarında, alt süreçte

Yerel arama diziniHam çıktı burada kalır; bağlama sonuç girer

Veri yerelde kalır; Insight bağlanırsa gider.

Araç çıktısını bağlamın dışında tutmakNe alırsın: Kısa sonuç; ham veri yerel dizinde aranabilirAyrı kurulum gerekir Sıkıştırmadan sonra kaldığı yerden sürmekNe alırsın: İlgili geçmiş geri yüklenirAyrı kurulum gerekir Belgeyi dizinleyip parça çekmekNe alırsın: İlgili bölüm parçalarıAyrı kurulum gerekir

"Kodla düşün" ilkesi: README, ajanın 50 dosyayı tek tek okuyup saymak yerine sayan küçük bir betik yazmasını ve yalnız sonucu yazdırmasını öneriyor; Context Mode bu betiği alt süreçte çalıştırır, bağlama yalnız betiğin yazdırdığı girer. Yanıtın üslubuna karışmaz: kısa ya da uzun yazmak modelin ve senin talimatının işi.

Kime yarar: Claude Code, Codex ya da Cursor ile uzun oturumlarda çalışan, büyük log ve API çıktılarıyla uğraşan, bağlamın sık dolup sıkıştırıldığını gören geliştiricilere. Kısa sohbetlerde fark azdır.

README'nin ölçümleri üreticinin ölçümüdür: tam bir oturumda 315 KB ham çıktının 5,4 KB'a indiği ve oturum süresinin yaklaşık 30 dakikadan 3 saate çıktığı yazıyor; hook desteği olan platformlarda ~%98, hook'suzlarda ~%60 tasarruf. Bağımsız bir ölçüm resmî kaynakta yok.

Context Mode nasıl çalışır? Sandbox, dizin ve oturum kaydı

Ajan bir araç çağırırHook (Claude Code'da PreToolUse) büyük çıktı üretecek çağrıyı sandbox araçlarına yönlendirir.

Veri alt süreçte işlenirctx_execute betiği ayrı bir süreçte çalıştırır; ham veri orada kalır.

Bağlama yalnız sonuç girerBetiğin yazdırdığı ya da aramayla seçilen parça.

Her şey yerelde kaydedilirHam çıktı arama dizinine, olaylar oturum veritabanına (SQLite).

Hook'u olmayan platformda yönlendirme yalnız talimat dosyasıyla yapılır; ajan araçları kullanmayı atlayabilir.

Sandbox (alt süreç)

Her ctx_execute çağrısı kendi süreç sınırı olan ayrı bir alt süreç açar; 12 dil çalışır (JavaScript, TypeScript, Python, Shell, Ruby, Go, Rust, PHP, Perl, R, Elixir, C#). Çıktı 5 KB'ı geçerse ve bir amaç (intent) verildiyse çıktının tamamı dizine alınır, bağlama yalnız eşleşen bölümler döner.

Yerel arama dizini

Markdown içeriği başlıklara göre parçalanıp SQLite FTS5 tablosuna yazılır; arama BM25 sıralaması, kök bulma ve parça eşleşmesiyle yapılır, yazım hataları düzeltilir. Web sayfaları 24 saat önbellekte tutulur; 14 günden eski içerik açılışta silinir.

Oturum sürekliliği

Dosya düzenlemeleri, git işlemleri, görevler, hatalar ve kararlar projeye özel SQLite'ta tutulur. Sohbet sıkıştırılınca ya da --continue, --resume, /resume ile dönünce ilgili kısım aramayla geri yüklenir. --continue kullanmazsan önceki oturum verisi hemen silinir.

Context Mode hangi araçları ekler?

MCP aracı	Ne yapar (README)
`ctx_execute`	12 dilde kod çalıştırır; bağlama yalnız standart çıktı (stdout) girer
`ctx_execute_file`	Bir dosyayı sandbox'ta işler; ham içerik bağlama girmez. Proje klasörünün dışına çıkamaz
`ctx_batch_execute`	Birden çok komutu ve aramayı tek çağrıda çalıştırır
`ctx_index`	Markdown içeriği parçalayıp yerel arama dizinine yazar
`ctx_search`	Dizinde birden çok sorguyla arar, eşleşen parçayı getirir
`ctx_fetch_and_index`	Web adresini çeker, Markdown'a çevirip dizinler (24 saat önbellek)
`ctx_stats`, `ctx_doctor`, `ctx_upgrade`, `ctx_purge`, `ctx_insight`	Rapor, tanılama, güncelleme, dizini silme, Insight panelini açma

Arama sınırı: aynı oturumda arama çağrıları 4–8 arasında daha az sonuç ve uyarı verir, 9. çağrıdan sonra ctx_batch_execute'a yönlendirilir (README "Progressive Throttling").

Context Mode nasıl kurulur? Claude Code ve diğer ajanlar

Oturum içinde pazarı ekle ve kur

› /plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

Sonra Claude Code'u yeniden başlat ya da /reload-plugins yaz.

Kurulduğunu doğrula (bütün satırlar [x] olmalı)› /context-mode:ctx-doctor

Plugin bütün hook'ları (PreToolUse, PostToolUse, UserPromptSubmit, PreCompact, SessionStart, Stop) ve 11 MCP aracını kaydeder; yönlendirme talimatı oturum başında eklenir, projene dosya yazılmaz. Claude Code v1.0.33+ gerekir.

Hook'suz deneme kurulumu (sürüm sabit)› claude mcp add context-mode -- npx -y context-mode@1.0.169

Bu yol 11 aracı verir ama otomatik yönlendirme yoktur: model araçları kullanabilir, büyük çıktılı Bash/Read/WebFetch yerine onları tercih etmeye zorlanmaz. README bunu "denemek için" öneriyor.

README komutu sürümsüz yazıyor (npx -y context-mode); @1.0.169 npm'in sürüm sabitleme biçimi. npm'de "next" etiketiyle 2.0 ön sürümleri de yayımlanıyor; kararlı sürüm 1.0.169.

Paketi genel kur (sürüm sabit)› npm install -g context-mode@1.0.169

Ardından ajanın ayar dosyasına MCP sunucusunu ve (destekliyorsa) hook'ları eklersin. Gemini CLI için tek bir ~/.gemini/settings.json, VS Code Copilot ve JetBrains Copilot için hooks.json + .github/copilot-instructions.md, GitHub Copilot CLI için copilot plugin install mksglu/context-mode:configs/copilot-cli; Cursor, Codex CLI, OpenCode, Kiro, Zed ve diğerleri için README'de ayrı adımlar var. Hook'suz platformda talimat dosyasını (ör. AGENTS.md, GEMINI.md) proje köküne kopyalaman gerekir.

Node.js 22.5 ve üstü ya da Bun. Linux'ta Node 22.5'ten eski ve Bun yoksa kurulum bilerek durur (eski Node'da SQLite eklentisinin çökme sorunu).
Kurulumda çalışan: npm paketi bağımlılıklarını (better-sqlite3 dahil) indirir ve bir kurulum betiği (postinstall) çalıştırır; bu betik Claude Code'un ~/.claude/plugins/installed_plugins.json ve ~/.claude/settings.json dosyalarındaki context-mode girdilerini onarır, Windows'ta yol düzeltmesi yapar.
Veri klasörü: oturumlar ve istatistikler platformun varsayılan klasöründe (ör. ~/.claude/context-mode), dizin ~/.context-mode/content/ altında; CONTEXT_MODE_DIR ile değişir.

Context Mode nasıl kullanılır? Ne yazarsın, ne alırsın

Kurduktan sonra ajanınla normal çalışırsın; hook'lu platformda büyük çıktılı çağrılar kendiliğinden sandbox'a gider. Aşağıdaki istekler README'nin "Try It" bölümünden; parantezdeki rakamlar üreticinin ölçümü, çıktılar README'de anlatıldığı kadar tarif edildi.

Örnek 1: Büyük bir deponun git geçmişini çözümletmek"https://github.com/facebook/react deposunu klonla ve son 500 commit'i analiz et: en çok katkı verenler, aylara göre commit sıklığı ve en çok değişen dosyalar. Sonra ctx stats çalıştır."README'deki İngilizce örneğin Türkçesi.

Ne alırsın: ajan commit'leri tek tek bağlama okumak yerine bunları sayan bir betik yazar ve sandbox'ta çalıştırır; bağlama yalnız özet tablo girer (README: tek çağrı, 5,6 KB bağlam). ctx stats araç bazında kaç KB'ın bağlam dışında kaldığını gösterir.

Örnek 2: Bir belgeyi dizinleyip yalnız gereken kısmı bulmak"React useEffect belgesini çek, dizinle ve temizleme (cleanup) kalıbını kod örnekleriyle bul. Sonra ctx stats çalıştır."

Ne alırsın: sayfa ctx_fetch_and_index ile çekilip Markdown'a çevrilir ve yerel dizine yazılır; ham sayfa bağlama girmez, ctx_search yalnız eşleşen parçaları getirir (README: 2 çağrı, 1,8 KB bağlam). Aynı adres 24 saat içinde yeniden istenirse yeniden indirilmez.

Örnek 3: Uzun bir işte kaldığı yeri korumak"Express ile bir REST API kur: rotaları, testleri ve hata yönetimini ekle."

Ne alırsın: README'ye göre 20'den fazla araç çağrısından sonra ctx stats oturum olay sayısını gösterir; bağlam sıkıştırıldığında model görevleri, dosyaları ve kararları geri yükleyip son isteğinden devam eder, isteği yeniden yazman gerekmez.

Sohbete yaz (her platform)	Claude Code komutu	Ne yapar
`ctx stats`	`/context-mode:ctx-stats`	Bağlam tasarrufu, çağrı sayıları, oturum raporu
`ctx doctor`	`/context-mode:ctx-doctor`	Çalışma ortamı, hook, FTS5 ve sürüm kontrolü
`ctx index`	`/context-mode:ctx-index`	Yerel bir dosyayı ya da klasörü dizine al
`ctx search`	`/context-mode:ctx-search`	Dizinde ara
`ctx upgrade`	`/context-mode:ctx-upgrade`	GitHub'dan son sürüme güncelle, hook'ları onar
`ctx purge`	`/context-mode:ctx-purge`	Dizindeki bütün içeriği kalıcı olarak sil
`ctx insight`	`/context-mode:ctx-insight`	Barındırılan Insight panelini tarayıcıda açar (ayrı hizmet)

Aynı komutların terminal karşılıkları da var: context-mode doctor, context-mode index . --source project:my-app, context-mode search "…". Claude Code'da isteğe bağlı durum satırı oturumdaki tasarrufu gösterir (~/.claude/settings.json içine "statusLine": {"type": "command", "command": "context-mode statusline"}).

Context Mode hangi ajanlarda çalışır?

Claude CodeVar	Plugin pazarı, bütün hook'lar ve slash komutları; README'ye göre en kapsamlı destek.
Gemini CLIVar	Tek ayar dosyasında MCP ve dört hook.
VS Code (Copilot)Var	VS Code Copilot Chat v0.32+ ile hook'lar ve SessionStart.
CursorVar	Hook'lar (preToolUse, postToolUse, sessionStart, stop); README Cursor Marketplace'te listelenince tek tıkla kurulacağını yazıyor.
Codex CLIKısmen	MCP araçları çalışır; hook'lar `[features].hooks = true` ister, araç girdisini değiştirme henüz yok.
Antigravity, ZedKısmen	Hook yok; yalnız talimat dosyasıyla yönlendirme (README: ~%60 tasarruf, üreticinin ölçümü).

README'nin tablosunda 17 istemci ve OpenClaw ağ geçidi var: Claude Code, Qwen Code, Gemini CLI, VS Code Copilot, JetBrains Copilot, GitHub Copilot CLI, Cursor, OpenCode, KiloCode, OpenClaw, Codex CLI, Kimi Code, Antigravity, Antigravity CLI, Kiro, Zed, Pi ve OMP. Sitenin Engine sayfası "18 AI coding tools" diyor.

Context Mode verilerime ne yapar? Güvenli mi?

Yerelde kalan

README: telemetri, bulut eşitleme, kullanım izleme ve hesap yok; kod, istem ve oturum verisi ev klasöründeki SQLite dosyalarında kalır. Kayıttan önce MCP araç girdilerindeki token, şifre, API anahtarı ve çerez gibi alanlar [REDACTED] ile maskelenir.

Dışarı çıkabilen

ctx_fetch_and_index web adreslerini çeker (bulut meta veri adresleri hep engelli; yerel ağ adresleri varsayılan açık, CTX_FETCH_STRICT=1 kapatır). Sitenin gizlilik sayfasına göre Insight'ı bağlarsan Engine olayları şirketin Insight hizmetine gider; bağlamazsan yerelde kalır.

Çalıştırdığı kod

ctx_execute ve ctx_batch_execute ajanın yazdığı her kodu çalıştırır ve sürecin dosya erişimini devralır; gh, aws, gcloud gibi araçların kimlik bilgileri geçer. README: bir çalıştırma aracını onaylamak, rastgele kod çalıştırmayı onaylamaktır.

Context Mode bir işletim sistemi kum havuzu değildir: çalıştırma aracını onaylamak, ajanın yazdığı kodu senin dosya erişiminle çalıştırmayı onaylamaktır.

Context Mode, Claude Code'daki izin kurallarını kendi araçlarına da uygular (ör. Bash(sudo *) yasaksa sandbox'ta da yasak).

Context Mode açık kaynak mı? Elastic License 2.0 ne demek?

Context Mode'un lisansı Elastic License 2.0 (ELv2). Kaynak kodu herkese açık ve okunabilir, ama bu lisans tam açık kaynak lisansı değil: README de "source-available" diyor. Asıl fark: yazılımı başkalarına barındırılan ya da yönetilen bir hizmet olarak sunamazsın; lisans bildirimlerini de silemezsin. GitHub bu lisansı tanınan listede göstermediği için depo sayfasında lisans "Other" görünür.

Yapabilirsin

Kullanmak, kopyalamak, dağıtmak ve erişime açmak (ücretsiz, dünya genelinde)
Değiştirmek ve türev çalışma hazırlamak (değiştirdiğini belirten not ekleyerek)
Kendi işinde, şirketinde ve projelerinde ücret ödemeden kullanmak

Yasak

Yazılımı üçüncü kişilere, özelliklerinin önemli bir kısmına erişim veren barındırılan ya da yönetilen bir hizmet olarak sunmak
Lisans anahtarı işlevini taşımak, değiştirmek, devre dışı bırakmak ya da atlatmak
Lisans, telif ve diğer bildirimleri silmek ya da gizlemek; kopyayı verdiğin herkese lisans metnini de vermek zorunlu

Özet LICENSE dosyasındaki Elastic License 2.0 metninden; hukuki görüş değildir. Lisansı ihlal edersen hakların kendiliğinden sona erer; bildirim aldıktan sonra 30 gün içinde ihlali durdurursan geri gelir.

Context Mode ücretsiz mi? Ücretli bulut hizmeti ne?

Yerel sürüm (bu rehberin anlattığı, sitede adı "Context Mode Engine") ücretsiz: hesap, kart ya da kayıt istemez. Aynı şirket (MKSF LTD, Londra) ayrıca barındırılan bir Context Mode hizmeti satıyor: ajanının istekleri şirketin ağ geçidinden geçer, model ücretini kendi Anthropic ya da OpenAI hesabın öder.

Engine (yerel)0 $

Bu rehberdeki bütün araçlar
Hesap gerekmez
Veri bilgisayarında

Barındırılan Free0 $ /ay

Ayda 1.000 istek
Kart gerekmez
Limitte özellikler bir sonraki aya kadar durur

Pro20 $ /ay

Ayda 10.000 istek (yıllık 200 $)
Ek 1.000 istek 2 $, bütçe sınırıyla
İlk 14 günde kullanılmayan kısmın iadesi

Team50 $ /koltuk/ay

Koltuk başı 50.000 istek, ortak havuz
Tek fatura
En az 2 koltuk

Fiyat sayfasına göre limitte ajan çalışmayı sürdürür, istekler doğrudan modele gider; yalnız özellikler durur. Enterprise sözleşmeyle (ayda 100.000+ istek; şirketin bulutu, ayrılmış sunucu ya da kendi Cloudflare hesabın). TL fiyat yok; Türkiye'den kartla ödeme resmî kaynakta net değil.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı (README)
`/plugin` tanınmıyor	Claude Code eski: `claude --version` ile bak, 1.0.33+ sürüme güncelle.
Linux'ta "context-mode: install aborted"	Node.js 22.5+ ya da Bun kur; eski Node'da SQLite eklentisi ara ara çöktüğü için kurulum bilerek durur.
Tasarruf beklenenden az	Yalnız MCP kurulumunda yönlendirme yok; Claude Code'da plugin yolunu kullan, hook'suz platformda talimat dosyasını proje köküne kopyala.
Kurulum ya da hook'larda sorun	`/context-mode:ctx-doctor` (ya da `context-mode doctor`); hata kaydı için `bash scripts/ctx-debug.sh` raporu.
Proje dışındaki bir dosyayı işleyemiyor	`ctx_execute_file` proje klasörüne kapalı; bilerek açmak için ayarlardaki `permissions.allow` içine aynı yolun `Read(...)` kuralını ekle.

Context Mode nasıl kaldırılır, verileri nasıl silinir?

Önce dizini sil (isteğe bağlı): Sohbete ctx purge yaz ya da /context-mode:ctx-purge: dizindeki bütün içerik kalıcı olarak silinir.
Plugin: Claude Code'da /plugin → Installed → context-mode → Uninstall.
Yalnız MCP kurduysan: claude mcp remove context-mode (Claude Code'un genel komutu); genel npm kurulumu için npm uninstall -g context-mode.
Kalan dosyalar: Oturum ve dizin klasörlerini (CONTEXT_MODE_DIR ya da varsayılan klasör, ~/.context-mode/) ve elle eklediysen durum satırı ayarını kaldır.

Sık sorulan sorular

Context Mode nedir?

Kodlama ajanlarının bağlam penceresini dolduran araç çıktılarını dışarıda tutan bir MCP sunucusu. Ham veri bir alt süreçte ve yerel dizinde kalır, bağlama yalnız sonuç girer; sohbet sıkıştırılınca ajanın kaldığı yeri de geri getirir.

Context Mode Claude Code'a nasıl kurulur?

Claude Code oturumunda /plugin marketplace add mksglu/context-mode ve /plugin install context-mode@context-mode yaz, sonra /reload-plugins. Kurulumu /context-mode:ctx-doctor ile doğrularsın. Node.js 22.5 ve üstü gerekir.

Context Mode Codex ve Cursor'da çalışır mı?

Evet. README 17 istemci listeliyor; Cursor'da hook desteği var, Codex CLI'da MCP araçları çalışır ve hook'lar ayrı bir ayarla açılır.

Context Mode ücretsiz mi?

Yerel sürüm ücretsiz ve hesap istemez. Aynı şirketin barındırılan hizmeti ayrı: ücretsiz planı ayda 1.000 istek, Pro planı ayda 20 dolar.

Context Mode açık kaynak mı?

Kaynak kodu açık ama tam açık kaynak değil: lisansı Elastic License 2.0. Kullanmak, değiştirmek ve dağıtmak serbest; barındırılan ya da yönetilen bir hizmet olarak sunmak ve lisans bildirimlerini silmek yasak.

Verilerim bir yere gidiyor mu?

README'ye göre yerel sürümde telemetri ve bulut eşitleme yok; veriler ev klasöründeki SQLite dosyalarında kalır. Insight hizmetini bağlarsan olaylar şirketin sunucusuna gider.

Yüzde 98 tasarruf gerçek mi?

Bu oran üreticinin kendi ölçümü; hook desteği olan platformlar için veriliyor, hook'suz platformlarda yaklaşık yüzde 60 yazıyor. Bağımsız bir ölçüm resmî kaynakta yok.

İlgili rehberler

Kimi

21st MCP

ai-memory awwwards-animations

Brave Search MCP

Chrome DevTools MCP

Kaynaklar

Resmî kaynaklarda net olmayanlar: Tasarruf oranlarının bağımsız ölçümü (yalnız üreticinin ölçümü var) · 2.0 sürümünde neyin değişeceği (npm'de "next" ön sürümleri çıkıyor, kararlı sürüm 1.0.169) · barındırılan hizmete Türkiye'den kartla ödeme · Türkçe arayüz yok (komutlar ve belge İngilizce). Her biri ilgili bölümde yazılı.