Kılavuzlar

CC Switch

LLMs Text

CC Switch kurulumu

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:

AlanDeğer
Provider name4AICode
API KeyPanelden bir sk-4ai-... token
API endpointhttps://relay.4aicode.com/v1
Default modelgpt-5.6-terra
Upstream formatOpenAI 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

  1. Panel → Token yönetiminden bir sk-4ai-... token oluşturun.
  2. CC Switch web sitesinden veya GitHub Releases sayfasından en son sürümü yükleyin.
  3. 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

  1. CC Switch'in üstünde Codex seçin.
  2. Sağ üstteki + düğmesine tıklayın.
  3. App-specific provider üzerinde kalın ve Custom ön ayarını seçin.
  4. Aşağıdaki değerleri girin:
CC Switch alanıDeğer
Name4AICode
API Keysk-4ai-xxxxxxxxxxxxxxxx
API endpoint / Base URLhttps://relay.4aicode.com/v1
Default modelgpt-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çenekAyar
Upstream formatOpenAI Responses API
Full URL modeKapalı
Local routing / mappingKapalı; yeni CC Switch sürümleri bunu üst formatından çıkarıp anahtarı gizleyebilir
Model mappingBoş

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

  1. 4AICode sağlayıcı kartında Enable'a tıklayın.
  2. Çalışan her Codex CLI veya Codex App örneğinden çıkın.
  3. 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-astraYeni nesil amiral gemisi; resmi fiyatın %15'i üzerinden faturalandırılır
gpt-5.6-solKarmaşık mühendislik ve en güçlü muhakeme
gpt-5.6-terraGünlük kodlama; önerilen varsayılan
gpt-5.6-lunaHızlı, ekonomik görevler
gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codexMevcut 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

BelirtiDüzeltme
Codex hâlâ önceki sağlayıcıyı kullanıyor4AICode 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üyorAPI anahtarının eksiksiz ve panelde aktif olduğunu kontrol edin
İstek 404 dönüyorBase URL'nin /v1 ile bittiğinden ve Full URL modunun kapalı olduğundan emin olun
İstekler CC Switch yerel proxy'sinden geçiyorResponses formatını seçin ve yerel yönlendirme devralmayı kapatın
Bu kılavuzdaki alanlar eksikCC 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.