Panduan Lengkap Claude Code SDK

Dunia pengembangan perangkat lunak sedang mengalami pergeseran transformatif, didorong oleh kekuatan kecerdasan buatan (AI). Alat bertenaga AI bukan lagi konsep futuristik tetapi kenyataan saat ini, meningkatkan kemampuan pengembang dan merampingkan alur kerja. Di garis depan revolusi ini adalah Claude Code dari Anthropic, model AI canggih yang dirancang khusus untuk tugas coding. Untuk memberdayakan pengembang agar dapat mengintegrasikan teknologi mutakhir ini dengan mulus ke dalam aplikasi dan alur kerja mereka sendiri, Anthropic telah merilis SDK Claude Code. Panduan komprehensif ini akan mendalami SDK Claude Code, mengeksplorasi fitur, fungsionalitasnya, dan menyediakan panduan langkah demi langkah tentang penggunaannya di berbagai lingkungan pemrograman.

💡

Ingin menguji API AI dalam hitungan detik?Apidog memungkinkan Anda merancang, membuat mock, dan menguji Claude, GPT, atau endpoint AI apa pun dalam satu UI yang bersih—tidak perlu Postman atau kode. Bangun tumpukan AI lengkap Anda mulai dari prompt hingga produksi, dengan mudah.

button

Apa itu Claude Code dan Claude Code SDK?

Sebelum kita mendalami detail SDK, penting untuk memahami teknologi inti yang mendukungnya. Claude Code adalah large language model (LLM) dari Anthropic, yang dilatih dengan cermat pada dataset kode yang sangat besar. Pelatihan khusus ini memungkinkannya memahami, menghasilkan, dan menalar tentang kode dengan tingkat kemahiran yang tinggi di berbagai bahasa pemrograman. Mulai dari menghasilkan kode boilerplate dan menulis algoritma kompleks hingga melakukan debugging dan menjelaskan cuplikan kode, Claude Code adalah alat serbaguna untuk setiap pengembang.

Claude Code SDK (Software Development Kit) bertindak sebagai jembatan, memungkinkan pengembang untuk berinteraksi secara terprogram dengan model Claude Code. Alih-alih terbatas pada antarmuka web, pengembang dapat memanfaatkan SDK untuk membangun aplikasi kustom, skrip, dan integrasi yang memanfaatkan potensi penuh Claude Code. Apakah Anda ingin membuat asisten coding yang dipersonalisasi, mengotomatiskan tinjauan kode di pipeline CI/CD Anda, atau membangun alat yang dapat menerjemahkan kode dari satu bahasa ke bahasa lain, Claude Code SDK menyediakan alat dan antarmuka yang diperlukan untuk mewujudkan ide-ide Anda.

Manfaat utama menggunakan SDK adalah kemampuan untuk melampaui kueri interaktif satu kali dan masuk ke dunia kontrol otomatis dan terprogram. Ini membuka lanskap kemungkinan yang luas untuk mengintegrasikan AI ke dalam inti siklus hidup pengembangan perangkat lunak.

Memulai: Langkah Pertama Anda dengan Claude Code SDK

Memulai perjalanan Anda dengan Claude Code SDK adalah proses yang mudah. Berikut adalah hal-hal yang Anda perlukan untuk memulai:

Prasyarat

Sebelum Anda dapat mulai melakukan panggilan ke API Claude Code, Anda memerlukan kunci API. Kunci ini mengautentikasi permintaan Anda dan menghubungkannya dengan akun Anthropic Anda. Anda dapat membuat kunci API khusus di Anthropic Console. Sangat disarankan untuk membuat kunci baru secara khusus untuk penggunaan SDK Anda guna memastikan keamanan dan manajemen yang lebih baik.

Setelah Anda memiliki kunci API, Anda perlu membuatnya dapat diakses oleh lingkungan pengembangan Anda. Pendekatan yang disarankan adalah mengaturnya sebagai variabel lingkungan bernama ANTHROPIC_API_KEY. Ini adalah praktik yang lebih aman daripada menulis kunci secara langsung (hardcode) ke dalam kode sumber Anda.

Instalasi: Memilih Versi Anda

Claude Code SDK dirancang agar serbaguna dan dapat diakses oleh pengembang yang bekerja di lingkungan yang berbeda. SDK ini tersedia untuk command line, TypeScript, dan Python.

Antarmuka Baris Perintah (CLI): CLI adalah cara paling langsung untuk berinteraksi dengan SDK dan merupakan titik awal yang bagus untuk eksperimen dan pembuatan skrip sederhana.
TypeScript SDK: Untuk pengembang yang membangun aplikasi web atau bekerja di lingkungan Node.js, TypeScript SDK, yang tersedia di NPM sebagai @anthropic-ai/claude-code, adalah pilihan ideal.
Python SDK: Bagi mereka yang berada di ekosistem Python, paket claude-code-sdk di PyPI menyediakan pengalaman integrasi yang mulus.

Proses instalasi untuk masing-masing akan dibahas di bagian masing-masing di bawah ini.

Mendalami Claude Code SDK: Dari Command Line hingga Aplikasi Kustom

Sekarang, mari kita jelajahi aspek praktis penggunaan Claude Code SDK di berbagai lingkungan.

Antarmuka Baris Perintah (CLI): Gerbang Anda ke Claude Code

CLI menyediakan cara yang kuat dan fleksibel untuk berinteraksi dengan Claude Code langsung dari terminal Anda.

Penggunaan Dasar:

Satu Prompt: Penggunaan paling dasar melibatkan menjalankan satu prompt dan meminta Claude Code menghasilkan respons.Bash

claude-code "write a python function to calculate the factorial of a number"

Piping stdin: Anda dapat mem-pipe output dari perintah lain atau konten file ke Claude Code sebagai input.Bash

cat my_script.py | claude-code "add type hints to this python code"

Output JSON: Untuk penggunaan terprogram, Anda bisa mendapatkan output dalam format JSON terstruktur.Bash

claude-code --json "explain this javascript code" < my_script.js

Streaming JSON: Untuk permintaan yang berjalan lama, Anda dapat melakukan streaming output JSON saat tersedia.Bash

claude-code --stream-json "write a comprehensive unit test for this function" < my_function.go

Opsi CLI Utama:

CLI dilengkapi dengan beragam opsi yang memungkinkan Anda menyesuaikan perilakunya:

i, --non-interactive: Jalankan dalam mode non-interaktif.
f, --output-format <format>: Tentukan format output (text, json, stream-json).
c, --continue <file>: Lanjutkan percakapan sebelumnya dari file.
-verbose: Aktifkan logging verbose untuk debugging.
-agentic-turns <n>: Batasi jumlah giliran agen.
-system <prompt>: Timpa prompt sistem default.
-allow-tool <tool> dan -disallow-tool <tool>: Kontrol akses ke alat eksternal.

TypeScript SDK: Membangun Aplikasi Bertenaga AI Modern

TypeScript SDK sangat cocok untuk mengintegrasikan Claude Code ke dalam aplikasi web, layanan backend, atau proyek berbasis Node.js apa pun.

Instalasi:

Bash

npm install @anthropic-ai/claude-code

Penggunaan Dasar:

`import { claudeCode } from '@anthropic-ai/claude-code';
async function main() { const result = await claudeCode({ prompt: 'Write a TypeScript interface for a User', }); console.log(result.stdout); }
main();`

Argumen Tambahan:

TypeScript SDK menerima semua argumen yang didukung oleh CLI, bersama dengan beberapa argumen tambahan lainnya:

abortController: Sebuah AbortController untuk membatalkan permintaan.
cwd: Direktori kerja saat ini.
executable: Jalur ke executable Claude Code.
executableArgs: Argumen tambahan untuk diteruskan ke executable.

Python SDK: Melepaskan AI di Ekosistem Python

Pengembang Python dapat memanfaatkan claude-code-sdk untuk mengintegrasikan kemampuan Claude Code ke dalam skrip dan aplikasi mereka.

Instalasi:

Bash

pip install claude-code-sdk

Prasyarat:

Python SDK membutuhkan Python 3.10 atau yang lebih baru, Node.js, dan Claude Code CLI harus diinstal.

Penggunaan Dasar:

import anyio
from claude_code_sdk import query, ClaudeCodeOptions, Message

async def main():
    messages: list[Message] = []
    
    async for message in query(
        prompt="Write a haiku about foo.py",
        options=ClaudeCodeOptions(max_turns=3)
    ):
        messages.append(message)
    
    print(messages)

anyio.run(main)

Kelas ClaudeCodeOptions memungkinkan Anda menentukan semua argumen baris perintah yang didukung secara terstruktur.

Fitur Canggih: Mendorong Batas Pengembangan Berbantuan AI

Di luar dasar-dasar, Claude Code SDK menawarkan berbagai fitur canggih yang membuka kemampuan yang lebih kuat lagi.

Percakapan Multi-Giliran: Mempertahankan Konteks

Banyak tugas pengembangan memerlukan dialog bolak-balik. Dukungan SDK untuk percakapan multi-giliran memungkinkan Anda membangun aplikasi yang dapat mempertahankan konteks dan memiliki nuansa yang lebih alami dan interaktif. Anda dapat melanjutkan atau meneruskan percakapan dengan menyediakan riwayat percakapan, memungkinkan Claude Code mengingat interaksi sebelumnya dan memberikan respons yang lebih relevan.

Prompt Sistem Kustom: Memandu Perilaku Claude

Prompt sistem adalah sekumpulan instruksi yang diberikan kepada model AI untuk memandu perilakunya. Claude Code SDK memungkinkan Anda memberikan prompt sistem kustom, memungkinkan Anda menyesuaikan respons Claude Code dengan kebutuhan spesifik Anda. Misalnya, Anda dapat memberikan prompt sistem yang menginstruksikan Claude Code untuk selalu menghasilkan kode dalam gaya tertentu, bertindak sebagai pengembang senior yang memberikan tinjauan kode, atau menjelaskan konsep dengan cara yang mudah dipahami oleh pemula.

Model Context Protocol (MCP): Memperluas Kemampuan Claude

Model Context Protocol (MCP) adalah fitur kuat yang memungkinkan Anda memperluas kemampuan Claude Code dengan menghubungkannya ke alat dan sumber daya eksternal. Ini dicapai dengan menjalankan server MCP yang dapat memberikan konteks tambahan kepada model. Untuk alasan keamanan, Anda harus secara eksplisit mengizinkan penggunaan alat MCP menggunakan flag --allowedTools. Ini membuka kemungkinan menarik untuk membuat alat pengembangan bertenaga AI yang sangat terspesialisasi dan kuat.

Aplikasi Praktis dan Praktik Terbaik: Dari Teori Menjadi Kenyataan

Kekuatan sebenarnya dari Claude Code SDK terwujud saat Anda mulai menerapkannya pada tantangan pengembangan dunia nyata.

Kasus Penggunaan Dunia Nyata:

Asisten Coding Bertenaga AI: Bangun asisten coding kustom yang terintegrasi langsung ke dalam IDE Anda, menyediakan penyelesaian kode, saran, dan penjelasan secara real-time.
Tinjauan Kode Otomatis: Integrasikan SDK ke dalam pipeline CI/CD Anda untuk mengotomatiskan tinjauan kode. Claude Code dapat memeriksa kesalahan umum, menyarankan perbaikan, dan memastikan bahwa kode baru mematuhi standar coding tim Anda.
Manajemen Pull Request dan Issue Otomatis: Gunakan SDK untuk membuat alat yang dapat secara otomatis menghasilkan pull request dari sekumpulan perubahan atau melakukan triase (penyortiran) issue yang masuk di repositori proyek Anda.

Praktik Terbaik:

Parsing Respons secara Terprogram: Saat menggunakan format output JSON, Anda dapat mengurai respons secara terprogram untuk mengekstrak informasi yang Anda butuhkan. Skema pesan memiliki tipe yang ketat, dan tipe tersedia di SDK Anthropic, membuat proses ini kuat dan andal.
Penanganan Kesalahan: Seperti halnya integrasi API apa pun, penanganan kesalahan yang kuat sangat penting. Terapkan mekanisme untuk menangani kesalahan jaringan, kesalahan API, dan masalah potensial lainnya.
Manajemen Sesi: Untuk aplikasi yang melibatkan percakapan multi-giliran, terapkan manajemen sesi yang tepat untuk melacak riwayat percakapan.
Timeout dan Rate Limit: Perhatikan batas laju API dan terapkan strategi backoff dan coba lagi yang sesuai. Tetapkan batas waktu yang wajar untuk permintaan Anda untuk mencegah aplikasi Anda macet.

Claude Code GitHub Actions: Contoh Potensi SDK

Contoh utama dari Claude Code SDK yang beraksi adalah Claude Code GitHub Actions. Kumpulan tindakan ini memungkinkan Anda mengotomatiskan berbagai tugas pengembangan langsung di dalam alur kerja GitHub Anda. Anda dapat menggunakannya untuk mengotomatiskan tinjauan kode, membuat pull request, dan melakukan triase issue, semuanya didukung oleh Claude Code. Ini adalah demonstrasi yang kuat tentang bagaimana SDK dapat digunakan untuk membuat alat praktis dan berharga yang dapat secara signifikan meningkatkan produktivitas tim pengembangan.

💡

Mencari kekuatan yang sama di backend API Anda?Apidog memungkinkan Anda membuat mock panggilan Claude, mensimulasikan kasus ekstrem, dan menghasilkan dokumen Swagger langsung—sempurna untuk membangun endpoint AI yang tidak akan rusak saat produksi.

Kesimpulan

Claude Code SDK lebih dari sekadar alat; ini adalah gerbang menuju era baru pengembangan perangkat lunak. Dengan menyediakan akses terprogram ke kekuatan Claude Code, Anthropic telah memberdayakan pengembang untuk membangun generasi berikutnya dari alat pengembangan berbantuan AI. Mulai dari utilitas baris perintah sederhana hingga asisten AI yang kompleks dan terintegrasi, kemungkinan hanya dibatasi oleh imajinasi Anda. Seiring model AI terus berkembang dan meningkat, peran alat seperti Claude Code SDK akan semakin penting, membentuk masa depan cara kita menulis, meninjau, dan memelihara perangkat lunak. Perjalanan baru saja dimulai, dan Claude Code SDK adalah tiket Anda untuk menjadi bagian dari revolusi menarik ini.