Skill Claude API

Skill claude-api adalah Agent Skill open-source yang menyediakan materi referensi yang terperinci dan terkini bagi Claude untuk membangun aplikasi di dua surface Anthropic:

• Messages API: Surface utama untuk permintaan tunggal, chat streaming, "tool use" (penggunaan alat), pemrosesan batch, "prompt caching" (caching prompt), output terstruktur, dan loop agen kustom.
• Claude Managed Agents (beta): Surface yang di-hosting Anthropic untuk agen stateful yang dikelola server dengan eksekusi alat yang di-hosting Anthropic, konfigurasi agen persisten, dan sandbox per sesi.

Skill ini mencakup delapan bahasa pemrograman untuk Messages API maupun Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby, dan cURL.

Skill ini disertakan bersama Claude Code dan juga tersedia di repositori skills Anthropic open-source, tempat Anda dapat menginstalnya di lingkungan apa pun yang mendukung Agent Skills.

Skill ini menggunakan progressive disclosure (pengungkapan bertahap) agar konteks tetap efisien: Claude hanya memuat dokumentasi yang relevan dengan bahasa proyek Anda, surface (Messages API atau Managed Agents), dan tugas spesifik yang sedang dikerjakan (penggunaan alat, streaming, batch, dan sebagainya), alih-alih memuat semuanya sekaligus.

Apa yang disediakan skill ini

Saat dipicu, skill ini membekali Claude dengan:

Untuk Messages API:

• Dokumentasi SDK khusus bahasa: Instalasi, panduan memulai cepat, pola umum, dan penanganan error untuk bahasa proyek Anda
• Panduan penggunaan alat: Contoh khusus bahasa dan dasar-dasar konseptual untuk "function calling" (pemanggilan fungsi), termasuk tool runner beta jika tersedia
• Pola streaming: Detail implementasi untuk membangun UI chat dan menangani tampilan inkremental
• Pemrosesan batch: Pemrosesan batch offline dengan biaya 50%
• Caching prompt: Desain stabilitas prefiks, penempatan breakpoint, dan audit terhadap penyebab invalidasi diam-diam
• Migrasi model: Panduan langkah demi langkah untuk bermigrasi ke model Claude yang lebih baru (termasuk perubahan yang merusak kompatibilitas dan pergeseran perilaku pada Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5, dan Claude Fable 5.1)
• Migrasi preserved thinking: Menemukan, mengukur, dan memperbaiki pengeditan riwayat yang membuat blok thinking tidak valid, tersedia melalui subperintah /claude-api preserved-thinking-migration
• Informasi model terkini: ID model, ukuran "context window" (jendela konteks), dan harga
• Kesalahan umum: Panduan terperinci untuk menghindari kesalahan yang sering terjadi saat berintegrasi dengan API

Untuk Managed Agents (beta):

• Alur onboarding: Panduan berbasis wawancara untuk menyiapkan Managed Agent baru dari awal, tersedia melalui subperintah /claude-api managed-agents-onboard
• Dokumentasi Managed Agents khusus bahasa: Membuat agen persisten, memulai sesi, streaming event, dan menangani konfirmasi alat untuk Python, TypeScript, C#, Go, Java, PHP, Ruby, dan cURL
• Pola klien: Reconnect stream tanpa kehilangan data, gate queued/processed processed_at, penanganan interupsi, jebakan file-mount, dan penanganan kredensial
• Batasan deployment: Managed Agents hanya tersedia di Claude API dan Claude Platform on AWS (tidak di Amazon Bedrock, Google Cloud, atau Microsoft Foundry). Skill ini mengarahkan deployment lain ke Messages API dan penggunaan alat sebagai gantinya.

Kapan skill ini aktif

Skill ini aktif dengan dua cara:

Aktivasi otomatis terjadi ketika:

• Kode Anda mengimpor SDK Anthropic (anthropic untuk Python, @anthropic-ai/sdk untuk TypeScript/JavaScript)
• Anda meminta Claude membantu membangun, men-debug, atau mengoptimalkan sesuatu dengan Claude API, SDK Anthropic, atau Managed Agents
• Anda menambahkan, memodifikasi, atau menyetel fitur Claude dalam sebuah file (caching prompt, adaptive thinking, compaction, penggunaan alat, batch, files, citations, memory) atau referensi model

Pemanggilan manual dengan mengetik /claude-api (dengan subperintah atau prosa opsional) di lingkungan mana pun tempat skill ini terinstal.

Skill ini tidak aktif untuk tugas pemrograman umum, pekerjaan ML/data-science, atau kode yang mengimpor SDK AI lain (seperti OpenAI).

Bahasa yang didukung

Skill ini mendeteksi bahasa proyek Anda secara otomatis dengan memeriksa file proyek (misalnya, requirements.txt untuk Python, tsconfig.json untuk TypeScript, go.mod untuk Go) dan memuat dokumentasi yang sesuai.

Jika proyek Anda menggunakan beberapa bahasa, Claude akan menanyakan bahasa mana yang berlaku. Untuk bahasa yang tidak didukung (Rust, Swift, C++), skill ini menyediakan contoh cURL/HTTP mentah.

Cara menggunakan skill ini

Di Claude Code (disertakan)

Skill ini disertakan bersama Claude Code dan tidak memerlukan instalasi. Saat Anda meminta Claude membantu membangun sesuatu dengan Claude API, atau saat proyek Anda sudah mengimpor SDK Anthropic, skill ini aktif secara otomatis.

Anda juga dapat memanggilnya secara langsung:

Untuk informasi lebih lanjut tentang cara kerja skill bawaan di Claude Code, lihat dokumentasi skills Claude Code.

Dari repositori skills

Sumber skill ini tersedia di repositori skills Anthropic. Anda dapat menginstalnya menggunakan perintah npx:

npx skills add https://github.com/anthropics/skills --skill claude-api

Atau minta Claude Code untuk menginstalnya sebagai plugin Claude Code:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Bermigrasi ke model Claude yang lebih baru

Skill Claude API dapat melakukan migrasi model Claude di seluruh basis kode. Panggil secara langsung dengan /claude-api migrate:

Anda juga dapat memberikan cakupan spesifik di awal untuk melewati pertanyaan konfirmasi cakupan:

Ketika cakupannya ambigu (misalnya, /claude-api migrate to claude-opus-5-5 tanpa keterangan tambahan), skill ini meminta Anda memilih antara seluruh direktori kerja, subdirektori tertentu, atau daftar file eksplisit sebelum mengedit file apa pun. Hal ini berlaku untuk pemanggil Messages API maupun Managed Agents.

Skill ini menangani:

• Penggantian ID model, termasuk konstanta SDK bertipe (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5_5) di semua bahasa yang didukung, serta mengklasifikasikan setiap file sebagai pemanggil, pendefinisi model, atau referensi string opak sebelum mengedit
• Deteksi platform cloud, mempertahankan format ID model khusus platform (misalnya, prefiks anthropic. di Amazon Bedrock) dan melewati perubahan untuk fitur yang tidak tersedia di platform yang dioperasikan mitra
• Perubahan parameter yang merusak kompatibilitas, seperti menghapus temperature, top_p, dan top_k untuk Claude Opus 4.8 dan Claude Opus 4.7, serta mengonversi thinking: {type: "enabled", budget_tokens: N} menjadi thinking: {type: "adaptive"}
• Penggantian prefill, mengonversi pola prefill pesan asisten menjadi output terstruktur jika memungkinkan
• Pembersihan header beta, menghapus header beta yang tidak diperlukan oleh model target (misalnya, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) dan beralih kembali dari client.beta.messages.create() ke client.messages.create()
• Kalibrasi effort, merekomendasikan titik awal output_config.effort untuk model target (misalnya, nilai default high pada Claude Opus 5, dan xhigh untuk kasus penggunaan coding dan agentik pada Claude Opus 4.8 dan Claude Opus 4.7)
• Penyetelan perilaku prompt, menandai prompt terkait kontrol panjang, pemicuan alat, subagen, dan kepatuhan instruksi yang mungkin berperilaku berbeda pada model target
• Penanganan default yang berubah diam-diam, mengaktifkan kembali ringkasan pemikiran (thinking.display: "summarized") ketika penalaran ditampilkan kepada pengguna pada Claude Opus 4.8 dan Claude Opus 4.7
• Konfigurasi fallback penolakan, menambahkan penanganan stop_reason: "refusal" sebelum membaca konten respons dan menyiapkan jalur percobaan ulang fallback ketika targetnya adalah Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, atau Claude Sonnet 5.5 (parameter fallbacks sisi server, biasanya dalam mode "default", middleware fallback penolakan SDK, atau percobaan ulang dengan kredit fallback), serta memperbarui kode fallback yang ditulis berdasarkan bentuk pratinjau sebelumnya

Saat mengedit, skill ini menjelaskan setiap perubahan dan motivasinya secara inline. Setelah selesai, skill ini menghasilkan daftar periksa item yang memerlukan verifikasi manual (biasanya tes integrasi, penyetelan prompt kontrol panjang, dan penetapan ulang baseline biaya/"rate limit" (batas laju)).

Untuk daftar lengkap perubahan khusus model yang diterapkan skill ini, lihat Migrasi ke Claude Opus 5.5 dari Claude Opus 5, Migrasi ke Claude Opus 5.5 dari Claude Opus 4.8, Migrasi ke Claude Sonnet 5.5 dari Claude Sonnet 5, panduan migrasi Claude Haiku 5.5, dan panduan migrasi Claude Fable 5.1 dan Claude Mythos 5.1.

Memeriksa integrasi untuk preserved thinking

Preserved thinking menjaga blok thinking tetap valid hanya selama prompt system, tools, dan pesan-pesan sebelumnya tidak berubah. Untuk menemukan dan memperbaiki tempat-tempat di mana kode Anda mengedit riwayat tersebut, buka repositori yang membangun permintaan Anda dan panggil subperintah preserved-thinking-migration:

Skill ini bekerja melalui lima langkah:

1. Cakupan: Memeriksa apakah integrasi Anda terpengaruh, lalu mengirim tiga permintaan uji untuk mengonfirmasi bahwa API melaporkan pengeditan yang disengaja.
2. Temukan: Merekam beberapa sesi multi-giliran milik Anda sendiri, membandingkan (diff) permintaan yang berurutan, dan mencantumkan setiap tempat kode Anda mengedit prefiks.
3. Ukur: Memutar ulang sesi dengan "drop_block" dan melaporkan percakapan mana yang kehilangan blok thinking, pada giliran mana, dan mengapa.
4. Perbaiki: Mengganti satu pengeditan pada satu waktu dengan pola yang sesuai di Melakukan perubahan tanpa mengedit prefiks, dan mengukur lagi setelah setiap perubahan.
5. Laporkan: Merangkum setiap penyebab, perubahan yang dilakukan untuknya, serta jumlah sebelum dan sesudahnya.

Jika proyek Anda memiliki eval, skill ini juga membandingkan skor dan penggunaan token dengan dan tanpa blok thinking yang dibuang.

Permintaan uji dan pemutaran ulang adalah permintaan Messages API sungguhan, yang ditagih sesuai tarif normal model. Setiap pemutaran ulang hanya meminta beberapa token output dan menetapkan tool_choice ke none, sehingga tidak ada alat yang dijalankan. Skill ini menyebutkan biayanya dan meminta persetujuan Anda sebelum mengirimkannya.

Menyiapkan Managed Agent

Untuk membuat kerangka Managed Agent baru dari awal, panggil subperintah managed-agents-onboard:

Skill ini menjalankan wawancara yang memandu Anda melalui model mental Managed Agents (konfigurasi Agent versus Session), membuat template konfigurasi agen, mengonfigurasi lingkungan dan alat, menyiapkan loop sesi, dan menghasilkan kode yang dapat dijalankan untuk bahasa Anda. Skill ini juga mencakup alur wajib Agent (sekali) → Session (setiap kali dijalankan): model, system, dan tools berada di agen, tidak pernah di sesi, dan agen sebaiknya dibuat sekali lalu direferensikan berdasarkan ID.

Managed Agents memerlukan header beta managed-agents-2026-04-01, yang diatur SDK secara otomatis untuk semua panggilan client.beta.agents.*, client.beta.environments.*, client.beta.sessions.*, dan client.beta.vaults.*.

Contoh penggunaan

Berikut adalah contoh tugas yang dibantu skill ini untuk ditangani Claude:

Membangun aplikasi chat:

Memigrasikan proyek yang sudah ada:

Onboarding Managed Agent baru:

Dalam setiap kasus, skill ini memuat dokumentasi khusus bahasa yang relevan dan memandu Claude melalui implementasi menggunakan pola API dan praktik terbaik terkini.

Langkah selanjutnya