Ana SayfaKılavuz
Cursor için Claude Code API: Özel Uç Nokta Kurulumu
Tek bir sağlayıcıya bağımlı olmayan bir Cursor kurulumu mu arıyorsunuz? Cursor herhangi bir OpenAI uyumlu uç noktaya bağlanabilir ve bu rehberde ihtiyacınız olan her ayarı gösteriyoruz.
güncellendi

Kurulumunuz
Cursor, yerleşik AI özelliklerine sahip bir editördür. Model ayarları arasında, OpenAI base URL'sini kendi URL'nizle değiştirmenize ve kendi anahtarınızı girmenize olanak tanıyan bir alan bulunur. Bu, OpenAI chat-completions formatını takip eden herhangi bir hizmete sohbet istekleri gönderilmesini mümkün kılar. Bu hizmet de bu formatı takip eder, bu nedenle Cursor bunu sohbet ve satır içi düzenlemelerin arkasındaki model olarak kullanabilir.
Gireceğiniz değerler sabittir. Base URL: https://api.claudecodeapikey.com/v1. Model adı: uncensored. Anahtar: hesabınızdan gelen ve Bearer token olarak gönderilen anahtar. Sunucu tarafında başka hiçbir yapılandırma gerekmez.
Bunun ne olduğunu netleştirin. Uç noktanın arkasındaki model bağımsız bir sağlayıcıdan açık ağırlıklı bir modeldir. Bu bir Claude modeli değildir ve Anthropic veya başka herhangi birinin resmi API'si değildir. Eğer Cursor içinde doğrudan Claude bekliyorsanız, bu farklı bir şeydir ve kapanış bölümleri bunun işiniz için yeterli olup olmadığını nasıl değerlendireceğinizi açıklar.
Cursor'ı açmadan önce
Yarı yolda kalmamak için bunları önceden hazırlayın.
- Google veya e-posta ve şifre ile bir hesap oluşturun.
- API anahtarı sayfasını açın ve bir anahtar oluşturun. anahtar kılavuzu her düğmenin nerede olduğunu gösterir.
- Ödemeden test etmek istiyorsanız $0,50 deneme kredisi talep edin. Tek tıklama ile yapılır, kart gerekmez ve 7 gün sürer.
- Editörü suçlamadan önce anahtarın çalıştığını doğrulamak için bir terminalden hızlı bir kontrol çalıştırın.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Bir mesaj içeren bir JSON yanıtı, anahtar ve URL'nin doğru olduğunu gösterir. HTTP 401, anahtarın yanlış veya etrafında boşluk karakteri içerdiğini gösterir. Bunu burada düzeltin, çünkü Cursor'ın hata mesajları curl'dakinden daha az özeldir.
Cursor'da adım adım yapılandırma
Menü adları Cursor sürümleri arasında değişebilir, bu nedenle aşağıdaki etiketleri bir rehber olarak kabul edin ve en yakın eşleşmeyi arayın.
- Cursor'un ayarlarını açın ve modeller bölümüne gidin.
- Bir OpenAI API anahtarı için alanı bulun ve anahtarınızı bu hizmetten yapıştırın.
- OpenAI base URL'sini geçersiz kılma seçeneğini açın ve
https://api.claudecodeapikey.com/v1girin. Sonuna/v1ekleyin ve/chat/completionsgibi herhangi bir son yol bırakmayın. - Özel model ekleme seçeneğini kullanın ve
uncensoredtam olarak, küçük harfle yazın. - Anahtar alanının yanındaki doğrula veya kaydet düğmesine basın. Cursor küçük bir test isteği gönderir.
- Bir sohbet paneli açın, model açılır menüsünden
uncensoredseçin ve kısa bir istem gönderin.
Doğrulama adımı başarısız olur ama curl kontrolü geçtiyse, URL'yi anahtar alanına değil base URL alanına yazdığınızdan ve güncelleme sonrası geçersiz kılmanın sıfırlanmadığından emin olun. hızlı başlangıç bu editör için mevcut adımları korur.
Bilinmesi gereken bir ayrıntı: tek bir geçersiz kılma, OpenAI sağlayıcı yuvasına uygulanır. Eğer bu yuva üzerinden gerçek OpenAI modelleri de kullanıyorsanız, bunlar da artık bu uç noktaya yönlendirilecektir. Birçok kişi, geri dönmek istediğinde ayrı bir Cursor profili tutar veya geçersiz kılmayı kapatır.
Gerçek bir kod istemiyle test etme
Bir selamlama çok az şey kanıtlar. Bağlamı ve talimatları kullanan bir istem kullanın. Projenizdeki bir işlevi seçin, sohbeti açın ve somut bir şey isteyin, örneğin girdi doğrulama ve bir birim test ekleme. Üç şeye dikkat edin.
- Akış. Yanıt token token görünmelidir. Uç nokta SSE üzerinden akış yaptığı için, uzun bir beklemeden sonra gelen metin bloğu bir proxy'nin veya ayarın tamponladığını gösterir.
- Bağlam kullanımı. İki veya üç dosya ekleyin ve hepsini gerektiren bir soru sorun. Pencere 100.000 token kapasitesine sahiptir, bu çok fazla kaynak tutar, ancak editörün gerçekten ne kadarını gönderdiğini o belirler.
- Talimat takip etme. Sadece diff yanıtı veya sıkı bir çıktı formatı isteyin ve modelin buna uyup uymadığını görün. Açık ağırlıklı modeller burada farklılık gösterir ve ilk günde onu öğrenmek istersiniz.
Kendi deponuzdan beş gerçek görevin kısa bir listesini tutun ve sıcaklık gibi bir ayarı değiştirdiğinizde bunları yeniden çalıştırın. Kendi kodunuzdan yargılamak, bizimkiler dahil genel tüm iddialardan daha iyidir.
Yaygın hataları düzeltme
401 veya geçersiz anahtar
Anahtar yanlış, panodan süresi dolmuş veya etrafında boşluk karakteri içeriyor. Tekrar yapıştırın. Yetkilendirme şemasının Bearer olduğundan emin olun, Cursor bunu OpenAI anahtar alanını kullandığınızda sizin için yapar.
404 veya model bulunamadı
Neredeyse her zaman bir base URL sorunudur. Eksik /v1 veya ekstra /chat/completions yolu bozar. Model adı da uncensored olmalı, büyük harf veya boşluk olmadan.
429 ile rate_limited veya concurrency
Bir limite ulaştınız. Deneme anahtarı 2 eşzamanlı istek ve dakika başına 60 istek izni verir; tam anahtar ise 8 eşzamanlı ve dakika başına 300 istek izni verir. Bir editör aynı anda birden fazla istek gönderebilir; örneğin sohbet ve arka plan düzenlemeleri. Akışlar, sona erene kadar slotlarını korur. Hata kodu hangi limite ulaştığınızı gösterir: rate_limited dakika başına istek sayısını, concurrency ise aynı anda çok fazla istek gönderildiğini belirtir. Geçici bir aşırı yüklenme durumunda da 429 yanıtı ve Retry-After: 5 başlığı döndürülür; bu nedenle beş saniye bekleyip yeniden denemek doğrudur.
Yanıt kesiliyor
Pencere 100.000 token kapasitesine sahiptir, istem ve tamamlama toplamı. Çok büyük bir ek, yanıt için çok az yer bırakır. Daha az dosya gönderin veya yeni bir sohbet başlatın.
Hiçbir işe yaramayan özellikler
API sadece metindir ve embedding sunmaz. Bir Cursor özelliği bir embedding modeli veya görsel girdi gerektiriyorsa, bu uç nokta üzerinden çalışmaz.
Çalıştıktan sonra ince ayar yapmaya değer ayarlar
İlk başarılı sohbetin ardından, günlük kullanımı daha sorunsuz hale getirecek birkaç ayarlama vardır.
Düzenleme görevleri için sıcaklığı düşürün. Editörünüz bu ayarı sunuyorsa, yaklaşık 0,2 değeri daha kararlı kod üretir. Beyin fırtınası için sıcaklığı artırın. Ardından, eklediğiniz bağlam miktarına dikkat edin. Pencere geniş olsa da, eklenen her dosya girdi olarak faturalandırılır; bu nedenle ilgisiz sekmeleri kapatmak ve build klasörlerini hariç tutmak maliyeti düşürür ve yanıtları daha odaklı hale getirir.
Agent veya çok adımlı modları kullanıyorsanız, fonksiyon çağırma desteğini unutmayın: uç nokta tools ve tool_choice parametrelerini kabul eder ve tool_calls sonucunu akış olarak gönderir. Belirli bir Cursor özelliğinin bunları kullanıp kullanmadığı sürüme bağlıdır; bu nedenle büyük bir değişiklik yapmadan önce küçük bir agent görevi çalıştırıp ne olduğunu okuyun. Son olarak, çalışırken ortada sürpriz yaşamamak için terminal testinde X-Balance-USD başlığını arada bir kontrol edin.
Komut dosyalarında aynı anahtarı kullanma
OpenAI uyumlu bir uç noktanın avantajlarından biri, Cursor'da ayarladığınız anahtarın kodda da çalışmasıdır. İşte build betikleri veya commit mesajı araçları için kullanışlı bir Node örneği.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Anahtarı bir dosyada değil, bir ortam değişkeninde saklayın. Her yanıt bir X-Balance-USD başlığı içerir, böylece bir komut dosyası kredi azaldığında sizi uyarabilir.
Maliyet ve ne zaman mevcut yapıda kalmak
Editör kullanımı girdi ağırlıklıdır çünkü her istek dosya bağlamını taşır. 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50 fiyatla, 15.000 girdi token ve 1.000 çıktı token içeren bir istek 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275 maliyetine sahiptir. Yüz tanesi $0,275 eder. fiyatlandırma sayfası bakiye yükleme miktarlarını, $20'dan başlayan tutarları ve $50'den başlayan bonusları listeler.
Zorlu yeniden yapılandırmalar için belirli bir sağlayıcının modeline bağlıysanız veya iş akışınız düz bir sohbet uç noktasının sağlayamayacağı özelliklere dayanıyorsa mevcut kurulumunuzu koruyun. Düşük token başına fiyat, düz bir API ve yasal işlerde daha az içerik reddi istiyorsanız bunu kullanın. Geliştiricilerin çoğu her ikisini de yapılandırılmış olarak tutar ve görevlere göre geçiş yapar.
Daha fazla kılavuz
Sorular ve cevaplar
Cursor'a hangi base URL'yi girmeliyim?
https://api.claudecodeapikey.com/v1 değerini /v1 dahil olacak şekilde girin. Sonuna /chat/completions eklemeyin.
Hangi model adını eklemeliyim?
uncensored adlı özel modeli küçük harfle ekleyin. API'nin sunduğu tek model ID'si budur.
Bu bana Cursor'da Claude modellerini verir mi?
Hayır. Uç nokta bağımsız bir sağlayıcıdan tek bir açık ağırlıklı model sunar. Bu, Anthropic veya başka bir sağlayıcının resmi API'si değildir.
Editörde neden 429 hataları alıyorum?
Ya dakikalık hız limitini aştınız ya da aynı anda çok fazla istek gönderiyorsunuz. Bir deneme anahtarı 2 eşzamanlı ve dakika başına 60 isteğe izin verir, tam anahtar ise 8 ve 300 isteğe izin verir.
Ödeme yapmadan deneyebilir miyim?
Evet. Yeni kullanıcılar API anahtarı sayfasından $0,50 değerinde deneme kredisi talep edebilir. Kart gerektirmez ve 7 gün boyunca geçerlidir.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.