# Cline'da özel API anahtarı

> Cline'da özel API anahtarı, OpenAI uyumlu provider, doğru Base URL ve Model ID ayarlayın; 401, 404, Invalid API Key ve Model Not Found hatalarını giderin.

- Canonical HTML: https://omniakey.com/tr/blog/cline-custom-api-key
- Markdown: https://omniakey.com/tr/blog/cline-custom-api-key.md
- Published: 2026-08-11 (updated 2026-09-21)
- Author: Kiki, COO at OmniaKey
- Language: tr
- Category: API setup
- Reading time: 9 min
- All posts: https://omniakey.com/blog/llms.txt

---

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.

> **11 Ağustos 2026 tarihinde kontrol edildi.** Cline dokümantasyonu OpenAI Compatible provider türünü, Base URL, API Key, Model ID ve Verify akışını doğruluyor. Model erişimi ve fiyatlar değişebilir; güncel ID'leri OmniaKey model kataloğundan kopyalayın.

## Cline özel API anahtarı ayarları

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

|Alan|Değer|
|-|-|
|API Provider|`OpenAI Compatible`|
|Base URL|`https://api.omniakey.com/v1`|
|API Key|OmniaKey dashboard'da oluşturduğunuz anahtar|
|Model ID|`gpt-5.6-terra` gibi tam desteklenen ID|

`/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:

```text
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](https://omniakey.com/tr/models) şu anda bulunan bir modelle başlayın:

|Model ID|Başlangıç için uygun kullanım|
|-|-|
|`claude-opus-5`|Derin araştırma isteyen zor repo görevleri|
|`gpt-5.6-terra`|Yetenek ve maliyet dengeli günlük kodlama|
|`gemini-3.1-pro-preview`|Gemini ailesiyle uzun bağlam deneyleri|
|`deepseek-v4-flash`|Daha düşük maliyetli hızlı kodlama ve agent adımları|

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:

```text
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](https://docs.omniakey.com/tr/coding) 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](https://omniakey.com/tr/blog/transparent-billing), 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ı](https://omniakey.com/tr/blog/best-llm-coding-agents) okuyun. IDE eklentisi yerine masaüstü istemci bağlıyorsanız [Cherry Studio API kurulumu](https://omniakey.com/tr/blog/cherry-studio-api-setup) ve [WorkBuddy özel model kurulumu](https://omniakey.com/tr/blog/workbuddy-custom-model-setup) yazılarına bakın. Claude Code için [Claude Code kurulumu](https://omniakey.com/tr/blog/claude-code-setup) yazısına bakın.

## 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. Lovable'da geliştirilen bir uygulama için [Lovable API Key nereye eklenir](https://omniakey.com/tr/blog/lovable-api-key) yazısına bakın.

## 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](https://docs.cline.bot/provider-config/openai-compatible)
- [Cline: Authorization ve BYOK](https://docs.cline.bot/getting-started/authorizing-with-cline)
- [OmniaKey Cline yapılandırması](https://docs.omniakey.com/tr/guides/cline)
- [OmniaKey model kataloğu](https://omniakey.com/tr/models)
