Giriş
Cursor, geliştiricilerin kodu daha verimli bir şekilde yazmasına, anlamasına ve dönüştürmesine yardımcı olmak için büyük dil modellerinden (LLM'ler) yararlanan, yapay zeka destekli güçlü bir kod editörüdür. Önemli özelliklerinden biri, geliştiricilere yapay zeka kullanımları üzerinde daha fazla kontrol sağlarken, kendi maliyetinizle sınırsız yapay zeka mesajı göndermenize olanak tanıyan, çeşitli sağlayıcılardan özel API anahtarlarını kullanabilmesidir. Bu eğitim, desteklenen tüm sağlayıcıları (OpenAI, Anthropic, Google ve Azure) kapsayan, Cursor'da özel API anahtarlarının kurulumu ve yönetimi sürecinde size rehberlik edecektir.
Cursor'da Neden Özel API Anahtarları Kullanmalısınız?
Kurulum sürecine dalmadan önce, neden kendi API anahtarlarınızı kullanmak isteyebileceğinizi anlayalım:
- Maliyet Kontrolü: Kendi yapay zeka kullanım giderlerinizi doğrudan sağlayıcı ile yönetin ve izleyin.
- Daha Yüksek Oran Sınırları: Cursor'ın paylaşımlı altyapısında mevcut olanlardan daha yüksek oran sınırlarına potansiyel olarak erişin.
- Model Esnekliği: Geliştirme ihtiyaçlarınıza uygun belirli modelleri ve yapılandırmaları kullanın.
- Gizlilik Hususları: Kodunuzun ve istemlerinizin nasıl işlendiği üzerinde daha doğrudan kontrole sahip olun.
Cursor'da API Anahtarı Entegrasyonunu Anlama
Cursor'da özel API anahtarlarını yapılandırdığınızda, uygulama yapay zeka destekli özellikler için ilgili LLM sağlayıcılarına çağrı yapmak üzere sağladığınız anahtarları kullanacaktır. Bu şu anlama gelir:
- Yapay zeka kullanımı için ücretler sağlayıcı hesabınızın faturalandırmasında görünecektir (OpenAI, Anthropic, vb.)
- API anahtarınız her istekte Cursor'ın sunucusuna gönderilecektir (ancak kalıcı olarak saklanmaz)
- Cursor, arka uç aracılığıyla son istem oluşturma ve işleme işlemlerini gerçekleştirir
Sekme Tamamlama gibi bazı özel özelliklerin belirli modeller gerektirdiğini ve özel API anahtarlarıyla çalışmayacağını unutmamak önemlidir. Özel anahtarlar yalnızca desteklenen sağlayıcılardan standart modelleri kullanan özellikler için çalışır.
Cursor'da Özel API Anahtarlarının Kurulumu
Adım 1: Ayarlar Paneline Erişin
- Bilgisayarınızda Cursor uygulamasını açın
2. Ayarlar simgesine tıklayın (genellikle sağ kenar çubuğunda veya menüde bulunur)
3. Ayarlar menüsünde "Modeller"i bulun ve seçin
Bu sizi, farklı sağlayıcılar için anahtar ekleyebileceğiniz API anahtarı yapılandırma sayfasına götürecektir.
Adım 2: Bir OpenAI API Anahtarı Ekleme
GPT-4 ve GPT-3.5 dahil olmak üzere OpenAI'nin modelleri, Cursor'da en yaygın kullanılanlar arasındadır. OpenAI API anahtarınızı şu şekilde ekleyebilirsiniz:
- İlk olarak, OpenAI platformundan bir API anahtarı edinin
- OpenAI hesabınızda oturum açın
- API bölümüne gidin
- Yeni bir API anahtarı oluşturun
- Anahtarı panonuza kopyalayın (OpenAI'nin anahtarı yalnızca bir kez gösterdiğini unutmayın)
- Cursor'ın Özel API Anahtarları ayarlarında:
- "OpenAI API Anahtarları" bölümünü bulun
- API anahtarınızı sağlanan alana yapıştırın
- Anahtarı doğrulamak için "Doğrula" düğmesine tıklayın
- Başarıyla doğrulandıktan sonra, OpenAI API anahtarınız etkinleştirilecek ve Cursor bunu uygun özellikler için kullanmaya başlayacaktır
Önemli Not: OpenAI'nin muhakeme modelleri (o1, o1-mini, o3-mini) özel yapılandırma gerektirir ve şu anda özel API anahtarlarıyla desteklenmemektedir.
Adım 3: Bir Anthropic API Anahtarı Ekleme
Anthropic'in Claude modelleri, yapay zeka destekli geliştirme için başka bir güçlü seçenek sunar. Anthropic API anahtarınızı eklemek için:
- Anthropic'in geliştirici platformundan bir API anahtarı edinin
- Anthropic hesabınız için kaydolun veya oturum açın
- API bölümüne gidin
- Yeni bir API anahtarı oluşturun
- Anahtarı kopyalayın
- Cursor'ın Özel API Anahtarları ayarlarında:
- "Anthropic API Anahtarları" bölümünü bulun
- Anthropic API anahtarınızı alana yapıştırın
- Anahtarı doğrulamak için "Doğrula"ya tıklayın
- Başarılı doğrulamanın ardından, Cursor claude tabanlı model etkileşimleri için Anthropic API anahtarınızı kullanacaktır
Adım 4: Bir Google API Anahtarı Ekleme
Google'ın Gemini modelleri, Cursor'da yapay zeka yardımı için başka bir seçenektir. Bir Google API anahtarını yapılandırmak için:
- Google AI Studio veya Google Cloud Platform'dan bir API anahtarı edinin
- API erişimi olan Google hesabınızda oturum açın
- Uygun kimlik bilgileri bölümüne gidin
- Yapay zeka/Gemini kullanımı için özel olarak yeni bir API anahtarı oluşturun
- Anahtarı kopyalayın
- Cursor'ın Özel API Anahtarları ayarlarında:
- "Google API Anahtarları" bölümünü bulun
- Google API anahtarınızı girin
- Doğrulamak için "Doğrula"ya tıklayın
- Doğrulama üzerine, Google API anahtarınız gemini-1.5-flash-500k gibi modeller için kendi maliyetinizle kullanılacaktır
Adım 5: Azure Entegrasyonunu Kurma
Azure OpenAI hizmetlerini kullanan kuruluşlar için Cursor, Azure'un API'si ile entegrasyon sunar. Yapılandırmak için:
- Azure portalınızda Azure OpenAI'yi kurun
- Bir Azure OpenAI kaynağı oluşturun
- Kullanmak istediğiniz modelleri dağıtın
- API anahtarınızı ve uç nokta bilgilerinizi edinin
- Cursor'ın Özel API Anahtarları ayarlarında:
- "Azure Entegrasyonu" bölümünü bulun
- Azure API anahtarınızı ve gerekli tüm uç nokta bilgilerini girin
- Gerekirse ek Azure'a özel ayarları yapılandırın
- Bağlantıyı doğrulamak için "Doğrula"ya tıklayın
- Doğrulamadan sonra, Cursor uygun istekleri Azure OpenAI dağıtımınıza yönlendirecektir
API Anahtarlarınızı Yönetme
Kullanımı İzleme
Kendi API anahtarlarınızı kullandığınız için, kullanımı izlemek önemlidir:
- Sağlayıcı faturalandırmasını takip edin: Maliyetleri izlemek için OpenAI, Anthropic, Google veya Azure'daki faturalandırma panolarınızı düzenli olarak kontrol edin
- Bütçe uyarıları ayarlayın: Beklenmedik ücretlerden kaçınmak için sağlayıcılarınızla harcama limitleri veya uyarılar yapılandırın
- Kullanım kalıplarını değerlendirin: Maliyetleri optimize etmek için en sık hangi modelleri ve özellikleri kullandığınızı düşünün
API Anahtarlarınızı Güvence Altına Alma
Cursor API anahtarlarınızı kalıcı olarak saklamasa da, bunlar isteklerle birlikte iletilir. Güvenliği korumak için:
- Uygun izinleri kullanın: En az gerekli izinlere sahip API anahtarları oluşturun
- Anahtarları düzenli olarak döndürün: Periyodik olarak yeni API anahtarları oluşturun ve bunları Cursor'da güncelleyin
- Yetkisiz kullanımı izleyin: Sağlayıcı panolarınızda alışılmadık etkinlik olup olmadığını kontrol edin
- Asla anahtar paylaşmayın: API anahtarlarını paylaşmaktan veya kod depolarına dahil etmekten kaçının
Yaygın Sorunları Giderme
Anahtar Doğrulama Başarısızlıkları
API anahtarınızı doğrulamada sorunlarla karşılaşırsanız:
- Yazım hatalarını kontrol edin: API anahtarının fazladan boşluk olmadan doğru bir şekilde kopyalandığından emin olun
- Hesap durumunu doğrulayın: Sağlayıcı hesabınızın mevcut kredilerle iyi durumda olduğunu doğrulayın
- Oran sınırlarını kontrol edin: Oran sınırlarına ulaştıysanız geçici doğrulama sorunları oluşabilir
- Farklı bir tarayıcı/cihaz deneyin: Bazen yerel ağ sorunları doğrulamayı engelleyebilir
Özellik Uyumluluğu
Tüm Cursor özelliklerinin özel API anahtarlarıyla çalışmadığını unutmayın:
- Sekme Tamamlama: Bu özellik özel modeller gerektirir ve özel anahtarlarla çalışmaz
- Sağlayıcıya özel özellikler: Bazı yetenekler belirli sağlayıcılara veya modellere bağlı olabilir
- Model kullanılabilirliği: İhtiyacınız olan modellerin sağlayıcı hesabınızda mevcut ve etkin olduğundan emin olun
Sıkça Sorulan Sorular
API anahtarım saklanacak mı veya cihazımdan ayrılacak mı?
API anahtarınız Cursor tarafından kalıcı olarak saklanmayacak, ancak her istekte Cursor'ın sunucusuna gönderilecektir. Tüm istekler, son istem oluşturmanın gerçekleştiği Cursor'ın arka ucundan yönlendirilir.
Hangi özel LLM sağlayıcıları desteklenmektedir?
Cursor, resmi olarak OpenAI, Anthropic, Google ve Azure'u destekler. Uygulama ayrıca OpenAI API formatıyla uyumlu API sağlayıcılarını (OpenRouter gibi) da destekler. Cursor, özel yerel LLM kurulumları veya diğer API formatları için destek sağlamaz.
Özel ve Cursor tarafından sağlanan API anahtarları arasında geçiş yapabilir miyim?
Evet, herhangi bir plan sınırlamasına tabi olarak, Cursor'ın yerleşik hizmetini kullanmaya geri dönmek için özel API anahtarlarınızı istediğiniz zaman devre dışı bırakabilirsiniz.
Yapay Zeka Otomasyonunuzu Apidog MCP Sunucu Entegrasyonu ile Geliştirin
Yapay zeka destekli iş akışlarınızı, Apidog MCP Sunucusu ile entegre ederek daha da ileriye taşıyın.
Bu güçlü bağlantı, yapay zeka asistanınızın Apidog projelerinden API spesifikasyonlarıyla doğrudan etkileşim kurmasını sağlayarak, sorunsuz API keşfi, kod oluşturma ve yapılandırılmış model oluşturma olanağı sunar.
Sonuç
Cursor'a özel API anahtarları eklemek, yapay zeka destekli geliştirme iş akışınız üzerinde daha fazla esneklik ve kontrol sağlar. Bu eğitimi takip ederek, tercih ettiğiniz yapay zeka sağlayıcılarınızı (OpenAI, Anthropic, Google veya Azure) sorunsuz bir şekilde entegre edebilir ve maliyetleri kendi şartlarınızda yönetirken Cursor'ın tüm gücünden yararlanabilirsiniz.
Özel API anahtarlarının birçok avantaj sunarken, aynı zamanda kendi kullanımınızı izleme ve yönetme sorumluluğu da getirdiğini unutmayın. Bütçeniz dahilinde kaldığınızdan emin olmak için sağlayıcı faturalandırma panolarınızı düzenli olarak kontrol edin ve API anahtarlarınızı güvence altına almak için uygun önlemleri alın.
Özel API anahtarlarınız doğru bir şekilde yapılandırıldığında, Cursor'da özel geliştirme ihtiyaçlarınıza ve tercihlerinize göre uyarlanmış sınırsız yapay zeka yardımının keyfini çıkarabilirsiniz.
