Claude Code

Bu kılavuz yalnızca Claude modellerini kullanır. Claude Code, Claude modellerini (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) ve istemci kısıtlaması olmayan modelleri (GLM, Qwen, Kimi, MiniMax, DeepSeek) çalıştırabilir. GPT modelleri Claude Code’da kullanılamaz — bkz. Codex.

1. Claude Code’u Kurun

Yerel Kurulum

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

npm ile Kurulum

Node.js 18 veya üzeri gerektirir

npm install -g @anthropic-ai/claude-code

2. Harogo API’sini Yapılandırın

Harogo’nun model hizmetine Anthropic uyumlu API üzerinden bağlanmak için aşağıdaki ortam değişkenlerini ayarlayın.

ANTHROPIC_BASE_URL değerini https://api.harogo.ai/ olarak ayarlayın
ANTHROPIC_AUTH_TOKEN değerini Harogo platformundan aldığınız API anahtarı olarak ayarlayın
ANTHROPIC_MODEL değerini Harogo’nun desteklediği bir Claude modeli olarak ayarlayın, örneğin claude-sonnet-5.

macOS
Windows

Varsayılan kabuğunuzu kontrol etmek için terminalde aşağıdaki komutu çalıştırın.

echo $SHELL

Ortam değişkenlerini kabuk türünüze göre ayarlayın:

# <HAROGO_API_KEY> değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc

# <HAROGO_API_KEY> değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile

Ortam değişkenlerini uygulamak için terminalde aşağıdaki komutu çalıştırın.

source ~/.zshrc

source ~/.bash_profile

Yeni bir terminal açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın.

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

Windows’ta Harogo’nun Taban URL’sini ve API anahtarını CMD veya PowerShell kullanarak ortam değişkeni olarak ayarlayabilirsiniz.

CMD
PowerShell

Ortam değişkenlerini ayarlamak için CMD’de aşağıdaki komutu çalıştırın.

REM <HAROGO_API_KEY> değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

Yeni bir CMD penceresi açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın.

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Ortam değişkenlerini ayarlamak için PowerShell’de aşağıdaki komutu çalıştırın.

# <HAROGO_API_KEY> değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)

Yeni bir PowerShell penceresi açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın.

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

Claude Code’u CC Switch üzerinden yönetecekseniz, ayrıca genel ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL veya ANTHROPIC_MODEL değerleri ayarlamamanızı öneririz. Sistem veya kullanıcı düzeyindeki ortam değişkenleri, CC Switch’in yazdığı sağlayıcı yapılandırmasını geçersiz kılabilir. Bu durumda arayüzde doğru sağlayıcı seçili görünse de Claude Code aslında hâlâ eski bir anahtar veya modelle çalışır.

3. Yapılandırmayı Doğrulayın

Ortam değişkenlerini veya CC Switch’i ayarladıktan sonra, uzun bir oturuma başlamadan önce anahtarın, modelin ve Anthropic uyumlu uç noktanın çalıştığını doğrulamak için önce tek bir minimal istek gönderin.

curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

4. Claude Code’u Kullanmaya Başlayın

Yapılandırma tamamlandıktan sonra çalışma dizininize gidin ve başlamak için terminalde claude komutunu çalıştırın.

$ cd /path/your-project
> claude

Başlangıçta Not logged in · Please run /login mesajını görüyorsanız veya Anthropic giriş akışına yönlendiriliyorsanız, bu genellikle Claude Code’un çalışan bir Harogo yapılandırmasını algılamadığı ya da ilk kullanım kurulumunun tamamlanmadığı anlamına gelir. Önce bir önceki adımdaki minimal isteğin 2 döndürdüğünü doğrulayın ve ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL veya ANTHROPIC_MODEL değerlerinin eski genel ortam değişkenleri tarafından geçersiz kılınıp kılınmadığını kontrol edin. Anahtarın çalıştığından emin olduktan sonra hâlâ giriş akışına yönlendiriliyorsanız, aşağıdaki adımlarla ilk kullanım kurulumunu atlayabilirsiniz:

Claude Code ilk açılışında giriş yapma veya devam etme istemini gösteren terminal

Ana dizininizdeki .claude.json dosyasını bulun:
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
hasCompletedOnboarding alanını true olarak ayarlayın

{
  "hasCompletedOnboarding": true
}

Dosyayı kaydedin, ardından terminalde claude komutunu yeniden çalıştırın.

(İsteğe Bağlı) Modeli Yapılandırmanın Diğer Yolları

Claude Code, modeli yapılandırmak için aşağıdaki yolları destekler; bunlar en yüksek öncelikten en düşüğe doğru sıralanmıştır — yüksek öncelikli bir ayar, düşük öncelikli olanı geçersiz kılar.

Sohbet sırasında: modeli değiştirmek için /model <model-name> komutunu çalıştırın. Tek seferlik geçişler için uygundur.

/model claude-sonnet-5

Claude Code’u başlatırken: bir model belirtmek için claude --model <model-name> komutunu çalıştırın. Tek bir oturum için uygundur.

claude --model claude-sonnet-5

Ortam değişkenlerini ayarlayın: görev karmaşıklığına göre farklı seviyelerde modeller yapılandırın; Claude Code göreve uygun modeli otomatik olarak seçer. Genel olarak uygulanır.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

Burada:

ANTHROPIC_DEFAULT_OPUS_MODEL: karmaşık muhakeme, mimari tasarım ve diğer yüksek zorluktaki görevler için.
ANTHROPIC_DEFAULT_SONNET_MODEL: kod yazma, özellik geliştirme ve diğer günlük görevler için.
ANTHROPIC_DEFAULT_HAIKU_MODEL: sözdizimi kontrolü, dosya arama ve diğer basit görevler için.

settings.json içinde kalıcı olarak ayarlayın: model yapılandırmasını Claude Code’un kullanıcı yapılandırma dosyasına (ör. ~/.claude/settings.json veya Windows’ta C:\Users\%USERNAME%\.claude\settings.json) ya da proje düzeyindeki bir yapılandırmaya yazarak kalıcı bir kullanıcı veya proje düzeyi ayar oluşturun.

CC Switch ile Yapılandırma

CC Switch’i açın, soldan Claude Code’u seçin ve ardından “Sağlayıcı Ekle” (Add Provider) seçeneğine tıklayın.

CC Switch ana ekranındaki Sağlayıcı Ekle girişi

Hazır ayarlar listesinden sağlayıcı olarak “Özel Yapılandırma” (Custom Configuration) seçeneğini seçin.

CC Switch sağlayıcı ön ayar listesinde Custom Configuration seçimi

Sağlayıcı adı, API anahtarı ve uç nokta (https://api.harogo.ai) gibi bilgileri doldurun. Tüm alanları doldurduktan sonra “Ekle” (Add) seçeneğine tıklayın.

CC Switch sağlayıcı yapılandırma formuna API anahtarının girilmesi

Ana ekrana döndüğünüzde sağlayıcı listesinden “harogo”yu seçin ve “Kullan” (Use) seçeneğine tıklayın.

CC Switch ana ekranında harogo seçilip Use düğmesine tıklanması

İpucu: Claude Code terminalde açıldıktan sonra model kimliğini kontrol etmek için /status, yapılandırılmış başka bir model seçmek için /models yazın.

CC Switch “Sistem ortam değişkeni çakışması algılandı” (System environment variable conflict detected) uyarısı gösterirse, önce ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL ve ANTHROPIC_MODEL değişkenleriyle ilgilenin. Bu genel değişkenler mevcut sağlayıcı yapılandırmasını geçersiz kılar — ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY> gibi bir yer tutucu değer kimlik doğrulamanın doğrudan başarısız olmasına neden olur. Genel değişkenlere artık ihtiyacınız olmadığından emin olduğunuzda, çakışan girdileri CC Switch’te kaldırın veya sistem/kullanıcı ortam değişkenlerini elle silip terminalinizi yeniden başlatın.

Başlarken

Hızlı başlangıç

Fiyatlandırma

1. Claude Code’u Kurun

Yerel Kurulum

npm ile Kurulum

2. Harogo API’sini Yapılandırın

3. Yapılandırmayı Doğrulayın

4. Claude Code’u Kullanmaya Başlayın

(İsteğe Bağlı) Modeli Yapılandırmanın Diğer Yolları

CC Switch ile Yapılandırma

​1. Claude Code’u Kurun

​Yerel Kurulum

​npm ile Kurulum

​2. Harogo API’sini Yapılandırın

​3. Yapılandırmayı Doğrulayın

​4. Claude Code’u Kullanmaya Başlayın

​(İsteğe Bağlı) Modeli Yapılandırmanın Diğer Yolları

​CC Switch ile Yapılandırma

1. Claude Code’u Kurun

Yerel Kurulum

npm ile Kurulum

2. Harogo API’sini Yapılandırın

3. Yapılandırmayı Doğrulayın

4. Claude Code’u Kullanmaya Başlayın

(İsteğe Bağlı) Modeli Yapılandırmanın Diğer Yolları

CC Switch ile Yapılandırma