Claude Code sağlayıcı değiştirme: 5 dakikada CC Switch eğitimi

Bu eğitimde CC Switch v4.0.26 (Kasım 2026) temel alınmıştır. Düğme adları sonraki sürümlerde değişebilir; yapılandırma modeli sabittir.

Claude Code’u sağlayıcılar arasında değiştirmek genellikle ~/.claude/settings.json dosyasını düzenlemek anlamına gelir: temel URL, API anahtarı ve bazen de model. Tek sağlayıcıyla bu yönetilebilir. İki ya da üç sağlayıcıda ise küçük bir bakım işine dönüşür; üstelik hata sessizce ortaya çıkar, çünkü kabuğunuzdaki eski bir ANTHROPIC_* dışa aktarımı, az önce düzenlediğiniz dosyadaki değerleri geçersiz kılabilir.

CC Switch, sağlayıcı değiştirmeyi tıklayacağınız bir karta dönüştürür. Yerleşik AiHubMix ön ayarı uç noktayı doldurur; siz de bir API anahtarı yapıştırırsınız. Claude Code genellikle değişikliği yeniden başlatma gerektirmeden yükler. Bu eğitimde tüm kurulum adımları anlatılıyor; ardından CC Switch’in ne yazdığı, ortam değişkeni tuzağı ve doğrudan modun ne zaman yeterli olduğu açıklanıyor.

Kısaca anlatmamız yeterliyse: CC Switch’i yükleyin, bir AIHubMix anahtarı oluşturun, Claude Code altında AiHubMix ön ayarını seçin, anahtarı yapıştırın, sağlayıcıya ANTHROPIC_MODEL=claude-sonnet-5-5 ekleyin, Switch düğmesine tıklayın ve claude -p "1+1, output only the answer" --model claude-sonnet-5-5 komutunu çalıştırın. Yazının geri kalanında bu adımların ayrıntılarını bulabilirsiniz.

CC Switch nedir?

CC Switch, Claude Code, Codex, Gemini CLI, OpenCode ve diğer kodlama araçlarındaki sağlayıcı yapılandırmalarını yönetmek için geliştirilmiş açık kaynaklı bir masaüstü uygulamasıdır (MIT, Tauri + Rust + React). 90'dan fazla sağlayıcı ön ayarı sunar ve özel sağlayıcıları destekler.

Bir anahtar değiştiriciden fazlasıdır:

• Doğrudan mod, istemcinin yapılandırma dosyasındaki anahtar alanlarını yeniden yazar ve istemcinin sağlayıcıyla iletişim kurmasını sağlar.
• Yönlendirme modu, API biçimi dönüştürme, yedek sağlayıcıya geçiş, sağlık kontrolleri ve istek günlükleri sunan yerel bir ağ geçidini 127.0.0.1:15721 adresinde çalıştırır.
• Toplama modu, birkaç sağlayıcının modellerini tek bir /model listesinde bir araya getirir.

Depo ve kullanım kılavuzu github.com/farion1231/cc-switch adresindedir. Resmî indirme kaynakları yalnızca ccswitch.io ve GitHub Releases sayfasıdır; ödeme veya hesap bilgileri isteyen hiçbir site resmî değildir.

Başlamadan önce

Üç şeye ihtiyacınız var:

• Claude Code yüklü olmalı ve terminalden çalıştırılabilmeli. claude --version komutuyla kontrol edin. Yüklü değilse resmî yükleyiciyi kullanın: curl -fsSL https://claude.ai/install.sh | bash veya Node.js 22 ya da daha yenisiyle npm i -g @anthropic-ai/claude-code.
• Bir AIHubMix hesabınız ve API anahtarınız olmalı. AIHubMix konsolunda bir anahtar oluşturun. Anahtar genellikle sk- ile başlar.
• Bir CC Switch yükleyicisi. ccswitch.io veya GitHub Releases sayfasından indirin.

1. adım: CC Switch’i yükleyin

CC Switch ilk açılışta mevcut Claude Code yapılandırmasını default adlı bir sağlayıcı olarak içe aktarır ve bir resmî sağlayıcı ekler. Özgün yapılandırmanız kaybolmaz; istediğiniz zaman geri dönebilirsiniz.

Claude Code henüz yüklü değilse CC Switch’teki Apps sayfasından uygulamayı yükleyebilir veya yükseltebilirsiniz.

2. adım: AIHubMix API anahtarı oluşturun

AIHubMix API anahtarları sayfasını açın, bir anahtar oluşturun ve kopyalayın.

Belgelerdeki AIHUBMIX_API_KEY yer tutucusu gerçek bir anahtar değildir. Bunu olduğu gibi yapıştırırsanız istek 401 invalid key: AIHUBMIX_API_KEY hatasıyla başarısız olur.

3. adım: Claude Code’a AIHubMix ekleyin

1. Sol kenar çubuğunda Claude Code’u seçin.
2. Sağ üst köşedeki + düğmesine tıklayın.
3. AiHubMix için arama yapın veya üçüncü taraf platformları kategorisinde bulun.
4. Ad ve uç nokta otomatik olarak doldurulur: https://aihubmix.com. Anahtarınızı API Key alanına yapıştırın.
5. Add düğmesine tıklayın.

Ön ayar iki ortam değişkeni kaydeder:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

Ön ayar model belirlemez. AIHubMix’in kılavuzu ANTHROPIC_MODEL değişkenini temel bir değişken olarak ele alıyor; bu nedenle geçiş yapmadan önce aynı env bloğuna ekleyin:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Model belirtilmezse Claude Code kendi varsayılan model kimliğini gönderir; bu model AIHubMix tarafından sunulan modellerden biri olmayabilir.

Dikkat edilmesi gereken iki ayrıntı var.

Temel URL’nin sonuna /v1 eklemeyin. Claude Code, Anthropic Messages protokolünü kullanır ve istek yolunu kendisi oluşturur. Doğru adres https://aihubmix.com; https://aihubmix.com/v1 ise diğer istemciler için OpenAI uyumlu temel URL’dir ve Claude Code bunun sonuna kendi /v1/messages yolunu ekler.

Ön ayar ANTHROPIC_API_KEY kullanırken AIHubMix’in kendi Claude Code kılavuzu ANTHROPIC_AUTH_TOKEN kullanır. AIHubMix ikisini de kabul eder: ANTHROPIC_AUTH_TOKEN bir Bearer başlığı gönderirken ANTHROPIC_API_KEY x-api-key gönderir. Birini seçin. İkisini farklı değerlerle doldurmayın. AIHubMix kurulum bilgileri, model kimlikleri ve hata başvuru kaynağı AIHubMix Claude Code belgelerinde yer alır.

Ön ayar yoksa (örneğin daha eski bir sürüm kullanıyorsanız veya kartı sildiyseniz) Custom Configuration seçeneğini belirleyip yukarıdaki JSON’u yapıştırın. Sağlayıcı kartının uç nokta yöneticisi gecikmeyi test edebilir; ön ayarda ayrıca https://api.aihubmix.com alternatif uç nokta olarak bulunur; aihubmix.com çözümlenmezse bunu kullanabilirsiniz.

4. adım: Geçiş yapın ve doğrulayın

Direct sekmesinde AiHubMix kartındaki Switch düğmesine tıklayın. Yapılandırma yazıldığında düğme In use olarak değişir.

Claude Code yapılandırmayı otomatik olarak yeniden yükler; genellikle yeniden başlatmak gerekmez. Mevcut oturum eski sağlayıcıyı kullanmaya devam ederse oturumu kapatıp yeniden başlatın.

Uçtan uca bağlantıyı doğrulayın:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

2 yanıtını almanız, isteğin AIHubMix’e ulaştığı anlamına gelir. Etkileşimli bir oturumda /status çıktısındaki Anthropic base URL satırında https://aihubmix.com görünmelidir.

Hızlı değişiklikler için sistem tepsisini kullanın: CC Switch simgesine sağ tıklayın, Claude Code alt menüsünü açın ve bir sağlayıcıya tıklayın. Alt menü başlığında etkin sağlayıcı ve kota özeti görünür.

Resmî sağlayıcıya geri dönmek için Claude Official sağlayıcısına geçin, Claude Code’u yeniden başlatın ve oturum açma adımlarını tamamlayın.

Geçiş işlemi gerçekte neyi değiştirir?

Doğrudan modda CC Switch, ~/.claude/settings.json dosyasındaki yalnızca bağlantı ve uyumluluk alanlarını değiştirir: ANTHROPIC_*, AWS_*, CLAUDE_CODE_USE_BEDROCK gibi protokol seçicileri, model, apiKeyHelper ve CLAUDE_CODE_DISABLE_ARTIFACT ile bağlam penceresi gibi sağlayıcıya özgü bazı uyumluluk seçenekleri.

permissions, hooks, enabledPlugins, statusLine, MCP yapılandırması, yorumlar ve eklediğiniz diğer her şey olduğu gibi kalır. Kesin listeye yapılandırma dosyası başvuru sayfasından ulaşabilirsiniz.

CC Switch, bir aracın yapılandırmasını ilk kez yeniden yazmadan önce özgün dosyanın yedeğini ~/.cc-switch/backups/live-first-write/ konumuna alır. JSON biçimi bozuksa yazma işlemini reddeder, satır ve sütun bilgilerini bildirir ve dosyayı değiştirmeden bırakır.

Tuzak: eski ANTHROPIC_* değişkenleri

CC Switch’in çalışmadığı izlenimini veren sorun budur.

Daha önce bir manuel kurulum kılavuzunu izleyip export ANTHROPIC_BASE_URL=... veya export ANTHROPIC_AUTH_TOKEN=... satırlarını ~/.zshrc ya da ~/.bash_profile dosyasına eklediyseniz bu değişkenler, CC Switch’in yazdığı değerleri geçersiz kılabilir. Kartı AIHubMix’e geçirirsiniz ama istekler eski uç noktaya gitmeye devam eder.

CC Switch çakışmayı algılar. Pencerenin üst kısmında, ortam değişkenlerinin yapılandırmanızı geçersiz kılabileceğini belirten sarı bir bant görünür; ayrıntılarda değişkenin adı, değeri ve kaynağı gösterilir. Delete Selected seçeneği bu değişkenleri silmeden önce ~/.cc-switch/backups/env-backup-<timestamp>.json konumuna yedekler.

Elle kontrol etmek için:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Eski dışa aktarma satırlarını yorum satırı hâline getirin, ardından source ~/.zshrc komutunu çalıştırın ya da yeni bir terminal açın. AIHubMix’in kendi belgeleri, yapılandırmayı CC Switch yönetirken genel ANTHROPIC_* değişkenlerinin kaldırılmasını önerir. Çakışma çözümünün tüm adımları ortam değişkenleri başvuru sayfasında yer alır.

Model takma adları ve geçiş

ANTHROPIC_MODEL ayarlandığında Claude Code’un varsayılanı Sonnet 5.5 olur. /model takma adlarının (opus, sonnet, haiku, fable) AIHubMix model kimliklerine karşılık gelmesini istiyorsanız bunları da eşlemeniz gerekir. Aşağıdaki anahtarları env içine ekleyin:

Sağlayıcının eksiksiz yapılandırması şöyle görünür:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Model seçme önceliği, en yüksekten en düşüğe: /model <name> → claude --model <name> → ANTHROPIC_MODEL → settings.json içindeki model alanı. Model kimliklerini AIHubMix model listesinden kopyalayın; büyük-küçük harfe duyarlıdırlar.

Yönlendirme veya toplama modunu ne zaman kullanmalı?

AIHubMix için varsayılan tercih doğrudan mod olmalıdır. Uç nokta zaten Anthropic Messages protokolünü desteklediğinden protokol dönüştürme gerekmez.

Yedek sağlayıcı kuyruğu istediğinizde veya OpenAI biçimli bir sağlayıcıyı Claude Code’un arkasına yerleştirmeniz gerektiğinde yönlendirme modunu kullanın. Yönlendirme, Claude Code’u http://127.0.0.1:15721 adresine yönlendirir, yapılandırmadaki anahtarı PROXY_MANAGED ile değiştirir ve gerçek anahtarı CC Switch üzerinden ekler. Uygulama çalışır durumda kalmalıdır; CC Switch’ten çıkıldığında doğrudan yapılandırma geri yazılır. Resmî Claude abonelikleri yönlendirme üzerinden kullanılmaz; bunlar için doğrudan modu kullanın.

Toplama modunu, tek bir /model listesinde birden fazla sağlayıcının modellerini kullanmak istediğinizde tercih edin. İstekler, öneksiz olarak varsayılan sağlayıcıya yönlendirilir; diğer sağlayıcıların modelleri ccs- önekiyle görünür. Toplama modunda yük devretme yapılmaz. Bu özellik yalnızca Claude Code ve Codex için kullanılabilir; Claude’un resmi abonelikleri toplama modunda desteklenmez. ccs- model listesi için Claude Code 2.1.243 veya üzeri gerekir. Claude Code model listesindeki değişiklikleri hemen algılar; Codex’in tamamen yeniden başlatılması gerekir.

CC Switch başka neleri yönetiyor?

• Kullanım: pano, yönlendirilen istek günlüklerini yerel oturum günlükleriyle bir araya getirir. Oturum taraması yönlendirme olmadan da çalışır ve ücretlendirme günlükte kaydedilen modele göre yapılır; yönlendirilen istekler ayrı olarak kaydedilir.
• MCP: MCP sunucuları için birleşik bir panel; seçtiğiniz uygulamalarla eşitlenir.
• Beceriler: becerileri tek bir yerden keşfedin, yükleyin ve kaldırın.
• Oturumlar: yerel oturumları arayın, görüntüleyin, dışa aktarın ve sürdürün.
• Projeler: bir projenin sağlayıcısını, MCP sunucularını, becerilerini ve bellek dosyalarını anlık görüntü olarak kaydedin; ardından proje başına tüm yapılandırmayı birlikte değiştirin.

Veriler, merkezinde bir SQLite veritabanı bulunan ~/.cc-switch/ dizininde tutulur. Otomatik yedekleme varsayılan olarak en son 10 yedeği saklar; WebDAV veya S3 uyumlu eşitleme de kullanılabilir. Veritabanı ve dışa aktarılan yedekler anahtarlar da dahil olmak üzere sağlayıcı yapılandırmalarını içerir; bunları gizli bilgi olarak değerlendirin.

Sorun giderme

Aşağıdaki hata mesajları, AIHubMix'in Claude Code belgelerinden alıntılanmıştır.

Hata olmayan sorunlar için:

• Giriş ekranı veya Not logged in mesajı: /status komutunu kontrol edin; Ayarlar → Uygulama yapılandırması → Claude Code bölümünde Skip Claude Code first-run confirmation seçeneğini etkinleştirin; uygulamayı yeniden başlatın ve anahtarın girildiğini doğrulayın.
• Geçiş etkili olmuyor: eski bir kabuk değişkeni veya önbelleğe alınmış oturum buna neden olabilir; yeni bir terminal açın ya da Claude Code’u yeniden başlatın.
• Kartın bağlantı testi başarılı, ancak istekler başarısız: test, anahtarı veya modeli değil, erişilebilirliği kontrol eder; uçtan uca claude -p komutunu çalıştırın.
• Resmî sağlayıcıya geri dönmek istiyorsunuz: Claude Official’a geçin, Claude Code’u yeniden başlatın ve tekrar oturum açın.

macOS'ta claude komutu bulunamıyorsa, resmî yükleyici genellikle komutu ~/.local/bin/claude dizinine yerleştirir. Kabuk profilinize export PATH="$HOME/.local/bin:$PATH" ekleyip yeni bir terminal açın.

Kontrol listesi

• [ ] CC Switch’i ccswitch.io veya GitHub Releases üzerinden yükleyin.
• [ ] AIHubMix konsolunda bir API anahtarı oluşturun.
• [ ] Claude Code → + → AiHubMix → anahtarı yapıştırın → Add.
• [ ] Sağlayıcı JSON’una ANTHROPIC_MODEL=claude-sonnet-5-5 ekleyin.
• [ ] Switch düğmesine tıklayın ve kartta In use yazdığını doğrulayın.
• [ ] Kabuk profilinizdeki eski ANTHROPIC_* dışa aktarımlarını kaldırın.
• [ ] claude -p "1+1, output only the answer" --model claude-sonnet-5-5 komutunu çalıştırın ve 2 sonucunu kontrol edin.

Son komut 2 döndürüyorsa sağlayıcı geçişi tamamlanmıştır. Geriye istediğiniz model takma adlarını eklemek ve yönlendirme ya da toplama moduna ihtiyacınız olup olmadığına karar vermek kalır; çoğu AIHubMix kullanıcısı için doğrudan mod yeterlidir.

Sık sorulan sorular

CC Switch ücretsiz mi?
Evet. MIT lisanslı açık kaynaklı bir yazılımdır. Yalnızca API'sini kullandığınız sağlayıcıya ödeme yaparsınız.

Geçiş yapmak hook'larımı, MCP sunucularımı veya eklentilerimi siler mi?
Hayır. Doğrudan geçiş, uç noktayı, anahtarı, modeli ve sağlayıcıya özgü birkaç seçeneği değiştirir. Hook'lar, izinler, MCP sunucuları, eklentiler ve durum çubuğu ayarları dosyada kalır.

CC Switch API anahtarımı yükler mi?
Sağlayıcı yapılandırmaları yerel olarak ~/.cc-switch/cc-switch.db dosyasında saklanır. WebDAV veya S3 eşitlemesini etkinleştirirseniz yapılandırmalar, denetiminizdeki depolama alanıyla eşitlenir. Veritabanları ve yedekler anahtarları içerir; bunları gizli bilgi olarak değerlendirin.

CC Switch’i çalışır durumda tutmam gerekir mi?
Doğrudan modda gerekmez. Yönlendirme ve toplama modlarının çalışması için uygulamanın açık olması gerekir; CC Switch’ten çıkmak istemciyi doğrudan moda döndürür.

Claude Official ve AIHubMix’i aynı anda kullanabilir miyim?
Doğrudan modda aynı anda yalnızca bir sağlayıcı etkin olabilir. Toplama modu, birden fazla sağlayıcının modelini tek listede gösterebilir; ancak Claude’un resmî aboneliği bu modda desteklenmez. Bu aboneliği kullanmak için doğrudan moda dönün.

Windows'ta çalışıyor mu?
Evet. CC Switch, .msi yükleyicisi veya taşınabilir sürümüyle Windows 10 ve sonraki sürümleri destekler. Linux için glibc 2.35+ ve WebKitGTK 4.1 gerekir.

Sağlayıcı kartında bağlantı sağlıklı görünmesine rağmen Claude Code neden çalışmıyor?
Karttaki bağlantı testi, uç noktaya erişilip erişilemediğini kontrol eder. API anahtarını veya modeli doğrulamaz. Tam bağlantı yolunu test etmek için uçtan uca claude -p komutunu kullanın.

Kaynaklar

• CC Switch deposu
• CC Switch kullanım kılavuzu: Sağlayıcı ekleme
• CC Switch kullanım kılavuzu: Sağlayıcı değiştirme
• CC Switch kullanım kılavuzu: Yapılandırma dosyaları
• AIHubMix belgeleri: Claude Code