Tutorial
Contoh praktis dan pola untuk menggunakan Claude Code secara efektif dalam alur kerja pengembangan Anda.
Panduan ini menyediakan tutorial langkah demi langkah untuk alur kerja umum dengan Claude Code. Setiap tutorial mencakup instruksi yang jelas, contoh perintah, dan praktik terbaik untuk membantu Anda mendapatkan hasil maksimal dari Claude Code.
Daftar isi
- Melanjutkan percakapan sebelumnya
- Memahami basis kode baru
- Memperbaiki bug secara efisien
- Refaktor kode
- Bekerja dengan pengujian
- Membuat pull request
- Menangani dokumentasi
- Bekerja dengan gambar
- Menggunakan pemikiran yang diperluas
- Menyiapkan memori proyek
- Menyiapkan Model Context Protocol (MCP)
- Menggunakan Claude sebagai utilitas gaya unix
- Membuat perintah slash kustom
- Menjalankan sesi Claude Code paralel dengan Git worktrees
Melanjutkan percakapan sebelumnya
Lanjutkan pekerjaan Anda dengan lancar
Kapan digunakan: Anda telah bekerja pada tugas dengan Claude Code dan perlu melanjutkan dari tempat Anda berhenti di sesi berikutnya.
Claude Code menyediakan dua opsi untuk melanjutkan percakapan sebelumnya:
--continue
untuk secara otomatis melanjutkan percakapan terbaru--resume
untuk menampilkan pemilih percakapan
Lanjutkan percakapan terbaru
Ini segera melanjutkan percakapan terbaru Anda tanpa prompt apa pun.
Lanjutkan dalam mode non-interaktif
Gunakan --print
dengan --continue
untuk melanjutkan percakapan terbaru dalam mode non-interaktif, sempurna untuk skrip atau otomatisasi.
Tampilkan pemilih percakapan
Ini menampilkan pemilih percakapan interaktif yang menunjukkan:
- Waktu mulai percakapan
- Prompt awal atau ringkasan percakapan
- Jumlah pesan
Gunakan tombol panah untuk menavigasi dan tekan Enter untuk memilih percakapan.
Cara kerjanya:
- Penyimpanan Percakapan: Semua percakapan secara otomatis disimpan secara lokal dengan riwayat pesan lengkap
- Deserialisasi Pesan: Saat melanjutkan, seluruh riwayat pesan dipulihkan untuk mempertahankan konteks
- Status Alat: Penggunaan alat dan hasil dari percakapan sebelumnya dipertahankan
- Pemulihan Konteks: Percakapan dilanjutkan dengan semua konteks sebelumnya tetap utuh
Tips:
- Riwayat percakapan disimpan secara lokal di mesin Anda
- Gunakan
--continue
untuk akses cepat ke percakapan terbaru Anda - Gunakan
--resume
ketika Anda perlu memilih percakapan masa lalu tertentu - Saat melanjutkan, Anda akan melihat seluruh riwayat percakapan sebelum melanjutkan
- Percakapan yang dilanjutkan dimulai dengan model dan konfigurasi yang sama dengan yang asli
Contoh:
Memahami basis kode baru
Dapatkan gambaran umum basis kode dengan cepat
Kapan digunakan: Anda baru saja bergabung dengan proyek baru dan perlu memahami strukturnya dengan cepat.
Navigasi ke direktori root proyek
Mulai Claude Code
Minta gambaran umum tingkat tinggi
Telusuri komponen tertentu lebih dalam
Tips:
- Mulai dengan pertanyaan luas, kemudian persempit ke area tertentu
- Tanyakan tentang konvensi pengkodean dan pola yang digunakan dalam proyek
- Minta glosarium istilah khusus proyek
Temukan kode yang relevan
Kapan digunakan: Anda perlu menemukan kode yang terkait dengan fitur atau fungsionalitas tertentu.
Minta Claude untuk menemukan file yang relevan
Dapatkan konteks tentang bagaimana komponen berinteraksi
Pahami alur eksekusi
Tips:
- Bersikaplah spesifik tentang apa yang Anda cari
- Gunakan bahasa domain dari proyek
Memperbaiki bug secara efisien
Mendiagnosis pesan kesalahan
Kapan digunakan: Anda telah menemukan pesan kesalahan dan perlu menemukan dan memperbaiki sumbernya.
Bagikan kesalahan dengan Claude
Minta rekomendasi perbaikan
Terapkan perbaikan
Tips:
- Beri tahu Claude perintah untuk mereproduksi masalah dan dapatkan stack trace
- Sebutkan langkah-langkah untuk mereproduksi kesalahan
- Beri tahu Claude jika kesalahan bersifat intermiten atau konsisten
Refaktor kode
Modernisasi kode lama
Kapan digunakan: Anda perlu memperbarui kode lama untuk menggunakan pola dan praktik modern.
Identifikasi kode lama untuk refaktor
Dapatkan rekomendasi refaktor
Terapkan perubahan dengan aman
Verifikasi refaktor
Tips:
- Minta Claude untuk menjelaskan manfaat pendekatan modern
- Minta agar perubahan mempertahankan kompatibilitas mundur jika diperlukan
- Lakukan refaktor dalam peningkatan kecil yang dapat diuji
Bekerja dengan pengujian
Tambahkan cakupan pengujian
Kapan digunakan: Anda perlu menambahkan pengujian untuk kode yang belum tercakup.
Identifikasi kode yang belum diuji
Buat kerangka pengujian
Tambahkan kasus pengujian yang bermakna
Jalankan dan verifikasi pengujian
Tips:
- Minta pengujian yang mencakup kasus tepi dan kondisi kesalahan
- Minta pengujian unit dan integrasi bila sesuai
- Minta Claude menjelaskan strategi pengujian
Membuat pull request
Buat PR yang komprehensif
Kapan digunakan: Anda perlu membuat pull request yang terdokumentasi dengan baik untuk perubahan Anda.
Ringkas perubahan Anda
Buat PR dengan Claude
Tinjau dan perbaiki
Tambahkan detail pengujian
Tips:
- Minta Claude secara langsung untuk membuat PR untuk Anda
- Tinjau PR yang dibuat Claude sebelum mengirimkannya
- Minta Claude untuk menyoroti potensi risiko atau pertimbangan
Menangani dokumentasi
Buat dokumentasi kode
Kapan digunakan: Anda perlu menambah atau memperbarui dokumentasi untuk kode Anda.
Identifikasi kode yang tidak terdokumentasi
Buat dokumentasi
Tinjau dan tingkatkan
Verifikasi dokumentasi
Tips:
- Tentukan gaya dokumentasi yang Anda inginkan (JSDoc, docstrings, dll.)
- Minta contoh dalam dokumentasi
- Minta dokumentasi untuk API publik, antarmuka, dan logika kompleks
Bekerja dengan gambar
Analisis gambar dan tangkapan layar
Kapan digunakan: Anda perlu bekerja dengan gambar dalam basis kode Anda atau mendapatkan bantuan Claude untuk menganalisis konten gambar.
Tambahkan gambar ke percakapan
Anda dapat menggunakan salah satu metode ini:
- Seret dan lepas gambar ke jendela Claude Code
- Salin gambar dan tempel ke CLI dengan cmd+v (di Mac)
- Berikan jalur gambar claude “Analyze this image: /path/to/your/image.png”
Minta Claude untuk menganalisis gambar
Gunakan gambar untuk konteks
Dapatkan saran kode dari konten visual
Tips:
- Gunakan gambar ketika deskripsi teks akan tidak jelas atau rumit
- Sertakan tangkapan layar kesalahan, desain UI, atau diagram untuk konteks yang lebih baik
- Anda dapat bekerja dengan beberapa gambar dalam satu percakapan
- Analisis gambar berfungsi dengan diagram, tangkapan layar, mockup, dan lainnya
Menggunakan pemikiran yang diperluas
Manfaatkan pemikiran diperluas Claude untuk tugas kompleks
Kapan digunakan: Saat bekerja pada keputusan arsitektur yang kompleks, bug yang menantang, atau merencanakan implementasi multi-langkah yang memerlukan penalaran mendalam.
Berikan konteks dan minta Claude untuk berpikir
Claude akan mengumpulkan informasi relevan dari basis kode Anda dan menggunakan pemikiran diperluas, yang akan terlihat di antarmuka.
Perhalus pemikiran dengan prompt lanjutan
Tips untuk mendapatkan nilai maksimal dari pemikiran diperluas:
Pemikiran diperluas paling berharga untuk tugas kompleks seperti:
- Merencanakan perubahan arsitektur yang kompleks
- Men-debug masalah rumit
- Membuat rencana implementasi untuk fitur baru
- Memahami basis kode yang kompleks
- Mengevaluasi pertukaran antara pendekatan yang berbeda
Cara Anda meminta pemikiran menghasilkan tingkat kedalaman pemikiran yang bervariasi:
- “think” memicu pemikiran diperluas dasar
- frasa intensifikasi seperti “think more”, “think a lot”, “think harder”, atau “think longer” memicu pemikiran yang lebih dalam
Untuk tips prompting pemikiran diperluas lainnya, lihat Tips pemikiran diperluas.
Claude akan menampilkan proses berpikirnya sebagai teks abu-abu miring di atas respons.
Menyiapkan memori proyek
Buat file CLAUDE.md yang efektif
Kapan digunakan: Anda ingin menyiapkan file CLAUDE.md untuk menyimpan informasi proyek penting, konvensi, dan perintah yang sering digunakan.
Bootstrap CLAUDE.md untuk basis kode Anda
Tips:
- Sertakan perintah yang sering digunakan (build, test, lint) untuk menghindari pencarian berulang
- Dokumentasikan preferensi gaya kode dan konvensi penamaan
- Tambahkan pola arsitektur penting yang spesifik untuk proyek Anda
- Memori CLAUDE.md dapat digunakan untuk instruksi yang dibagikan dengan tim Anda dan untuk preferensi individual Anda. Untuk detail lebih lanjut, lihat Mengelola memori Claude.
Menyiapkan Model Context Protocol (MCP)
Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan LLM mengakses alat eksternal dan sumber data. Untuk detail lebih lanjut, lihat dokumentasi MCP.
Gunakan server MCP pihak ketiga dengan risiko Anda sendiri. Pastikan Anda mempercayai server MCP, dan berhati-hatilah terutama saat menggunakan server MCP yang berkomunikasi dengan internet, karena ini dapat membuat Anda rentan terhadap risiko injeksi prompt.
Konfigurasi server MCP
Kapan digunakan: Anda ingin meningkatkan kemampuan Claude dengan menghubungkannya ke alat khusus dan server eksternal menggunakan Model Context Protocol.
Tambahkan Server MCP Stdio
Tambahkan Server MCP SSE
Kelola server MCP Anda
Tips:
- Gunakan flag
-s
atau--scope
untuk menentukan di mana konfigurasi disimpan:local
(default): Hanya tersedia untuk Anda di proyek saat ini (disebutproject
di versi lama)project
: Dibagikan dengan semua orang di proyek melalui file.mcp.json
user
: Tersedia untuk Anda di semua proyek (disebutglobal
di versi lama)
- Atur variabel lingkungan dengan flag
-e
atau--env
(misalnya,-e KEY=value
) - Konfigurasikan batas waktu startup server MCP menggunakan variabel lingkungan MCP_TIMEOUT (misalnya,
MCP_TIMEOUT=10000 claude
menetapkan batas waktu 10 detik) - Periksa status server MCP kapan saja menggunakan perintah
/mcp
dalam Claude Code - MCP mengikuti arsitektur klien-server di mana Claude Code (klien) dapat terhubung ke beberapa server khusus
Memahami cakupan server MCP
Kapan digunakan: Anda ingin memahami bagaimana cakupan MCP yang berbeda bekerja dan bagaimana berbagi server dengan tim Anda.
Server MCP dengan cakupan lokal
Cakupan default (local
) menyimpan konfigurasi server MCP di pengaturan pengguna khusus proyek Anda. Server-server ini hanya tersedia untuk Anda saat bekerja di proyek saat ini.
Server MCP dengan cakupan proyek (.mcp.json)
Server dengan cakupan proyek disimpan dalam file .mcp.json
di root proyek Anda. File ini harus dimasukkan ke dalam kontrol versi untuk berbagi server dengan tim Anda.
Ini membuat atau memperbarui file .mcp.json
dengan struktur berikut:
Server MCP dengan cakupan pengguna
Server dengan cakupan pengguna tersedia untuk Anda di semua proyek di mesin Anda, dan bersifat pribadi untuk Anda.
Tips:
- Server dengan cakupan lokal lebih diutamakan daripada server dengan cakupan proyek dan pengguna dengan nama yang sama
- Server dengan cakupan proyek (dalam
.mcp.json
) lebih diutamakan daripada server dengan cakupan pengguna dengan nama yang sama - Sebelum menggunakan server dengan cakupan proyek dari
.mcp.json
, Claude Code akan meminta Anda untuk menyetujuinya demi keamanan - File
.mcp.json
dimaksudkan untuk dimasukkan ke dalam kontrol versi untuk berbagi server MCP dengan tim Anda - Server dengan cakupan proyek memudahkan untuk memastikan semua orang di tim Anda memiliki akses ke alat MCP yang sama
- Jika Anda perlu mengatur ulang pilihan Anda untuk server dengan cakupan proyek mana yang diaktifkan atau dinonaktifkan, gunakan perintah
claude mcp reset-project-choices
Hubungkan ke server MCP Postgres
Kapan digunakan: Anda ingin memberi Claude akses hanya-baca ke database PostgreSQL untuk kueri dan inspeksi skema.
Tambahkan server MCP Postgres
Kueri database Anda dengan Claude
Tips:
- Server MCP Postgres menyediakan akses hanya-baca untuk keamanan
- Claude dapat membantu Anda mengeksplorasi struktur database dan menjalankan kueri analitis
- Anda dapat menggunakan ini untuk dengan cepat memahami skema database dalam proyek yang tidak familiar
- Pastikan string koneksi Anda menggunakan kredensial yang sesuai dengan izin minimum yang diperlukan
Tambahkan server MCP dari konfigurasi JSON
Kapan digunakan: Anda memiliki konfigurasi JSON untuk satu server MCP yang ingin Anda tambahkan ke Claude Code.
Tambahkan server MCP dari JSON
Verifikasi server telah ditambahkan
Tips:
- Pastikan JSON diloloskan dengan benar di shell Anda
- JSON harus sesuai dengan skema konfigurasi server MCP
- Anda dapat menggunakan
-s global
untuk menambahkan server ke konfigurasi global Anda alih-alih konfigurasi khusus proyek
Impor server MCP dari Claude Desktop
Kapan digunakan: Anda telah mengonfigurasi server MCP di Claude Desktop dan ingin menggunakan server yang sama di Claude Code tanpa mengonfigurasi ulang secara manual.
Impor server dari Claude Desktop
Pilih server mana yang akan diimpor
Setelah menjalankan perintah, Anda akan melihat dialog interaktif yang memungkinkan Anda memilih server mana yang ingin Anda impor.
Verifikasi server telah diimpor
Tips:
- Fitur ini hanya berfungsi di macOS dan Windows Subsystem for Linux (WSL)
- Ini membaca file konfigurasi Claude Desktop dari lokasi standarnya di platform tersebut
- Gunakan flag
-s global
untuk menambahkan server ke konfigurasi global Anda - Server yang diimpor akan memiliki nama yang sama seperti di Claude Desktop
- Jika server dengan nama yang sama sudah ada, mereka akan mendapatkan akhiran numerik (misalnya,
server_1
)
Gunakan Claude Code sebagai server MCP
Kapan digunakan: Anda ingin menggunakan Claude Code itu sendiri sebagai server MCP yang dapat dihubungkan oleh aplikasi lain, menyediakan mereka dengan alat dan kemampuan Claude.
Mulai Claude sebagai server MCP
Hubungkan dari aplikasi lain
Anda dapat terhubung ke server MCP Claude Code dari klien MCP mana pun, seperti Claude Desktop. Jika Anda menggunakan Claude Desktop, Anda dapat menambahkan server MCP Claude Code menggunakan konfigurasi ini:
Tips:
- Server menyediakan akses ke alat Claude seperti View, Edit, LS, dll.
- Di Claude Desktop, coba minta Claude untuk membaca file dalam direktori, membuat edit, dan lainnya.
- Perhatikan bahwa server MCP ini hanya mengekspos alat Claude Code ke klien MCP Anda, sehingga klien Anda sendiri bertanggung jawab untuk mengimplementasikan konfirmasi pengguna untuk panggilan alat individual.
Menggunakan Claude sebagai utilitas gaya unix
Tambahkan Claude ke proses verifikasi Anda
Kapan digunakan: Anda ingin menggunakan Claude Code sebagai linter atau peninjau kode.
Langkah-langkah:
Tambahkan Claude ke skrip build Anda
Pipe in, pipe out
Kapan digunakan: Anda ingin menyalurkan data ke Claude, dan mendapatkan kembali data dalam format terstruktur.
Salurkan data melalui Claude
Kontrol format output
Kapan digunakan: Anda memerlukan output Claude dalam format tertentu, terutama saat mengintegrasikan Claude Code ke dalam skrip atau alat lain.
Gunakan format teks (default)
Ini menghasilkan hanya respons teks biasa Claude (perilaku default).
Gunakan format JSON
Ini menghasilkan array JSON dari pesan dengan metadata termasuk biaya dan durasi.
Gunakan format JSON streaming
Ini menghasilkan serangkaian objek JSON secara real-time saat Claude memproses permintaan. Setiap pesan adalah objek JSON yang valid, tetapi seluruh output bukan JSON yang valid jika digabungkan.
Tips:
- Gunakan
--output-format text
untuk integrasi sederhana di mana Anda hanya memerlukan respons Claude - Gunakan
--output-format json
ketika Anda memerlukan log percakapan lengkap - Gunakan
--output-format stream-json
untuk output real-time dari setiap giliran percakapan
Membuat perintah slash kustom
Claude Code mendukung perintah slash kustom yang dapat Anda buat untuk dengan cepat menjalankan prompt atau tugas tertentu.
Buat perintah khusus proyek
Kapan digunakan: Anda ingin membuat perintah slash yang dapat digunakan kembali untuk proyek Anda yang dapat digunakan oleh semua anggota tim.
Buat direktori perintah di proyek Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom Anda di Claude Code
Tips:
- Nama perintah berasal dari nama file (misalnya,
optimize.md
menjadi/project:optimize
) - Anda dapat mengatur perintah dalam subdirektori (misalnya,
.claude/commands/frontend/component.md
menjadi/project:frontend:component
) - Perintah proyek tersedia untuk semua orang yang mengkloning repositori
- Konten file Markdown menjadi prompt yang dikirim ke Claude ketika perintah dijalankan
Tambahkan argumen perintah dengan $ARGUMENTS
Kapan digunakan: Anda ingin membuat perintah slash fleksibel yang dapat menerima input tambahan dari pengguna.
Buat file perintah dengan placeholder $ARGUMENTS
Gunakan perintah dengan nomor masalah
Ini akan mengganti $ARGUMENTS dengan “123” dalam prompt.
Tips:
- Placeholder $ARGUMENTS diganti dengan teks apa pun yang mengikuti perintah
- Anda dapat memposisikan $ARGUMENTS di mana saja dalam template perintah Anda
- Aplikasi berguna lainnya: menghasilkan kasus uji untuk fungsi tertentu, membuat dokumentasi untuk komponen, meninjau kode dalam file tertentu, atau menerjemahkan konten ke bahasa yang ditentukan
Buat perintah slash pribadi
Kapan digunakan: Anda ingin membuat perintah slash pribadi yang berfungsi di semua proyek Anda.
Buat direktori perintah di folder home Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom pribadi Anda
Tips:
- Perintah pribadi diawali dengan
/user:
alih-alih/project:
- Perintah pribadi hanya tersedia untuk Anda dan tidak dibagikan dengan tim Anda
- Perintah pribadi berfungsi di semua proyek Anda
- Anda dapat menggunakan ini untuk alur kerja yang konsisten di berbagai basis kode
Menjalankan sesi Claude Code paralel dengan Git worktrees
Gunakan worktrees untuk lingkungan pengkodean yang terisolasi
Kapan digunakan: Anda perlu bekerja pada beberapa tugas secara bersamaan dengan isolasi kode lengkap antara instance Claude Code.
Memahami Git worktrees
Git worktrees memungkinkan Anda untuk checkout beberapa cabang dari repositori yang sama ke dalam direktori terpisah. Setiap worktree memiliki direktori kerja sendiri dengan file terisolasi, sambil berbagi riwayat Git yang sama. Pelajari lebih lanjut di dokumentasi Git worktree resmi.
Buat worktree baru
Ini membuat direktori baru dengan salinan kerja terpisah dari repositori Anda.
Jalankan Claude Code di setiap worktree
Di terminal lain:
Kelola worktree Anda
Tips:
- Setiap worktree memiliki status file independen sendiri, menjadikannya sempurna untuk sesi Claude Code paralel
- Perubahan yang dibuat di satu worktree tidak akan memengaruhi yang lain, mencegah instance Claude saling mengganggu
- Semua worktree berbagi riwayat Git dan koneksi remote yang sama
- Untuk tugas yang berjalan lama, Anda dapat memiliki Claude bekerja di satu worktree sementara Anda melanjutkan pengembangan di worktree lain
- Gunakan nama direktori deskriptif untuk dengan mudah mengidentifikasi tugas mana yang untuk setiap worktree
- Ingat untuk menginisialisasi lingkungan pengembangan Anda di setiap worktree baru sesuai dengan pengaturan proyek Anda. Tergantung pada stack Anda, ini mungkin termasuk:
- Proyek JavaScript: Menjalankan instalasi dependensi (
npm install
,yarn
) - Proyek Python: Menyiapkan lingkungan virtual atau menginstal dengan package manager
- Bahasa lain: Mengikuti proses pengaturan standar proyek Anda
- Proyek JavaScript: Menjalankan instalasi dependensi (
Langkah selanjutnya
Implementasi referensi Claude Code
Kloning implementasi referensi container pengembangan kami.