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, quick start, pola umum, dan penanganan error untuk bahasa proyek Anda
• Panduan penggunaan alat: Contoh khusus bahasa dan landasan konseptual untuk function calling, 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 silent-invalidator
• Migrasi model: Panduan langkah demi langkah untuk bermigrasi ke model Claude yang lebih baru (termasuk breaking changes dan pergeseran perilaku pada Claude Opus 5 dan Claude Fable 5.1)
• 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:

/claude-api

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 instal 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:

/claude-api migrate this project to claude-opus-5

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

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

Ketika cakupannya ambigu (misalnya, /claude-api migrate to claude-opus-5 saja), skill ini meminta Anda memilih antara seluruh direktori kerja, subdirektori tertentu, atau daftar file eksplisit sebelum mengedit file apa pun. 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) di semua bahasa yang didukung, dan 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 bersifat breaking, 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 berlaku
• Pembersihan header beta, menghapus header beta yang tidak diperlukan 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, 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 kontrol panjang, pemicu alat, subagen, dan kepatuhan instruksi yang mungkin berperilaku berbeda pada model target
• Penanganan default diam-diam, memilih kembali ringkasan thinking (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 retry fallback ketika targetnya adalah Claude Fable 5.1, Claude Fable 5, atau Claude Opus 5 (parameter fallbacks sisi server, biasanya dalam mode "default", middleware refusal-fallback SDK, atau retry fallback-credit), serta memperbarui kode fallback yang ditulis berdasarkan bentuk preview 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 Bermigrasi ke Claude Opus 5 dari Claude Opus 4.8 dan Bermigrasi ke Claude Fable 5.1.

Menyiapkan Managed Agent

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

/claude-api 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:

Build a streaming chat UI with the Claude API in TypeScript

Memigrasikan proyek yang sudah ada:

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

Onboarding Managed Agent baru:

/claude-api managed-agents-onboard

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