Herkese merhaba, ben Cang He.
CodexGuide dünden önceki gün yayına girdiğinden beri arkadaşların soruları yağıyor.
En çok sorulan soru şu: Codex Çin'de nasıl kullanılır? Plus aboneliği olmadan kullanabilir miyim?
Dürüst olmak gerekirse, bu acıyı çok iyi anlıyorum.
Plus'a abone olmanın kendi engelleri var, bir de ödeme yöntemini halletmek uğraştırıyor; yorucu gerçekten.
Bu yüzden internette bulabildiğim tüm çözümleri test etmek için iki gün harcadım, bir sürü tuzağa düştüm ve sonunda en güvenilir üç erişim yöntemini derledim.
Hepsini bugün sizinle paylaşıyorum, adımları takip etmeniz yeterli.
Eğitim videosu ayrıca CodexGuide'da canlı olarak yayında, istediğiniz zaman başvurabilirsiniz.
Ne kadar uğraştığımı düşünürsek, bir yıldız atıverin, hahaha.
Öncelikle bir ön koşul: Codex'i kullanmanın en istikrarlı yolu hâlâ resmi bir GPT hesabıyla giriş yapmaktır.
Üçüncü taraf bir API'ye bağlanmak ileri düzey bir işlemdir; config.toml, API Key ve Base URL'nin ne olduğunu bilmeniz gerekir.
Bilmiyorsanız sorun değil, sadece aşağıdaki adımları izleyin.
Üç Yöntem Arasında Nasıl Seçim Yapılır
İşte size uygun olanı bulmanız için bir tablo:
Yöntem | Kimler İçin Uygun | Avantajları | Not |
|---|---|---|---|
Manuel Yapılandırma | Altında yatan mantığı anlamak isteyenler | Şeffaf, kontrol edilebilir, sorun gidermesi kolay |
|
Codex++ | GUI yönetimi isteyen Masaüstü Uygulama kullanıcıları | Yönetim arayüzü var, tek tıkla yapılandırma | Üçüncü taraf araç, Codex güncellemelerinden sonra güncelleme gerektirebilir |
CCX + CC Switch | Birden fazla sağlayıcısı olan ve protokol dönüşümüne ihtiyaç duyanlar | Ağ geçidi yönlendirmesi + tek tıkla sağlayıcı değiştirme | Birçok bileşen var, port ve proxy zincirlerini anlamak gerekir |
Açıkçası, yeni başlıyorsanız, sadece 2. Yöntem'e bakın; en zahmetsizi o.
Codex'i yeni öğrenmeye başladıysanız, üçüncü taraf API'lerle uğraşmadan önce Codex başlangıç eğitimime göz atmanızı öneririm.
Yöntem 1: Manuel Yapılandırma
Bu yöntemin bir dezavantajı var: Codex UYGULAMASININ eklenti işlevini kullanamazsınız.
Eklenti kullanmak istiyorsanız, doğrudan 2. Yöntem'e geçin.
Manuel yapılandırmanın özü tek bir dosyayı değiştirmektir:
Değiştirmeden önce yedekleyin, iyi alışkanlıklar edinin:
İki Giriş Yaklaşımı
Yaklaşım | Nasıl Anlaşılır | Uygun Senaryo |
|---|---|---|
GPT Girişi | Resmi giriş durumunu koru, sadece istek yönlendirme adresini değiştir | Resmi hesap özelliklerini korurken bir aktarma kullanmak istiyorum |
API Anahtarı Girişi | Anahtarı ortam değişkenlerinde kullan, doğrudan üçüncü tarafa istek gönder | OpenAI API Key veya kendi oluşturduğun uyumlu servisi kullan |
Bir öneri: aynı anda çok fazla şeyi değiştirmeyin. Önce sadece bir sağlayıcı ekleyin, çalıştığından emin olun, sonra birden fazla yapılandırma ile uğraşın.
GPT Giriş Durumu Örneği
Bu, Codex'inizin önce bir GPT hesabına giriş yapması gerektiği anlamına gelir.
Adım 1: Yapılandırma dosyasını değiştirin:
~/.codex/config.toml dosyasını açın ve aşağıdaki yapılandırmayı ekleyin.
Not: alanları ve değerleri kendi gerçek servisinize göre doldurun:
Birkaç yaygın tuzak:
model_provider,[model_providers.xxx]içindekixxxile birebir aynı olmalıdır; bir harf bile farklı olmamalı.base_urlsadece/v1'e kadar olmalı,/v1/responsessegmentinin tamamını içermemeli.wire_api = "responses", Responses API formatında istek yapmak anlamına gelir; bunu değiştirmeyin.requires_openai_auth = false, resmi giriş durumunu kullanmamak anlamına gelir.
Adım 2: Ortam değişkenlerini ayarlayın
Terminali açın ve şunu yazın:
Adım 3: Codex UYGULAMASINI terminalden başlatın
Burada bir püf nokta var: Mac kullanıcıları terminalden başlatmalı; doğrudan simgeye tıklamak modeli okumayabilir.
Başlatmadan önce Codex UYGULAMASINI tamamen kapatın, ardından terminale şunu yazın:
Adım 4: Etkiyi doğrulayın
Codex UYGULAMASINI açın, modelin başarıyla değiştirildiğini göreceksiniz:
Aman Tanrım, uçuyor resmen.
API Anahtarı Giriş Örneği
API Anahtarı yöntemini kullanıyorsanız, şu prensibi unutmayın: gizli anahtarı ortam değişkenlerine koyun, yapılandırma dosyasına sabit kodlamayın.
Buna karşılık gelen config.toml yapılandırması:
Dikkat edilmesi gereken bir nokta: yukarı akışınız yalnızca Chat Completions'ı destekliyorsa ve Responses API'yi desteklemiyorsa, sadece yapılandırmayı değiştirmek işe yaramaz; protokol dönüşümü için CCX gibi bir ağ geçidi kullanmanız gerekir, bu 3. Yöntem'de ele alınacak.
Kimlik doğrulama dosyasını değiştirin
~/.codex/auth.json dosyasını açın ve OPENAI_API_KEY değerini model sağlayıcınızın Anahtarı ile değiştirin:
Yapılandırma Başarısı Nasıl Doğrulanır
Yapılandırmadan sonra hemen acele etmeyin; önce doğrulayın:
- Codex'ten tamamen çıkın ve yeniden açın.
- Sadece okunabilir bir görev yapmasını isteyin, örneğin mevcut dizin yapısını özetlemek gibi.
- Hata verirse, önce
model_provideradını,base_url'i ve ortam değişkenlerini kontrol edin. - Kimlik doğrulama hatası alırsanız, önce yedek yapılandırmaya geri dönün; panik yapmayın.
Yöntem 2: Codex++
Manuel yapılandırmayı çok zahmetli buluyorsanız, Codex++'a bir göz atın.
Bu, aktarma yapılandırmalarını tek tıkla halletmenize yardımcı olan, toml dosyalarını manuel olarak yazmanıza gerek bırakmayan grafiksel bir yönetim aracıdır.
Ayrıca, 1. Yöntem'in yapamadığı eklenti işlevlerini de destekler.
Şu kişiler için uygundur:
- Ağırlıklı olarak Codex masaüstü Uygulamasını kullananlar.
- Yapılandırma dosyalarını manuel olarak yazmak istemeyenler.
- İstediği zaman resmi moda geri dönmek isteyenler.
Kurulum Adımları
- Codex++ Releases sayfasını açın ve kurulum paketini indirin.
İki kurulum paketi göreceksiniz: "Codex++ Yönetim Aracı" ve "Codex++ uygulaması"; ikisini de kurun.
- Kurulumdan sonra "Codex++ Yönetim Aracı"nı açın.
İlk açılışta bu hata çıkarsa panik yapmayın:
"Sistem Ayarları" - "Gizlilik ve Güvenlik" bölümüne gidin ve "Yine de Aç"a tıklayın:
Açıldıktan sonra yönetim arayüzüne girin:
Codex++ uygulamasını da aynı şekilde kurun; yönetim aracı tespiti tamamen yeşilse doğrudur:
GPT giriş durumunun algılandığını onaylayın.
- Aktarma yapılandırması ekleyin.
"Sağlayıcı Yapılandırması" - "Sağlayıcı Ekle"yi seçin ve Base URL ile Anahtarınızı girin.
Not: erişim yöntemi olarak "Salt API"yi seçin:
Model listesi yukarı akıştan otomatik olarak alınabilir; bir aktarma istasyonu yapılandırıyorsanız, burada seçilebilecek birçok model olacaktır:
Temel olarak, bu araç yapılandırmaları daha rahat yazmanıza yardımcı olur, dosyaları manuel olarak düzenleme derdinden kurtarır:
Kaydettikten sonra bağlantıyı test edin; sorun yoksa doğrudan kullanın:
- Codex'i Codex++ giriş noktasından başlatın.
Not: orijinal Codex'ten değil, Codex++'tan başlatın:
Yeniden başlattıktan sonra Codex'in artık özel model sağlayıcısını kullandığını ve seçilebilir model sayısının bir anda arttığını göreceksiniz:
Eklentiler de doğrudan kullanılabilir; işte tam deneyim bu:
İtiraf etmelisiniz ki bu yöntem şu ana kadar kullandıklarımın en akıcısı; şiddetle tavsiye edilir.
Ya geri almak istersem?
- Yönetim aracındaki API modunu temizleyin ve resmi yapılandırmaya geri dönün.
- Codex güncellemesinden sonra Codex++ çalışmazsa, uyarlanmasını bekleyin; orijinal sürümün kullanımını etkilemez.
Yöntem 3: CCX + CC Switch
Bu yöntem, "ağ geçidini" ve "değiştirme aracını" ayırarak ileri düzey kullanıcılar için uygundur:
- CCX: API proxy ağ geçidi, protokol dönüşümü ve yönlendirmeden sorumludur. Claude, OpenAI, Codex, Gemini vb. gibi çeşitli giriş noktalarını destekler.
- CC Switch: Masaüstü yönetim aracı, farklı sağlayıcı yapılandırmaları arasında tek tıkla geçiş yapar.
Bu yöntem ne zaman kullanılır? Birden fazla yerli model API'niz, birden fazla aktarma servisiniz, birden fazla Anahtarınız olduğunda veya yukarı akış yalnızca Chat Completions'ı desteklediğinde ve Responses API'ye dönüştürülmesi gerektiğinde.
Adım 1: CCX'i Dağıtın
Docker ile tek bir komut kullanın:
Başlattıktan sonra tarayıcıyı açarak görebilirsiniz.
Adım 2: Yukarı Akış Kanalları Ekleyin
CCX yönetim arayüzünde kanallarınızı ekleyin:
- Yukarı akış servis türünü seçin.
- API Key ve Base URL'yi girin.
- Model eşleme ve yönlendirme kurallarını yapılandırın.
- Yerleşik test işlevini kullanarak bağlantıyı doğrulayın.
Burada önemli bir nokta var: Codex'in bir Responses API giriş noktasına ihtiyacı vardır. Yukarı akışta yalnızca Chat Completions varsa, CCX sizin için protokol dönüşümü yapacaktır, bu da kullanılmasının temel nedenidir.
Adım 3: CC Switch'i Kurun
Komut satırından kurulum:
Başlatma:
Başlatma sırasında CCX adresini aktarma giriş noktası olarak girin.
Adım 4: Yapılandırmayı Değiştirin ve Başlatın
Sağlayıcıları değiştirmek için tek satırlık komut:
Ardından etkinleşmesi için Codex'i yeniden başlatın.
Değiştirdikten sonra ~/.codex/config.toml dosyasını açarak doğrulamanız önerilir:
model_provideraz önce seçtiğiniz şey mi?base_urlCCX'i işaret ediyor mu?- Anahtarı yanlışlıkla halka açık bir depoya yazdınız mı (bu çok önemli)?
Yaygın Tuzakların Özeti
Son olarak, bir sorun giderme tablosu; sorun yaşarsanız önce buna bakın:
Durum | Önce neyi kontrol edin |
|---|---|
Değişiklikten sonra etkili olmuyor | Codex tamamen yeniden başlatıldı mı, |
Kimlik doğrulama hatası | API Key geçerli mi, ortam değişkenleri mevcut kabuk tarafından devralınıyor mu |
Arayüz yolu hatası |
|
Yerli model yanıt vermiyor | Yukarı akış Responses API'yi destekliyor mu; desteklemiyorsa dönüşüm için CCX kullanmalısınız |
Eklenti yapılandırması eksik | Değiştirme aracı yapılandırmanın üzerine yazdı mı; önceden yedeklediniz mi? |
Dürüst olmak gerekirse, üç yöntemi de başarıyla çalıştırdım ama günlük kullanımda en çok 2. Yöntem olan Codex++'ı kullanıyorum; sorunsuz.
Birkaç Anahtarı ve birkaç sağlayıcısı olan ileri düzey bir kullanıcıysanız, 3. Yöntem sizin için daha uygundur.
Pekala, bugünlük paylaşacaklarım bu kadar.
Bu eğitim size yardımcı olduysa, bir beğeni vererek bana bildirin, gelecekte daha fazla Codex pratik oyun tarzı paylaşmaya devam edeceğim.
Sorularınız varsa, doğrudan yorum bölümüne yazın; gördüklerimin hepsine cevap vereceğim.
