# Claude Code kurulumu

Claude Code'u 4AICode üzerinden kullanarak API anahtarlarını, ekip kotalarını ve token harcamalarını tek panelde yönetin. Bu kılavuz macOS, Linux ve Windows için bağlantı ayarlarını açıklar.

## Hazırlık

[Token yönetiminden](/tokens) bir API anahtarı oluşturun. Aşağıdaki `sk-4ai-YOUR_TOKEN` örnek değerini kendi anahtarınızla değiştirin. Anahtarı paylaşmayın veya Git'e eklemeyin.

## macOS ve Linux

Claude Code'u resmi kurulum komutuyla yükleyin:

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

`~/.claude/settings.json` dosyasında `env` bölümünü oluşturun. Dosyada mevcut ayarlar varsa koruyarak birleştirin:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.4aicode.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-4ai-YOUR_TOKEN",
    "ANTHROPIC_API_KEY": "sk-4ai-YOUR_TOKEN"
  }
}
```

Yeni terminal penceresinde proje klasörünüze geçip `claude` komutunu çalıştırın.

## Windows

PowerShell'de etkileşimli kurulum betiğini çalıştırın. Betik gerekli araçları denetler ve token'ınızı sorar:

```powershell
irm https://4aicode.com/claude-install.ps1 | iex
```

Mevcut kurulum için `%USERPROFILE%\.claude\settings.json` dosyasına yukarıdaki `env` ayarlarını ekleyebilirsiniz. Yeni PowerShell penceresinde `claude --version`, ardından `claude` çalıştırın.

## Bağlantıyı doğrulayın

Claude Code'da kısa bir mesaj gönderin. [Kullanım kayıtlarında](/usage) isteği ve modeli doğrulayın. Resmi hesapla daha önce giriş yaptıysanız bağlantı ayarlarınızı kontrol edin; 4AICode token'ının seçili olduğundan emin olun.

Türkiye için `.com` hattını kullanın. Çin ana karasındaki bir makinede çalıştırıyorsanız temel adresi `https://relay.4aicode.net` olarak değiştirebilirsiniz. Claude Code temel adresine `/v1` eklemeyin.

## Sorun giderme

- Kimlik doğrulama hatası: token'ı ve `ANTHROPIC_AUTH_TOKEN` değerini kontrol edin.
- Kota veya bakiye hatası: [kullanım ve bakiye bilgilerini](/usage) kontrol edin.
- 429: [hız sınırı adımlarını](/docs/tr/guides/rate-limit) uygulayın.
- IDE eklentisi: [VS Code / Cursor kılavuzunu](/docs/tr/guides/vscode) izleyin.

Model adları ve fiyatları zamanla değişebilir; hesap panelindeki güncel bilgileri kullanın. Destek için hata zamanı, model ve varsa `trace_id` paylaşın; token'ınızı gizli tutun.