Context7, yapay zeka kodlama yardımcınıza en güncel kütüphane belgelerini doğrudan enjekte eden bir platformdur. Böylece kod üretiminde LLM'nin eski eğitim verilerine takılı kalmasının önüne geçer. CLI aracı (ctx7) kurulum gerektirmez; npx ctx7 ile anında çalışır ve tek bir ctx7 setup komutuyla Claude Code, Cursor veya OpenCode'a entegre olur.
Context7 Nedir ve Neden Önemlidir?
Yapay zeka tabanlı kodlama araçları, çoğu zaman güncel olmayan API ve fonksiyon imzalarını önerir. Bunun nedeni, LLM'lerin sabit bir eğitim setiyle sınırlı olmasıdır. Örneğin Next.js 15'teki değişikliklerden veya bir kütüphanenin son API güncellemelerinden genellikle habersizdirler.
Context7, bu problemi doğrudan çözer. Upstash tarafından geliştirilen bu platform, 9000+ kütüphanenin belgelerini indeksler ve yapay zeka yardımcınıza gerçek zamanlı olarak iletir. Sorunuz geldiğinde, Context7 güncel ve sürüme özel belgeleri otomatik olarak modelin bağlam penceresine enjekte eder.
Bu sayede, AI yardımcınız hem doğru API'leri hem de güncel yöntemleri kullanarak kod üretir.
ctx7 CLI ile üç temel işlemi gerçekleştirebilirsiniz:
- Kütüphane belgelerini doğrudan terminalde getirme
- Yapay zeka kodlama becerilerini yönetme (aracınızı geliştiren yeniden kullanılabilir komut dosyaları)
- Claude Code, Cursor veya OpenCode için Context7 MCP sunucusu yapılandırma
💡API entegrasyonları kuruyorsanız, Apidog API test ve otomasyon tarafını üstlenir. İstekleri göndermek, düzenlemek ve doğrulamak için ücretsiz bir istemci sunar. Context7 ile AI yardımcınız güncel kalırken, Apidog gerçek API çağrılarınızın doğruluğunu sağlar.
ctx7 Kurulumu
Başlamak için yalnızca Node.js 18+ gereklidir. Sürümünüzü kontrol edin:
node --version
Kurulum Yapmadan Çalıştırma
En hızlı başlangıç için npx kullanın:
npx ctx7 --help
npx ctx7 library react
Her kullanımda en güncel sürüm çalışır. Hızlı testler için idealdir.
Genel Kurulum
Düzenli kullanım için global kurulum önerilir:
npm install -g ctx7
ctx7 --version
Bundan sonra, ctx7 komutunu doğrudan kullanabilirsiniz.
Yapay Zeka Kodlama Aracınız İçin Context7 Kurulumu
ctx7 setup ile Context7'yi AI kodlama ortamınıza bağlayın. OAuth ile kimlik doğrulaması, API anahtarı oluşturma ve yapılandırma otomatik olarak yapılır.
Etkileşimli Kurulum
ctx7 setup
Tercihlerinizi otomatikleştirmek için:
ctx7 setup --yes
Belirli Bir Aracıya Kurulum
ctx7 setup --claude
ctx7 setup --cursor
ctx7 setup --opencode
Mevcut Bir API Anahtarı Kullanımı
context7.com/dashboard üzerinden aldığınız API anahtarını doğrudan kullanabilirsiniz:
ctx7 setup --api-key YOUR_API_KEY
Proje veya Genel Kurulum
Varsayılan olarak genel kurulur. Sadece mevcut proje için:
ctx7 setup --project
İki Mod: CLI+Beceriler ve MCP
-
CLI+Beceriler:
SKILL.mddosyasıyla AI aracınızactx7komutlarını çalıştırmayı öğretir. MCP gerektirmez.
ctx7 setup --cli --claude
ctx7 setup --cli --cursor
ctx7 setup --cli --universal
-
MCP Sunucu: Context7'yi Model Context Protocol sunucusu olarak kaydeder. AI aracınız doğrudan
resolve-library-idvequery-docsfonksiyonlarını çağırır.
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
}
Claude Code için CLI ile ekleyin:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
Kimlik Doğrulama Komutları
ctx7 login
ctx7 whoami
ctx7 logout
API anahtarını ortam değişkeni olarak da kullanabilirsiniz:
export CONTEXT7_API_KEY=your_key_here
Giriş, beceri oluşturma ve kurulum için gereklidir. Basit belge sorguları için şart değildir.
Telemetriyi Devre Dışı Bırakma
export CTX7_TELEMETRY_DISABLED=1
Terminalden Kütüphane Belgeleri Getirme
ctx7 ile doğrudan terminalden kütüphane bilgilerine ulaşabilirsiniz.
Kütüphane Adı Çözümleme
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json
Çıktı örneği:
Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0
Belgeleri Getir
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
Güncel belge parçacıkları ilgili kütüphanenin en son sürümünden gelir. Doğrudan başka araçlara veya dosyalara aktarabilirsiniz.
Yapay Zeka Kodlama Becerilerini Yönetme
Beceriler, SKILL.md dosyalarıyla AI aracınıza özel bilgi veya davranış ekler. Context7'nin beceri kayıtlarını kullanın, kurun, özel beceri oluşturun ya da kaldırın.
Beceri Arama
ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Beceri Kurma
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
Genel kurulum için:
ctx7 skills install /anthropics/skills pdf --global
Proje Tabanlı Beceri Önerileri
ctx7 skills suggest
Kurulu Becerileri Listeleme
ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
Beceri Kaldırma
ctx7 skills remove pdf
Yapay Zeka ile Özel Beceri Üretimi
ctx7 login
ctx7 skills generate
İnteraktif olarak: kütüphane seçin, becerinin ne yapmasını istediğinizi belirtin, Context7 güncel belgelerden SKILL.md üretir.
Oluşturulan beceriler Agent Skills standardına uygundur ve farklı araçlarda yeniden kullanılabilir.
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
|
AI İsteklerinde Context7 Kullanımı
Kurulumdan sonra, aşağıdaki yöntemlerle Context7'yi iş akışınıza entegre edin.
"Context7 Kullan" Deseni
MCP modunda, prompt'un sonuna use context7 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
Belirli Kütüphaneye Odaklama
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.
Otomatik Context7 Çağrısı
AI agentınıza, kütüphane kodu yazarken Context7'yi otomatik çağırması için kural ekleyin. Claude Code için CLAUDE.md dosyanıza:
Üçü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 için, Ayarlar > Yapay Zeka İçin Kurallar bölümüne benzer bir kural ekleyin.
Tam API Güvenilirliği İçin Apidog ile Eşleştirin
Context7, AI yardımcınızın kütüphane bilgisini güncel tutar. Ancak entegrasyonlarınızın güvenilir API çağrılarıyla test edilmesi gerekir.
Apidog, API isteklerini gönderebileceğiniz, yanıtları inceleyebileceğiniz ve testleri otomatikleştirebileceğiniz ücretsiz bir API istemcisidir.
- Next.js uygulaması + üçüncü taraf API: Context7 ile kod önerileri güncel, Apidog ile gerçek API çağrılarınızı doğrulama.
- Yeni bir SDK entegre ederken: Context7 ile güncel SDK belgeleri, Apidog ile ham API uç noktası testi.
- Hata ayıklama: Kodunuzun oluşturduğu isteği Apidog ile gönderin, ham yanıtı inceleyin, hatanın kaynağını izole edin.
Apidog'da ortam değişkenleriyle API anahtarlarınızı yönetin, test onaylarını her yanıtta çalıştırın. Context7 + Apidog kombinasyonu ile hem belgeler hem API davranışı güvence altına alınır.
Fiyatlandırma ve İstek Limitleri
ctx7 ücretsizdir. İstek limitleri ve özellikler planınıza göre değişir:
| 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şırsanız, ay sıfırlanana kadar günde 20 ek API çağrısı alırsınız.
- Özel depolar için Pro veya üstü gerekir.
- Haftalık beceri üretim hakkı: Ücretsiz planda 6, Pro planda 10.
- Pro planı maksimum 20 kullanıcı destekler.
Önemli sınırlama: Context7 internetsiz çalışmaz; tüm sorgular Upstash sunucularından geçer. Büyük belge yanıtları LLM'nin bağlamını tüketebilir. Karmaşık projelerde bu önemli olabilir.
Ücretsiz API anahtarınızı context7.com/dashboard adresinden alın ve CONTEXT7_API_KEY olarak ayarlayın.
Sıkça Sorulan Sorular
Context7 kodumu sunuculara gönderiyor mu?
Hayır. Yalnızca kütüphane adı ve sorgu metni gönderilir. Kodunuz veya sohbet geçmişiniz gönderilmez.
Hangi kütüphaneler destekleniyor?
9000+ açık kaynak kütüphane ve framework. context7.com üzerindeki dizinden kontrol edebilirsiniz. Eksikse /add-library üzerinden ekleyebilirsiniz.
Belgeler ne kadar güncel?
Belgeler düzenli olarak yeniden dizine eklenir. Çok yeni sürümler hemen eklenmeyebilir, ancak genellikle en güncel stable sürüm bulunur.
API anahtarı zorunlu mu?
Hayır, temel kullanım için gerekmez; ancak daha yüksek istek limiti ve verim için CONTEXT7_API_KEY ile kullanın.
Desteklenen editör ve araçlar?
Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop ve MCP/Agent Skills standardını destekleyen tüm istemciler.
CLI+Beceriler ve MCP arasındaki fark?
CLI+Beceriler: AI aracınız açıkça ctx7 komutlarını çalıştırır. MCP: Context7 araçları arka planda otomatik çağrılır. MCP'de "use context7" yazmanıza gerek kalmaz.
AI kod yardımcısı olmadan ctx7 kullanılır mı?
Evet. ctx7 library ve ctx7 docs komutlarını terminalden bağımsız kullanabilirsiniz.
Top comments (0)