# Claude Code API Anahtarı Kurulumu

Claude Code istekleri herhangi bir yere yönlendirmek için iki ortam değişkeni okur: ANTHROPIC_BASE_URL ve ANTHROPIC_API_KEY. Bunları RunAPI'ye yönlendirin ve her Claude modelini resmi tarifenin yarı fiyatına çalıştırın. Bu kılavuz Mac, Linux ve Windows için tam komutları gösterir.

*Updated June 18, 2026 · RunAPI Editöryal*

## Claude Code'da özel bir API anahtarı nasıl ayarlanır?

Claude Code, isteklerin nereye gideceğine ve nasıl kimlik doğrulayacağına karar vermek için iki ortam değişkeni kullanır. ANTHROPIC_BASE_URL ve ANTHROPIC_API_KEY değerlerini RunAPI değerleri olarak ayarlayın; her istek RunAPI üzerinden 50% indirimli yönlendirilir. Tamamen farklı bir sağlayıcı mı kullanmak istiyorsunuz? RunAPI ayrıca doğrudan Anthropic hesabı olmadan Claude modellerini çalıştırabilmeniz için tak-çalıştır bir ağ geçidi olarak da çalışır.

- **İki değişken**: ANTHROPIC_BASE_URL uç noktayı ayarlar. ANTHROPIC_API_KEY anahtarı ayarlar. Tüm yapılandırma bu kadar — iki değişken, başka değişiklik yok.
- **Uç nokta değeri**: Claude Code'un RunAPI üzerinden yönlenmesi için ANTHROPIC_BASE_URL'yi https://runapi.ai olarak ayarlayın.
- **Kalıcı hale getirin**: Her oturumda yeniden ayarlamamak için her iki export satırını kabuk profilinize (.zshrc veya .bashrc) ekleyin. Windows kullanıcıları bunları PowerShell içinde ayarlar ve yeni bir pencere açar.
- **%50 indirim**: Her Claude modeli resmi Anthropic ücretinin yarısında faturalandırılır. Abonelik yok, sınır yok.

## Claude Code'u yapılandırmadan önce neye ihtiyacınız var?

Kurulum birkaç dakika sürer. Claude Code kurulu olmalı, bir RunAPI hesabınız ve bir terminaliniz olmalıdır. Herhangi bir API anahtarı yapılandırmasına dokunmadan önce Claude Code'un çalıştığını doğrulamak için claude --version çalıştırın.

### Claude Code yüklü

Claude Code'u resmi kaynaktan kurun ve terminalinizde claude --version ile çalıştığını doğrulayın. Bu komut hata verirse, herhangi bir API anahtarı ayarlamadan önce kurulumu düzeltin.

### Bir RunAPI hesabı

runapi.ai adresinde kaydolun. Ücretsiz katman, bir bakiye finanse etmeden önce herhangi bir Claude modelini test etmek için kredi içerir.

### Bir API anahtarı

Dashboard → API Keys bölümünden bir anahtar oluşturun. Bir kez kopyalayın — tam hali yalnızca oluşturma sırasında gösterilir. Bunu herkese açık repolara yapıştırmayın veya ekran görüntülerinde paylaşmayın.

### Terminal erişimi

Ortam değişkenlerini ayarlamak için bir kabuğa ihtiyacınız var. macOS ve Linux .zshrc veya .bashrc kullanır. Windows kullanıcıları PowerShell kullanabilir — değişkeni ayarlayın, ardından etkili olması için yeni bir terminal penceresi açın.


## RunAPI ile Claude Code API anahtarı nasıl kurulur

Bu komutları sırayla çalıştırın. Uç noktayı ve anahtarı ayarlar, bunları kabuk profilinize kalıcı olarak yazar ve Claude Code'un bunları algıladığını doğrular. Yer tutucuyu gerçek RunAPI anahtarınızla değiştirin. ANTHROPIC_API_KEY kullanın (CLAUDE_API_KEY değil) — Claude Code'un gerçekten okuduğu değişken budur.

## Claude Code hangi ortam değişkenlerini okur?

Claude Code; uç noktayı, kimlik doğrulamayı, modeli ve çıktı uzunluğunu kontrol etmek için küçük bir değişken seti okur. Tablo, özel uç nokta kurulumu için önemli olanları ve her birinin ne yaptığını listeler. Not: ANTHROPIC_API_KEY kullanın (CLAUDE_API_KEY değil) — Claude Code'un gerçekten okuduğu değişken budur.

| Değişken | Amaç | Örnek değer |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Code'un istekleri gönderdiği özel uç nokta | https://runapi.ai |
| ANTHROPIC_API_KEY | İsteklerin kimliğini doğrulamak için kullanılan anahtar | sk-your-runapi-key |
| ANTHROPIC_MODEL | Yeni oturumlar için varsayılan model | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Yanıt başına döndürülen token sayısı sınırı | 8192 |

## Claude Code'da hangi Claude modelini çalıştırmalısınız?

Claude Code, RunAPI üzerinden herhangi bir Claude model ID'sini kabul eder. Göreve göre seçin: rutin düzenlemeler için hızlı ve ucuz bir model, günlük kodlama için dengeli bir model veya zor problemler için en güçlü model. Varsayılanı değiştirmek için ANTHROPIC_MODEL ayarlayın veya Claude Code içinde model değiştirin — faturalandırma gerçekten çağırdığınız modeli takip eder.

### claude-haiku-4-5

RunAPI üzerinden giriş için $1/M ve çıkış için $5/M ile en hızlı ve en ucuz. Rutin düzenlemeler ve hızlı sorgular için en iyisi.

### claude-sonnet-4-6

RunAPI üzerinden giriş için $3/M ve çıkış için $15/M ile günlük kodlama için dengeli varsayılan. Çoğu geliştirici bunu kullanır.

### claude-opus-4-7

RunAPI üzerinden giriş için $5/M ve çıkış için $25/M ile zorlu problemler için en güçlü. Karmaşık yeniden yapılandırmalar ve incelemeler için kullanın.

### İstediğiniz zaman değiştirin

ANTHROPIC_MODEL ayarlayın veya Claude Code içinde modeli istediğiniz zaman değiştirin. Faturalandırma gerçekten çağırdığınız modeli takip eder ve hepsi 50% indirimlidir.


## Claude Code API anahtarım neden çalışmıyor?

Çoğu kurulum sorunu üç şeyden birinden kaynaklanır: yanlış env var adı (CLAUDE_API_KEY değil, ANTHROPIC_API_KEY kullanın), profil değişikliklerinizi henüz almamış eski bir kabuk oturumu veya anahtarda yazım hatası. Tablo yaygın hataları ve her biri için düzeltmeyi listeler.

| Hata veya belirti | Olası neden | Düzeltme |
|---|---|---|
| 401 Yetkisiz | Yanlış veya süresi dolmuş API anahtarı | ANTHROPIC_API_KEY'i tekrar kontrol edin ve gerekirse RunAPI kontrol panelinde yeni bir anahtar oluşturun |
| İstekler hâlâ Anthropic'e gidiyor | Bu kabukta ANTHROPIC_BASE_URL ayarlanmamış | echo $ANTHROPIC_BASE_URL komutunu çalıştırın; boşsa, profilinizi yeniden yükleyin veya yeni bir terminal açın |
| 404 Bulunamadı | Temel URL'de sondaki eğik çizgi veya yanlış yol | Temel URL'yi sondaki yol olmaksızın tam olarak https://runapi.ai olarak ayarlayın |
| Model bulunamadı | Geçersiz veya yanlış yazılmış model ID'si | claude-sonnet-4-6 veya claude-opus-4-7 gibi geçerli bir ID kullanın |
| Yeniden başlatmada değişkenler kayboldu | Dışa aktarımlar kabuk profiline yazılmamış | Her iki dışa aktarımı da ~/.zshrc veya ~/.bashrc dosyasına ekleyin ve yeniden yükleyin |

## RunAPI ile Claude Code API anahtarı nasıl kurulur

1. **Temel URL'yi ayarlayın** — İstekleri RunAPI üzerinden yönlendirmek için ANTHROPIC_BASE_URL=https://runapi.ai'yi dışa aktarın.
2. **API anahtarını ayarlayın** — ANTHROPIC_API_KEY'i Kontrol Paneli → API Anahtarları'ndan aldığınız RunAPI anahtarınızla dışa aktarın.
3. **Her iki değişkeni de kalıcı hale getirin** — Her iki export satırını ~/.zshrc veya ~/.bashrc dosyasına ekleyin ve yeni oturumlarda kalıcı olmaları için source ~/.zshrc ile yeniden yükleyin. Windows'ta bunları PowerShell içinde ayarlayın ve yeni bir terminal penceresi açın.
4. **Claude Code'u çalıştırın** — Kurulumu doğrulamak için claude --version çalıştırın, ardından projenizde claude başlatın. İstekler artık resmi tarifeden 50% indirimli olarak RunAPI üzerinden yönlendirilir.

## Claude Code API Anahtarı SSS

### Claude Code'a API anahtarı nasıl eklenir?

İki ortam değişkeni ayarlayın. ANTHROPIC_BASE_URL değişkenini https://runapi.ai olarak, ANTHROPIC_API_KEY değişkenini ise RunAPI anahtarınız olarak dışa aktarın. Oturumlar arasında kalıcı olmaları için ikisini de kabuk profilinize (.zshrc veya .bashrc) ekleyin. Claude Code başlangıçta bunları okur ve her isteği RunAPI üzerinden yönlendirir.

### Claude Code API anahtarını nereden alabilirim?

runapi.ai adresinde bir tane oluşturun. Kaydolun, Dashboard → API Keys bölümünü açın ve bir anahtar oluşturun. Hemen kopyalayın — tam anahtar yalnızca oluşturma sırasında gösterilir. Ücretsiz katman, bakiye yüklemeden önce herhangi bir Claude modelini test etmeniz için kredi içerir.

### ANTHROPIC_BASE_URL ne içindir?

Claude Code'a istekleri hangi uç noktaya göndereceğini söyler. Varsayılan olarak Claude Code, Anthropic'e doğrudan bağlanır. Bunu https://runapi.ai olarak ayarlamak, her isteği RunAPI üzerinden yönlendirir; RunAPI ise aynı modelleri resmi ücretin %50'sinde faturalandırır.

### Claude Code'u OpenAI gibi diğer API sağlayıcılarıyla kullanabilir miyim?

Claude Code'u OpenAI gibi diğer API sağlayıcılarıyla kullanmanın bir yolu var mı? Evet — Claude Code, ANTHROPIC_BASE_URL üzerinden OpenAI uyumlu herhangi bir uç noktayı destekler. RunAPI uyumlu bir ağ geçidi sunar; böylece kodunuzu değiştirmeden sağlayıcıları değiştirebilir, Claude, GPT ve diğer modeller genelinde tek bir anahtar kullanabilirsiniz.

### Claude Code neden hâlâ tam tarifeden faturalandırıyor?

Terminalinizde echo $ANTHROPIC_BASE_URL çalıştırın. Hiçbir şey yazdırmıyorsa, dışa aktarma kalıcı olmamıştır. Her iki export satırını ~/.zshrc veya ~/.bashrc dosyasına ekleyin, source ~/.zshrc çalıştırın, ardından yeni bir terminal açıp tekrar kontrol edin. Windows kullanıcılarının env var ayarladıktan sonra yeni bir PowerShell penceresi açması gerekir.

### Anahtarı bunun yerine bir yapılandırma dosyasında saklayabilir miyim?

Evet. Değerleri her oturumda dışa aktarmak yerine ana dizininizde veya proje dizininizde bir .claude.json dosyasına yerleştirin. Her iki yaklaşım da çalışır — dosya proje başına anahtarlar için kullanışlıdır, export kullanımı ise tek bir global kurulum için daha basittir.

### Kurulumdan sonra maliyeti nasıl izlerim?

RunAPI panosunu açın. Anahtar başına ve istek başına harcamayı gerçek zamanlı gösterir. Çıktı maliyetini sınırlamak için CLAUDE_CODE_MAX_OUTPUT_TOKENS ayarlayarak her yanıtı sınırlandırın ve rutin düzenlemeler için claude-haiku-4-5 kullanın.

### Bu, Claude Code'un davranışını değiştirir mi?

Hayır. RunAPI istekleri doğrudan alttaki Claude modellerine proxy'ler. Çıktı, araç kullanımı ve davranış Anthropic'i doğrudan çağırmakla aynıdır. Yalnızca isteklerin nereye gittiğini ve nasıl faturalandırıldığını değiştirirsiniz — kodlama deneyimi aynı kalır.