Blog

Panduan Pemula Kode Claude: Praktik Terbaik

Mark Ponomarev

Mark Ponomarev

20 June 2025

Panduan Pemula Kode Claude: Praktik Terbaik

Pengantar Pemrogram Pasangan AI Baru Anda

Selamat datang di masa depan pengembangan perangkat lunak. Kecerdasan buatan bukan lagi hanya konsep dari fiksi ilmiah; ini adalah alat praktis dan kuat yang dapat meningkatkan dan mempercepat alur kerja pengkodean harian kita. Di garis depan revolusi ini adalah Claude dari Anthropic, keluarga model AI canggih yang dirancang untuk membantu, tidak berbahaya, dan jujur. Ketika diterapkan pada pengkodean, Claude menjadi pemrogram pasangan yang sangat cakap, asisten yang tak kenal lelah, dan panduan yang berpengetahuan luas.

Panduan ini dirancang untuk pengembang yang siap melangkah lebih jauh dari sekadar "penyelesaian kode" sederhana dan merangkul pendekatan yang lebih kolaboratif, agentik, terhadap pengembangan yang dibantu AI. Kita akan menjelajahi praktik terbaik untuk menginstruksikan Claude, mengelola memorinya untuk tugas-tugas kompleks, dan menggunakan kekuatan penuh alat baris perintah claude-code.

Baik Anda ingin beradaptasi dengan basis kode baru lebih cepat, mengotomatiskan refactoring yang membosankan, atau melakukan brainstorming solusi arsitektur yang kompleks, prinsip dan alur kerja dalam panduan ini akan membantu Anda mengubah Claude dari chatbot sederhana menjadi anggota tim pengembangan Anda yang sangat diperlukan. Kami akan mensintesis wawasan dari dokumentasi resmi dan blog teknik Anthropic untuk memberikan tutorial yang komprehensif dan dapat ditindaklanjuti.

Mari kita mulai.

Bagian 1: Fondasi: Prinsip Inti untuk Pengkodean dengan Claude

💡
Ingin alat Pengujian API yang hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform Terintegrasi, All-in-One untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
button

Sebelum masuk ke alat dan alur kerja spesifik, penting untuk memahami prinsip-prinsip dasar berkomunikasi dengan model bahasa besar seperti Claude. Kualitas output Anda berbanding lurus dengan kualitas input Anda. Pikirkan ini kurang seperti kueri pencarian dan lebih seperti memberikan instruksi kepada pengembang junior yang sangat cerdas, sangat literal, tetapi tidak bisa membaca pikiran.

Bersikaplah Eksplisit dan Langsung

Ini adalah aturan emas. Instruksi yang tidak jelas menghasilkan hasil yang tidak jelas. Model Claude 4, khususnya, dilatih untuk mengikuti instruksi dengan presisi tinggi. Jangan berasumsi model tahu apa yang Anda inginkan; beri tahu dengan tepat.

Kurang efektif:

"Tulis fungsi untuk menangani unggahan pengguna."

Lebih efektif:

"Tulis fungsi Python menggunakan Flask yang menangani unggahan gambar multipart/form-data. Fungsi tersebut harus:
1. Menerima file hingga 5MB.
2. Hanya mengizinkan ekstensi .png dan .jpg.
3. Menyimpan file ke direktori '/uploads' dengan UUID sebagai nama filenya.
4. Mengembalikan respons JSON dengan URL file baru saat berhasil, atau pesan kesalahan saat gagal."

Jika Anda ingin Claude "melampaui harapan," Anda perlu memintanya. Frasa seperti "Sertakan fitur dan interaksi relevan sebanyak mungkin," atau "Melampaui dasar-dasar untuk menciptakan implementasi yang berfungsi penuh" dapat mendorong hasil yang lebih komprehensif.

Berikan Konteks dan Motivasi

Menjelaskan mengapa Anda meminta sesuatu membantu Claude memahami tujuan dan memberikan respons yang lebih sesuai. Konteks mengubah instruksi sederhana menjadi masalah yang harus dipecahkan.

Kurang efektif:

"JANGAN PERNAH menggunakan elipsis di output."

Lebih efektif:

"Output dari fungsi ini akan dibacakan oleh mesin text-to-speech untuk tujuan aksesibilitas. Oleh karena itu, Anda JANGAN PERNAH menggunakan elipsis (...) karena mesin tidak dapat mengucapkannya dengan benar. Mohon tulis kalimat lengkap."

Penjelasan ini memungkinkan Claude untuk menggeneralisasi. Sekarang ia memahami bahwa batasan tersebut terkait dengan sintesis ucapan dan akan lebih mungkin menghindari karakter atau pemformatan lain yang akan menyebabkan masalah serupa.

Gunakan Contoh Berkualitas Tinggi (Few-Shot Prompting)

Salah satu teknik paling ampuh adalah memberikan contoh format input dan output yang diinginkan. Ini dikenal sebagai few-shot prompting. Claude sangat baik dalam pengenalan pola dan akan menyesuaikan responsnya agar sesuai dengan gaya contoh Anda.

Manusia: Terjemahkan kamus Python berikut ke Java HashMap.

Python:
{'user_id': 123, 'username': 'claude', 'is_active': True}

Java:

Asisten:
import java.util.HashMap;

HashMap<String, Object> user = new HashMap<>();
user.put("user_id", 123);
user.put("username", "claude");
user.put("is_active", true);

Saat memberikan contoh, berhati-hatilah. Pastikan contoh Anda sangat sesuai dengan perilaku yang ingin Anda dorong dan tidak mengandung perilaku yang ingin Anda hindari.

Beri Claude Peran (System Prompts)

Menetapkan persona atau peran kepada Claude di awal percakapan menyiapkan panggung untuk semua interaksi berikutnya. Ini biasanya dilakukan menggunakan "system prompt."

Contoh:

"Anda adalah seorang ahli dalam keamanan siber dan praktik pengkodean yang aman. Saat Anda meninjau atau menulis kode, fokus utama Anda adalah mengidentifikasi dan memitigasi potensi kerentanan keamanan, seperti SQL injection, XSS, dan buffer overflows. Semua respons Anda harus dari perspektif ini."

Instruksi awal ini membingkai seluruh percakapan, memastikan respons Claude secara konsisten disaring melalui lensa seorang ahli keamanan.

Gunakan Tag XML untuk Struktur dan Kejelasan

Tag XML adalah cara fantastis untuk membatasi bagian-bagian berbeda dari prompt Anda, membuatnya lebih mudah bagi Claude untuk memahami struktur permintaan Anda. Anda dapat menggunakannya untuk memisahkan instruksi, konteks, contoh, dan kueri akhir.

Contoh:

<instructions>
Anda adalah pengembang Go ahli. Tugas Anda adalah melakukan refactor kode Go yang disediakan untuk meningkatkan kinerja dan keterbacaannya. Harap patuhi praktik Go idiomatik.
</instructions>

<go_code_to_refactor>
// ... kode Go yang disediakan ...
</go_code_to_refactor>

<output_format>
Harap berikan kode yang direfactor di dalam satu blok kode Go. Setelah blok kode, tambahkan bagian dalam tag <explanation> yang merinci perubahan spesifik yang Anda buat dan mengapa itu meningkatkan kode.
</output_format>

Pendekatan terstruktur ini tidak menyisakan ruang untuk ambiguitas dan membantu memandu Claude untuk menghasilkan respons yang diformat dengan sempurna.

Bagian 2: Mengelola Konteks dan Memori

Satu prompt itu kuat, tetapi pengembangan di dunia nyata melibatkan tugas yang mencakup banyak file, memerlukan pengetahuan historis, dan berkembang seiring waktu. Di sinilah mengelola "memori" Claude—jendela konteksnya—menjadi sangat penting.

Sistem Memori CLI claude-code: CLAUDE.md

Alat baris perintah claude-code memiliki sistem memori berbasis file yang brilian, dibangun di sekitar file khusus: CLAUDE.md. Claude secara otomatis membaca konten file ini dan menyertakannya dalam konteksnya di awal setiap sesi di direktori tersebut. Ini memberikan memori yang persisten dan spesifik proyek.

Ada tiga tempat utama di mana Anda dapat menempatkan file memori ini:

  1. Memori Proyek (./CLAUDE.md): Terletak di akar proyek Anda. Ini adalah lokasi yang paling umum. Anda harus memeriksa file ini ke Git agar instruksi, perintah, dan panduan gaya spesifik proyek dibagikan dengan seluruh tim Anda.
  2. Memori Pengguna (~/.claude/CLAUDE.md): Terletak di direktori home Anda. Konten file ini dimuat untuk semua proyek Anda. Ini sempurna untuk preferensi pribadi, seperti gaya pengkodean pilihan Anda atau pintasan alat kustom yang Anda gunakan di mana pun.
  3. Memori Direktori Induk/Anak: Claude secara rekursif mencari file CLAUDE.md. Jika Anda berada di subdirektori monorepo, ia akan memuat CLAUDE.md dari akar dan CLAUDE.md dari direktori saat ini. Ia juga akan memuat memori dari direktori anak sesuai permintaan saat Anda mulai berinteraksi dengan file di dalamnya.

Praktik Terbaik untuk CLAUDE.md

Anggap file CLAUDE.md Anda sebagai prompt yang dibuat dengan cermat yang terus Anda perbaiki.

Anda dapat melakukan bootstrap file ini dengan menjalankan /init di CLI claude-code, dan Anda dapat dengan cepat menambahkan memori baru selama sesi dengan memulai prompt Anda dengan simbol #. Untuk pengeditan yang lebih luas, cukup gunakan perintah /memory untuk membuka file di editor default Anda.

Teknik untuk Mengingat Konteks Panjang

Bahkan dengan CLAUDE.md, tugas kompleks dapat memenuhi jendela konteks. Penelitian dari Anthropic telah menunjukkan dua teknik ampuh untuk meningkatkan kemampuan Claude dalam mengingat informasi spesifik dari dokumen atau percakapan panjang:

Minta Kutipan Referensi: Sebelum menjawab pertanyaan tentang konteks besar, instruksikan Claude untuk terlebih dahulu menemukan dan mengekstrak kutipan atau cuplikan yang paling relevan dari teks yang disediakan yang mendukung jawabannya. Ini memaksa model untuk mendasarkan responsnya pada materi sumber. Anda bahkan dapat menggunakan tag XML <scratchpad> untuk ini.

<instructions>
Jawab pertanyaan pengguna berdasarkan dokumen yang disediakan. Sebelum Anda menulis jawaban akhir, gunakan <scratchpad> untuk menuliskan kutipan persis dari dokumen yang paling relevan dengan pertanyaan.
</instructions>

Berikan Contoh Dalam Konteks: Sama seperti dengan prompt pendek, memberikan beberapa contoh pertanyaan yang dijawab dengan benar tentang bagian lain dari dokumen secara dramatis meningkatkan kinerja. Ini mempersiapkan model untuk format tugas Q&A.

Terakhir, jangan lupakan perintah /clear di CLI claude-code. Jika Anda beralih antara tugas yang tidak terkait dalam sesi panjang, gunakan /clear untuk mengatur ulang jendela konteks dan memberi Claude awal yang baru, mencegah kebingungan dari percakapan masa lalu yang tidak relevan.

Bagian 3: Toolkit Pengguna Tingkat Lanjut: Penyelaman Mendalam ke dalam CLI claude-code

Meskipun prinsip-prinsip di atas berlaku untuk interaksi apa pun dengan Claude, antarmuka baris perintah claude-code membuka tingkat kekuatan dan integrasi baru. Ini adalah asisten pengkodean agentik yang hidup di terminal Anda, memahami basis kode Anda, dan dapat mengambil tindakan nyata.

Instalasi dan Penyiapan

Memulai itu mudah.

Persyaratan Sistem:

Instalasi:
Buka terminal Anda dan jalankan:

npm install -g @anthropic-ai/claude-code

Penting: Jangan gunakan sudo dengan perintah ini, karena dapat menyebabkan masalah izin. Jika Anda menemukan kesalahan, konsultasikan dokumentasi resmi untuk mengonfigurasi izin npm.

Autentikasi:
Pertama kali Anda menjalankan claude, ia akan memandu Anda melalui proses autentikasi. Anda dapat terhubung melalui akun Anthropic Console Anda, langganan Claude Pro, atau platform perusahaan seperti Amazon Bedrock dan Google Vertex AI.

Kustomisasi dan Konfigurasi

Claude Code dirancang untuk disesuaikan dengan keinginan Anda.

Bagian 4: Alur Kerja Praktis dalam Tindakan

Teori itu berharga, tetapi kekuatan sebenarnya dari Claude Code muncul ketika Anda menerapkannya pada tugas pengembangan sehari-hari yang praktis. Berikut adalah beberapa alur kerja yang telah teruji oleh insinyur di Anthropic dan lainnya.

Alur Kerja 1: Tanya Jawab Basis Kode (Onboarding)

Saat bergabung dengan proyek baru, memahami basis kode adalah rintangan pertama. Gunakan Claude sebagai pemandu pribadi Anda. Ajukan pertanyaan seperti yang Anda lakukan kepada pengembang senior.

Tidak diperlukan prompt khusus. Cukup bertanya. Claude akan secara agentik mencari di basis kode, membaca file yang relevan, dan mensintesis jawaban. Ini secara dramatis mempercepat waktu adaptasi.

Alur Kerja 2: Jelajahi, Rencanakan, Kodekan, Commit

Ini adalah alur kerja dasar yang serbaguna untuk menangani hampir semua fitur baru atau perbaikan bug.

  1. Jelajahi: Minta Claude untuk membaca file, gambar (seperti mockup UI), atau URL yang relevan. Yang krusial, instruksikan agar belum menulis kode apa pun. Tujuannya adalah pengumpulan informasi.
  2. Rencanakan: Minta Claude untuk membuat rencana terperinci, langkah demi langkah. Gunakan kata "pikirkan" untuk mendorong pertimbangan yang lebih mendalam (misalnya, "Pikirkan baik-baik dan buat rencana untuk mengimplementasikan fitur ini"). Tinjau rencana ini dengan cermat.
  3. Kodekan: Setelah Anda menyetujui rencana, instruksikan Claude untuk mengimplementasikan solusi. Sekarang ia akan menulis kode berdasarkan langkah-langkah yang disepakati.
  4. Commit: Setelah implementasi selesai dan diverifikasi, minta Claude untuk melakukan commit hasilnya, menulis pesan commit yang deskriptif, dan bahkan membuat pull request menggunakan CLI gh.

Melewatkan langkah "Jelajahi" dan "Rencanakan" adalah kesalahan umum. Memaksakan fase perencanaan secara signifikan meningkatkan kualitas dan tingkat keberhasilan kode akhir.

Alur Kerja 3: Test-Driven Development (TDD) dengan Claude

TDD dan pengkodean agentik adalah pasangan yang sempurna. Claude unggul ketika memiliki target yang jelas dan dapat diverifikasi untuk dikerjakan.

  1. Tulis Tes: Jelaskan fungsionalitas yang diinginkan dan minta Claude untuk menulis tes terlebih dahulu. Bersikaplah eksplisit: "Kita sedang melakukan TDD. Tulis tes untuk fungsi yang melakukan X. Tes ini harus gagal pada awalnya."
  2. Konfirmasi Kegagalan: Instruksikan Claude untuk menjalankan tes dan mengonfirmasi bahwa tes tersebut gagal seperti yang diharapkan.
  3. Commit Tes: Setelah Anda yakin tes tersebut menangkap persyaratan, minta Claude untuk melakukan commit.
  4. Tulis Kode: Sekarang, instruksikan Claude untuk menulis kode implementasi dengan tujuan membuat semua tes lulus. Beri tahu jangan memodifikasi tes. Claude kemungkinan akan berulang—menulis kode, menjalankan tes, menganalisis kegagalan, menyesuaikan kode, dan mengulang hingga berhasil.
  5. Commit Kode: Setelah semua tes lulus, minta Claude untuk melakukan commit implementasi akhir.

Alur Kerja 4: Alur Kerja Tingkat Lanjut dan Otomatis

Kesimpulan: Awal Perjalanan Anda

Kita telah melakukan perjalanan dari prinsip-prinsip dasar rekayasa prompt hingga alur kerja yang rumit dan kuat dari CLI claude-code. Anda sekarang dilengkapi dengan pengetahuan untuk mengubah cara Anda mengkode, beralih dari aktivitas soliter menjadi kolaborasi dinamis dengan salah satu sistem AI paling canggih di dunia.

Poin pentingnya adalah ini: jadilah kolaborator aktif. Pandu Claude, berikan konteks yang jelas, perbaiki ketika ia menyimpang, dan lengkapi dengan alat dan pengetahuan yang tepat melalui CLAUDE.md. Pengguna yang paling efektif tidak memperlakukan Claude sebagai kotak hitam ajaib; mereka memperlakukannya sebagai mitra cerdas.

Alur kerja dan teknik yang diuraikan di sini adalah titik awal. Kekuatan sejati akan terbuka saat Anda bereksperimen, mengadaptasi pola-pola ini dengan kebutuhan unik Anda, dan menemukan praktik terbaik Anda sendiri. Sekarang, buka terminal Anda, ketik claude, dan mulailah membangun masa depan.

💡
Ingin alat Pengujian API yang hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform Terintegrasi, All-in-One untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
button

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.

Daftar gratisUnduh