Claude Beceriler API'si 20 Ağustos 2026 itibarıyla genel kullanıma sunulmuştur. Artık standart başlıklarla, beta bayrağına gerek kalmadan `https://api.anthropic.com/v1/skills` üzerinden özel beceriler oluşturabilir, sürümleyebilir ve yönetebilir, bunları Claude'un kod sanal alanında kendi barındırma derdiniz olmadan çalıştırabilirsiniz. Anthropic, genel kullanıma sunulan bu sürümü bilgisayar kullanımı, yeni tarayıcı aracı ve Dosyalar API'si ile tek bir dalga halinde sundu ve duyuruda Claude Platformu üzerinde aracı oluşturmak için üretim yığını olarak çerçeveledi.
Beceriler kavramı sizin için yeniyse, Claude Becerileri Rehberimiz bu fikri baştan sona ele almaktadır. Bu makale, API katmanı hakkındadır: uç noktalar, sürümleme modeli, becerileri bir Mesaj çağrısına yükleyen istek yapısı ve genel kullanıma sunulmayla giderilmeyen zorluklar (çalışma alanı kapsamı, anlık görüntü sürümleme). Her şey düz HTTP olduğundan, burada bahsedilen her çağrı siz takip ederken Apidog'da oluşturulabilir ve regresyon testinden geçirilebilir.
düğme
30 Saniyelik Hızlı Tekrar: Bir beceri nedir
Bir beceri bir klasördür. En üst seviyesinde bir `name` ve bir `description` içeren YAML ön bilgisi taşıyan bir `SKILL.md` dosyası bulunur; etrafında görevin ihtiyaç duyduğu tüm komut dosyaları, şablonlar ve referans dosyaları yer alır. Bir istek beceriyi içerdiğinde, Claude talimatları yalnızca görev onları çağırdığında yükler ve paketlenmiş tüm komut dosyalarını sanal kod ortamında yürütür.
Ön bilginin gerçek doğrulama kuralları vardır:
- `name`: en fazla 64 karakter, yalnızca küçük harfler, sayılar ve kısa çizgiler. XML etiketleri yasaktır ve “anthropic” ile “claude” kelimeleri rezerve edilmiştir.
- `description`: boş olamaz, en fazla 1024 karakter.
- İsteğe bağlı bir `display_name` (en fazla 255 karakter) kullanıcı dostu olabilir.
- Tüm yükleme, sıkıştırılmamış halde 30 MB'nin altında kalmalıdır.
Beceriler iki kaynaktan gelir. Anthropic tarafından yönetilen beceriler (`type: "anthropic"`), `pptx`, `xlsx`, `docx` ve `pdf` gibi kısa kimliklerle önceden oluşturulmuş olarak gelir ve `20251013` gibi tarih tabanlı sürümler kullanır. Özel beceriler (`type: "custom"`) size aittir: API aracılığıyla yüklenir, çalışma alanınıza özeldir ve `skill_01AbCdEfGhIjKlMnOpQrStUv` gibi oluşturulmuş kimliklere sahiptir.
Genel Kullanıma Sunulmayla Gerçekte Ne Değişti
20 Ağustos 2026 itibarıyla üç şey yeni veya pekiştirilmiştir:
- Beta başlığı yok. Beceriler API'si, Claude API üzerinde yalnızca `x-api-key` ve `anthropic-version: 2023-06-01` ile çalışır.
- Daha basit bir yükleme ve sürümleme akışı. Anthropic, genel kullanıma sunulmanın özel beceriler için “daha basit bir yükleme ve sürümleme API'si” getirdiğini belirtiyor. Sürümler, kendi uç noktalarına sahip birinci sınıf kaynaklardır.
- Daha fazla platform. Beceriler API'si, Claude API'sinin yanı sıra Microsoft Foundry aracılığıyla da kullanılabilir. Beceriler Claude'un yönetilen sanal alanında yürütüldüğü için sizin tarafınızda hala herhangi bir altyapı bulunmamaktadır.
Genel kullanıma sunulma dalgasının geri kalanı beceri kullanıcıları için de önemlidir: beceriler sık sık dosyalar (bir sunum destesi, doldurulmuş bir elektronik tablo) üretir ve bu çıktılar yeni genel kullanıma sunulan Dosyalar API'si aracılığıyla geri döner.
Uç Nokta Yüzeyi
Her şey `/v1/skills` altında yer alır:
| İşlem | Uç Nokta |
|---|---|
| Beceri oluştur | POST /v1/skills |
| Becerileri listele | GET /v1/skills |
| Beceri al | GET /v1/skills/{skill_id} |
| Beceri sil | DELETE /v1/skills/{skill_id} |
| Yeni sürüm oluştur | POST /v1/skills/{skill_id}/versions |
| Sürümleri listele | GET /v1/skills/{skill_id}/versions |
Bir beceri oluşturmak, tüm dosya kümesini yükler; bir sürüm oluşturmak, mevcut bir beceri kimliğine karşı aynı şeyi yapar. Bir Apidog projesinde, bu durum `{{skill_id}}` ve `{{skill_version}}` ortam değişkenleri ile altı kayıtlı isteğin bulunduğu tek bir klasöre temiz bir şekilde eşleşir, böylece yeni bir sürümü geliştirme ve üretim ortamlarında ilerletmek bir değişken değişikliğidir, istek düzenlemesi değil.
Özel bir beceri yükleme
Minimal bir özel beceri iki şeyden oluşur: klasör ve yükleme çağrısı. Diyelim ki deponuzda bir marka raporu becerisi tutuyorsunuz:
brand-report/
SKILL.md
templates/report.html
scripts/build_report.py
Şöyle başlayan bir `SKILL.md` ile:
---
name: brand-report
description: Generates the weekly brand performance report as a formatted HTML document from a CSV of metrics. Use when asked for a brand report, weekly summary deck, or performance writeup.
---
Dosyaları multipart form verisi olarak göndererek yükleyin:
curl -X POST https://api.anthropic.com/v1/skills \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-F 'files[]=@brand-report/SKILL.md;filename=brand-report/SKILL.md' \
-F 'files[]=@brand-report/templates/report.html;filename=brand-report/templates/report.html' \
-F 'files[]=@brand-report/scripts/build_report.py;filename=brand-report/scripts/build_report.py'
Yanıt, oluşturulan `skill_id`'yi ve ilk sürümün `skver_*` kimliğini döndürür. Her ikisini de saklayın; beceri kimliği Mesajlar isteklerinize gider ve sürüm kimliği geri alma çıpanızdır. Çoğu dilde tipik SDK yardımcıları bu çağrıyı sardığı için SDK sürümünüz için Beceriler API referansına karşı tam multipart alan adlarını kontrol edin.
Açıklamaya dikkat edin: bir yönlendirme kuralı gibi okunur. Claude, o alanı okuyarak bir beceriyi yükleyip yüklemeyeceğine karar verir, bu nedenle kullanıcılarınızın söylediği tetikleyici ifadeleri listeleyen bir açıklama, tek satırlık bir etiketten her zaman daha iyi performans gösterir.
Bir Mesaj isteğinde beceri kullanma
Beceriler bir isteğe kendi başlarına eklenmezler. `container` parametresi aracılığıyla belirtilen kod yürütme aracını kullanırlar:
response = client.messages.create(
model="claude-opus-5",
max_tokens=4096,
container={
"skills": [
{"type": "anthropic", "skill_id": "pptx", "version": "latest"},
{"type": "custom", "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv", "version": "latest"}
]
},
messages=[{"role": "user", "content": "Build the Q3 revenue deck from the attached numbers"}],
tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)
Bu bloğu yöneten kurallar:
- Kod yürütme aracı `tools` içinde etkinleştirilmelidir, çünkü beceriler bu sanal alan içinde yürütülür. Model desteği, kod yürütme aracının uyumluluk listesini takip eder.
- İstek başına en fazla 20 beceri. Claude, her becerinin açıklamasını okur ve yalnızca görevin ihtiyaç duyduğu beceriler için talimatları yükler.
- Sürüm sabitleme sizin kontrolünüzdedir. `"latest"` en yeni sürüme geçer; sabitlenmiş bir `skver_*` kimliği (veya Anthropic becerileri için tarih sürümü) davranışı dondurur. Üretimde sabitleyin, geliştirme ortamında akıcı kullanın.
Bir beceri bir belge ürettiğinde, yanıt, Dosyalar API'sinin `GET /v1/files/{file_id}/content` aracılığıyla indireceğiniz bir `file_id` taşır. Bu iki API el sıkışması (üretmek için Beceriler, almak için Dosyalar) temel üretim döngüsüdür.
Sürümleme: Anlık görüntüler, farklar değil
Sürümleme modeli, çoğu ekibin ilk denemede yanlış yaptığı kısımdır. Yeni bir sürüm, bir delta değil, eksiksiz bir anlık görüntüdür. `POST /v1/skills/{skill_id}/versions` yaptığınızda, becerinin tüm dosya kümesini yeniden yüklersiniz; atladığınız dosyalar önceki sürümden aktarılmaz. Yeni sürümün `SKILL.md` dosyasındaki `name` de becerinin mevcut adıyla eşleşmelidir.
Beceri klasörlerini derleme yapıtları gibi ele alın: doğruluk kaynağını deponuzda tutun, tüm klasörü CI'da paketleyin ve yeni bir sürüm olarak itin. Eski sürümler `skver_*` kimlikleriyle erişilebilir kaldığı ve bir üretim olayı tek bir dizenin yeniden sabitlenmesiyle düzeltildiği için geri alma işlemi basittir.
Çalışma alanı kapsamı: çok kiracılı tuzak
Özel beceriler tüm çalışma alanınıza açıktır. Bir son kullanıcıya, bir konuşmaya veya bir oturuma kapsamlı değildirler ve çalışma alanındaki her API anahtarı bunları paylaşır. Kiracıların kendi becerilerini yüklediği çok kiracılı bir ürün çalıştırıyorsanız, tek bir çalışma alanı veri sızıntısı için bekleyen bir tehlikedir.
Çözüm, Dosyalar API'si için olduğu gibidir: her kiracı için ayrı bir çalışma alanı oluşturun. Çalışma alanı bir izolasyon sınırıdır ve her kuruluş, bir hesap ekibiyle konuşmaya gerek kalmadan 100'e kadar çalışma alanına sahip olabilir. Anahtarlar, dosyalar ve becerilerin hepsi bu sınırı devralır, bu nedenle tek bir karar üçünü de izole eder.
Uzun süreli beceriler: pause_turn ve konteynerin yeniden kullanılması
Beceri yürütmeleri tek bir model turundan daha uzun sürebilir. İki mekanizma bunu halleder:
- `pause_turn`: bir yanıt `stop_reason: "pause_turn"` ile durduğunda, asistan içeriğini mesaj geçmişinize ekleyin ve aynı `container.id`'yi geçirerek tekrar çağrı yapın. Sanal alan kaldığı yerden devam eder.
- Konteynerin yeniden kullanılması: `container` nesnesi önceki bir yanıttan bir `id` kabul eder, kurulu dosyaları ve durumu çok turlu bir konuşma boyunca canlı tutar. Bu, bir becerinin birinci turda bir elektronik tablo oluşturup üçüncü turda sıfırdan yeniden oluşturmadan revize edebileceği anlamına gelir.
Her iki desen de durumlu HTTP dizileridir, bu da onları elle test etmeyi zorlaştırır ve bir Apidog senaryosu olarak test etmeyi keyifli hale getirir: birinci istek `stop_reason` üzerinde doğrulama yapar, bir betik `container.id`'yi bir değişkene alır, ikinci istek onu yeniden kullanır ve son adım oluşturulan `file_id`'nin sorunsuz indiğini doğrular. Apidog CLI aynı senaryoyu CI'da çalıştırır, bu nedenle bir beceri sürümü artışı hattınızı sessizce bozamaz. Karşılaştırma için becerilerin başka bir satıcının ekosisteminde nasıl davrandığını görmek isterseniz, daha önceki bir incelememizde Postman'ın Claude becerisini incelemiştik.
Nerede çalışır
Genel kullanıma sunulma aşamasında Beceriler API'si Claude API'sinde ve Microsoft Foundry aracılığıyla mevcuttur. Beceriler, Anthropic'in sanal alanında yürütülür, bu nedenle “dağıtım” bir yüklemedir ve sizin tarafınızda konteyner görüntüsü, çalışma zamanı yaması veya ölçeklendirme düğmesi yoktur. Bir platform bağımlılığı yerine model bağımlılığını unutmayın: istek, yukarıdaki örneklerde olduğu gibi `claude-opus-5` gibi kod yürütme aracının desteklediği bir model kullanmalıdır. Eğer yeni başlıyorsanız, Claude Opus 5 API rehberimiz o modelin temel isteklerini kapsar.
Sıkça Sorulan Sorular
Hala beceriler beta başlığına ihtiyacım var mı? Hayır. 20 Ağustos 2026'dan itibaren `/v1/skills` ve `container.skills` parametresi Claude API'sinde standart başlıklarla çalışır. SDK'nızı yükselttiğinizde sabitlenmiş tüm beta bayraklarını kaldırın.
Bir beceri çalışırken harici API'leri çağırabilir mi? Beceriler, Claude'un kod sanal alanında, kod yürütme aracının ağ kısıtlamalarıyla yürütülür. Açık çıkış varsaymak yerine becerinin ihtiyaç duyduğu her şeyi klasöründe paketleyin ve API çağırma mantığını doğru bir şekilde test edebileceğiniz uygulama katmanınızda tutun.
Bir istek kaç beceri yükleyebilir? En fazla 20. Claude, görevin hangilerine ihtiyaç duyduğuna karar vermek için her becerinin `description` ön bilgisini okur, bu nedenle açıklamalar yük taşıyıcıdır: bunları pazarlama metni gibi değil, yönlendirme kuralları gibi yazın.
Bununla Claude Code becerileri arasındaki fark nedir? Aynı konsept, farklı çalışma zamanı. Claude Code, dosya sisteminizdeki beceri klasörlerini keşfeder; Beceriler API'si bunları sunucu tarafında, sürümlenmiş olarak, Mesajlar API çağrıları için barındırır. `SKILL.md` ön bilgisiyle klasör formatı paylaşılır, bu nedenle Claude Code için yazdığınız bir beceri genellikle çok az değişiklikle taşınabilir.
Sonuç
Genel kullanıma sunulma, becerileri bir deneyden operasyonel bir yüzeye dönüştürüyor: altı uç nokta, anlık görüntü sürümleme, çalışma alanı izolasyonu ve çıktılar için Dosyalar API'sine temiz bir devir. En hızlı değer elde eden ekipler, becerileri diğer dağıtılabilir yapıtlar gibi ele alır; bu da CI paketleme, üretimde sabitlenmiş sürümler ve konteyner yaşam döngüsü etrafında otomatik testler anlamına gelir. Altı uç noktayı Apidog'da modelleyin, sürüm artışını bir test senaryosuna bağlayın ve kötü bir beceri sürümünün sunum oluşturucunuzu bozduğunu kullanıcılarınızdan önce siz bileceksiniz. Apidog'u ücretsiz indirin ve sistemi bir öğleden sonra kurun.