Uygun Sürümler: CC Switch 3.16.0 ve üzeri. Bu makale, depo dokümantasyonu ve koduna dayanarak derlenmiştir, DeepSeek örneği üzerinden OpenAI Chat Completions uyumlu arayüz gösterilmektedir. Ekran görüntüleri, mevcut ön yüz arayüzünden alınmış olup, gerçek API Anahtarlarını veya hesap bakiyelerini sızdırmamak için duyarlılığı giderilmiş örnek veriler kullanılarak oluşturulmuştur.
Yerel Yönlendirme Neden Gerekli?
Codex CLI'nin yeni sürümü, OpenAI Responses API'sini hedef alırken, DeepSeek, Kimi, MiniMax ve SiliconFlow gibi birçok sağlayıcı aslında OpenAI Chat Completions formatını, yani /chat/completions yolunu sunar. Bu iki protokolün istek gövdeleri, akış olayları ve dönüş yapıları farklıdır. Codex yapılandırmasına doğrudan bir Chat arayüzü girmek genellikle hatalı model listelerine, 404/400 hatalarına veya Codex'in doğru ayrıştıramayacağı akış yanıtlarına yol açar.
CC Switch'in yaklaşımı, Codex'in her zaman yerel bir yola bağlanmasını sağlamak ve istekleri yine Responses API üzerinden göndermektir; yol, mevcut sağlayıcının Chat formatında olup olmadığını dahili olarak belirler, isteği yukarı akışa göndermek üzere Chat Completions'a dönüştürür ve son olarak Chat yanıtını Codex'e döndürmek üzere tekrar Responses formatına çevirir.
Bu zincir temel olarak dört adıma ayrılır:
- Codex devraldığında, yerel yapılandırma
http://127.0.0.1:15721/v1olarak yazılır vewire_api = "responses"zorunlu kılınır. - Sağlayıcının
meta.apiFormat = "openai_chat"değeri, yola gerçek yukarı akışın Chat Completions olduğunu bildirir. - Yol,
/responsesveya/v1/responsesadresini/chat/completionsolarak yeniden yazar ve Responses istek gövdesini bir Chat istek gövdesine dönüştürür. - Yukarı akış döndükten sonra yol, Chat JSON veya SSE'sini Codex'in anlayabileceği Responses JSON/SSE'sine dönüştürür.
Hazırlık
Öncelikle üç şey hazırlamanız gerekiyor:
- CC Switch'in kurulu ve başlatılmaya hazır olması.
- Codex CLI'nin kurulu olması ve
~/.codex/config.tomldizin yapısının oluşması için en az bir kez çalıştırılmış olması. - DeepSeek veya benzer bir Chat Completions sağlayıcısı için bir API Anahtarı.
DeepSeek'in resmi dokümantasyonu şu anda OpenAI uyumlu temel URL'nin https://api.deepseek.com olduğunu belirtmektedir (diğer sağlayıcılar genellikle /v1 sonekiyle bir temel URL kullanır) ve Chat API yolu /chat/completions'dır; CC Switch'in DeepSeek ön ayarı bu bilgilerle zaten yapılandırılmıştır, bu nedenle lütfen arayüz yollarını manuel olarak birleştirmek yerine ön ayarı kullanmaya öncelik verin.
Adım 1: Codex Sağlayıcısı Ekleme
CC Switch'i açın, üst kısımdaki Codex sekmesine geçin ve bir sağlayıcı eklemek için sağ üst köşedeki artı işaretine tıklayın.
Yerleşik ön ayarlardan DeepSeek'i seçin; yalnızca iki şey yapmanız gerekir:
- DeepSeek API Anahtarını girin.
- Sağlayıcıyı kaydedin.
Ön ayar, DeepSeek'in istek adresini, varsayılan modelini, model menüsünü ve düşünme/akıl yürütme parametrelerini zaten içerir ve "Yerel Yönlendirme Eşlemesi Gerektirir" seçeneğini otomatik olarak açar. Varsayılan modeli veya model görünen adını ihtiyaca göre ayarlayabilirsiniz; protokol dönüşümü yönlendirme katmanı tarafından halledilir.
Adım 2: Yerel Yönlendirmeyi Etkinleştirin ve Codex'i Devralın
Ayarlar'daki Yönlendirme sayfasına gidin, Yerel Yönlendirme bölümünü genişletin ve iki anahtarı tamamlayın:
- Yerel hizmeti başlatmak için Ana Yönlendirme Anahtarını açın. Varsayılan adres
127.0.0.1:15721'dir. - Yönlendirme Etkinleştirme bölümünde Codex anahtarını açın. Yalnızca Codex'in yönlendirmeden geçmesini istiyorsanız Claude ve Gemini'yi kapalı tutabilirsiniz.
Devralma işleminden sonra CC Switch, Codex'in canlı yapılandırmasını yerel yola yönlendirecek ve kimlik doğrulamayı yer tutucularla yönetecektir. Gerçek DeepSeek Anahtarı hala CC Switch Sağlayıcı yapılandırmasında kaydedilir ve iletim sırasında yerel yol tarafından enjekte edilir, böylece Anahtarı Codex canlı yapılandırmasına maruz bırakmanıza gerek kalmaz.
Adım 3: Sağlayıcıyı Değiştirin ve Codex'i Yeniden Başlatın
Codex sağlayıcı listesine dönün ve DeepSeek sağlayıcısı için Etkinleştir'e tıklayın. "Yol Gerektirir" etiketi görürseniz, bu sağlayıcının yol çalışırken kullanılması gerektiği anlamına gelir; yol başlatılmamışsa, CC Switch "Normal kullanım için yönlendirme hizmeti gereklidir" diyen bir uyarı açılır penceresi gösterecektir.
Değişiklikten sonra, mevcut Codex terminal oturumunu yeniden başlatmanız önerilir çünkü:
- Codex işlemi eski
config.tomldosyasını zaten okumuş olabilir. modelcatalogjsonoluşturulduktan sonra,/modelmenüsü genellikle yenilenmesi için yeni bir işlem gerektirir.
Codex'e girdikten sonra, mevcut modelin DeepSeek V4 Flash gibi DeepSeek ön ayarından olup olmadığını kontrol etmek için /model komutunu kullanabilirsiniz. Şu anda Codex uygulaması özel çoklu model seçimini desteklemez ve varsayılan olarak yapılandırmadaki ilk modeli kullanır.
Diğer Chat Sağlayıcıları Nasıl Ele Alınır
DeepSeek, Kimi, MiniMax ve SiliconFlow gibi yaygın Chat formatı sağlayıcılarının CC Switch'te zaten ön ayarları bulunmaktadır; bunları kullanmaya öncelik verin. Yalnızca ön ayarlarda olmayan sağlayıcılar için özel bir yapılandırma seçmeniz gerekir; bu durumda, API Anahtarını, temel URL'yi ve modeli ilgili dokümantasyona göre doldurun ve API Formatını OpenAI Chat Completions (yönlendirme gerektirir) olarak ayarlayın.
Yukarı akış doğrudan OpenAI Responses API'sini destekliyorsa, "Yerel Yönlendirme Eşlemesi Gerektirir" seçeneğini açmanıza gerek yoktur; bu durumda CC Switch, Chat dönüşümü olmadan doğrudan Responses üzerinden bağlanabilir.
SSS
Codex 404 hatası veriyor veya /responses bulamıyor
Bu genellikle Codex devralmanın etkinleştirilmemesinden veya yukarı akış Chat temel URL'sini doğrudan Codex'e manuel olarak yazmanızdan kaynaklanır. ~/.codex/config.toml dosyasının http://127.0.0.1:15721/v1 adresini gösterip göstermediğini kontrol edin.
DeepSeek yukarı akışı 404 hatası veriyor
Yerleşik DeepSeek ön ayarını kullanıyorsanız, öncelikle mevcut sağlayıcının gerçekten ön ayardan olduğunu ve Codex yönlendirmesinin etkinleştirildiğini doğrulayın. Yalnızca özel bir sağlayıcı kullanırken temel URL'yi çift kontrol etmeniz gerekir: bu, hizmet kök adresi olmalıdır, /chat/completions ile tam arayüz yolu olmamalıdır.
/model DeepSeek modellerini göstermiyor
Sağlayıcıyı kaydettikten sonra Codex'i yeniden başlatın. CC Switch, cc-switch-model-catalog.json dosyasını oluşturur ve yolu modelcatalogjson içine yazar, ancak çalışan bir Codex işlemi model dizinini sıcak olarak yükleyemeyebilir.
Şu anda Codex uygulaması çoklu model seçimini desteklemez ve varsayılan olarak ilk modeli kullanır.
Yol açık ancak istekler hala yanlış sağlayıcıya gidiyor
Üç durumun tutarlı olduğunu doğrulayın: Codex sekmesi altındaki mevcut sağlayıcı DeepSeek; yerel yönlendirme hizmeti çalışıyor; ve Yönlendirme Etkinleştirme bölümündeki Codex anahtarı açık.
Resmi OpenAI Codex hesabını yerel yönlendirme aracılığıyla kullanabilir miyim?
Önerilmez. CC Switch, yerel yönlendirme devralma modunda resmi sağlayıcılara geçişi engeller çünkü resmi API'ye bir proxy kullanarak erişmek hesap riskleri oluşturabilir. Yönlendirme esas olarak üçüncü taraf, toplama veya protokol dönüştürme senaryoları içindir.
![Yusuke Narita'nın Dahi Yapay Zeka Kullanım Teknikleri [Arşivlik Sürüm]](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1784137658627_u4bwry_HNMS89bbsAAUPJI.jpg)
