Claude Code API anahtarı — nereden alınır, nereye konur ve yanlış değişken neden sessizce başarısız olur

Claude Code iki farklı şekilde kimlik doğrulayabilir ve hangisine ihtiyacınız olduğu diğer her şeyi belirler. Bir claude.ai abonelik girişi, Pro veya Max planınız kapsamındaki kullanımı karşılar. Bir API anahtarı, plan sınırı olmadan token başına ücretlendirilir. Bu rehber anahtarın nereden alınacağını, tam olarak nereye konulacağını, iki kimlik bilgisi değişkenini ve yanlış olanı seçmenin neden sessiz bir hataya yol açtığını, ayrıca çalışmaya başladıktan sonra faturayı nasıl kontrol altında tutacağınızı açıklar.

Hiç anahtara ihtiyacınız var mı?

Başlamadan önce bilinmesi gereken: bir anahtar ayarlamak aboneliğinizi devre dışı bırakır. Bir kimlik bilgisi değişkeni etkinken Claude Code, kaydedilmiş claude.ai giriş bilgisi yerine bunu kullanır; planın limitleri uygulanmaz ve kullanım, anahtarın sahibine faturalandırılır. Değişkeni kaldırdığınızda Claude Code aboneliğe geri döner.

Seçenek 1 — birinci taraf Anthropic anahtarı

1. console.anthropic.com adresinde oturum açın (claude.ai hesabınızdan ayrı bir hesaptır).
2. Billing bölümünden kredi ekleyin. API ön ödemelidir ve aboneliklerden ayrıdır — Pro planı API'yi finanse etmez.
3. API Keys bölümünden bir anahtar oluşturun. Anahtar sk-ant- ile başlar ve yalnızca bir kez gösterilir.

export ANTHROPIC_API_KEY=sk-ant-...
# Then approve it once, interactively:
#   /config  ->  Use custom API key
claude

Bu kod parçacığındaki ikinci adımı unutmayın. ANTHROPIC_API_KEY, x-api-key üstbilgisinde gönderilir ve Claude Code'un bunu kullanabilmesi için tek seferlik etkileşimli onay gerekir. Bu istem daha önce reddedildiyse anahtar bundan sonra hiç istem gösterilmeden yok sayılır — bu da değişken okunmuyormuş gibi görünür. /config → Use custom API key bölümünden yeniden etkinleştirin.

Seçenek 2 — token başına daha düşük maliyetli anahtar

Claude Code, ANTHROPIC_BASE_URL değişkenini doğrudan okur; bu nedenle Anthropic Messages API'sini sunan tüm uç noktalarla çalışır — eklenti, proxy veya değiştirilmiş ikili dosya gerekmez. Ağ geçitleri için desteklenen yol budur ve aynı Claude modellerini daha düşük ücretle böyle çalıştırabilirsiniz:

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

ANTHROPIC_BASE_URL yalnızca kaynak adresidir — Claude Code /v1/messages yolunu kendisi ekler. Model satırlarını koruyun: Claude Code'un yerleşik varsayılanı ve opus takma adı en yeni Opus'a çözümlenir; Kunavo bu modeli henüz sunmuyorsa ilk istek 404 döndürür. opus satırı bunu Claude Opus 5.5'e sabitler; bu, Claude Code v2.1.280 veya sonraki sürümünü gerektirir (eski bir sürümde claude update komutunu çalıştırın). sonnet takma adı, Kunavo'nun sunmadığı Sonnet 5.5'i ister; bu nedenle ANTHROPIC_DEFAULT_SONNET_MODEL olmadan /model sonnet, opusplan yürütme aşaması ve sonnet olarak ayarlanmış alt aracılar 404 döndürür. sk-kn- anahtarını, kaydolup 10 $ yükledikten sonra panoda oluşturun. Aylık ücret yoktur ve bakiyenin süresi dolmaz.

Bu, ana modeldeki liste fiyatından yaklaşık %30 daha düşüktür. Tam ücretler Claude API fiyatlandırma kılavuzunda yer alır; Claude Code fiyatlandırması bu yolu Pro ve Max plan ücretleriyle karşılaştırır. Görev başına model yönlendirmesi ve ağ geçidinin arkasında nelerin değiştiği dahil olmak üzere tüm kurulum Claude Code yönlendirici kılavuzunda bulunur. CLI henüz yüklü değilse Claude Code'u yükleyerek başlayın.

Anahtar gerçekte nereye gider?

İki değişken, iki farklı HTTP üstbilgisi. Sunucunun okumadığı üstbilgideki anahtar 401 hatasıyla başarısız olur:

Hangi türe sahip olduğunuz söylenmediyse, onay adımı gerektirmeyen ANTHROPIC_AUTH_TOKEN ile başlayın. Kunavo'da her iki değişken de Claude Code'un model listesini keşfetmesini sağlar; çünkü /v1/models, anahtarı her iki üstbilgiden de okur.

Shell dışa aktarması ve ayar dosyası

Shell dışa aktarması yalnızca o terminal ve alt süreçleri için geçerlidir. Dock'tan başlatılan bir editör bunu göremez; arka plan aracıları da göremez. Kalıcı bir ayar için bunun yerine env içindeki ~/.claude/settings.json bloğunu kullanın — aynı anahtarlar Claude Code'un çalıştığı her yerde geçerli olur. Anahtarı bir projenin .claude/settings.json dosyasına koymayın; bu dosya commit edilir ve depoyu klonlayan herkesle paylaşılır.

Hangi kimlik bilgisinin etkin olduğunu doğrulamak için /status çalıştırın. Değişkeninizi adlandıran bir Auth token veya API key satırı anahtarın etkin olduğu anlamına gelir; bir claude.ai hesabını adlandıran Login method satırı ise etkin olmadığını gösterir.

Dosyaları düzenlemeden anahtarları döndürme

Kimlik bilgisi belirli aralıklarla sona eriyorsa veya bir kasadan geliyorsa, apiKeyHelper değişkenini güncel anahtarı yazdıran bir komuta yönlendirin:

#!/bin/bash
# Any command that prints the current key to stdout works.
vault kv get -field=api_key secret/claude-code

Ayar dosyanızda "apiKeyHelper": "~/bin/get-key.sh" olarak referans verin. Claude Code çıktıyı beş dakika boyunca önbelleğe alır ve 401 durumunda komutu yeniden çalıştırır; CLAUDE_CODE_API_KEY_HELPER_TTL_MS ile ayarlayabilirsiniz. Değer her iki üstbilgide de gönderilir, dolayısıyla her iki şekilde de çalışır.

Faturayı öngörülebilir tutma

Ajan destekli kodlama token tüketir — her adımda sistem istemi, görev geçmişi ve yeni dosya bağlamı yeniden gönderilir. Diğer her şeyden daha önemli dört nokta:

1. Haiku satırını koruyun. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 ayarı olmadan Claude Code'un haiku takma adı Kunavo'nun sunmadığı bir model kimliği ister (v2.1.293'ten itibaren Haiku 5.5); bu nedenle /model haiku ve haiku olarak ayarlanmış alt ajanlar 404 hatası verir. Aynı satır, Claude Code'un kendi başına oluşturduğu özetleri ve başlıkları ana modelinizden alır. İşler birden fazla alt göreve ayrıldıkça bu tasarruf artar; fiyatlar Claude Code iş akışının maliyetinde verilmiştir.
2. Aynı iki değişken Agent SDK'yı da yönlendirir. SDK'nın kendine ait bir temel URL seçeneği yoktur — bu CLI'yi başlatır ve ortamınızı doğrudan aktarır; bu nedenle bir Agent SDK programı tam olarak yukarıdaki yapılandırmayla yönlendirilir.
3. Bir görevi sonsuza kadar uzatmak yerine yeni görevler başlatın. Bağlam her adımda yeniden gönderildiği için uzun bir oturum karesel olarak pahalıdır. Ana modele hangi katmanın atanacağı Opus ve Sonnet ve Haiku karşılaştırmasında, token başına maliyet yerine tamamlanan görev başına maliyet olarak ele alınır.
4. İstem önbelleklemesinin çalışmasına izin verin. Önbelleğe alınmış girdi, girdi ücretinin %10'u üzerinden faturalandırılır ve Anthropic'in kendi Messages API yolu cache_control değerini çevirmeden iletir (ayrıntılar).
5. Editöre harcama limiti olan kendi anahtarını verin; bunu kontrol panelinde ayarlayın, ardından bir hafta sonra kullanımı kontrol edin. Anahtar başına limitler, kontrolden çıkan bir döngüyü sınırlı bir döngüye dönüştürür.

Sorun giderme

Sık sorulan sorular