Skill Claude API

Skill claude-api adalah Agent Skill open-source yang menyediakan Claude dengan materi referensi yang terperinci dan terkini untuk membangun aplikasi pada dua permukaan Anthropic:

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

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

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

Skill ini menggunakan "progressive disclosure" (pengungkapan progresif) — lihat penjelasannya — untuk menjaga konteks tetap efisien: Claude hanya memuat dokumentasi yang relevan dengan bahasa proyek Anda, permukaan (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

Ketika dipicu, skill ini melengkapi Claude dengan:

Untuk Messages API:

• Dokumentasi SDK spesifik bahasa: Instalasi, quick start, pola umum, dan penanganan error untuk bahasa proyek Anda
• Panduan penggunaan alat: Contoh spesifik bahasa dan fondasi 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 perubahan yang merusak dan pergeseran perilaku pada Claude Opus 4.8)
• Informasi model terkini: ID model, ukuran 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 spesifik bahasa: Membuat agen persisten, memulai sesi, streaming event, dan menangani konfirmasi alat untuk Python, TypeScript, C#, Go, Java, PHP, Ruby, dan cURL
• Pola klien: Penyambungan ulang stream tanpa kehilangan data, gerbang queued/processed processed_at, penanganan interrupt, kendala 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 untuk 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 apa pun tempat skill ini diinstal.

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 (dibundel)

Skill ini dikirimkan bersama Claude Code dan tidak memerlukan instalasi. Ketika Anda meminta Claude untuk membantu membangun sesuatu dengan Claude API, atau ketika 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 yang dibundel di Claude Code, lihat dokumentasi skill Claude Code.



Dari repositori skill

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

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

Atau 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 codebase. Panggil langsung dengan /claude-api migrate:

/claude-api migrate this project to claude-opus-4-8

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

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

Ketika cakupannya ambigu (misalnya, /claude-api migrate to claude-opus-4-8 saja), skill ini meminta Anda untuk 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:

• Penukaran ID model, termasuk konstanta SDK bertipe (Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8) di semua bahasa yang didukung, dan mengklasifikasikan setiap file sebagai pemanggil, pendefinisi model, atau referensi string opaque sebelum mengedit
• Deteksi platform cloud, mempertahankan format ID model spesifik platform (misalnya, prefiks anthropic. pada Amazon Bedrock) dan melewati perubahan untuk fitur yang tidak tersedia pada platform yang dioperasikan mitra
• Perubahan parameter yang merusak, seperti menghapus temperature, top_p, dan top_k untuk Claude Opus 4.8 dan Claude Opus 4.7, dan 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 yang sudah GA pada 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, xhigh untuk kasus penggunaan coding dan agentic pada Claude Opus 4.8 dan Claude Opus 4.7)
• Penyetelan perilaku prompt, menandai prompt kontrol panjang, pemicu alat, subagen, dan instruction-following yang mungkin berperilaku berbeda pada model target
• Penanganan default diam-diam, mengaktifkan 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 (parameter fallbacks sisi server, middleware refusal-fallback SDK, atau retry fallback-credit), dan 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 penyesuaian ulang baseline biaya/batas laju).

Untuk daftar lengkap perubahan spesifik model yang diterapkan skill ini, lihat Bermigrasi dari Claude Opus 4.7 ke Claude Opus 4.8.



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 Sessions), membuat template konfigurasi agen, mengonfigurasi environment dan alat, menyiapkan loop sesi, dan menghasilkan kode yang dapat dijalankan untuk bahasa Anda. Skill ini juga mencakup alur wajib Agent (sekali) → Session (setiap run): model, system, dan tools berada pada agen, tidak pernah pada sesi, dan agen harus dibuat sekali dan 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-4-8 and re-tune effort

Onboarding Managed Agent baru:

/claude-api managed-agents-onboard

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



Langkah selanjutnya