Anthropic (Claude)

Anthropic, Claude model ailesini oluşturur ve bir API aracılığıyla erişim sağlar. Mayros'ta bir API anahtarı veya setup-token ile kimlik doğrulaması yapabilirsiniz.

Seçenek A: Anthropic API anahtarı

En iyisi: standart API erişimi ve kullanıma dayalı faturalandırma için. API anahtarınızı Anthropic Console'da oluşturun.

CLI kurulumu

bashCopy
mayros onboard
# seçin: Anthropic API key

# veya etkileşimli olmayan
mayros onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Yapılandırma snippet'i

json5Copy
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

İstem önbelleğe alma (Anthropic API)

Mayros, Anthropic'in istem önbelleğe alma özelliğini destekler. Bu yalnızca API içindir; abonelik kimlik doğrulaması önbellek ayarlarını kabul etmez.

Yapılandırma

Model yapılandırmanızda cacheRetention parametresini kullanın:

json5Copy
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

Varsayılanlar

Anthropic API Anahtarı kimlik doğrulaması kullanıldığında, Mayros tüm Anthropic modelleri için otomatik olarak cacheRetention: "short" (5 dakikalık önbellek) uygular. Yapılandırmanızda cacheRetention'ı açıkça ayarlayarak bunu geçersiz kılabilirsiniz.

Eski parametre

Eski cacheControlTtl parametresi geriye dönük uyumluluk için hala desteklenmektedir:

• "5m", short'a eşlenir
• "1h", long'a eşlenir

Yeni cacheRetention parametresine geçiş yapmanızı öneririz.

Mayros, Anthropic API istekleri için extended-cache-ttl-2025-04-11 beta bayrağını içerir; sağlayıcı başlıklarını geçersiz kılarsanız bunu koruyun (bkz. /gateway/configuration).

1M bağlam penceresi (Anthropic beta)

Anthropic'in 1M bağlam penceresi beta ile sınırlandırılmıştır. Mayros'ta, desteklenen Opus/Sonnet modelleri için model başına params.context1m: true ile etkinleştirin.

json5Copy
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

Mayros bunu Anthropic isteklerinde anthropic-beta: context-1m-2025-08-07 olarak eşler.

Seçenek B: Claude setup-token

En iyisi: Claude aboneliğinizi kullanmak için.

setup-token'ı nereden alırsınız

Setup-token'lar Anthropic Console tarafından değil, Claude Code CLI tarafından oluşturulur. Bunu herhangi bir makinede çalıştırabilirsiniz:

bashCopy
claude setup-token

Tokeni Mayros'a yapıştırın (sihirbaz: Anthropic token (setup-token yapıştır)), veya ağ geçidi ana bilgisayarında çalıştırın:

bashCopy
mayros models auth setup-token --provider anthropic

Tokeni farklı bir makinede oluşturduysanız, yapıştırın:

bashCopy
mayros models auth paste-token --provider anthropic

CLI kurulumu (setup-token)

bashCopy
# Onboarding sırasında bir setup-token yapıştırın
mayros onboard --auth-choice setup-token

Yapılandırma snippet'i (setup-token)

json5Copy
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Notlar

• Setup-token'ı claude setup-token ile oluşturun ve yapıştırın veya ağ geçidi ana bilgisayarında mayros models auth setup-token çalıştırın.
• Claude aboneliğinde "OAuth token refresh failed …" görüyorsanız, bir setup-token ile yeniden kimlik doğrulaması yapın. Bkz. /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
• Kimlik doğrulama ayrıntıları + yeniden kullanım kuralları /concepts/oauth'dadır.

Sorun giderme

401 hataları / token aniden geçersiz

• Claude abonelik kimlik doğrulamasının süresi dolabilir veya iptal edilebilir. claude setup-token'ı yeniden çalıştırın ve ağ geçidi ana bilgisayarına yapıştırın.
• Claude CLI girişi farklı bir makinedeyse, ağ geçidi ana bilgisayarında mayros models auth paste-token --provider anthropic kullanın.

Sağlayıcı "anthropic" için API anahtarı bulunamadı

• Kimlik doğrulama ajan başınadır. Yeni ajanlar ana ajanın anahtarlarını miras almaz.
• O ajan için onboarding'i yeniden çalıştırın veya ağ geçidi ana bilgisayarına bir setup-token / API anahtarı yapıştırın, ardından mayros models status ile doğrulayın.

Profil anthropic:default için kimlik bilgileri bulunamadı

• Hangi kimlik doğrulama profilinin aktif olduğunu görmek için mayros models status çalıştırın.
• Onboarding'i yeniden çalıştırın veya o profil için bir setup-token / API anahtarı yapıştırın.

Kullanılabilir kimlik doğrulama profili yok (hepsi cooldown/kullanılamıyor)

• auth.unusableProfiles için mayros models status --json kontrol edin.
• Başka bir Anthropic profili ekleyin veya cooldown'u bekleyin.

Daha fazlası: /gateway/troubleshooting ve /help/faq.