CC Switch AI CLI'ler için çapraz platform yapılandırma yöneticisidir. Resmi Codex kurulumu ile birden fazla API sağlayıcısı arasında görsel geçiş sağlar. Bu kılavuz CC Switch 3.20 veya üzeri kullanır.
Yapılandırmaya genel bakış
CC Switch ~/.codex/auth.json ve ~/.codex/config.toml dosyalarını yönetir:
| Alan | Değer |
|---|---|
| Provider name | 4AICode |
| API Key | Panelden bir sk-4ai-... token |
| API endpoint | https://relay.4aicode.com/v1 |
| Default model | gpt-5.6-terra |
| Upstream format | OpenAI Responses API |
4AICode Responses API'yi doğrudan destekler. Full URL modunu ve yerel yönlendirmeyi kapalı tutun.
1. Token ve istemcileri hazırlayın
- Panel → Token yönetiminden bir
sk-4ai-...token oluşturun. - CC Switch web sitesinden veya GitHub Releases sayfasından en son sürümü yükleyin.
- Codex CLI yükleyin.
sk-4ai-xxxxxxxxxxxxxxxx bu kılavuzda bir yer tutucudur. Sağlayıcıyı doldururken panelde oluşturulan token ile değiştirin. Gerçek token'ları sürüm kontrolünden ve özel mesajlardan uzak tutun.
İlk açılışta CC Switch mevcut Codex yapılandırmanızı içe aktarabilir. Sağlayıcı değiştirdiğinizde Codex yapılandırma dosyalarını günceller.
2. 4AICode sağlayıcısını ekleyin
- CC Switch'in üstünde Codex seçin.
- Sağ üstteki + düğmesine tıklayın.
- App-specific provider üzerinde kalın ve Custom ön ayarını seçin.
- Aşağıdaki değerleri girin:
| CC Switch alanı | Değer |
|---|---|
| Name | 4AICode |
| API Key | sk-4ai-xxxxxxxxxxxxxxxx |
| API endpoint / Base URL | https://relay.4aicode.com/v1 |
| Default model | gpt-5.6-terra |
Önerilen uç nokta bölgeye bağlıdır: uluslararası ağlarda .com, Çin ana karasında https://relay.4aicode.net/v1 kullanın. İngilizce örnekler .com kullanır.
3. Gelişmiş seçenekleri kontrol edin
Advanced options bölümünü genişletin ve doğrulayın:
| Seçenek | Ayar |
|---|---|
| Upstream format | OpenAI Responses API |
| Full URL mode | Kapalı |
| Local routing / mapping | Kapalı; yeni CC Switch sürümleri bunu üst formatından çıkarıp anahtarı gizleyebilir |
| Model mapping | Boş |
https://relay.4aicode.com/v1 bir API önekidir. Full URL modu kapalıyken Codex /responses yolunu ekler.
Formun altındaki config.toml (TOML) düzenleyicisinde model_reasoning_effort'u xhigh olarak ayarlayın. Bu kılavuz için önerilen değerdir ve CC Switch bunu Codex yapılandırmasına yazar.
Sağlayıcıyı kaydetmek için Add'e tıklayın.
4. Etkinleştirin ve doğrulayın
- 4AICode sağlayıcı kartında Enable'a tıklayın.
- Çalışan her Codex CLI veya Codex App örneğinden çıkın.
- Yeni bir terminal açıp çalıştırın:
codex
“Bu dizini listele ve proje yapısını açıkla” gibi basit bir görev girin. Normal bir yanıt kurulumu doğrular.
CC Switch sağlayıcısını değiştirdikten sonra Codex'in yeniden başlatılması gerekir. Gelecekteki sağlayıcı geçişleri için ana pencereyi veya sistem tepsisini kullanabilirsiniz.
Modelleri değiştirme
4AICode sağlayıcısını düzenleyip Default model altına bir model girin. Bu modeller şu anda 4AICode tarafından sunulur; panel model listesi ve hesap havuzu durumu yetkilidir:
| Model | Önerilen kullanım |
|---|---|
gpt-6-astra | Yeni nesil amiral gemisi; resmi fiyatın %15'i üzerinden faturalandırılır |
gpt-5.6-sol | Karmaşık mühendislik ve en güçlü muhakeme |
gpt-5.6-terra | Günlük kodlama; önerilen varsayılan |
gpt-5.6-luna | Hızlı, ekonomik görevler |
gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex | Mevcut iş akışları |
gpt-5.6-sol max muhakeme çabasını destekler. Diğer modeller için xhigh önerilen ayardır. max daha fazla muhakeme hesaplama kullanır, daha yavaş yanıt verir ve daha pahalıdır. Kaydedin, sağlayıcıyı yeniden etkinleştirin ve Codex'i yeniden başlatın.
Yapılandırma referansı
CC Switch, üçüncü taraf API anahtarı sağlayıcısı için token'ı auth.json'da saklar; semantik aşağıdaki örneklerle aynıdır. Resmi ChatGPT giriş modu tokens ve last_refresh içeren ayrı bir kimlik doğrulama yapısı kullanır; CC Switch her yapıyı sağlayıcı türüne göre yönetir. CC Switch farklı bir sağlayıcı ID'si ve bölüm adı da üretebilir.
auth.json:
{
"OPENAI_API_KEY": "sk-4ai-xxxxxxxxxxxxxxxx"
}
config.toml:
model_provider = "custom"
model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
[model_providers.custom]
name = "4AICode"
base_url = "https://relay.4aicode.com/v1"
wire_api = "responses"
requires_openai_auth = true
requires_openai_auth = true bu sağlayıcıya API anahtarını auth.json'dan okumasını söyler.
Sorun giderme
| Belirti | Düzeltme |
|---|---|
| Codex hâlâ önceki sağlayıcıyı kullanıyor | 4AICode kartının “Currently enabled” dediğini doğrulayın, Codex'ten tamamen çıkın, ardından yeni bir terminal açın veya uygulamayı yeniden başlatın |
İstek 401 dönüyor | API anahtarının eksiksiz ve panelde aktif olduğunu kontrol edin |
İstek 404 dönüyor | Base URL'nin /v1 ile bittiğinden ve Full URL modunun kapalı olduğundan emin olun |
| İstekler CC Switch yerel proxy'sinden geçiyor | Responses formatını seçin ve yerel yönlendirme devralmayı kapatın |
| Bu kılavuzdaki alanlar eksik | CC Switch'i yükseltin; alan etiketleri güncel uygulama sürümünü izler |
Kurulum betiği, Codex App mobil desteği ve SDK örnekleri için ChatGPT / Codex kurulumu sayfasına bakın.