Alur kerja umum
Pelajari tentang alur kerja umum dengan Claude Code.
Setiap tugas dalam dokumen ini mencakup instruksi yang jelas, contoh perintah, dan praktik terbaik untuk membantu Anda mendapatkan hasil maksimal dari Claude Code.
Memahami basis kode baru
Mendapatkan gambaran umum basis kode dengan cepat
Misalkan 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
Mendalami komponen-komponen spesifik
Tips:
- Mulai dengan pertanyaan luas, kemudian persempit ke area spesifik
- Tanyakan tentang konvensi coding dan pola yang digunakan dalam proyek
- Minta glosarium istilah-istilah khusus proyek
Menemukan kode yang relevan
Misalkan Anda perlu menemukan kode yang terkait dengan fitur atau fungsionalitas tertentu.
Minta Claude untuk menemukan file yang relevan
Dapatkan konteks tentang bagaimana komponen berinteraksi
Memahami alur eksekusi
Tips:
- Spesifik tentang apa yang Anda cari
- Gunakan bahasa domain dari proyek
Memperbaiki bug secara efisien
Misalkan Anda mengalami pesan error dan perlu menemukan serta memperbaiki sumbernya.
Bagikan error dengan Claude
Minta rekomendasi perbaikan
Terapkan perbaikan
Tips:
- Beritahu Claude perintah untuk mereproduksi masalah dan dapatkan stack trace
- Sebutkan langkah-langkah untuk mereproduksi error
- Beri tahu Claude jika error bersifat intermiten atau konsisten
Refaktor kode
Misalkan Anda perlu memperbarui kode lama untuk menggunakan pola dan praktik modern.
Identifikasi kode legacy untuk refaktor
Dapatkan rekomendasi refaktor
Terapkan perubahan dengan aman
Verifikasi refaktor
Tips:
- Minta Claude menjelaskan manfaat dari pendekatan modern
- Minta agar perubahan mempertahankan kompatibilitas mundur jika diperlukan
- Lakukan refaktor dalam increment kecil yang dapat diuji
Bekerja dengan tes
Misalkan Anda perlu menambahkan tes untuk kode yang belum tercakup.
Identifikasi kode yang tidak diuji
Buat scaffolding tes
Tambahkan kasus tes yang bermakna
Jalankan dan verifikasi tes
Tips:
- Minta tes yang mencakup kasus edge dan kondisi error
- Minta tes unit dan integrasi jika sesuai
- Minta Claude menjelaskan strategi pengujian
Membuat pull request
Misalkan 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 langsung untuk membuat PR untuk Anda
- Tinjau PR yang dibuat Claude sebelum mengirimkan
- Minta Claude untuk menyoroti risiko atau pertimbangan potensial
Menangani dokumentasi
Misalkan Anda perlu menambahkan 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, interface, dan logika kompleks
Bekerja dengan gambar
Misalkan Anda perlu bekerja dengan gambar dalam basis kode Anda, dan Anda ingin bantuan Claude menganalisis konten gambar.
Tambahkan gambar ke percakapan
Anda dapat menggunakan salah satu dari metode ini:
- Seret dan lepas gambar ke dalam jendela Claude Code
- Salin gambar dan tempel ke dalam CLI dengan ctrl+v (Jangan gunakan cmd+v)
- Berikan path gambar claude. Misalnya, “Analisis gambar ini: /path/to/your/image.png”
Minta Claude menganalisis gambar
Gunakan gambar untuk konteks
Dapatkan saran kode dari konten visual
Tips:
- Gunakan gambar ketika deskripsi teks akan tidak jelas atau rumit
- Sertakan screenshot error, desain UI, atau diagram untuk konteks yang lebih baik
- Anda dapat bekerja dengan beberapa gambar dalam satu percakapan
- Analisis gambar bekerja dengan diagram, screenshot, mockup, dan lainnya
Menggunakan pemikiran diperpanjang
Misalkan Anda bekerja pada keputusan arsitektur yang kompleks, bug yang menantang, atau perencanaan 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 diperpanjang, yang akan terlihat di interface.
Perbaiki pemikiran dengan prompt lanjutan
Tips untuk mendapatkan nilai maksimal dari pemikiran diperpanjang:
Pemikiran diperpanjang 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 trade-off antara pendekatan yang berbeda
Cara Anda meminta pemikiran menghasilkan tingkat kedalaman pemikiran yang bervariasi:
- “think” memicu pemikiran diperpanjang dasar
- frasa intensifikasi seperti “think more”, “think a lot”, “think harder”, atau “think longer” memicu pemikiran yang lebih dalam
Untuk tips prompting pemikiran diperpanjang lebih lanjut, lihat Tips pemikiran diperpanjang.
Claude akan menampilkan proses pemikirannya sebagai teks abu-abu miring di atas respons.
Melanjutkan percakapan sebelumnya
Misalkan Anda telah bekerja pada tugas dengan Claude Code dan perlu melanjutkan di mana Anda berhenti dalam sesi selanjutnya.
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 langsung 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 navigasi dan tekan Enter untuk memilih percakapan.
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 yang spesifik - Ketika melanjutkan, Anda akan melihat seluruh riwayat percakapan sebelum melanjutkan
- Percakapan yang dilanjutkan dimulai dengan model dan konfigurasi yang sama seperti aslinya
Cara kerjanya:
- Penyimpanan Percakapan: Semua percakapan secara otomatis disimpan secara lokal dengan riwayat pesan lengkap mereka
- Deserialisasi Pesan: Ketika melanjutkan, seluruh riwayat pesan dipulihkan untuk mempertahankan konteks
- Status Tool: Penggunaan tool dan hasil dari percakapan sebelumnya dipertahankan
- Pemulihan Konteks: Percakapan dilanjutkan dengan semua konteks sebelumnya tetap utuh
Contoh:
Menjalankan sesi Claude Code paralel dengan Git worktree
Misalkan Anda perlu bekerja pada beberapa tugas secara bersamaan dengan isolasi kode lengkap antara instance Claude Code.
Memahami Git worktree
Git worktree memungkinkan Anda untuk checkout beberapa branch dari repositori yang sama ke dalam direktori terpisah. Setiap worktree memiliki direktori kerja sendiri dengan file yang terisolasi, sambil berbagi riwayat Git yang sama. Pelajari lebih lanjut dalam dokumentasi Git worktree resmi.
Buat worktree baru
Ini membuat direktori baru dengan salinan kerja terpisah dari repositori Anda.
Jalankan Claude Code di setiap worktree
Jalankan Claude di worktree lain
Kelola worktree Anda
Tips:
- Setiap worktree memiliki status file independen sendiri, membuatnya sempurna untuk sesi Claude Code paralel
- Perubahan yang dibuat dalam satu worktree tidak akan mempengaruhi yang lain, mencegah instance Claude saling mengganggu
- Semua worktree berbagi riwayat Git dan koneksi remote yang sama
- Untuk tugas jangka panjang, Anda dapat memiliki Claude bekerja dalam satu worktree sambil Anda melanjutkan pengembangan di worktree lain
- Gunakan nama direktori yang deskriptif untuk mudah mengidentifikasi tugas mana yang untuk setiap worktree
- Ingat untuk menginisialisasi lingkungan pengembangan Anda di setiap worktree baru sesuai dengan setup proyek Anda. Tergantung pada stack Anda, ini mungkin termasuk:
- Proyek JavaScript: Menjalankan instalasi dependensi (
npm install
,yarn
) - Proyek Python: Menyiapkan virtual environment atau menginstal dengan package manager
- Bahasa lain: Mengikuti proses setup standar proyek Anda
- Proyek JavaScript: Menjalankan instalasi dependensi (
Menggunakan Claude sebagai utilitas gaya unix
Menambahkan Claude ke proses verifikasi Anda
Misalkan Anda ingin menggunakan Claude Code sebagai linter atau code reviewer.
Tambahkan Claude ke build script Anda:
Tips:
- Gunakan Claude untuk code review otomatis dalam pipeline CI/CD Anda
- Sesuaikan prompt untuk memeriksa masalah spesifik yang relevan dengan proyek Anda
- Pertimbangkan membuat beberapa skrip untuk berbagai jenis verifikasi
Pipe in, pipe out
Misalkan Anda ingin mem-pipe data ke Claude, dan mendapatkan kembali data dalam format terstruktur.
Pipe data melalui Claude:
Tips:
- Gunakan pipe untuk mengintegrasikan Claude ke dalam skrip shell yang ada
- Kombinasikan dengan tool Unix lain untuk alur kerja yang powerful
- Pertimbangkan menggunakan —output-format untuk output terstruktur
Mengontrol format output
Misalkan Anda memerlukan output Claude dalam format spesifik, terutama ketika mengintegrasikan Claude Code ke dalam skrip atau tool lain.
Gunakan format teks (default)
Ini mengoutput hanya respons teks biasa Claude (perilaku default).
Gunakan format JSON
Ini mengoutput array JSON dari pesan dengan metadata termasuk biaya dan durasi.
Gunakan format streaming JSON
Ini mengoutput 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 mengeksekusi prompt atau tugas tertentu.
Untuk detail lebih lanjut, lihat halaman referensi Perintah slash.
Membuat perintah khusus proyek
Misalkan Anda ingin membuat perintah slash yang dapat digunakan kembali untuk proyek Anda yang dapat digunakan oleh semua anggota tim.
Buat direktori commands dalam proyek Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom Anda dalam Claude Code
Tips:
- Nama perintah diturunkan dari nama file (misalnya,
optimize.md
menjadi/project:optimize
) - Anda dapat mengorganisir 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 dipanggil
Menambahkan argumen perintah dengan $ARGUMENTS
Misalkan Anda ingin membuat perintah slash yang fleksibel yang dapat menerima input tambahan dari pengguna.
Buat file perintah dengan placeholder $ARGUMENTS
Gunakan perintah dengan nomor issue
Dalam sesi Claude Anda, gunakan perintah dengan argumen.
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 tes untuk fungsi tertentu, membuat dokumentasi untuk komponen, meninjau kode dalam file tertentu, atau menerjemahkan konten ke bahasa yang ditentukan
Membuat perintah slash personal
Misalkan Anda ingin membuat perintah slash personal yang bekerja di semua proyek Anda.
Buat direktori commands di folder home Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom personal Anda
Tips:
- Perintah personal diawali dengan
/user:
bukan/project:
- Perintah personal hanya tersedia untuk Anda dan tidak dibagikan dengan tim Anda
- Perintah personal bekerja di semua proyek Anda
- Anda dapat menggunakan ini untuk alur kerja yang konsisten di berbagai basis kode
Langkah selanjutnya
Implementasi referensi Claude Code
Kloning implementasi referensi development container kami.