Home → Guides → Claude Desktop ve Codex'i APICLAN'a yönlendirmek

Claude Desktop ve Codex'i APICLAN'a yönlendirmek

Masaüstü uygulamalarının kendi ayarlarında base URL alanı yoktur. Bu yapılandırmayı sizin yerinize CC Switch yazar. Aşağıda tam olarak ne girileceği ve başarısız kurulumların neredeyse tamamını açıklayan iki nokta var.

Başlamadan önce

Bakiyesi olan bir hesaba ve bir API anahtarına ihtiyacınız var. Anahtarı konsolda «API Anahtarları» bölümünden oluşturun: çağıracağınız sağlayıcı ailesini seçin — Claude masaüstü için Anthropic, Codex için OpenAI — ardından harcama yapılacak anahtar grubunu seçin. Grup, tarifenizi belirler; her modelin fiyatı fiyat sayfasında.

Bir anahtar yalnızca tek bir gruba aittir. Metin modelleri için oluşturulan bir anahtar görsel modellerini çağıramaz, tersi de geçerlidir; bu, yetki hatası olarak değil model üzerinde 404 olarak döner. İkisi de gerekiyorsa iki anahtar oluşturun. Belirli bir anahtarın neyi çağırabileceğinin kesin yanıtı, o anahtarla gönderilen GET /v1/models sonucudur.

Girilecek adres ve /v1 kuralı

Her istek /v1 ile başlayan bir yola ulaşmak zorundadır. İstemciye /v1 yazmanız gerekip gerekmediği istemciye bağlıdır: bazıları bunu kendi ekler, bazıları eklemez. Aldığımız «bağlanmıyor» bildirimlerinin çoğu tam da bu tek ayrıntıdan kaynaklanır.

İstemci	Girilecek istek adresi
Claude Desktop (via CC Switch)	https://apiclan.us/v1
Codex / ChatGPT desktop app	https://apiclan.us/v1
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Claude Code	https://apiclan.us
Anthropic SDK	https://apiclan.us

Ters girilirse istek kenarda 404 alır; yani ağ geçidine hiç ulaşmaz ve kullanım kaydınızda hiç görünmez — dolayısıyla boş bir kayıt zaten belirtinin kendisidir. Adresin sonuna asla eğik çizgi koymayın.

Codex artık ChatGPT masaüstü uygulamasının içinde

Codex, ChatGPT masaüstü uygulamasıyla birleştirildi. Windows'ta ChatGPT'yi Microsoft Store'dan kurun; macOS'ta OpenAI'nin sitesinden indirin. Komut satırı Codex'i de aynı ayarları kullanır.

CC Switch'te Codex için bir sağlayıcı ekleyin, anahtarınızı yapıştırın ve istek adresi olarak https://apiclan.us/v1 girin. Bu sağlayıcıyı etkinleştirin, sonra Codex'ten tamamen çıkın — pencereyi kapatmak yetmez — ve yeniden başlatın. Yapılandırma yalnızca açılışta okunur; çalışmaya devam eden bir örnek eski ayarları kullanmayı sürdürür ve hiçbir şey olmamış gibi görünür.

CC Switch yerine yapılandırma dosyasını elle düzenlemeyi tercih ederseniz, base URL ve anahtarın nereye yazılacağı hızlı başlangıç sayfamızda.

Claude masaüstü uygulaması

Claude masaüstü uygulamasını claude.com'dan kurun, ardından sağlayıcıyı CC Switch'te yapılandırın:

1. CC Switch'i açın, Claude masaüstü hedefini seçin ve yeni bir sağlayıcı ekleyin.
2. İstediğiniz adı verin ve APICLAN anahtarınızı API Key alanına yapıştırın.
3. İstek adresi olarak https://apiclan.us/v1 girin — istemci sonuna /messages ekler. Sonda eğik çizgi olmasın.
4. Kaydedin, Claude masaüstü uygulamasını başlatın ve bir model seçin.

CC Switch size doğrudan bağlantı ile model eşleme arasında bir seçim sunuyorsa, karar vermeden önce bir sonraki bölümü okuyun. Model seçicinin çalışıp çalışmayacağını bu ayar belirler.

Model seçici ağ geçidi hatası döndürdüğünde

Bağlantının çalıştığını ama sağlayıcının isteği reddettiğini söyleyen uyarı neredeyse her zaman anahtarla değil model adıyla ilgilidir. Masaüstü uygulaması kendi gömülü model tanımlayıcılarını gönderir; ağ geçidi ise yalnızca üst kaynak hesaplarının gerçekten sunduğu modelleri sunabilir.

Çözüm, doğrudan bağlantı yerine model eşlemedir: uygulamanın girdilerini bu ağ geçidinin sunduğu adlara eşleyin. Doğrudan bağlantı yalnızca sağlayıcı, uygulamanın gönderdiği tanımlayıcıları birebir kabul ettiğinde çalışır.

Eşleme yapacağınız listeyi almak için anahtarınızla GET /v1/models gönderin. Bu liste anahtarınızın kendi grubundan üretilir; yani genel bir katalog değil, hesabınız için gerçek yanıttır.

Resmî hesaba geri dönmek

Hiçbir şey kalıcı olarak üzerine yazılmaz. CC Switch'te resmî sağlayıcıyı yeniden etkinleştirip istemciyi yeniden başlatın; masaüstü uygulaması aboneliğinize döner. İkisini de yapılandırılmış bırakıp istediğiniz zaman geçiş yapabilirsiniz — buradaki bakiye ön ödemelidir ve süresi dolmaz, dolayısıyla kullanılmayan bir yapılandırmayı tutmanın maliyeti yoktur.

Hâlâ çalışmıyorsa

• 404 alıyor ve kullanım kaydınızda hiçbir şey görmüyorsanız adres yanlıştır. Yukarıdaki tablodan o istemcinin /v1 isteyip istemediğine bakın ve sondaki eğik çizgiyi kaldırın.
• 401 alıyorsanız anahtar isteğe ulaşmıyordur. Yeniden yapıştırın; uzun bir dizedir ve eksik kopyalanmış bir anahtar tıpkı yanlış anahtar gibi başarısız olur.
• Aynı anahtarla diğer modeller çalışırken biri çalışmıyorsa, o model başka bir gruptadır. Doğru grubu seçerek ikinci bir anahtar oluşturun; yetki değişikliği bunu çözmez.

Yine de takıldıysanız, başarısız olan model adını ve yaklaşık deneme zamanını support@apiclan.us adresine yazın. Mesajı bir insan okuyor.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.