Cursor ile DeepSeek V4-Pro Nasıl Kullanılır: Akıl Yürütme Proxy Kurulum Rehberi (2026)

DeepSeek V4-Pro'yu Cursor'a varsayılan OpenAI uyumlu ayarlarıyla takın ve ilk araç çağrısı 400 hatası döndürür. Nedeni küçük ama inatçı: V4-Pro, reasoning_content bloğu döndüren bir düşünme modelidir, Cursor bu alanı sonraki isteklerinden çıkarır ve DeepSeek'in API'si muhakeme zincirini düşüren araç çağrısı mesajlarını reddeder. yxlao/deepseek-cursor-proxy adresindeki açık kaynaklı bir proxy, muhakeme içeriğini önbelleğe alır ve giden isteklere yeniden enjekte eder. Proxy çalıştığında, V4-Pro, Cursor'ın özel model panelindeki diğer modeller gibi davranır ve düşünme tokenleri katlanabilir markdown olarak görüntülenir. Aşağıda tam kurulum, maliyet hesaplaması ve sorun giderme listesi bulunmaktadır.

Kısaca

DeepSeek V4-Pro ile Cursor, varsayılan olarak 400 hatası döndürür, çünkü V4-Pro bir düşünme modelidir ve Cursor, araç çağrısı mesajlarında reasoning_content'i çıkarır.
deepseek-cursor-proxy (açık kaynak, Python) Cursor ile DeepSeek arasına oturur, her konuşmanın muhakeme içeriğini önbelleğe alır ve araç çağrılarının başarısız olmaması için yeniden enjekte eder.
Kurulum: uv veya pip aracılığıyla yükleyin, deepseek-cursor-proxy'yi çalıştırın, ngrok URL'sini ve DeepSeek API anahtarınızı Cursor'ın özel model ayarlarına yapıştırın.
Cursor içindeki V4-Pro artık milyon çıktı tokeni başına yaklaşık 0,87 ABD dolarına mal oluyor, bu da çıktıda GPT-5.5'ten yaklaşık 34 kat daha ucuzdur. Tam fiyatlandırma bağlamı için DeepSeek V4-Pro %75 Fiyat İndirimi Artık Kalıcı makalesine bakın.

Neden bir proxy'ye ihtiyacınız var?

V4-Pro her yanıtta iki şey döndürür: normal bir content alanı ve düşünce zincirini barındıran bir reasoning_content alanı. Sıradan sohbet için reasoning_content'i göz ardı edebilirsiniz. Sorun araç çağrılarıyla başlar.

DeepSeek'in düşünme modelleri için API sözleşmesi, reasoning_content bloğu içeren bir konuşmaya devam ettiğinizde, bu bloğu tool_calls sonucuyla birlikte bir sonraki isteğe dahil etmenizi gerektirir. Muhakeme zinciri, konuşma durumunun bir parçasıdır. Cursor bu gereksinimi bilmez. Bir OpenAI tarzı sohbet istemcisi gönderir ve reasoning_content, OpenAI şemasının bir parçası olmadığından bu alanı düşürür. Sonraki araç çağrısı HTTP 400 ve eksik bir reasoning_content mesajıyla geri döner.

Bu tam olarak bir Cursor hatası değildir. Bu, API yüzeylerinin çoğunu paylaşan iki sağlayıcı arasındaki bir sözleşme uyumsuzluğudur. Cursor birinci sınıf V4-Pro desteği ekleyene veya DeepSeek sözleşmeyi gevşetene kadar, geçici çözüm Cursor'ın unuttuğunu hatırlayan bir proxy'dir.

Proxy ne yapar, üç satırda

Cursor'ın giden sohbet istekleri için yerel bir portta (varsayılan 9000) dinler.
Her V4-Pro yanıtından gelen reasoning_content'i, kanonik konuşma ön ekinin SHA-256'sına göre anahtarlayarak önbelleğe alır.
Her yeni istekte, eşleşen ön ek için önbelleğe alınmış reasoning_content'i arar ve DeepSeek'e iletmeden önce mesaja ekler.

Ayrıca yerel portu bir ngrok tüneli aracılığıyla açar, çünkü Cursor'ın özel model ayarı HTTPS gerektirir ve bir localhost URL'sini kabul etmez.

Önbellek ~/.deepseek-cursor-proxy/reasoning_content.sqlite3 içinde bulunur. SHA-256 anahtarlama, iki paralel konuşmanın çakışmamasını sağlar. Muhakeme içeriği, DeepSeek'in döndürdüğü gibi depolanır, böylece DeepSeek'in kendi istem önbelleği hala isabet eder, bu da yeni kalıcı fiyatlandırma için önemlidir.

Ön Koşullar

Başlamadan önce dört şeye ihtiyacınız var:

Cursor 2.0 veya daha yeni. Özel model kullanıcı arayüzü 3.x'te aynıdır; ikisi de çalışır.
Bir DeepSeek API anahtarı. Yoksa platform.deepseek.com adresinden kaydolun. Küçük bir bakiye yeterlidir; fiyatlandırma ayrıntıları aşağıdadır.
Python 3.11 veya daha yeni. Proxy tamamen Python'dır. uv önerilir ancak pip de çalışır.
Bir yetkilendirme anahtarına sahip bir ngrok hesabı. Ücretsiz katman, solo geliştiriciler için yeterlidir. Statik alan adları isteğe bağlıdır ancak proxy'yi sık sık yeniden başlatırsanız hayatı kolaylaştırır.

Daha önce hiç uv yüklemediyseniz, resmi uv kurulum belgelerine bakın. ngrok için, ngrok hızlı başlangıç size yetkilendirme anahtarı adımında rehberlik edecektir.

Adım 1: Proxy'yi kurun

En hızlı yol uv'dir. Herhangi bir dizinden:

uv tool install deepseek-cursor-proxy

Pip'i tercih ediyorsanız, depoyu klonlayın ve düzenlenebilir bir paket olarak yükleyin:

git clone https://github.com/yxlao/deepseek-cursor-proxy.git
cd deepseek-cursor-proxy
pip install -e .

Her iki yol da deepseek-cursor-proxy komutunu PATH'inize ekler. deepseek-cursor-proxy --help ile doğrulayın.

Adım 2: ngrok'u yapılandırın

Proxy'nin genel bir HTTPS URL'sine ihtiyacı var çünkü Cursor'ın özel model alanı http://localhost'u kabul etmeyecek. ngrok tüneli sağlar.

ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN

Kaydolduktan sonra yetkilendirme anahtarınızı ngrok kontrol panelinden alın. Ücretsiz katman, her yeniden başlatmada rastgele bir alt alan adı verir. Bu bir sorunsa, kontrol panelinde ayrılmış bir alan adı talep edin ve bunu --ngrok-url https://your-reserved.ngrok-free.app ile proxy'ye geçirin.

Adım 3: Proxy'yi başlatın

Varsayılanlar çoğu kurulum için uygundur:

deepseek-cursor-proxy

İlk çalıştırmada proxy, ~/.deepseek-cursor-proxy/config.yaml dosyasını oluşturur, bir tünel açar ve genel URL'yi yazdırır. Çıktı şöyle görünür:

Starting deepseek-cursor-proxy
Tunnel: https://random-name.ngrok-free.app
Local:  http://127.0.0.1:9000
Cache:  /Users/you/.deepseek-cursor-proxy/reasoning_content.sqlite3

Faydalı bayraklar:

--port 9000: 9000 doluysa yerel portu değiştirin.
--verbose: istek ve yanıt gövdelerini yazdırın. Cursor entegrasyonunda hata ayıklarken bunu kullanın.
--no-ngrok: tüneli atlayın. http://localhost'u kabul eden bir araçtan test yaparken kullanışlıdır.
--no-display-reasoning: Cursor'ın görünümünden katlanabilir düşünme bloklarını kaldırın. Muhakeme hala akar; yalnızca görüntüleme engellenir.

Proxy'yi ayrı bir terminalde çalışır durumda tutun veya macOS'ta bir launchctl işine sarın. Cursor her istekte onunla konuşur.

Adım 4: Cursor'ı yapılandırın

Cursor'ın ayarlarını açın, Modellere gidin ve özel bir model ekleyin. İhtiyacınız olan alanlar:

Model adı: deepseek-v4-pro. Proxy bu dizeyi doğrudan DeepSeek'e iletir, bu nedenle gerçek bir DeepSeek model tanımlayıcısıyla eşleşmelidir. Daha ucuz varyant için deepseek-v4-flash kullanın.
Temel URL: proxy'nin yazdırdığı ngrok URL'si artı /v1. Örnek: https://random-name.ngrok-free.app/v1.
API anahtarı: DeepSeek API anahtarınız (sk- ile başlar). Proxy'nin kendi kimlik doğrulama katmanı yoktur; anahtarı olduğu gibi iletir.

Cursor bir "Modeli Doğrula" kontrolü çalıştırır. Kontrol tek bir sohbet tamamlama gönderir. Yeşil bir tik, işinizin bittiği anlamına gelir. Bir bağlantı hatası genellikle ngrok URL'sini işaret eder: proxy çıktısından tekrar kopyalayın ve /v1 ile bittiğini doğrulayın.

Adım 5: Modeli seçin ve bir araç çağrısı deneyin

Sohbet panelindeki model seçiciyi açın ve yeni özel modelinizi seçin. Denenecek ilk istem, araç kullanımını zorlayan bir istemdir, çünkü orijinal 400 hatalarının oluştuğu yer araç çağrılarıydı:

"Bu depodaki README'yi açın, her kod bloğunu listeleyin ve hangilerinin dil ipuçlarını eksik olduğunu söyleyin."

Cursor bir read_file araç çağrısı yayınlayacaktır. Proxy işini yapıyorsa, yanıt zinciri şöyle görünür:

Cursor kullanıcı mesajını proxy'ye gönderir.
Proxy, reasoning_content olmadan DeepSeek'e iletir (bu ilk dönüştür).
DeepSeek metin, bir reasoning_content bloğu ve bir tool_calls isteği döndürür.
Proxy, reasoning_content'i konuşma ön eki hash'ine göre anahtarlayarak önbelleğe alır.
Cursor aracı çalıştırır, ardından araç sonucuyla birlikte bir takip isteği gönderir. Takip isteği, Cursor onu düşürdüğü için reasoning_content içermez.
Proxy, önbelleğe alınmış reasoning_content'i ön ek hash'ine göre arar ve iletmeden önce yeniden enjekte eder.
DeepSeek isteği kabul eder, muhakemeye devam eder ve nihai yanıtı döndürür.

--verbose ile çalıştırırsanız, enjeksiyonun loglarda gerçekleştiğini görürsünüz.

Uygulamada maliyet nasıl görünür

Cursor içindeki V4-Pro, DeepSeek'in standart API oranlarını öder, Cursor'ın paketlenmiş kredi fiyatlandırmasını değil. Bu oranlar Mayıs 2026 itibarıyla kalıcıdır:

Token türü	1 milyon token başına oran
Girdi (önbellek ıskası)	0,435 dolar
Girdi (önbellek isabeti)	0,003625 dolar
Çıktı	0,87 dolar

Yoğun bir Cursor günü kabaca 50 sohbet dönüşü artı 20 araç çağrısı zinciri gibi görünür. Her dönüş ortalama 8.000 istem tokeni (dosya bağlamı artı sistem istemi artı geçmiş) ve 1.500 çıktı tokeni tutar. Bu da:

50 dönüş × 8.000 girdi × 0,435 dolar / 1.000.000 = en kötü durumda 1,74 dolar
%60 oranında 6.000 tokenlik sistem ve bağlam ön eki üzerinde önbellek isabetleriyle: yaklaşık 0,85 dolar
50 × 1.500 × 0,87 dolar / 1.000.000 = 0,065 dolar çıktı

Toplam: yoğun bir gün için yaklaşık 1 dolar. Aynı iş yükünü Cursor Pro'nun paketlenmiş GPT-5.5 kotası aracılığıyla çalıştırmakla karşılaştırıldığında, bu, kota kısıtlaması devreye girmeden önce bir büyüklük derecesi daha ucuzdur. Tam fiyat indirimi hesaplaması DeepSeek V4-Pro %75 Fiyat İndirimi Artık Kalıcı makalesindedir.

DeepSeek'in diğer ürün yelpazesinin bağlamı için DeepSeek V4 nedir ve DeepSeek V4 API nasıl kullanılır makalelerine bakın.

V4-Pro, Cursor içinde nasıl hissettiriyor

Varsayılan Cursor modelinize kıyasla üç fark ortaya çıkar.

1. Düşünme tokenleri görünür. Varsayılan olarak proxy, DeepSeek'in muhakemesini her yanıtın üzerinde katlanabilir bir markdown bloğu olarak gösterir. Cursor'ın sohbet paneli bunu bir <details> öğesi olarak görüntüler. İstemi hata ayıklamak için kullanışlıdır; rutin işler için gürültülüdür. --no-display-reasoning ile değiştirilebilir.

2. İlk araç çağrısındaki gecikme daha yüksektir. V4-Pro bir düşünme modelidir ve zincir herhangi bir araç çağrısından önce çalışır. İlk araç tetiklenmeden önce 2 ila 4 saniye bekleyin, ardından takiplerde standart verim sağlanır.

3. Cursor'ın "Uygula" önerileri karmaşık yeniden düzenlemelerde daha iyi hale gelir. Manşet budur. V4-Pro'nun muhakeme zinciri, düz tamamlama modellerinin kaçırdığı çoklu dosya bağımlılıklarını yakalar. GPT-5.5 ile üç tur gerektiren yeniden adlandırmalar, imza değişiklikleri ve yapılandırma odaklı yeniden düzenlemeler genellikle V4-Pro ile tek seferde halledilir.

Önceki modeller için diğer DeepSeek-Cursor kılavuzları da mevcuttur. Eski kalıplar için DeepSeek R1'i Cursor ile yerel olarak nasıl kullanacağınız ve DeepSeek V3'ü Cursor ile: adım adım makalelerine bakın. Bu kılavuzdaki proxy, bu yazılarda belgelenen manuel muhakeme enjeksiyonu hilelerinin yerini alır.

DeepSeek kurulumunuzu Apidog ile test etme

Cursor entegrasyonu yalnızca Cursor içindeki yolu kanıtlar. V4-Pro'yu başka yüzeylere (bir CI botu, bir arka uç ajanı, özel bir IDE eklentisi) gönderiyorsanız, proxy'nizin ilettiği aynı uç noktaya karşı deterministik bir test düzeneğine ihtiyacınız vardır.

İşte Apidog burada yerini kazanıyor. Bir Apidog ortamını https://api.deepseek.com/v1 adresine yönlendirin, API anahtarınızı bırakın ve OpenAI Sohbet Tamamlama şemasını içe aktarın. Şunları yapabilirsiniz:

V4-Pro'dan "golden" yanıtları kaydedin ve kaymayı yakalamak için her istem değişikliğinde yeniden oynatın.
JSON Şema onaylarıyla tool_calls şekillerini doğrulayın, böylece kötü bir sistem istemi düzenlemesi üretim ajanıınızı sessizce bozmaz.
Apidog'un test senaryolarını kullanarak aynı girdi grubunda V4-Pro ve GPT-5.5'i yan yana karşılaştırın.

Apidog'u indirin, DeepSeek OpenAPI spesifikasyonunu içe aktarın ve beş dakika içinde çalışan bir V4-Pro test tezgahına sahip olun. DeepSeek V4 API nasıl kullanılır makalesinde anlattığımız iş akışının aynısıdır.

Yaygın Tuzaklar

İlk araç çağrısından sonra 400 hataları. Bu proxy'nin çözmek için yapıldığı klasik hata modu. Kurulumdan sonra hala görüyorsanız, proxy çalışmıyor veya Cursor yanlış temel URL'ye işaret ediyor demektir. URL'nin /v1 ile bittiğini ve proxy günlüğünün gelen istekleri gösterdiğini yeniden kontrol edin.

ngrok tüneli sürekli yeniden bağlanıyor. Ücretsiz katman tünelleri yeniden başlatmada döner. Cursor'ın doğrulaması geçer ancak birkaç dakika sonra başarısız olursa, tüneliniz döngüye girmiştir. Ayrılmış bir alan adına geçin (ngrok kontrol panelinde tek tıklama) ve --ngrok-url ile geçirin.

Muhakeme içeriği yinelenmiş olarak görünüyor. Bu, iki proxy örneği aynı SQLite önbellek yoluyla çalıştığında olur. İkisini de durdurun, ~/.deepseek-cursor-proxy/reasoning_content.sqlite3'ü silin ve tek bir örneği başlatın.

Önbellek isabet oranı düşük görünüyor. DeepSeek'in istem önbelleği, bayt düzeyinde aynı ön ekler gerektirir. Cursor, bazı sistem istemlerine zaman damgaları ve oturum kimlikleri ekler, bu da önbellek isabetlerini engeller. Çözüm proxy'nin içinde değildir; ya maliyeti kabul edin ya da V4-Pro oturumları için Cursor'ın "sistem istemi yok" modunu kullanın.

Cursor "model bulunamadı" hatası bildiriyor. Cursor'ın ayarlarındaki model adı gerçek bir DeepSeek modeliyle eşleşmelidir. Bugün geçerli değerler deepseek-v4-pro, deepseek-v4-flash, deepseek-v3-2-pro ve deepseek-r1-1'dir. Proxy adları çevirmez; onları iletir.

Proxy size uygun değilse alternatifler

Proxy bugün en temiz yoldur, ancak iki alternatif mevcuttur:

Proxy olmadan V4-Flash. V4-Flash bir düşünme modeli değildir ve reasoning_content döndürmez. Cursor onunla doğrudan, geçici bir çözüm olmadan konuşur. Düşünce zinciri artışından vazgeçersiniz ama entegrasyonu basit tutarsınız. Fiyatlandırma milyon token başına 0,14 / 0,28 dolardır.
Yerel düşünme modeli desteğine sahip Cline, Continue veya diğer AI IDE eklentileri. Bu araçlar, araç çağrısı mesajlarındaki reasoning_content'i yerel olarak işler. Özel olarak Cursor'a bağlı değilseniz, düzenleyiciyi değiştirmek bazen proxy çalıştırmaktan daha kolaydır. Alan için 2026'nın en iyi açık kaynak kodlama yardımcıları: ücretsiz Cursor alternatifleri makalesine bakın.

Ayrıntılı olarak ele alınan diğer Cursor model entegrasyonları: Claude Opus 4.6 ile Cursor, Kimi K2.5 ile Cursor ve Gemini 3.0 Pro ile Cursor.

SSS

Cursor neden DeepSeek V4-Pro'yu yerel olarak desteklemiyor? Cursor'ın sohbet istemcisi OpenAI Sohbet Tamamlama şemasını takip eder. reasoning_content bu şemanın bir parçası değildir; R1 ailesiyle ortaya çıkan ve V4-Pro'da kalan DeepSeek'e özgü bir uzantıdır. Cursor'ın alanı geçirmek için sağlayıcıya özgü bir işlem eklemesi gerekir. Yapabilirler; o zamana kadar, proxy geçici çözümdür.

Proxy, DeepSeek R1 veya V3.2 ile çalışır mı? Evet. reasoning_content döndüren ve araç çağrısı takiplerinde bunu gerektiren herhangi bir DeepSeek düşünme modeli desteklenir. Cursor'ın ayarlarındaki model adını gerçek DeepSeek model tanımlayıcısına ayarlayın.

Proxy'yi çalışır durumda bırakmak güvenli mi? Evet, tek bir uyarı ile: SQLite önbelleği, oturumlarınızdan ham muhakeme içeriği içerir. Çok kullanıcılı kurulumlar çalıştırıyorsanız veya makineleri paylaşıyorsanız, önbellek dizininin izinlerini kısıtlayın veya --no-cache ile çalıştırın (yalnızca bellekte, bu da bir proxy yeniden başlatmasından sonra araç çağrılarının başarısız olacağı anlamına gelir).

Proxy'yi ngrok olmadan kullanabilir miyim? Evet, --no-ngrok ile. Proxy o zaman yalnızca http://127.0.0.1:9000'i açığa çıkarır. Cursor'ın özel model kullanıcı arayüzü standart sürümlerde http:// URL'lerini reddeder, ancak bazı yan yüklemeli yapılar ve yama uygulanmış yapılandırmalar localhost'u kabul eder. Çoğu kullanıcı ngrok veya eşdeğerini (Cloudflare Tunnel, Tailscale Funnel) isteyecektir.

Bu, Cursor Composer 2.5 ile çalışır mı? Composer, sohbet paneliyle aynı model yönlendirme hattını kullanır, evet. Bir Composer ajanı içindeki ilk araç çağrısı aynı reasoning_content gereksinimini tetikleyecek ve proxy bunu aynı şekilde düzeltir.

Proxy'nin gecikme ek yükü nedir? Önemsizdir. Proxy, istek başına bir yerel ağ atlaması, bir SQLite araması ve birkaç KB'lik JSON manipülasyonu ekler. Ölçülen ek yük çağrı başına 5 ila 15 ms'dir. ngrok, en yakın uç noktaya bağlı olarak 30 ila 80 ms ekler. Proxy darboğaz değildir.

Proxy neyi önbelleğe alacağına nasıl karar verir? Konuşma ön ekini (en son kullanıcı veya araç mesajından önceki her şey) hash'ler, bu hash'in SHA-256'sını son DeepSeek yanıtından gelen reasoning_content'e anahtarlar ve ikisini de SQLite'da depolar. Bir sonraki istekte, yeni ön ekin hash'ini hesaplar ve eşleşen girişi arar. Bu muhafazakardır. Kısmi ön ek eşleşmeleri bir önbellek isabetini tetiklemez, bu nedenle iki neredeyse aynı konuşma birbirini kirletmez.

Anthropic, OpenAI veya Cursor bunu bozar mı? Anthropic ve OpenAI dahil değildir. Cursor ya yerel düşünme modeli desteği ekleyebilir (bu durumda proxy gereksiz hale gelir) ya da istek formatını proxy'yi bozacak şekilde değiştirebilir. Depo bakımı yapılıyor; uyumluluk güncellemeleri için sorunlarını izleyin.

Bu sizi nereye getiriyor

V4-Pro'nun kodlama yeteneği, GPT-5.5'in (DataCamp karşılaştırması) birkaç kıyaslama noktası içinde, çıktı fiyatının kabaca 1/34'ü kadardır. Cursor kullanıcıları için tek engel, reasoning_content etrafındaki bir API sözleşmesi uyumsuzluğuydu. deepseek-cursor-proxy deposu, bunu yüz satırdan az anlamlı kod ve beş dakikalık bir kurulumla çözüyor.

Üç somut sonraki adım:

Proxy'yi kurun ve deponuzdan beş gerçek çekme isteği üzerinde mevcut Cursor varsayılanınızla yan yana bir test çalıştırın.
Önbellek isabetlerini engelleyen değişken içerik (zaman damgaları, oturum kimlikleri) için Cursor sistem isteminizi denetleyin. Bu içeriği kullanıcı mesajına taşıyın.
api.deepseek.com adresine karşı bir Apidog regresyon testi paketi kurun, böylece sözleşme kaymasını her seferinde Cursor aracılığıyla yeniden test etmeden yakalayabilirsiniz.

Düşünme tokeni vergisi ödendi. Fiyat etiketi ise öyle değil.

düğme