Cline'da özel API anahtarı

Cline kodlama istemcisidir. API provider modeli sunar, isteği doğrular ve token kullanımını faturalandırır. Özel anahtar bu iki katmanı bağlar; ücretli model kullanımını ücretsiz yapmaz ve sağlayıcının erişim kurallarını aşmaz.

Cline'ın resmi OpenAI Compatible yapılandırmasında gerekli alanlar bulunur: API Provider, Base URL, API Key ve Model ID. OmniaKey ile tek anahtar üzerinden desteklenen Claude, GPT, Gemini, DeepSeek ve diğer modellere erişebilirsiniz.

Cline özel API anahtarı ayarları

VS Code'da Cline'ı açın, ayarlar simgesine tıklayın ve şunları doldurun:

/v1, OpenAI uyumlu Base URL'nin parçasıdır. Yalnızca çıplak alan adını kullanmayın ve /chat/completions eklemeyin; istek yolunu Cline oluşturur.

Adım adım Cline kurulumu

1. Ayrı bir API anahtarı oluşturun

OmniaKey'e giriş yapın, ön ödemeli bakiyeyi yükleyin ve API Key oluşturun. Cline için ayrı anahtar kullanmak, tüm araçlarda aynı kimlik bilgisini paylaşmaktan daha kolay limit, rotasyon ve kullanım denetimi sağlar.

Anahtarı kaynak koda, repo dosyasına, issue'ya veya ekran görüntüsüne yazmayın. Yalnızca Cline API Key alanına yapıştırın.

2. OpenAI Compatible seçin

API Provider altında OpenAI Compatible seçin. Anahtar başka bir sağlayıcıya aitse resmi OpenAI seçeneğini kullanmayın; provider seçimi Cline'ın alanlarını ve endpoint'ini belirler.

3. Base URL girin

Tam olarak şunu kullanın:

https://api.omniakey.com/v1

Yaygın hatalar: /v1 kısmını atlamak, /v1/v1 olarak iki kez eklemek veya tam /v1/chat/completions yolunu yazmak.

4. Tam Model ID girin

OmniaKey model kataloğunda şu anda bulunan bir modelle başlayın:

Bunlar yaklaşık adlar değil, tam kimliklerdir. Büyük-küçük harf, tire ve sürüm ekleri önemlidir; hafızadan yazmak yerine kopyalayın.

5. Dosyaları değiştirmeden önce doğrulayın

Seçilen provider için Verify görünüyorsa önce onu kullanın. Ardından dar ve geri alınabilir bir görev çalıştırın:

package.json dosyasını oku ve paket yöneticisini söyle. Dosyaları değiştirme.

İyi bir doğrulama şunları kanıtlar:

1. Cline özel provider ayarlarını kabul etti.
2. Provider API Key'i kabul etti.
3. Tam Model ID anahtar için erişilebilir.
4. Basit yanıt, düzenleme veya araç döngüsü olmadan döndü.

Sonra repo değiştiren işe geçin. Daha geniş akış için kodlama ajanı kurulumuna bakın.

Cline BYOK nasıl faturalandırılır?

BYOK, Bring Your Own Key anlamına gelir. Cline verdiğiniz provider ayarlarıyla istek gönderir; model kullanımını provider hesabı faturalandırır. Ücretli API ücretsiz hale gelmez.

Yalnızca görünür yanıtı değil; input, cached input ve output token'larını inceleyin. Agent görevleri repo bağlamı, araç çağrıları ve tekrarlar da üretir. Şeffaf faturalandırma rehberi, neden kabul edilen görev maliyetinin daha anlamlı olduğunu açıklar.

Model seçimi açıksa önce kodlama ajanı model karşılaştırmasını okuyun.

Cline API anahtarı çalışmıyorsa

Invalid API Key veya HTTP 401

401, endpoint'in gönderilen kimlik bilgisini kabul etmediğini gösterir. Şunları kontrol edin:

• anahtar ve Base URL aynı provider'a ait;
• başta veya sonda boşluk yok;
• anahtar etkin, silinmemiş ve rotate edilmemiş;
• hesapta kullanılabilir bakiye var;
• Cline hâlâ OpenAI Compatible kullanıyor.

Kimlik doğrulama hatasını Model ID değiştirmek çözmez.

Model Not Found veya HTTP 404

404, yanlış Base URL veya erişilemeyen Model ID anlamına gelebilir. Önce URL'nin tek /v1 ile bittiğini doğrulayın, sonra ID'yi katalogdan kopyalayın.

Aynı endpoint başka listelenen modelle çalışıyorsa bağlantı geçerlidir; kalan sorun model adı veya erişimidir.

Bağlantı hatası

Cline'ın çalıştığı makineden https://api.omniakey.com/v1 erişimini kontrol edin. VPN, proxy, DNS, TLS inspection ve firewall IDE'yi başka bir tarayıcıdan farklı etkileyebilir.

Sertifika hatasını gizlemek için TLS doğrulamasını kapatmayın. Ağ veya güven yapılandırmasını düzeltin.

Metin yanıtı geliyor ama araçlar çalışmıyor

Tek metin yanıtı yalnızca temel üretimi kanıtlar. Cline okuma, düzenleme ve komutlar için yapılandırılmış tool call ister. Büyük otonom değişiklikten önce salt okunur repo görevi deneyin.

Model sürekli hatalı araç çağrısı üretiyorsa output limitini körlemesine artırmak yerine agent çalışmasına uygun modeli karşılaştırın.

Maliyet beklenenden yüksek

Uzun repo bağlamı, kısa son yanıta rağmen faturayı belirleyebilir. Görevi daraltın, ilgisiz klasörleri bağlamdan çıkarın ve kabul edilen değişiklik başına maliyeti karşılaştırın.

Deneyler için ayrı anahtar veya cap kullanın. Cap finansal riski sınırlar; verimsiz görevin token tüketimini azaltmaz.

Güvenlik kontrol listesi

• Production hizmetleriyle paylaşılmayan ayrı Cline anahtarı kullanın.
• Proje boyutuna uygun cap ayarlayın.
• Repo, terminal kaydı, ekran görüntüsü veya issue'ya giren anahtarı rotate edin.
• Shell komutu ve dosya düzenleme izinlerini kontrol edin.
• Yeni veya güvenilmeyen repo'da salt okunur görevle başlayın.
• İlk başarılı oturumdan sonra provider kullanım kaydını inceleyin.

API Key model erişimini, Cline izinleri ise agent'ın yerelde yapabileceklerini kontrol eder. Bunlar ayrı güvenlik sınırlarıdır.

Sık sorulan sorular

Cline ile kendi API anahtarımı kullanabilir miyim?

Evet. OpenAI Compatible seçin; uyumlu provider'ın Base URL, API Key ve tam Model ID değerlerini girin.

Cline'da özel API anahtarı ücretsiz mi?

Hayır. BYOK isteği kimin doğrulayıp faturalandırdığını değiştirir. Provider input, cached input ve output token'larını ücretlendirebilir.

OmniaKey için Cline Base URL nedir?

https://api.omniakey.com/v1. /chat/completions eklemeyin, /v1 kısmını tekrarlamayın.

Cline'da hangi modeli kullanmalıyım?

Katalogdaki güncel ve göreve uygun modelle başlayın. gpt-5.6-terra dengeli bir başlangıçtır; daha güçlü veya ucuz modeli kabul edilen görev sonucuyla kıyaslayın.

Cline neden Model Not Found diyor?

Tam Model ID ve Base URL'yi kontrol edin. Geçerli API Key her modele erişmeyebilir; bozuk URL de 404 döndürebilir.

Cline anahtarımı repo'da saklar mı?

Provider kimlik bilgisi proje dosyalarında değil, Cline ayarlarında olmalıdır. Anahtarı koda, prompt'a, ekran görüntüsüne veya issue'ya kopyalamayın.

Kontrol edilen kaynaklar

• Cline: OpenAI Compatible provider
• Cline: Authorization ve BYOK
• OmniaKey Cline yapılandırması
• OmniaKey model kataloğu