Claude Code ile Kullanım

Claude Code'u Onysoft anahtarınız ve TL bakiyenizle çalıştırın

Claude Code, Onysoft anahtarınızla doğrudan çalışır: üç ortam değişkeni yeterlidir. İstekler Anthropic Messages API ucundan geçer ve Chat Completions ile aynı bakiyeden, aynı fiyatla ücretlendirilir.

Ortam Değişkenleri

Değişken	Değer
`ANTHROPIC_BASE_URL`	`https://api.onysoft.com` (sonuna `/v1` eklemeyin)
`ANTHROPIC_AUTH_TOKEN`	Onysoft API anahtarınız (`sk-ony-...`)
`ANTHROPIC_MODEL`	Örneğin `anthropic/claude-sonnet-5`. `claude-sonnet-5-5` ya da `anthropic/claude-sonnet-5.5` gibi yazımlar da kabul edilir.

İsteğe bağlı değişkenler:

ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-5.5: Claude Code'un arka plan işleri ve /model haiku için kullanacağı modeli, anahtarınızın izinli olduğu bir modele sabitler.
CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000: Claude Code her istekte 64.000–128.000 çıktı tokenı ister. Bakiye ön kontrolü bu üst sınıra göre yapılır, bu yüzden bakiyeniz azsa istekler "Yetersiz bakiye" (402) ile reddedilebilir. Bu değişken üst sınırı düşürür. Ücret her zaman gerçek kullanım üzerinden kesilir.
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1: Claude Code'un yeni sürümlerinde /model seçicisi, anahtarınızın kullanabildiği Claude modellerini listeler.

security

Anahtar güvenliği: Anahtarı komut satırına, Read-Host istem metnine, betiklere ya da ekran görüntülerine yazmayın. Aşağıdaki yöntemlerde anahtar gizli girilir, ekranda görünmez ve komut geçmişine yazılmaz. Anahtarınız bir yerde açıkta göründüyse panelden yeni anahtar alın ya da bize yazın; eski anahtarı kapatırız.

Windows (PowerShell)

                PowerShell
                
            

$env:ANTHROPIC_BASE_URL = "https://api.onysoft.com"
$env:ANTHROPIC_MODEL = "anthropic/claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "anthropic/claude-haiku-5.5"
# isteğe bağlı: bakiye ön kontrolü için çıktı üst sınırı
# $env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "16000"

# Anahtarı gizli girin: istem metni sabit kalır, anahtarı yalnızca yapıştırırsınız (ekranda * görünür).
$secret = Read-Host "Onysoft API anahtarini yapistir" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secret).Password
Remove-Variable secret

# Bağlantı testi
claude -p "Sadece BAGLANTI_BASARILI yaz."

# Normal kullanım (proje klasörünüzde)
claude
            

Oturumu kapatırken değişkenleri temizleyin:

PowerShell

Remove-Item Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_MODEL, Env:ANTHROPIC_DEFAULT_HAIKU_MODEL -ErrorAction SilentlyContinue

macOS / Linux (zsh ya da bash)

                zsh / bash
                
            

export ANTHROPIC_BASE_URL="https://api.onysoft.com"
export ANTHROPIC_MODEL="anthropic/claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-5.5"
# isteğe bağlı: bakiye ön kontrolü için çıktı üst sınırı
# export CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000

# Anahtarı gizli girin (ekranda görünmez, geçmişe yazılmaz) — zsh, macOS varsayılanı:
read -rs "ANTHROPIC_AUTH_TOKEN?Onysoft API anahtari: "; echo
# bash kullanıyorsanız bunun yerine: read -rsp "Onysoft API anahtari: " ANTHROPIC_AUTH_TOKEN; echo
export ANTHROPIC_AUTH_TOKEN

claude -p "Sadece BAGLANTI_BASARILI yaz."
claude
            

Temizlemek için: unset ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL ANTHROPIC_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL

Model Seçimi

Claude Code'un kendi takma adları (/model sonnet, opus, haiku) ve Anthropic kimlikleri (claude-sonnet-5-5, claude-haiku-4-5-20251001 gibi) Onysoft kataloğundaki karşılığına çevrilir. Anahtarınızın izinli olmadığı bir model seçilirse Claude Code "There's an issue with the selected model" der; bu durumda izinli modellerden birini seçin.

Claude dışı modeller de kullanılabilir (ör. ANTHROPIC_MODEL=openai/gpt-5.5 ya da z-ai/glm-5.3:tr): istek sohbet biçimine çevrilir, düşünce blokları gösterilmez ve sunucu araçları istekten çıkarılır. :tr modelleri kişisel anahtarlarda yalnız doğrulanmış hesaplara açıktır ve günlük istek sınırları tüm :tr modellerinde ortaktır; Claude Code bir oturumda çok sayıda istek gönderdiği için bu sınıra hızlı ulaşılabilir.

Ücretlendirme ve Sınırlar

Ücret gerçek kullanımdan, modelin katalog fiyatıyla kesilir. Her istekten önce max_tokens değerine göre bakiye ön kontrolü yapılır; Claude Code yüksek bir üst sınır istediği için düşük bakiyede CLAUDE_CODE_MAX_OUTPUT_TOKENS kullanın. Claude Code tek bir turda birden fazla istek gönderebilir (başlık üretimi, token sayımı); dakikalık istek sınırı API anahtarı başına sayıldığından Claude Code için ayrı bir anahtar kullanmanızı öneririz.

Sık Görülen Hatalar

401: anahtar eksik ya da yanlış.
402: bakiye yetersiz. İletide gereken ve mevcut tutar yazar; CLAUDE_CODE_MAX_OUTPUT_TOKENS değişkeni bu durumda yardımcı olur.
"There's an issue with the selected model": ANTHROPIC_BASE_URL sonunda /v1 var, model adı katalogda yok ya da anahtarınız bu modele izinli değil.
429: dakikalık istek sınırı aşıldı. Claude Code beklemeden sonra kendisi yeniden dener.

Notlar

ANTHROPIC_AUTH_TOKEN yerine ANTHROPIC_API_KEY de çalışır; Claude Code bu durumda anahtarı x-api-key başlığıyla gönderir. Etkileşimli kipte anahtarı bir kez onaylamanızı ister ve anahtarın yalnızca son 20 karakterini kendi ayar dosyasına (~/.claude.json) yazar. ANTHROPIC_AUTH_TOKEN ile bu onay adımı yoktur.
Claude Code'un web araması (WebSearch) aracı Claude modellerinde çalışır ve kullanımı ücretlendirilir.
Sunucu tarafında kod çalıştırma (code execution) ve uzak MCP sunucuları (mcp_servers) bu uçta desteklenmez. Kendi bilgisayarınızda kurduğunuz MCP sunucuları normal çalışır.
Sunucu tarafı yedek model (fallbacks), sunucu tarafı özetleme (compact_*) ve hızlı mod (speed) istekten çıkarılır; istek normal biçimde çalışır. Ayrıntılar: Anthropic Messages API.

Onysoft'un katalog, fiyat ve bakiye araçlarını Claude Code'a eklemek isterseniz MCP Sunucusu bölümüne bakın.