Dokümanlar/Entegrasyon kılavuzu

CC Switch birleşik sağlayıcısı ile Codex yapılandırma

Bu belge hakkında

Bu belge, OpenAI Codex komut satırı aracını belirtilen API ağ geçidine bağlamak ve yapılandırmayı yürürlüğe koymak için CC Switch birleşik sağlayıcı (Universal Provider) özelliğinin nasıl kullanılacağını açıklar.

Uygulanabilir sürüm: CC Switch v3.16.x ve üzeri.

Bilgi kaynağı: CC Switch resmi deposunun kullanıcı kılavuzu ve kaynak kodu. Yazılım hızla yenilenir; ürün arayüzü bu belgedeki açıklamayla uyuşmuyorsa, uygulamada görünen esas alınır.

Terim açıklamaları

Terim Açıklama
Codex OpenAI tarafından sunulan komut satırı yapay zeka kodlama asistanıdır. Kurulumdan sonra terminalde codex komutu çalıştırılarak başlatılır.
CC Switch Codex, Claude Code, Gemini CLI gibi araçların hizmet uç noktalarını ve kimlik bilgilerini yönetmek için kullanılan, platformlar arası bir masaüstü yapılandırma yönetim aracıdır. CC Switch’in kendisi yapay zeka yeteneği sunmaz; yalnızca yapılandırma dosyalarını oluşturmak ve bunlar arasında geçiş yapmakla sorumludur.
Sağlayıcı (Provider) Model çıkarım yeteneği sunan hizmet tarafıdır. Model üreticisinin resmi hizmeti olabileceği gibi, kendi kurduğunuz veya satın aldığınız bir API ağ geçidi de olabilir.
API Key Kimlik doğrulama için kullanılan anahtar dizesidir; genellikle sk- ile başlar.
Birleşik sağlayıcı (Universal Provider) CC Switch’in bir özelliğidir. Tek bir yapılandırma Claude Code, Codex ve Gemini CLI olmak üzere üç araca aynı anda senkronize edilebilir. Birden fazla API protokolünü aynı anda destekleyen ağ geçitleri (örneğin NewAPI) için uygundur.
Uygulamaya özel sağlayıcı Yalnızca tek bir araca uygulanan sağlayıcı yapılandırmasıdır; birleşik sağlayıcının karşılığıdır.

Başlamadan önce

Sistem gereksinimleri

İşletim sistemi Minimum sürüm Mimari
Windows Windows 10 x64
macOS macOS 12 (Monterey) Intel (x64) / Apple Silicon (arm64)
Linux Ubuntu 22.04 / Debian 11 / Fedora 34 ve eşdeğer sürümler x64 / ARM64

Ayrıca Node.js 18 veya daha yüksek bir sürüm gerekir. Kurulum adımları için “Görev 1”e bakın.

Önceden edinilmesi gereken bilgiler

Yapılandırmaya başlamadan önce lütfen API hizmet sağlayıcısından aşağıdaki dört bilgiyi edinin. Herhangi biri eksik olursa yapılandırma tamamlanamaz.

Öğe Açıklama Örnek
API adresi (Base URL) Ağ geçidinin hizmet adresi https://seedrouter.net
API Key Kimlik doğrulama anahtarı sk-xxxxxxxxxxxx
Model adı Codex tarafında kullanılan model tanımlayıcısı gpt-5.6-sol
Protokol desteği durumu Ağ geçidinin OpenAI Responses protokolünü destekleyip desteklemediği Destekleniyor / Desteklenmiyor

Önemli nokta: Dördüncü madde, bu belgenin geçerli olup olmadığını belirler. Birleşik sağlayıcının Codex için oluşturduğu yapılandırmada iletişim protokolü wire_api = "responses" olarak sabittir ve değiştirilemez. Ağ geçidi Responses protokolünü desteklemiyor ve yalnızca Chat Completions protokolünü destekliyorsa birleşik sağlayıcı kullanılamaz; “Sorun giderme” bölümündeki F çözümünü kullanın.

Terminali açma

Bu belgenin birçok yerinde terminalde komut çalıştırmanız gerekir. Terminali şu şekilde açabilirsiniz:

  • Windows: Win + R tuşlarına basın, powershell yazın ve Enter tuşuna basın.
  • macOS: Command + Boşluk tuşlarına basın, terminal yazın ve Enter tuşuna basın.
  • Linux: Dağıtımla birlikte gelen terminal uygulamasını kullanın.

Görev 1: Node.js kurulumu

Bu görev hakkında

Codex, Node.js paket yöneticisi npm aracılığıyla dağıtılır. CC Switch’in tek tıkla kurulum yöntemini kullansanız bile önce Node.js çalışma ortamına sahip olmanız gerekir.

İşlem

  1. Node.js resmi web sitesini ziyaret edin.

  2. LTS (uzun süreli destek sürümü) olarak işaretlenen kurulum paketini indirin. Current sürümünü indirmeyin.

  3. Kurulum programını çalıştırın ve varsayılan seçeneklerle kurulumu tamamlayın; hiçbir yapılandırma öğesini değiştirmeniz gerekmez.

    Homebrew kurulu macOS kullanıcıları terminalde brew install node komutunu da çalıştırabilir.

  4. Açık olan tüm terminal pencerelerini kapatın ve yeni bir terminal penceresi açın.

  5. Kurulumu doğrulamak için aşağıdaki komutları sırayla çalıştırın:

    node --version
      npm --version

Sonuç

Her iki komut da bir sürüm numarası yazdırır (örneğin v22.14.0 ve 10.9.2) ve Node.js sürümü en az v18 ise kurulum başarılıdır.

Not: “iç veya dış komut” ya da “command not found” iletisi görünürse, bunun nedeni genellikle terminal penceresinin yeniden açılmamış olmasıdır. Yeni kurulan komutlar yalnızca yeni açılan terminal oturumunda etkinleşir.

Görev 2: CC Switch kurulumu

Bu görev hakkında

CC Switch ücretsiz ve açık kaynaklı bir yazılımdır ve yalnızca aşağıdaki iki kanaldan dağıtılır:

Uyarı: Ödeme, bakiye yükleme veya hesap oturum açma kimlik bilgileri talep eden hiçbir “CC Switch” web sitesi veya istemcisi resmi kanal değildir; bunları indirmeyin ve kullanmayın.

İşlem

Windows

  1. GitHub yayın sayfasını açın ve en son sürüm girişinin altındaki Assets bölümünde CC-Switch-v3.16.x-Windows.msi dosyasını bulun.

  2. Kurulum programını indirip çift tıklayarak çalıştırın ve yönergeleri izleyerek kurulumu tamamlayın.

    Çift tıkladıktan sonra hiçbir tepki olmazsa dosya sistem güvenlik ilkesi tarafından kilitlenmiştir. Dosyaya sağ tıklayın, Özellikler’i seçin, Genel sekmesinin altındaki Güvenlik alanında Engellemeyi kaldır kutusunu işaretleyin, Tamam’a tıklayın ve yeniden çalıştırın.

    Sisteme kurmak istemezseniz kurulum gerektirmeyen CC-Switch-v3.16.x-Windows-Portable.zip sürümünü de indirebilir, arşivi açtıktan sonra doğrudan CC-Switch.exe dosyasını çalıştırabilirsiniz.

macOS

Aşağıdaki yöntemlerden birini kullanın:

  • Yöntem 1 (Homebrew kuruluysa önerilir): Terminalde şunu çalıştırın

    brew install --cask cc-switch

  • Yöntem 2: CC-Switch-v3.16.x-macOS.dmg dosyasını indirin, çift tıklayarak açın ve CC Switch simgesini “Uygulamalar” klasörüne sürükleyin.

    Not: macOS sürümü Apple kod imzasından ve noter tasdikinden geçmiştir; doğrudan kurulup açılabilir, “geliştirici doğrulanamıyor” uyarısı görünmez ve ek bir karantina kaldırma işlemi gerekmez.

Linux

Dağıtıma göre seçin:

  • Debian / Ubuntu: .deb paketini indirip ardından şunu çalıştırın

    sudo dpkg -i CC-Switch-v3.16.x-Linux-*.deb
      sudo apt-get install -f

  • Arch Linux: paru -S cc-switch-bin

  • Diğer dağıtımlar: .AppImage dosyasını indirin, çalıştırma izni eklemek için chmod +x çalıştırdıktan sonra doğrudan çalıştırın.

Sonuç

CC Switch başlatıldıktan sonra ana pencerenin normal şekilde görünmesi ve sistem tepsisinde (Windows’ta sağ alt köşede, macOS’ta menü çubuğunun sağında) CC Switch simgesinin belirmesi, kurulumun başarılı olduğunu gösterir.

İlk başlatmada mevcut CLI aracı yapılandırmasını içe aktarmanız istenirse içe aktarmayı seçmeniz önerilir. Bu işlem, mevcut yapılandırmayı varsayılan bir sağlayıcı olarak kaydeder ve yapılandırma kaybına yol açmaz.

Görev 3: Codex kurulumu

Bu görev hakkında

Kurulumu CC Switch grafik arayüzünden veya komut satırından yapabilirsiniz. İlk kez kullananlara Yöntem A önerilir.

İşlem

Yöntem A: CC Switch üzerinden kurulum (önerilen)

  1. CC Switch’i başlatın.

  2. Sırasıyla Settings > About bölümüne gidin.

  3. Local Environment Check alanında Codex satırının durumuna bakın.

  4. Durum Not detected olarak görünüyorsa satırın sağındaki Install düğmesine tıklayın.

    Kurulum arka planda sessizce yürütülür, ilerleme düğmede gösterilir ve tamamlandığında sürüm numarası otomatik olarak yenilenir.

Not: Sonraki yükseltmeler de bu arayüzde yapılır. Yeni bir sürüm algılandığında tek tek yükseltebilir veya Upgrade All düğmesine tıklayarak toplu işlem yapabilirsiniz.

Yöntem B: Komut satırından kurulum

  1. Terminali açın.

  2. Aşağıdaki komutu çalıştırın:

    npm install -g @openai/codex

    İndirme çok yavaşsa mirror kaynağına geçebilirsiniz:

    npm install -g @openai/codex --registry=https://registry.npmmirror.com

    Mirror kaynağını uzun süreli kullanacaksanız, global ayar için önce aşağıdaki komutu bir kez çalıştırın:

    npm config set registry https://registry.npmmirror.com

Sonuç

Terminali kapatıp yeniden açtıktan sonra aşağıdaki komutu çalıştırın:

codex --version

Sürüm numarasının yazdırılması, kurulumun başarılı olduğunu gösterir.

Not: Bu aşamada sağlayıcı yapılandırması henüz tamamlanmamıştır. codex doğrudan çalıştırıldığında geçerli kimlik bilgisi olmadığı için hata vermesi beklenen davranıştır. Yapılandırma Görev 4’te tamamlanır.

Görev 4: Birleşik sağlayıcı oluşturma

Bu görev hakkında

Bu görevde CC Switch içinde bir birleşik sağlayıcı yapılandırması oluşturulur ve Codex sağlayıcı listesine eşitlenir.

İşlem

  1. CC Switch’i başlatın.

  2. Üstteki uygulama değiştiricide Codex seçeneğine geçin.

    Claude veya Gemini paneline geçmek de birleşik sağlayıcı girişine ulaşmanızı sağlar. Üçü aynı yapılandırmayı paylaşır.

  3. Sağ üst köşedeki ＋ düğmesine tıklayarak sağlayıcı ekleme panelini açın.

  4. Panelin üstünde Unified Provider sekmesini seçin.

    Kısıtlama: OpenCode, OpenClaw, Hermes ve Claude Desktop panelleri birleşik sağlayıcıyı desteklemez; bu panellerde bu sekme görünmez. Sekmeyi görmüyorsanız önce Claude, Codex veya Gemini paneline geçin.

  5. Add Unified Provider öğesine tıklayın.

  6. Form alanlarını aşağıdaki tabloya göre doldurun:

    Alan Doldurma açıklaması
    Select Preset Type Ağ geçidi NewAPI ise NewAPI seçin. Diğer durumlarda veya emin değilseniz Custom Gateway seçin. İki seçeneğin alanları tamamen aynıdır, yalnızca varsayılan değerleri farklıdır.
    Name Özel bir tanımlayıcı ad, örneğin NewAPI ağ geçidi. Bu ad Codex sağlayıcı kartında görünür.
    API Address Önceden edindiğiniz Base URL’yi girin. Doldurma kuralları için aşağıdaki "API adresinin işlenme kuralları" bölümüne bakın.
    API Key Önceden edindiğiniz anahtarı girin. Düz metin görünümünü açıp kapatmak için sağdaki göz simgesine tıklayabilirsiniz.
    Official Website İsteğe bağlı. Doldurulursa sağlayıcı kartından doğrudan gidilebilir.
    Notes İsteğe bağlı. Anahtarın kaynağı ve geçerlilik süresi gibi bilgilerin kaydedilmesi önerilir.
    Enabled Apps Claude Code, OpenAI Codex ve Gemini olmak üzere üç anahtar içerir. OpenAI Codex mutlaka açılmalıdır. Ağ geçidi diğer iki araç için de kullanılacaksa onları da açabilirsiniz.
    Model Configuration > Codex > Model Önceden edindiğiniz model adını girin, örneğin gpt-5.6-sol.
    Model Configuration > Codex > Reasoning Effort Akıl yürütme yoğunluğu. Değer low, medium veya high olabilir. Özel bir gereksinim yoksa high girin.

    Not: Unified Provider formu "Fetch Models" düğmesini sunmaz; model adını elle girmeniz gerekir ve büyük/küçük harf duyarlıdır.

  7. Add düğmesine tıklayın.

Sonuç

Arayüz "Unified provider added and synced" iletisini gösterir. Bu sırada CC Switch, Codex sağlayıcı listesinde aynı adlı bir sağlayıcı kartı oluşturmuştur; başka uygulamaları da işaretlediyseniz, ilgili listelerde de kart oluşturulur.

Önemli: Eşitleme, etkinleştirme ile aynı şey değildir. Bu aşamada yapılandırma henüz Codex'in çalışma yapılandırma dosyasına yazılmamıştır; Görev 5'e devam etmeniz gerekir.

API adresi işleme kuralları

CC Switch, Codex için yapılandırma oluştururken girilen API adresini aşağıdaki gibi işler:

Girilen adres biçimi İşlem sonucu
Yalnızca alan adı, yol içermez; örneğin https://seedrouter.net Otomatik olarak https://seedrouter.net/v1 biçimine tamamlanır
/v1 ile bitiyorsa, örneğin https://seedrouter.net/v1 Olduğu gibi kullanılır
Başka bir yol içeriyorsa, örneğin https://api.example.com/openai Olduğu gibi kullanılır, /v1 eklenmez

Ölçüt şudur: işlenen adresin sonuna /responses eklendikten sonra elde edilen yol, ağ geçidinde gerçekten kullanılabilen bir endpoint yolu olmalıdır. Doldurmadan önce hizmet sağlayıcıdan tam endpoint adresini doğrulamanız, ardından yukarıdaki tabloya göre girilecek değeri çıkarmanız önerilir. Adres yanlışsa istek 404 döndürür.

Görev 5: Sağlayıcıyı etkinleştirin ve yapılandırmayı geçerli kılın

Bu görev hakkında

Sağlayıcı kartı oluşturulduktan sonra kartı elle etkinleştirmeniz gerekir; yapılandırma ancak o zaman Codex yapılandırma dosyasına yazılır. Codex, yapılandırma hot reload özelliğini desteklemez; etkinleştirdikten sonra terminali yeniden başlatmanız gerekir.

İşlem

  1. Sağlayıcı ekleme panelini kapatın.

  2. Üstteki uygulama değiştiricide Codex seçeneğine geçin.

  3. Sağlayıcı listesinde, Görev 4'te oluşturulan aynı adlı kartı bulun.

  4. Karttaki Enable düğmesine tıklayın.

    Kart mavi kenarlıkla görünür ve "Currently enabled" etiketi taşır; bu, yapılandırmanın yazıldığını gösterir.

  5. Mevcut terminal penceresini tamamen kapatın, ardından yeni bir terminal penceresi açın.

    Önemli: Burada kastedilen tüm terminal penceresini kapatmaktır; codex işleminden çıkıp codex komutunu yeniden çalıştırmak değildir. Araçların geçerli olma biçimleri şöyle farklılık gösterir:

    Araç Sağlayıcı değiştirildikten sonra geçerli olma biçimi
    Claude Code Anında geçerli olur, hot reload desteklenir
    Gemini CLI Anında geçerli olur, her istekte yapılandırma yeniden okunur
    Codex Terminali kapatıp yeniden açmak gerekir
    OpenCode / OpenClaw Terminali kapatıp yeniden açmak gerekir

  6. Yeni terminalde şunu çalıştırın:

    codex

  7. Başladıktan sonra bir deneme cümlesi girin, örneğin "Merhaba, lütfen kısaca kendinizi tanıtın".

Sonuç

Model normal biçimde yanıt döndürür. Bu, yapılandırmanın tamamlandığını ve Codex'in belirtilen ağ geçidine bağlandığını gösterir.

Referans: Oluşturulan yapılandırma dosyaları

CC Switch, en az müdahale ilkesine uyar. Sağlayıcı etkinleştirildikten sonra yapılandırma doğrudan Codex'in kendi yapılandırma dosyasına yazılır; CC Switch kaldırılsa bile Codex normal çalışmaya devam eder.

İlgili dosyalar aşağıdadır. Yoldaki ~ geçerli kullanıcı dizinini gösterir; Windows altında C:\Users\<kullanıcı adı>\, macOS ve Linux altında /Users/<kullanıcı adı>/ veya /home/<kullanıcı adı>/ biçimindedir.

~/.codex/auth.json — kimlik bilgilerini saklar:

{
        "OPENAI_API_KEY": "<API Key>"
      }

~/.codex/config.toml — model ve endpoint yapılandırmasını saklar:

model_provider = "cliproxyapi"
      model = "gpt-5.6-sol"
      model_reasoning_effort = "max"
      sandbox_mode = "workspace-write"
      model_context_window = 372000
      model_auto_compact_token_limit = 334800
      model_auto_compact_token_limit_scope = "total"
      service_tier = "priority"
      
      [model_providers.cliproxyapi]
      name = "SeedRouter"
      base_url = "https://seedrouter.net/v1"
      wire_api = "responses"
      requires_openai_auth = true
      experimental_bearer_token = "sk-xxxxxxxxxx"

CC Switch'in kendi verileri ~/.cc-switch/ dizininde saklanır; veritabanı dosyası cc-switch.db'dir, otomatik yedekler backups/ alt dizininde bulunur ve en son 10 kopya tutulur.

Bakım işlemleri

Yapılandırmayı değiştirme

API Key, model adı veya hizmet adresini değiştirirken:

  1. ＋ düğmesine tıklayın ve Unified Provider sekmesine geçin.

  2. Hedef karttaki düzenleme simgesine tıklayın.

  3. Karşılık gelen alanları değiştirin.

    Düzenleme modunda formun alt kısmında Config JSON Preview alanı bulunur; senkronizasyondan önce her uygulamaya yazılacak gerçek içeriği doğrulayabilirsiniz.

  4. Save and Sync'e tıklayın.

  5. Onay iletişim kutusunda işlemi onaylayın. Bu işlem, Claude, Codex ve Gemini içindeki ilişkili sağlayıcı yapılandırmalarının üzerine yazacaktır.

  6. Terminali kapatıp yeniden açın.

Sağlayıcı kartı işlem açıklamaları

İşlem Açıklama
Sync Geçerli yapılandırmayı her ilişkili uygulamaya elle yeniden gönderir; yapılandırma tutarsız olduğunda onarmak için kullanılır.
Copy Geçerli yapılandırmaya dayanarak bir kopya oluşturur; yedek anahtar yapılandırmayı kolaylaştırır.
Edit Yapılandırma içeriğini değiştirir.
Delete Unified Provider'ı siler; bunun Claude, Codex ve Gemini içinde oluşturduğu ilişkili sağlayıcı kartlarını da siler.

Hızlı geçiş

Bildirim alanındaki CC Switch simgesine sağ tıklayın. Codex alt menüsünde hedef sağlayıcı adına doğrudan tıklayarak geçiş yapabilirsiniz; ana arayüzü açmanız gerekmez. Geçişten sonra terminali yine yeniden başlatmanız gerekir.

Sorun giderme

A. 401 veya 403 döner: kimlik doğrulama başarısız

Olası neden Çözüm
API Key kopyalanırken fazladan boşluk veya satır sonu karakteri içermesi Yeniden kopyalayıp yapıştırın; seçim aralığına dikkat edin
API Key'in süresinin dolması veya kotanın tükenmesi Anahtar durumunu hizmet sağlayıcıdan teyit edin
API Key ile API adresinin uyuşmaması İkisinin aynı hizmetten gelip gelmediğini kontrol edin

B. 404 döner veya endpoint'in mevcut olmadığı belirtilir

Çoğu durumda API adresi işlendikten sonra hatalıdır. “Görev 4 > API adresi işleme kuralları”na göre yeniden kontrol edin ve tam endpoint adresini hizmet sağlayıcıdan teyit edin.

C. Yapılandırma değiştirildikten sonra hiçbir değişiklik olmaz

Terminal yeniden başlatılmamıştır. Terminal penceresini tamamen kapatıp yeniden açın. Bu, Codex kullanılırken en sık karşılaşılan sorundur.

D. Arayüzün üst kısmında ortam değişkeni çakışması uyarısı görünür

Sistemde OPENAI_API_KEY gibi ortam değişkenleri vardır. Ortam değişkenlerinin önceliği yapılandırma dosyalarından yüksektir; CC Switch'in yazdığı yapılandırmanın üzerine yazarlar ve isteklerin yanlış endpoint'e gitmesine veya yanlış anahtarın kullanılmasına yol açarlar.

İşlem adımları:

  1. Uyarı bandındaki Expand'e tıklayarak çakışan değişkenin adını, değerini ve kaynağını görüntüleyin.
  2. Silinecek değişkenleri işaretleyin veya Select All'a tıklayın.
  3. Delete Selected'e tıklayıp onaylayın.

CC Switch, silmeden önce otomatik olarak ~/.cc-switch/env-backups/ konumuna yedek alır. Geri yüklemeniz gerekirse bu dizindeki JSON dosyasından elle geri yükleyebilirsiniz.

E. Terminal, codex komutunun bulunmadığını bildirir

Olası neden Çözüm
Kurulumdan sonra terminalin yeniden açılmaması Tüm terminal pencerelerini kapatıp yeniden açın
Node.js'in doğru kurulmaması Görev 1'e dönüp npm --version komutunun normal çıktı verip vermediğini doğrulayın
npm genel dizininin PATH'e eklenmemiş olması CC Switch içindeki Settings > About > Local Environment Check ile yeniden kurun

F. Ağ geçidi yalnızca Chat Completions protokolünü destekler

Unified Provider'ın iletişim protokolü Responses olarak sabittir; bu senaryoda geçerli değildir. Uygulamaya özel sağlayıcı kullanmanız gerekir.

  1. CC Switch'te Codex paneline geçin ve ＋ düğmesine tıklayın.
  2. Soldaki Codex Provider sekmesinde kalın; Unified Provider'a geçmeyin.
  3. Preset açılır listesinden karşılık gelen hizmet sağlayıcıyı seçin. DeepSeek, Zhipu GLM, Kimi, MiniMax, StepFun, Bailian, ModelScope, SiliconFlow, Doubao Seed, Xiaomi MiMo, Novita AI ve benzerlerinin tümü Chat Completions türü presetlerdir.
  4. Bu tür bir preset seçildikten sonra CC Switch, “Requires local route mapping” anahtarını otomatik olarak açar ve model eşleme tablosunu yapılandırır. Protokol dönüşümünü yerel proxy tamamlar; elle ayar gerekmez.
  5. API Key'i girin, Add'e tıklayın, ardından bu sağlayıcıyı etkinleştirip terminali yeniden başlatın.

G. Resmi hesapla oturum açmaya geri dönülmesi gerekir

  1. Codex panelinde “OpenAI Official” presetine ait sağlayıcıyı ekleyin.
  2. Bu sağlayıcıyı etkinleştirin ve terminali yeniden başlatın.
  3. Kimlik doğrulamayı Codex'in kendi oturum açma akışına göre tamamlayın.

Tamamlandıktan sonra resmi oturum açma ile üçüncü taraf sağlayıcılar arasında serbestçe geçiş yapabilirsiniz.

Seçim referansı: Unified Provider ve App-specific Provider

Kullanım senaryosu Önerilen çözüm
Tek bir ağ geçidi aynı anda Claude Code, Codex ve Gemini CLI için hizmet verir ve Responses protokolünü destekler Unified Provider
Yalnızca Codex aracı kullanılır Her ikisi de uygundur; App-specific Provider için yapılandırma yolu daha kısadır
Ağ geçidi yalnızca Chat Completions protokolünü destekler App-specific Provider, yerleşik hazır ayarla birlikte
Her araç farklı bir hizmet sağlayıcısına bağlanır App-specific Provider, ayrı ayrı yapılandırın
OpenCode, OpenClaw veya Hermes yapılandırması gerekir App-specific Provider; bu üç araç Unified Provider'ı desteklemez

Güvenlik notları

  1. API Key, hesap kimlik bilgileriyle aynı ölçüde hassastır. Anlık mesajlaşma araçlarında iletmeyin, ekran görüntüsü olarak paylaşmayın veya kod deposuna göndermeyin.
  2. CC Switch kurulum paketini yalnızca CC Switch resmi sitesinden veya resmi GitHub deposundan edinin.
  3. Cihaz değiştiğinde veya anahtarın sızdığından şüphe ettiğinizde anahtarı hemen değiştirin.
  4. CC Switch yapılandırma dışa aktarma özelliği, tüm sağlayıcı bilgilerini düz metin olarak .sql yedek dosyasına yazar. Dışa aktarılan dosyayı özenle saklayın; paylaşılan bir dizinde bulundurmayın.

Hızlı referans

1. Node.js kurun               nodejs.org, LTS sürümünü seçin
      2. CC Switch kurun             ccswitch.io veya GitHub Releases
      3. Codex kurun                 CC Switch > Settings > About > Local Environment Check > Install
      4. Unified Provider oluşturun  Codex paneline geçin > ＋ > Unified Provider > Add Unified Provider
                                    Ad, API adresi, API Key girin
                                    OpenAI Codex anahtarını açın, model adını girin
      5. Sağlayıcıyı etkinleştirin   Codex paneli > hedef kart > Enable
      6. Terminali yeniden başlatın  Terminal penceresini tamamen kapatıp yeniden açın
      7. Doğrulayın                  codex komutunu çalıştırın ve bir test mesajı gönderin

Sorun geri bildirimi gönderirken, sorun giderme süresini kısaltmak için hata bilgisinin eksiksiz ekran görüntüsünü ve görev 4'te doldurduğunuz API adresini (anahtar kısmı maskelenmelidir) birlikte iletin.

SeedRouter API Key alın Belge ana sayfasına dönün