Kursus
Claude Code 101
3 jam
28.3K
Menggunakan Claude API dari Anthropic memungkinkan Anda melampaui sekadar mengobrol dengan chatbot. Ini memberi Anda kemampuan untuk mengintegrasikan seluruh kapabilitas Claude AI ke dalam aplikasi Anda.
Anthropic mengejutkan dunia AI dengan merilis Fable 5, model yang begitu andal hingga mendorong pemerintah AS untuk sementara membatasi akses tak lama setelah peluncuran. Meski kini model tersebut telah kembali tersedia untuk pengguna di seluruh dunia, cara kita mengaksesnya telah berubah.
Anthropic kini membatasi Fable 5 hanya untuk akses berbasis API melalui kredit penggunaan terukur (dengan batasan diberlakukan setelah perpanjangan lima hari).
Ini berarti kita harus memikirkan ulang cara berinteraksi dengan AI. Model berdaya tinggi dan alat pengkodean otomatis memerlukan sumber daya komputasi jauh lebih besar dibandingkan paket konsumen berbiaya tetap.
Dalam tutorial ini, saya akan mempersiapkan Anda menghadapi realitas baru ini dengan melihat cara menggunakan Claude API.
Saya akan mengajarkan Anda langkah demi langkah cara menyiapkan Claude Code dengan Anthropic Developer API. Dengan beralih ke model pay-as-you-go hari ini, Anda akan mendapatkan akses tanpa gangguan ke model mutakhir seperti Fable 5, menghilangkan batasan laju yang tidak terlihat, dan mempelajari cara menjalankan sesi pengkodean kompleks langsung dari terminal Anda.
Jika Anda mencari referensi cepat, saya sarankan melihat cheat sheet Claude API di Python.
Mengapa Anda Memerlukan Claude API Dibanding Langganan Claude Pro
Bagi banyak orang, paket Claude Pro senilai $20 per bulan adalah cara ideal untuk mengakses AI kelas atas. Paket ini menawarkan harga tetap dan akses stabil.
Namun, munculnya alat pengkodean otomatis benar-benar mengubah perhitungannya. Alur kerja agen memerlukan sumber daya jauh lebih besar daripada yang dapat disediakan langganan standar, sehingga Claude API menjadi satu-satunya opsi yang layak bagi pengembang serius.
Berikut tiga alasan utama untuk meninggalkan langganan dan menggunakan Claude Code langsung melalui API.
Kehabisan token akibat alat berbasis agen
Paket standar kesulitan menangani alat seperti Claude Code karena cara alat ini beroperasi.
Tidak seperti obrolan web sederhana, alat pengembang otomatis harus terus-menerus memindai seluruh proyek kita untuk memahami apa yang sedang dikerjakan.
Setiap kali kita memberinya tugas, ia melalui beberapa langkah: membaca file, memeriksa struktur, dan menjalankan pengujian. Ini memerlukan pengiriman data dalam jumlah besar bolak-balik untuk menjaga AI tetap terkini dengan status kode kita.
Proses ini sangat cepat menghabiskan token. Pada langganan Pro, alur kerja kompleks ini dapat menguras batas penggunaan beberapa jam hanya dalam beberapa menit, sehingga pekerjaan kita tiba-tiba terhenti.
Melindungi kapasitas penggunaan harian Anda
Akun Claude Pro menggunakan satu kumpulan sumber daya bersama. Jika kita menggunakan akun utama untuk pengkodean berbasis terminal, tugas otomatis yang berat tersebut akan mengurangi kapasitas yang kita miliki untuk aplikasi peramban atau seluler.
Kita tentu tidak ingin terkunci dari percakapan sederhana hanya karena tugas pengkodean latar belakang mencapai batas. Mengarahkan alat pengembangan Anda melalui Claude API menjaga pekerjaan pengkodean profesional benar-benar terpisah dari penggunaan AI sehari-hari.
Akses eksklusif ke model kelas berat
Saat Anthropic merilis model yang dibuat khusus untuk rekayasa berat dan pekerjaan otonom, seperti Claude Fable 5, mereka beralih dari paket berbiaya tetap.
Karena Fable 5 memerlukan daya komputasi yang sangat besar, Anthropic telah mengonfirmasi bahwa model khusus ini pada akhirnya akan memerlukan penagihan pay-per-use untuk mengelola biaya operasional yang tinggi.
Pembatasan ini adalah gambaran masa depan. Bertahan pada langganan konsumen berarti Anda pada akhirnya akan kehilangan akses ke mesin penalaran paling kuat dari Anthropic, menjadikan akun Claude API sebagai persyaratan mutlak untuk tetap berada di garis terdepan.
Claude API vs Langganan Claude
Perbedaan antara langganan konsumen dan developer API bermuara pada pertukaran antara biaya yang dapat diprediksi dan akses tanpa henti.
Langganan Claude memberi kita tarif bulanan tetap.
Kita bisa menggunakannya secara intens untuk sementara, dan pada akhirnya kita akan mencapai batas penggunaan dinamis berdasarkan beban server. Saat Claude Code menabrak dinding tak terlihat ini di tengah proyek, ia berhenti bekerja sepenuhnya.
Kita terpaksa menunggu beberapa jam hingga batas kita disetel ulang sebelum agen dapat menyelesaikan penulisan kode.
Claude API menghilangkan roda bantu ini. Tidak ada batas pesan per jam, tidak ada batas bandwidth bersama, dan tidak ada masa tunggu. Jika kita ingin Fable 5 melakukan refaktor basis kode masif selama delapan jam tanpa henti, API akan menjalankan setiap perintah tanpa gangguan.
Namun, kebebasan ini menghadirkan bahaya signifikan: pembengkakan anggaran. Menggunakan langganan mungkin membuat frustrasi saat mencapai batas, tetapi setidaknya kita tahu persis berapa tagihan kita di akhir bulan.
Ini sangat berbahaya dengan model mahal seperti Fable 5.
Manajemen biaya Claude API dan kontrol anggaran
Ada dua cara untuk mengontrol anggaran saat menggunakan API.
Pertama, pastikan fitur isi ulang otomatis dimatikan. Isi ulang otomatis akan memungkinkan Claude membeli kredit secara otomatis saat habis.
Karena penggunaan token saat menggunakan Claude Code sangat tidak terprediksi, saya sangat menyarankan untuk tidak mengaktifkannya.
Kedua, pilih model yang digunakan dengan cermat.
Fable 5 sangat mumpuni menyelesaikan tugas kompleks dan mengimplementasikan aplikasi rumit. Namun, sering kali berlebihan untuk tugas yang lebih sederhana.
Saya pribadi menyukai penggunaan model yang lebih murah dan hanya beralih ke model yang lebih mahal ketika model murah gagal menyelesaikan tugas setelah beberapa percobaan. Model yang paling sering saya gunakan justru Haiku 4.5.
Untuk memilih model, gunakan perintah /model.
Penyiapan Claude API Langkah demi Langkah (Menampilkan Fable 5)
Jika Anda mencari tutorial Claude Fable 5 API khusus, saya sarankan melihat panduan terpisah kami.
Untuk memulai, masuk ke platform web Claude dan atur penagihan. Selanjutnya, buka terminal dan instal Claude Code menggunakan perintah:
npm install -g @anthropic-ai/claude-codeSetelah terinstal, kita dapat menjalankannya dengan mengetik claude di terminal. Saat pertama kali berjalan, ia akan meminta kita untuk melakukan konfigurasi. Pastikan memilih “API usage billing” saat penyiapan:
Pada akhirnya, Claude akan membuka peramban dan meminta izin untuk menautkan akun kita serta membuat kunci API untuk kita. Klik “Authorize,” dan akun akan ditautkan secara otomatis.
Setelah penyiapan selesai, kita siap mulai membangun dengan Claude Code:
Dalam kasus saya, Claude Code sudah berjalan dengan Fable 5. Jika belum, kita dapat memilih model dengan menggunakan perintah /model dan memilih Fable 5 dari menu.
Ubah Claude Code dari langganan ke API
Bagi yang sudah menggunakan Claude Code dengan langganan dan ingin beralih ke penagihan penggunaan API, prosesnya sederhana.
- Keluar menggunakan perintah
/logout. - Jalankan kembali Claude Code menggunakan perintah
claudedan pilih metode masuk “Anthropic Console account · API usage billing”.
Jika kita kehabisan kredit saat Claude Code sedang mengimplementasikan suatu fitur, ia akan berhenti dan memberi tahu bahwa Anda perlu menambah kredit.
Setelah menambah kredit, jika Claude masih aktif, cukup minta untuk melanjutkan dengan prompt, dan ia akan meneruskan dari titik terakhir. Jika tidak berjalan, gunakan perintah claude --continue.
Membangun Proyek Dunia Nyata dengan Claude API
Fokus tutorial ini adalah mempelajari cara menyiapkan Claude Code dengan API, bukan memberikan tutorial mendetail tentang cara menggunakan Claude Code.
Jika Anda ingin mempelajari lebih lanjut, saya sarankan mendaftar di Kursus Claude Code 101 kami.
Gambaran proyek
Tujuan proyek ini adalah membangun aplikasi Python yang memungkinkan pengguna dengan mudah menemukan foto di komputer mereka.
Saat ini, orang mengambil banyak foto, dan sering kali berakhir tidak teratur serta tersebar di banyak lokasi. Bagi saya pribadi, sebagai fotografer, sering kali pusing mencari foto berbulan-bulan setelah diambil.
Gagasan di balik aplikasi ini adalah memungkinkan pengguna menemukan foto dengan mendeskripsikan isi foto atau memberikan tangkapan layar maupun referensi gambar.
Mode kedua ini sangat berguna bagi saya karena saya sering memublikasikan karya di media sosial, sehingga saya cukup mengambil tangkapan layar unggahan dan menemukan file asli berkualitas tinggi.
Kita bisa membiarkan Claude Code menentukan arsitektur proyek dan melakukan seluruh implementasi. Mungkin hasilnya akan baik-baik saja.
Namun demi tujuan edukasi, saya ingin menentukan arsitektur proyek sendiri dan membiarkan Claude Code fokus pada implementasi.
Arsitektur proyek dengan CLAUDE.md
Untuk membuat aplikasi ini, saya membuat file CLAUDE.md yang menjelaskan arsitektur proyek.
File CLAUDE.md adalah file konfigurasi Markdown khusus proyek yang dibaca Claude Code pada awal setiap sesi untuk menetapkan memori persisten tentang arsitektur, standar pengkodean, dan preferensi alur kerja Anda.
Aplikasi memiliki dua komponen utama:
- Proses pemasukan foto yang memungkinkan pengguna memilih folder berisi gambar, mengonversi gambar tersebut menjadi vektor, dan menyimpannya di basis data vektor.
- Input multimodal yang memungkinkan pengguna menelusuri basis data.
Untuk mengenkode gambar menjadi vektor, kita menggunakan model CLIP. Untuk basis data, kita menggunakan ChromaDB, yang berjalan secara lokal dan gratis.
Intuisi cara kerjanya adalah model CLIP dilatih untuk mengonversi teks dan gambar menjadi vektor (representasi numerik data) sehingga gambar yang tampak serupa atau memuat konsep serupa dipetakan berdekatan pada peta ini, sementara gambar yang tidak terkait didorong lebih jauh terpisah.
Saat kita ingin menemukan gambar, kita juga mengonversi kueri menjadi vektor kueri dan menggunakan ChromaDB untuk mencari vektor yang paling dekat dengan vektor kueri.
Jika Anda ingin mempelajari lebih lanjut tentang basis data vektor, lihat Tutorial ChromaDB: Panduan Langkah demi Langkah ini.
Prompt
Dengan arsitektur proyek yang ditentukan dalam file CLAUDE.md, saya memulai terminal di folder tersebut dan memberi Claude Code yang menjalankan model Fable 5 prompt berikut:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. Hasilnya
Saya mengirimkan prompt dan membiarkan Claude Code bekerja. Setelah sekitar tujuh menit, selesai.
Saya menjalankan aplikasinya, dan beginilah tampilannya:
Saya mengunggah beberapa gambar yang saya ambil tahun ini lalu membuka Instagram dan mengambil tangkapan layar salah satu unggahan saya untuk digunakan sebagai gambar referensi.
Saya sengaja menyertakan seluruh UI untuk mempersulit aplikasi menemukan gambar sumber. Berikut hasilnya:
Harus saya akui, hasilnya cukup baik, dan antarmukanya persis seperti yang saya bayangkan. Saya juga mengujinya dengan penelusuran teks untuk mencari foto Taipei 101, gedung tertinggi di Taiwan.
Berikut hasilnya:
Penggunaan token Claude API dan biaya dunia nyata
Secara total, membuat proyek ini menelan biaya $3,65 token API. Kita bisa mendapatkan rincian biaya sesi menggunakan perintah /cost:
Menariknya, kita melihat bahwa ia juga menggunakan claude-haiku-4.5 untuk sebagian pekerjaan.
Ini menunjukkan bahwa Fable 5 cukup mahal.
Sesi tujuh menit pada proyek kosong saja sudah menghabiskan $3,65.
Jadi saya hanya bisa membayangkan berapa biaya menggunakan Fable 5 pada proyek yang sudah ada dengan ratusan file kode.
Tentu saja, di dunia nyata, saat membangun aplikasi yang juga menghasilkan pendapatan, biaya ini perlu dievaluasi secara berbeda karena menjadi investasi.
Fitur Lanjutan Claude API yang Perlu Anda Ketahui
Beralih ke API membuka akses alat yang tidak ditawarkan Claude.ai: prompt caching, pemrosesan batch, dan integrasi tool.
Jika Anda menggunakan Claude Code, mengarahkan volume panggilan API tinggi, atau membangun sistem agen yang berinteraksi dengan layanan eksternal, inilah fitur yang paling langsung memengaruhi biaya dan latensi.
1. Prompt caching (pengurangan biaya)
Prompt caching menyimpan bagian statis dari jendela konteks Anda di sisi server antar panggilan API, sehingga Anda berhenti membayar untuk memroses ulang konten yang sama pada setiap permintaan.
Jika Anda bekerja dengan Claude Code, kemungkinan Anda mengirim konteks besar yang sama pada setiap panggilan (file CLAUDE.md, ringkasan basis kode, atau system prompt yang panjang). Menurut dokumentasi caching Anthropic, prefix yang di-cache mengurangi biaya input hingga 90% dan mempercepat time-to-first-token karena prefix melewati proses pemasukan ulang.
Permintaan pertama membayar harga input penuh. Setiap panggilan berikutnya yang mengenai prefix cache yang sama ditagih dengan tarif yang lebih rendah.
2. Batch API (pemrosesan asinkron)
Batch API menangani beban kerja yang tidak memerlukan respons waktu nyata.
Memproses 10.000 tiket dukungan pelanggan, menghasilkan dokumentasi untuk seluruh basis kode, atau menjalankan evaluasi pada set uji besar: semuanya cocok untuk batch. Anthropic memberi harga permintaan batch sebesar 50% dari biaya token input dan output standar, dan seluruh pekerjaan dikirim dalam satu panggilan API alih-alih mengharuskan Anda mengelola antrean.
Kendalanya adalah pekerjaan batch memerlukan hingga 24 jam untuk selesai, dan hasilnya datang sekaligus, tidak di-stream. Ini baik untuk pipeline offline, tetapi tidak cocok untuk aplikasi yang menghadap pengguna.
3. Penggunaan tool dan Model Context Protocol (MCP)
Penggunaan tool (kadang disebut function calling) memungkinkan Claude memanggil fungsi eksternal selama proses generasi dan memasukkan hasilnya ke dalam respons.
Anda mendefinisikan tool yang tersedia dalam format skema JSON; Claude memutuskan kapan memanggilnya, argumen apa yang diberikan, dan apa yang dilakukan dengan keluarannya. Dengan demikian Claude dapat menanyakan basis data, memanggil REST API, atau menjalankan skrip Python tanpa Anda menentukan titik pemanggilan tepat dalam prompt.
Model Context Protocol (MCP) memperluas ini dengan antarmuka server standar: alih-alih mendefinisikan tool per proyek, Claude terhubung ke server MCP lokal yang mengekspos akses file, eksekusi kode, atau pembacaan basis data.
Computer Use API bekerja secara berbeda. Claude menafsirkan tangkapan layar dan mengeluarkan event keyboard serta mouse, menavigasi antarmuka tanpa akses API terprogram ke aplikasi yang mendasarinya.
Kesimpulan
Beralih ke Claude API adalah langkah yang diperlukan untuk menjalankan alat pengembangan otomatis, tetapi memerlukan perubahan cara kita mengelola proyek.
Fable 5 tidak diragukan lagi adalah model pengkodean yang luar biasa, mampu menghasilkan aplikasi kompleks yang benar-benar berfungsi hanya dari satu prompt.
Kemampuan penalarannya dapat mengubah visi arsitektur menjadi kenyataan fungsional dalam hitungan menit, yang sungguh mengesankan.
Namun, menggunakan Claude API untuk tingkat kekuatan ini ada harganya. Karena model seperti Fable 5 sangat mahal untuk dioperasikan, sangat penting untuk bersikap strategis dalam pemilihan model.
Saya menyarankan mengandalkan model yang lebih murah dan efisien untuk tugas rutin dan menyimpan Fable 5 untuk saat Anda menghadapi hambatan nyata atau tantangan arsitektur kompleks yang memerlukan penalaran lebih dalam.
Seperti yang kita lihat pada proyek kita, bahkan untuk aplikasi sederhana satu file, biaya token API dapat cepat bertambah. Lindungi anggaran Anda dengan memantau penggunaan secara cermat dan, yang terpenting, menonaktifkan isi ulang otomatis agar sesi pengkodean otomatis tidak menguras anggaran Anda.
Jika Anda ingin mempelajari lebih lanjut tentang ekosistem Claude, saya sarankan melihat kursus Claude 101 kami.
