Context7, yapay zeka kodlama yardımcınızın bağlamına güncel kütüphane belgelerini doğrudan enjekte eden bir platformdur, böylece eski eğitim verilerine dayanarak kod üretmeyi bırakır. CLI (ctx7), npx ctx7 komutuyla (kurulum gerektirmez) çalışır ve tek bir ctx7 setup komutuyla Claude Code, Cursor veya OpenCode'a bağlanır.
Context7 Nedir ve Neden Önemlidir?
Yapay zeka kodlama araçlarını kullanan her geliştiricinin karşılaştığı bir sorun var: Yardımcınızdan iyi bildiğiniz bir kütüphaneyi kullanarak kod yazmasını istiyorsunuz ve o, doğru gibi görünen ancak artık mevcut olmayan API'ler kullanan bir şey veriyor. Fonksiyon imzaları yanlış. İçe aktarma yolları iki ana sürüm önce değişti. Örnek, sürüm 12 belgelerinde çalışıyor, ancak siz sürüm 15'tesiniz.
Bu, LLM'lerin belirli bir kesme tarihine sahip verilerle eğitilmesi nedeniyle olur. Geçen ay neyin değiştiğini bilmezler. Next.js 15'in düzenlerin nasıl çalıştığını yeniden düzenlediğini veya güvendiğiniz bir kütüphanenin eğitim anından bu yana API yüzeyinin yarısını kullanımdan kaldırdığını bilmezler.
Context7 bunu çözer. Bu, Upstash tarafından oluşturulmuş, 9.000'den fazla kütüphanenin belgelerini dizine ekleyen ve yapay zeka yardımcınıza gerçek zamanlı olarak sunan bir platformdur. Kodlama aracınıza bir soru sorduğunuzda, Context7 güncel, sürüme özel belgeleri alır ve model yanıtını oluşturmadan önce bağlam penceresine yerleştirir.
Sonuç: Yapay zeka kodlama aracınız API'leri hayal etmeyi bırakır ve kütüphanenin bugün gerçekten ne yaptığını yansıtan kod üretmeye başlar.
ctx7 CLI, Context7'nin komut satırı arayüzüdür. Üç şey yapar:
- Kütüphane belgelerini doğrudan terminalinizde getirir
- Yapay zeka kodlama becerilerini yönetir (aracınızı geliştiren yeniden kullanılabilir komut dosyaları)
- Claude Code, Cursor veya OpenCode için Context7 MCP sunucusunu yapılandırır
ctx7 Kurulumu
Tek gereksinim Node.js 18 veya üstüdür. Sürümünüzü node --version ile kontrol edin.
Kurulum Yapmadan Çalıştırın
ctx7'yi denemenin en hızlı yolu npx ile:
npx ctx7 --help
npx ctx7 library react
Bu, her çalıştırdığınızda en son sürümü çeker. Ara sıra kullanım için uygundur.
Genel Kurulum
Düzenli kullanım için genel olarak yükleyin:
npm install -g ctx7
ctx7 --version
Bundan sonra, her ctx7 komutu npx ek yükü olmadan yerel olarak çalışır.
Yapay Zeka Kodlama Aracınız İçin Context7 Kurulumu
ctx7 setup komutu Context7'yi yapay zeka kodlama ortamınıza bağlar. OAuth aracılığıyla kimlik doğrulaması yapar, bir API anahtarı oluşturur ve yapılandırmayı doğru yere yazar.
Etkileşimli Kurulum
ctx7 setup
Bu, aracınızı ve tercih ettiğiniz modu (CLI + Beceriler veya MCP) seçmeniz için size sorular sorar. Komutları atlamak isterseniz:
ctx7 setup --yes
Belirli Bir Aracıyı Hedefleyin
ctx7 setup --claude # Claude Code (~/.claude/skills veya MCP yapılandırması)
ctx7 setup --cursor # Cursor (~/.cursor/skills veya MCP yapılandırması)
ctx7 setup --opencode # OpenCode
Mevcut Bir API Anahtarını Kullanın
context7.com/dashboard adresinden zaten bir Context7 API anahtarınız varsa:
ctx7 setup --api-key YOUR_API_KEY
Proje Seviyesi ve Genel Kurulum
Varsayılan olarak, ctx7 setup genel olarak kurulur. Yalnızca mevcut proje için yapılandırmak üzere:
ctx7 setup --project
İki Mod: CLI + Beceriler ve MCP
CLI + Beceriler modu, yapay zeka aracınıza ctx7 CLI komutlarını çalıştırarak belgeleri getirmesini söyleyen bir SKILL.md dosyası kurar. Aracınız beceri talimatlarını okur ve kütüphane belgelerine ihtiyaç duyduğunda otonom olarak ctx7 library ve ctx7 docs komutlarını çalıştırır. MCP sunucusu gerekmez.
ctx7 setup --cli --claude # Beceriyi ~/.claude/skills dizinine kurar
ctx7 setup --cli --cursor # Beceriyi ~/.cursor/skills dizinine kurar
ctx7 setup --cli --universal # ~/.config/agents/skills dizinine kurar
MCP Sunucu modu, Context7'yi bir Model Bağlam Protokolü sunucusu olarak kaydeder. Aracınız, herhangi bir CLI komutu çalıştırmadan doğal olarak resolve-library-id ve query-docs araçlarını çağırır. Belge getirme işlemi görünmezdir.
MCP modu için yapılandırma şöyle görünür (editörünüzün MCP ayarlarına ekleyin):
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
}
Veya CLI aracılığıyla Claude Code'a ekleyin:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
Kimlik Doğrulama
ctx7 login # OAuth tarayıcı girişi
ctx7 whoami # Kim olarak giriş yaptığınızı onaylayın
ctx7 logout # Depolanan kimlik bilgilerini kaldırın
API anahtarını bir ortam değişkeni olarak da ayarlayabilirsiniz:
export CONTEXT7_API_KEY=your_key_here
Giriş yalnızca beceri oluşturma ve belirli kurulum akışları için gereklidir. Temel belge aramaları onsuz da çalışır.
Telemetri
Context7 varsayılan olarak anonim kullanım verilerini toplar. Bunu devre dışı bırakmak için:
export CTX7_TELEMETRY_DISABLED=1
Terminalden Kütüphane Belgeleri Getirme
Yapay zeka aracısı devrede olmasa bile, ctx7 tek başına bir belge arama aracı olarak kullanışlıdır. İki komut bu ağır işi yapar.
Bir Kütüphane Adını Çözümleyin
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json # JSON çıktısı
Bu, Context7 indeksini arar ve kütüphanenin standart kimliğini, metadataları (kod parçacığı sayısı, kaynak itibarı, kıyaslama puanları ve sürüm tanımlayıcıları) ile birlikte döndürür.
ctx7 library nextjs için örnek çıktı:
Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0
Belgeleri Getir
Bir kütüphane kimliğiniz olduğunda, onu bir konu sorgusuyla birlikte ctx7 docs komutuna iletin:
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json
Çıktı, sorgunuzla ilgili, kütüphanenin güncel sürümünden alınan belge parçacıklarıdır. Bu çıktıyı bir dosyaya veya başka bir araca yönlendirebilirsiniz.
Kütüphane kimliğini zaten biliyorsanız, ctx7 library komutunu atlayıp doğrudan ctx7 docs komutuna geçebilirsiniz.
Yapay Zeka Kodlama Becerilerini Yönetme
Beceriler, yapay zeka aracınıza özel bilgi veya davranış sağlayan SKILL.md dosyalarıdır. Bunları, aracınızın belirli bir görev türünü ele almadan önce okuduğu küçük talimat kılavuzları olarak düşünebilirsiniz.
Context7, topluluk tarafından katkıda bulunulan becerilerin bir kaydını barındırır. Bunu arayabilir, aracınızın ortamına beceriler kurabilir, özel beceriler oluşturabilir ve ihtiyacınız olmayanları kaldırabilirsiniz.
Beceri Arama
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Bir Beceri Kur
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor # Özellikle Cursor için kur
ctx7 skills install /anthropics/skills pdf --claude # Claude Code için kur
Genel olarak kurduğunuzda (--global), beceri tüm projelerinizde kullanılabilir olur:
ctx7 skills install /anthropics/skills pdf --global
Projenize Göre Öneriler Alın
ctx7 skills suggest komutu, proje dizininizi tarar, kullandığınız kütüphaneleri ve çerçeveleri algılar ve ilgili becerileri önerir:
ctx7 skills suggest
Bu, yeni bir projeye başladığınızda ve aracınıza ilgili bilgileri önceden beslemek istediğinizde iyi çalışır.
Kurulu Becerileri Listele
ctx7 skills list # Tüm kurulu beceriler
ctx7 skills list --claude # Sadece Claude Code için kurulu beceriler
ctx7 skills list --cursor # Sadece Cursor becerileri
Bir Beceriyi Kaldır
ctx7 skills remove pdf
Yapay Zeka ile Özel Bir Beceri Oluşturun
Bu, en güçlü özelliktir. Ücretli bir hesapla, Context7 indeksindeki herhangi bir kütüphaneden özel bir beceri oluşturabilirsiniz:
ctx7 login
ctx7 skills generate
CLI sizi etkileşimli bir istem üzerinden yönlendirir: bir kütüphane seçin, becerinin aracınıza ne öğretmesini istediğinizi açıklayın ve Context7, o kütüphanenin güncel belgelerine özel bir SKILL.md dosyası oluşturur.
Oluşturulan beceriler taşınabilirdir. SKILL.md formatı Agent Skills standardına uyar, bu da Claude Code için oluşturduğunuz bir becerinin Cursor, VS Code Copilot, OpenCode ve Agent Skills uyumlu diğer araçlarda değişmeden çalıştığı anlamına gelir.
Ücretsiz hesaplar haftada 6 beceri üretimi, Pro hesaplar ise 10 beceri üretimi hakkı elde eder.
Daha hızlı yazmak için Kısayol Takma Adları:
| Tam Komut | Takma Ad |
|---|---|
ctx7 skills install | ctx7 si |
ctx7 skills search | ctx7 ss |
ctx7 skills generate | ctx7 skills gen veya ctx7 skills g |
Yapay Zeka İsteklerinizde Context7 Kullanımı
Context7 kurulduktan sonra, günlük kodlama iş akışınızda kullanmanın birkaç yolu vardır.
"Context7 Kullan" Deseni
MCP modunda, güncel belgelendirme istediğiniz herhangi bir isteme "use context7" ifadesini ekleyin:
Çerezlerde geçerli bir JWT'yi kontrol eden ve kimliği doğrulanmamış kullanıcıları /login'e yönlendiren bir Next.js middleware oluşturun. use context7
Kullanıcı ve gönderi modelleriyle ve bire-çok ilişkiyle bir Prisma şeması kurun. use context7
Next.js 15'te App Router düzenini nasıl yapılandırırım? use context7
Aracı, Context7'nin resolve-library-id ve query-docs araçlarını otomatik olarak çağırır, güncel belgeleri getirir ve yanıtını temellendirmek için kullanır.
Belirli Bir Kütüphaneye Atıfta Bulunma
İsteminiz birden çok kütüphane içeriyorsa ve Context7'nin birine odaklanmasını istiyorsanız:
Bir Next.js uygulamasında Supabase kimlik doğrulamasını uygulayın.
Supabase için /supabase/supabase kütüphanesini ve Next.js yönlendirmesi için /vercel/next.js kütüphanesini kullanın.
Bu, kütüphane eşleştirme adımını atlar ve doğrudan belgelere gider.
"use context7" Yazmadan Otomatik Çağırma
Yapay zeka aracınıza, kütüphane koduna dokunduğunda belgeleri otomatik olarak getirmesi için bir kural ekleyin. Claude Code'da, CLAUDE.md dosyanıza şunu ekleyin:
Üçüncü taraf kütüphaneleri kullanan kod oluştururken daima Context7 MCP araçlarını kullanın.
Herhangi bir uygulama yazmadan önce kütüphane kimliğini çözümleyin ve güncel belgeleri getirin.
Bunu ben sormadan yapın.
Cursor'da, Ayarlar > Yapay Zeka İçin Kurallar bölümüne şunu ekleyin:
Harici kütüphaneler veya framework'ler kullanan kod yazarken, daima
uygulamayı oluşturmadan önce güncel belgeleri getirmek için Context7'yi çağırın.
Tam API Güvenilirliği İçin Apidog ile Eşleştirin
Context7, yapay zeka yardımcınızın kütüphane bilgisini güncel tutar. Ancak doğru belgeler resmin sadece yarısıdır. Bir API entegrasyonu oluştururken, gerçek HTTP çağrılarınızın beklediğiniz gibi çalıştığını da doğrulamanız gerekir.
Apidog bunu kapsar. İstek gönderebileceğiniz, yanıtları inceleyebileceğiniz, ortamlar kurabileceğiniz ve test paketlerini otomatikleştirebileceğiniz ücretsiz bir API istemcisidir. Anlık uç nokta keşfinden tekrarlanabilir entegrasyon testlerine kadar her şeyi yönetir.
Gerçek bir iş akışında birbirlerini nasıl tamamladıkları aşağıda açıklanmıştır:
Üçüncü taraf bir API'yi çağıran bir Next.js uygulaması oluşturuyorsunuz. Context7, yapay zeka aracınıza güncel Next.js belgeleri sağlayarak kod önerilerinin doğru olmasını sağlar. Apidog, üçüncü taraf API'yi doğrudan test etmenize, yanıt yapısını doğrulamanıza ve kodunuzun gönderdiği yüklerin API'nin beklediğiyle eşleştiğini onaylamanıza olanak tanır.
Kendi HTTP API'si olan yeni bir kütüphaneyi entegre ediyorsunuz. Context7, aracınıza kütüphanenin güncel SDK belgelerini verir. Apidog, herhangi bir uygulama kodu yazmadan önce HTTP düzeyinde davranışı anlamak için ham API uç noktalarını test etmenizi sağlar.
Bir entegrasyonda hata ayıklıyorsunuz. Kodunuzun Apidog'da oluşturduğu tam isteği gönderebilir, ham yanıtı inceleyebilir ve sorunun istek mantığınızda mı yoksa API'nin davranışında mı olduğunu yalıtabilirsiniz.
Apidog'da API anahtarlarınızın değişkenler olarak saklandığı bir ortam kurun, tek tıklamayla geliştirme ve üretim arasında geçiş yapın ve her yanıtta test onayları çalıştırın. Context7 + Apidog size hem güncel belgeleri hem de doğrulanmış API davranışını sunar.
Fiyatlandırma ve İstek Limitleri
ctx7 CLI'yi kullanmak ücretsizdir. İstek limitleri ve özellik erişimi Context7 planınıza bağlıdır:
| Plan | Fiyat | API çağrıları/ay | İstek limiti | Özel depolar |
|---|---|---|---|---|
| Ücretsiz | 0 $ | 1.000 | 60 istek/saat | Hayır |
| Pro | 7 $/kullanıcı/ay | 5.000/kullanıcı | 60/saat/kullanıcı | Evet (ayrıştırmak için 1M token başına 15 $) |
| Enterprise | Özel | 5.000/kullanıcı | Özel | Evet (1M token başına 25 $) |
Ücretsiz katman notları:
- Aylık limite ulaştığınızda, ay sıfırlanana kadar günde 20 bonus API çağrısı alırsınız.
- Özel depolara erişim için Pro veya daha yüksek bir plan gereklidir.
- Beceri üretimi: Ücretsiz planda haftada 6, Pro planda haftada 10.
- Pro, maksimum 20 üyeyi destekler.
Önemli sınırlama: Context7, tüm sorguları Upstash'ın sunucuları aracılığıyla yönlendirir. Çevrimdışı mod yoktur. İnternet erişiminin olmadığı bir ortamdaysanız, araç çalışmayacaktır. Belge yanıtları da büyük olabilir, bu da LLM'nizin bağlam penceresini tüketir. Çok sayıda kütüphane sorgusu içeren karmaşık projelerde bu durum artar.
context7.com/dashboard adresinden ücretsiz bir API anahtarı alın. API anahtarı, kimliği doğrulanmamış isteklere göre daha yüksek istek limitleri sağlar.
Sıkça Sorulan Sorular
Context7 kodumu sunucularına gönderiyor mu?
Hayır. Yalnızca kütüphane adı ve sorgu metni Context7'nin sunucularına gönderilir, kodunuz, sohbet geçmişiniz veya hassas verileriniz gönderilmez. Kod tabanınız LLM sağlayıcınızda kalır.
Context7 hangi kütüphaneleri destekliyor?
Dizin 9.000'den fazla genel kütüphane ve framework'ü kapsar. Belirli bir kütüphanenin mevcut olup olmadığını kontrol etmek için context7.com adresindeki dizini arayabilirsiniz. Yeni kütüphaneler Context7 arayüzünde /add-library aracılığıyla gönderilebilir.
Belgeler ne kadar güncel?
Kütüphaneler periyodik olarak yeniden dizine eklenir. Çok yeni sürümler (son birkaç gün içinde çıkanlar) henüz mevcut olmayabilir. Kararlı kütüphaneler için belgeler genellikle en son sürümle günceldir.
API anahtarı olmadan çalışıyor mu?
Temel kullanım, API anahtarı olmadan da çalışır ancak daha düşük istek limitleriyle. Düzenli kullanım için context7.com adresinden kaydolun ve daha iyi verim elde etmek için CONTEXT7_API_KEY'i ayarlayın.
Hangi editörleri ve aracıları destekliyor?
Context7, Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop ve MCP veya Agent Skills standardını destekleyen diğer tüm istemcilerle çalışır.
CLI + Beceriler modu ile MCP modu arasındaki fark nedir?
CLI + Beceriler modunda, bir beceri dosyası aracınıza belgeler gerektiğinde ctx7 komutlarını açıkça çalıştırmasını söyler. MCP modunda ise aracınız, Context7'nin araçlarını MCP protokolü aracılığıyla doğal olarak çağırır. MCP modu kullanıcı için daha şeffaftır ve yapılandırıldıktan sonra herhangi bir açık "use context7" istemi gerektirmez.
Yapay zeka kodlama aracısı olmadan ctx7 kullanabilir miyim?
Evet. ctx7 library ve ctx7 docs komutları bağımsız terminal komutları olarak çalışır. Herhangi bir yapay zeka aracısı dahil olmadan kütüphane belgelerini doğrudan arayabilirsiniz.