Bu rehberde: Claude modellerini kendi Anthropic hesabınızla çalıştırırsınız (BYOK: "kendi anahtarınızı getirin"). Anthropic Console'da bir anahtar oluşturur, OrqLabs'a girer ve faturayı doğrudan Anthropic'e ödersiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | ANTHROPIC |
| Kategori | LLM anahtarları (BYOK) |
| Kimlik doğrulama | API anahtarı (+ isteğe bağlı Workspace ID) |
| Kapsam | Organizasyon geneli; tüm projelerdeki Claude çağrıları bu anahtarla yapılır |
| Webhook | Hayır |
| Yetenekler | LLM |
| Kullanan kutular | Tüm ajan kutuları ve model kullanan yapay zekâ kutuları (seçilen model claude-* ise) |
| Kullanan ajanlar | Varsayılan modeli Claude olan tüm ajanlar |
Ne işe yarar?
- Anahtar tanımlıysa organizasyondaki her
claude-*çağrısı sizin Anthropic hesabınızdan faturalanır. Anahtar yoksa platform anahtarı kullanılır. - Kendi hız limitleriniz, veri saklama ayarlarınız ve Anthropic kullanım panolarında birebir görünürlük elde edersiniz.
- OrqLabs yine her çağrıyı ölçer ve katalog fiyatıyla maliyet hesaplar. Aylık bütçe, iş akışı bütçesi ve ajan bütçesi aynen çalışır; bütçe uyarıları üretilir. Rakamlar Anthropic faturasıyla küçük farklar gösterebilir (önbellek indirimleri).
BYOK plan katmanlarını değiştirmez: STARTER'da yine yalnızca ekonomi ve dengeli, PRO ve ENTERPRISE'da amiral gemisi modeller.
Ön koşullar
- Planınız STARTER veya üstü. FREE planda kart "BYOK bu planda kapalı" der ve Bağla pasiftir.
- Bir Anthropic Console hesabı ve ödeme yöntemi veya yüklenmiş kredi. Kredisiz hesaplarda ilk çağrı 400 ile reddedilir.
- Console'da Admin veya Developer rolü.
- OrqLabs'ta Sahip veya Yönetici rolü.
claude-fable-5-1kullanacaksanız Anthropic'te 30 günlük veri saklama ayarı açık olmalı.
Adım adım kurulum
A) Anthropic Console
- console.anthropic.com → giriş yapın, sağ üstten organizasyonu seçin.
- Settings → Billing → Add credits ile kredi yükleyin. Auto-reload açarsanız ajanlar gece yarısı durmaz.
- (Önerilen) Settings → Workspaces → Create Workspace → ad
OrqLabs. Workspace'ler maliyeti ayırır; her birine harcama ve hız limiti koyabilirsiniz. - ① Settings → API Keys → Create Key: ② Workspace:
OrqLabs(veya Default); ③ Name: ayırt edici bir ad (orqlabs-prod) → Create Key.
- ① Anahtar
sk-ant-api03-…biçiminde yalnızca bir kez gösterilir; kopyalayın. - ② Workspace ID (
wrkspc_…): yalnızca anahtar bir workspace'e bağlı değilse gerekir; çoğu kurulumda boş bırakılır. - Settings → Limits sayfasında kullanım katmanınızı ve model bazında limitleri görün.
claude-fable-5-1için: Settings → Privacy (veya Data retention) → 30 days.
B) OrqLabs'ta bağlama
- Entegrasyonlar → LLM anahtarları (BYOK) → Anthropic API key (BYOK) → Bağla. ③ Organizasyon geneli; proje seçilmez.
- Alanları doldurun:
| Alan | Nereden alınır |
|---|---|
| API key ① | Console → API Keys → Create Key |
| Workspace ID (optional) ② | Yalnızca anahtar bir workspace'e bağlı değilse; biçim wrkspc_… |
- ④ Bağla. OrqLabs küçük bir deneme isteğiyle anahtarı doğrular; kart Bağlı olur. Bu andan itibaren organizasyonun tüm Claude çağrıları bu anahtarla yapılır; çalışan iş akışlarını yeniden başlatmanız gerekmez.
- Ayarlar → Modeller ve fiyat sayfasında organizasyon varsayılan modelini seçin.
Kullanılabilen modeller
| Model | Katman | Giriş $/1M | Çıkış $/1M | Bağlam | Not |
|---|---|---|---|---|---|
claude-opus-5 | amiral gemisi | 5 | 25 | 1M | Platform varsayılanı |
claude-fable-5-1 | amiral gemisi | 10 | 50 | 1M | En yetenekli; 30 günlük veri saklama gerekir; zorunlu araç seçimi desteklenmez |
claude-opus-4-8 | amiral gemisi | 5 | 25 | 1M | Strateji ve içerik |
claude-sonnet-5 | dengeli | 2 | 10 | 1M | Ajanların varsayılan dengeli modeli |
claude-sonnet-4-6 | dengeli | 3 | 15 | 1M | Sıcaklık parametresini kabul eder |
claude-haiku-4-5 | ekonomi | 1 | 5 | 200K | Sınıflandırma, yüksek hacimli chatbot |
Platform yöneticisi fiyatları ve açık/kapalı durumunu değiştirebilir.
Hangi ajanlar varsayılan olarak Claude kullanır?
| Varsayılan model | Ajanlar |
|---|---|
claude-opus-5 | Market Analyst, SEO & Traffic, Analytics Strategist, Campaign Planner |
claude-sonnet-5 | Content Creator, Community Manager, AI Chatbot, Lead Researcher, Lead Qualifier, Outreach, Competitor Analyst, Report Writer, Custom |
claude-haiku-4-5 | Social Publisher; FREE planda ve ekonomik model seçiminde tüm ajanlar |
Dikkat: Bilgi bankası gömmeleri ve görsel üretimi her zaman OpenAI'ye gider. Anthropic anahtarı bunları kapsamaz. Bkz. OpenAI BYOK.
İzinler
Anthropic anahtarlarında kapsam yoktur; anahtar ait olduğu workspace'in tüm erişimine sahiptir. Daraltmak için:
| Kontrol | Nerede | Etkisi |
|---|---|---|
| Workspace harcama limiti | Settings → Workspaces → Limits | Aylık tavan; aşımda 429 |
| Workspace hız limiti | Aynı ekran | Organizasyon limitinin bir bölümü |
| Anahtar izleme | Settings → API Keys | Son kullanım tarihi; şüphede silin |
| Model erişimi | Settings → Privacy / Limits | Veri saklama Fable 5.1 erişimini belirler |
Kullanım katmanları ve limitler
- Anthropic uygulama incelemesi yapmaz. Hız ve harcama limitleri hesabın toplam harcamasına göre otomatik yükselir (Tier 1 → 4). Paralel çalışan çok ajan için en az Tier 2 önerilir.
- Bağlam: Opus 5 / Fable 5.1 / Sonnet 5 1M token; Haiku 4.5 200K.
- Maksimum çıktı: 128.000 token (Haiku 4.5: 64.000).
- 529 "overloaded" geçicidir; OrqLabs otomatik yeniden dener.
- Plan kotaları (iş akışı ve ajan çalıştırması, konuşma sayıları) BYOK'ta da geçerlidir. Anthropic'e giden harcama ise aylık LLM bütçenize ve platform harcama tavanlarına sayılmaz; üst sınırı Anthropic Console → Limits sayfasından koyun.
Bağlantıyı test etme
② Bağlantıyı test et claude-haiku-4-5 ile birkaç token'lık istek gönderir; kullanılan modeli, yanıt süresini ve kalan kotayı gösterir. Maliyeti 0,001 $'ın altındadır.
Kimlik bilgilerini yenileme
- Anahtarlar süresizdir.
- Yenileme sırası: Console'da yeni anahtar → OrqLabs'ta entegrasyon kartı → Kimlik bilgileri → Güncelle → API key → Bağlantıyı test et → eski anahtarı Console'da Delete.
- Sızıntı şüphesinde önce Console'da silin. OrqLabs bir sonraki çağrıda
AUTHhatası verir; yeni anahtar girilene kadar çağrılar platform anahtarına düşmez, iş akışları hata verir. - Entegrasyonu silerseniz organizasyon platform anahtarına döner.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 "invalid x-api-key" | Anahtar yanlış veya silinmiş | Yeni anahtar; Kimlik bilgileri → Güncelle |
AUTH – 403 "permission_error" | Workspace modele erişemiyor veya veri saklama uygun değil | Privacy → 30 gün; veya başka model |
AUTH – 401 workspace hatası | Anahtar workspace'e bağlı değil ve Workspace ID boş | Workspace ID (optional) alanını doldurun |
INVALID – 404 "model: claude-…" | Model kimliği yok | Ayarlar → Modeller ve fiyat'tan seçin |
INVALID – 400 "credit balance is too low" | Kredi bitti | Billing → Add credits; Auto-reload |
INVALID – 400 "tool_choice … not supported" | Fable 5.1 ile zorunlu araç seçimi | Katalog ayarını geri alın |
RATE_LIMIT – 429 | Hız veya harcama limiti | Otomatik bekleme; limit artışı isteyin |
UPSTREAM – 529 "overloaded" | Geçici aşırı yük | Otomatik tekrar |
INVALID – 413 "request_too_large" | Bağlam sınırı aşıldı | Bilgi bankası parça sayısını ve maks. adımı düşürün |
| "BYOK bu planda kapalı" | Plan FREE | STARTER veya üstüne geçin |
Sık sorulan sorular
BYOK daha ucuz mu? Anthropic'e liste fiyatı ödersiniz; platform kâr payı uygulanmaz. Plan kotaları (çalıştırma sayıları) yine geçerlidir; aylık LLM bütçesi yalnızca platform üzerinden faturalanan harcamayı sayar, BYOK harcamasını sınırlamaz.
Verilerim nereye gider? Doğrudan sizin Anthropic hesabınıza. Veri işleme sözleşmeniz Anthropic ile olur.
Workspace ID'yi doldurmalı mıyım? Anahtarı bir workspace içinde oluşturduysanız hayır. Yalnızca workspace'e bağlı olmayan eski tip anahtarlarda gerekir.