Cline'ı Codex4Less'e Bağlama: OpenAI Uyumlu API Kurulumu

Cline, VS Code içinde çalışan açık kaynak bir kodlama ajanıdır (resmî CLI'sı da vardır). Sizin onayınızla dosyaları okur, kod yazar ve komut çalıştırır — ve OpenAI uyumlu API sunan her sağlayıcıyla konuşabilir. Bu rehber, OpenAI Compatible sağlayıcısını kullanarak Cline'ı Codex4Less'e bağlar; böylece Cline'ın istekleri Codex4Less modelleriyle karşılanır.

Aşağıdaki tüm yapılandırma değerleri canlı Codex4Less API'si üzerinde doğrulanmıştır. Sağlayıcı yapılandırması Cline CLI v3.0.72 ile uçtan uca test edilmiştir (bağlantı + dosya yazma ve komut çalıştırma içeren gerçek bir kodlama görevi). VS Code eklentisi aynı sağlayıcı alanlarını kullanır; bu rehber yazıldığı sırada güncel eklenti sürümü 4.1.25'tir. Test sırasında çalıştırılmayan noktalar açıkça işaretlenmiştir.

Ön Koşullar

  • VS Code + Cline eklentisi ya da Node.js (Cline CLI için). (CLI, Node 20.20'de bir trust-store uyarısı yazdırdı; kendi mesajı kurumsal/kendinden imzalı CA'lar için Node ≥ 22.15 öneriyor. Bu rehberdeki testler Node 20.20'de geçti.)
  • Codex4Less hesabı ve API anahtarı — ikisi de ücretsiz oluşturulur, yalnızca token başına ödersiniz.
  • Yapılandırma için beş dakika. Başka araç gerekmez.

Adım 1 — Codex4Less API Anahtarınızı Oluşturun

  1. Hesap oluşturun: codex4less.com/register
  2. Giriş yapın ve panelde API Anahtarları sayfasını açın: codex4less.com/dashboard/api-keys
  3. Yeni API Anahtarı Oluştur'a tıklayıp anahtarı kopyalayın. Anahtar yalnızca bir kez gösterilir.
Güvenlik: Gerçek API anahtarını ekran görüntüsüne, sohbet mesajına veya kaynak koda yapıştırmayın. Cline, sağlayıcı anahtarlarını kendi ayar/config dosyasında saklar — o dosyayı gizli bilgi gibi koruyun.

Adım 2 — Cline'ı Kurun

VS Code eklentisi: VS Code'da Extensions görünümünü açın, Cline araması yapın (yayıncı saoudrizwan) ya da Marketplace sayfasını kullanıp kurun. Cline'ı etkinlik çubuğundaki Cline simgesinden (veya Ctrl/Cmd+Shift+P → “Cline: Open”) açın.

Cline CLI (alternatif; bu rehberin canlı testlerinde kullanıldı):

bash
npm install -g cline
cline --version

Bu komut, yazıldığı sırada 3.0.72 sürümünü kurar.

Adım 3 — OpenAI Compatible Sağlayıcısını Yapılandırın

Seçenek A — VS Code eklentisi

  1. Cline ayar panelini açın (Cline görünümündeki ⚙️ simgesi).
  2. API Provider alanını OpenAI Compatible yapın.
  3. Şunları doldurun:
    1. Base URL: https://api.codex4less.com/v1 — API kökünü kullanın, tam bir uç nokta yolu değil.
    2. API Key: Adım 1'deki sk-... anahtarı.
    3. Model ID: gpt-6.1-sol (doğrulanmış model — Adım 4'e bakın).
  4. Bağlantıyı doğrulamak için Verify'a tıklayın. Uç nokta ve anahtar kabul edildiğinde Cline başarı göstergesi verir.
  5. İsteğe bağlı — Model Configuration: bağlam penceresi boyutu, maksimum çıktı token'ı ve görsel desteği / computer use (tool calling) gibi yetenek bayraklarını ayarlayabilirsiniz. Yalnızca seçtiğiniz modelin gerçekten sunduğu yetenekleri açın.

Seçenek B — Cline CLI (bu rehber için birebir test edilen komutlar)

bash
cline auth -p openai-compatible -k "sk-..." -b "https://api.codex4less.com/v1" -m "gpt-6.1-sol"

Bu komut sağlayıcıyı, anahtarı, base URL'yi ve modeli Cline yapılandırmasında saklar (varsayılan: ~/.cline). Ana kurulumunuza dokunmadan test etmek isterseniz --config <dizin> ile izole bir yapılandırma dizini kullanabilirsiniz.

Adım 4 — Desteklenen Bir Model Seçin

Codex4Less güncel model kataloğunu iki yerde sunar — her makale yerine buralara güvenin:

Bu rehberin yazıldığı sırada katalogda gpt-6.1-sol, gpt-5.6-sol ve gpt-6-astra bulunuyor. Bu rehber `gpt-6.1-sol` kullanır; Cline ile uçtan uca doğrulanan model budur. Farklı bir kimlik seçerseniz önce yukarıdaki listede göründüğünü doğrulayın.

Adım 5 — Bağlantıyı Doğrulayın

CLI ile sabit bir yanıt isteyin ve makine tarafından okunabilir sonucu inceleyin:

bash
cline --json "Reply with exactly: CONNECTED"

Çalışan bir kurulum şunun gibi bir run_result satırıyla biter:

json
{"type":"run_result","finishReason":"completed","text":"CONNECTED","model":{"id":"gpt-6.1-sol","provider":"openai-compatible"}}

VS Code'da eşdeğer kontrol, ayarlardaki Verify düğmesidir (Adım 3). Başarılı bir yanıt tek başına isteğin Codex4Less üzerinden geçtiğini kanıtlamaz — Panel → Kullanım'dan teyit edin: codex4less.com/dashboard/usage her istek için modeli, token sayılarını ve maliyeti gösterir.

Adım 6 — Küçük Bir Kodlama Görevi Çalıştırın

Aşağıdaki görev test sırasında birebir çalıştırılmıştır. Bir proje dizininde CLI'dan:

bash
cline "Create a file named hello.js that prints exactly READY when run with node. Then run it and report the output."

Gözlemlenen sonuç: Cline, dosya yazma ve komut çalıştırma araçlarını birkaç iterasyon boyunca kullandı, hello.js dosyasını oluşturdu, node ile çalıştırdı ve çıktı olarak READY raporladı. VS Code'da aynı akış sohbet panelinde çalışır; araç işlemleri (dosya düzenleme, terminal komutları) otomatik onay açık değilse onay istemi olarak görünür.

Bu neyi kanıtlar: Codex4Less üzerinden sunulan model, Cline'ın ajan döngüsünün gerektirdiği OpenAI tarzı function calling'i destekliyor — ajan başarıyla dosya yazdı ve komut çalıştırdı. Diğer yetenekler (vision, çok uzun bağlam, sağlayıcıya özgü özellikler) modele bağlıdır ve bu testin kapsamında değildir.

Sorun Giderme

“Invalid API Key” / 401

  • Anahtar, panelden alınan tam sk-... değeri olmalı; tırnak veya boşluk içermemelidir.
  • İptal edilen veya silinen anahtar anında çalışmaz hale gelir — yenisini oluşturun.
  • Anahtarı yerleşik “OpenAI” sağlayıcısına değil, mutlaka OpenAI Compatible sağlayıcısına girdiğinizden emin olun (yerleşik sağlayıcı api.openai.com'a gider).

404 veya bağlantı hataları

  • Base URL tam olarak https://api.codex4less.com/v1 olmalıdır. Uç nokta yollarını Cline kendisi ekler; https://api.codex4less.com/v1/chat/completions gibi bir base URL yolu ikiye katlar ve 404 döner.
  • İstek anında başarısız oluyorsa ağ/güvenlik duvarınızı kontrol edin; uç noktaya standart HTTPS üzerinden erişilebilir (doğrulandı).

“Model Not Found”

Ajan araç çağırmıyor / düzenlemeler başarısız

  • Cline ayarlarındaki Model Configuration bölümünde modelin tool desteği olmadan işaretlenmediğinden emin olun — ajan tabanlı dosya düzenlemeleri için Cline'ın tool calling'e ihtiyacı vardır.
  • Belirli bir model normal sohbet çalışırken tool-calling isteklerini reddediyorsa gpt-6.1-sol'e geçin ve görevi yeniden başlatın.

Eski Node sürümlerinde CLI trust-store uyarısı

Cline CLI, Node 20'nin işletim sistemi sertifika deposunu okuyamadığını bildirebilir. Bu durum buradaki testleri etkilemedi; kurumsal proxy veya kendinden imzalı sertifika kullanıyorsanız Node ≥ 22.15'e yükseltin ya da NODE_EXTRA_CA_CERTS ayarlayın.

SSS

Cline ile özel bir API sağlayıcı kullanabilir miyim? Evet — OpenAI Compatible sağlayıcısı tam olarak bunun içindir: OpenAI API standardını uygulayan her uç nokta çalışır. Resmî Cline dokümantasyonuna bakın.

API anahtarımı nerede saklamalıyım? Cline'ın sağlayıcı ayarlarında (eklenti) veya cline auth ile (CLI). Bir depoya işlemeyin, ayar ekranının ekran görüntüsünü paylaşmayın.

Uç nokta hangi API biçimini destekliyor? Codex4Less OpenAI uyumlu API'ler sunar. Cline'ın sohbet ve araç çağrıları POST https://api.codex4less.com/v1/chat/completions üzerinde doğrulanmıştır; model kataloğu GET /v1/models adresindedir. Ayrıntılar: API dokümantasyonu.

Seçtiğim model kullanılamıyorsa ne yapmalıyım? Güncel listeyi kontrol edin (GET /v1/models veya fiyatlandırma sayfası) ve Cline'daki Model ID alanını değiştirin. Katalog geliştikçe erişilebilirlik değişebilir.

VS Code eklentisi ile CLI aynı yapılandırmayı paylaşır mı? Hayır — ayrı kurulumlardır ve ayrı yapılandırmaları vardır. Kullanacağınız her biri için sağlayıcıyı ayrı yapılandırın.

Sonuç ve Çağrı

Cline'ı Codex4Less'e bağladınız, uç noktayı doğruladınız ve dosya düzenleme ile komut çalıştırma içeren gerçek bir kodlama görevi koşturdunuz. Tool calling uçtan uca çalışıyor; yani Cline'ın ajan yetenekleri Codex4Less modelleriyle kullanılabilir.

Başlamaya hazır mısınız?

Codex4Less hesabınızı oluşturun, bir API anahtarı üretin ve Cline'ı https://api.codex4less.com/v1 adresine yönlendirin.

Hesabınızı oluşturun →

İlgili yazılar: Codex CLI'ı Codex4Less ile Kullanma · API dokümantasyonu