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 spesifik
Tips:
- Mulai dengan pertanyaan luas, kemudian persempit ke area spesifik
- Tanyakan tentang konvensi coding dan pola yang digunakan dalam proyek
- Minta glosarium 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
Pahami alur eksekusi
Tips:
- Bersikap 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 pendekatan modern
- Minta agar perubahan mempertahankan kompatibilitas mundur jika diperlukan
- Lakukan refaktor dalam increment kecil yang dapat diuji
Menggunakan subagen khusus
Misalkan Anda ingin menggunakan subagen AI khusus untuk menangani tugas tertentu dengan lebih efektif.
Lihat subagen yang tersedia
Ini menampilkan semua subagen yang tersedia dan memungkinkan Anda membuat yang baru.
Gunakan subagen secara otomatis
Claude Code akan secara otomatis mendelegasikan tugas yang sesuai ke subagen khusus:
Secara eksplisit meminta subagen tertentu
Buat subagen kustom untuk alur kerja Anda
Kemudian pilih “Create New subagent” dan ikuti petunjuk untuk mendefinisikan:
- Jenis subagen (misalnya,
api-designer
,performance-optimizer
) - Kapan menggunakannya
- Tool mana yang dapat diaksesnya
- System prompt khususnya
Tips:
- Buat subagen khusus proyek di
.claude/agents/
untuk berbagi tim - Gunakan field
description
yang deskriptif untuk memungkinkan delegasi otomatis - Batasi akses tool pada apa yang benar-benar dibutuhkan setiap subagen
- Periksa dokumentasi subagen untuk contoh detail
Bekerja dengan tes
Misalkan Anda perlu menambahkan tes untuk kode yang belum tercakup.
Identifikasi kode yang belum diuji
Generate 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
Generate 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 menyoroti risiko atau pertimbangan potensial
Menangani dokumentasi
Misalkan Anda perlu menambahkan atau memperbarui dokumentasi untuk kode Anda.
Identifikasi kode yang tidak terdokumentasi
Generate 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 metode berikut:
- Drag dan drop gambar ke jendela Claude Code
- Salin gambar dan paste ke CLI dengan ctrl+v (Jangan gunakan cmd+v)
- Berikan path gambar ke 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 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
Mereferensikan file dan direktori
Gunakan @ untuk dengan cepat menyertakan file atau direktori tanpa menunggu Claude membacanya.
Referensikan satu file
Ini menyertakan konten lengkap file dalam percakapan.
Referensikan direktori
Ini memberikan daftar direktori dengan informasi file.
Referensikan sumber daya MCP
Ini mengambil data dari server MCP yang terhubung menggunakan format @server:resource. Lihat sumber daya MCP untuk detail.
Tips:
- Path file dapat relatif atau absolut
- Referensi file @ menambahkan CLAUDE.md di direktori file dan direktori parent ke konteks
- Referensi direktori menampilkan daftar file, bukan konten
- Anda dapat mereferensikan beberapa file dalam satu pesan (misalnya, “@file1.js dan @file2.js”)
Menggunakan pemikiran diperpanjang
Misalkan Anda bekerja pada keputusan arsitektur yang kompleks, bug yang menantang, atau merencanakan implementasi multi-langkah yang memerlukan penalaran mendalam.
Berikan konteks dan minta Claude berpikir
Claude akan mengumpulkan informasi relevan dari basis kode Anda dan menggunakan extended thinking, yang akan terlihat di interface.
Perbaiki pemikiran dengan prompt lanjutan
Tips untuk mendapatkan nilai maksimal dari extended thinking:
Extended thinking paling berharga untuk tugas kompleks seperti:
- Merencanakan perubahan arsitektur yang kompleks
- Debugging masalah rumit
- Membuat rencana implementasi untuk fitur baru
- Memahami basis kode yang kompleks
- Mengevaluasi tradeoff antara pendekatan berbeda
Cara Anda meminta thinking menghasilkan tingkat kedalaman thinking yang bervariasi:
- “think” memicu extended thinking dasar
- frasa intensifikasi seperti “think more”, “think a lot”, “think harder”, atau “think longer” memicu thinking yang lebih dalam
Untuk tips prompting extended thinking lebih lanjut, lihat Tips extended thinking.
Claude akan menampilkan proses berpikirnya 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 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 otomasi.
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 tertentu - Saat 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
- Deserialisasi Pesan: Saat 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 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 checkout beberapa branch dari repositori yang sama ke direktori terpisah. Setiap worktree memiliki direktori kerja sendiri dengan file yang 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
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 di 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 di satu worktree sambil melanjutkan pengembangan di yang 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 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 (
Menggunakan Claude sebagai utilitas gaya unix
Tambahkan Claude ke proses verifikasi Anda
Misalkan Anda ingin menggunakan Claude Code sebagai linter atau code reviewer.
Tambahkan Claude ke skrip build Anda:
Tips:
- Gunakan Claude untuk code review otomatis dalam pipeline CI/CD Anda
- Sesuaikan prompt untuk memeriksa masalah tertentu yang relevan dengan proyek Anda
- Pertimbangkan membuat beberapa skrip untuk berbagai jenis verifikasi
Pipe masuk, pipe keluar
Misalkan Anda ingin pipe data ke Claude, dan mendapatkan kembali data dalam format terstruktur.
Salurkan data melalui Claude:
Tips:
- Gunakan pipe untuk mengintegrasikan Claude ke dalam skrip shell yang ada
- Kombinasikan dengan tool Unix lain untuk alur kerja yang kuat
- Pertimbangkan menggunakan —output-format untuk output terstruktur
Kontrol format output
Misalkan Anda memerlukan output Claude dalam format tertentu, terutama saat mengintegrasikan Claude Code ke dalam skrip atau tool lain.
Gunakan format teks (default)
Ini mengeluarkan hanya respons teks biasa Claude (perilaku default).
Gunakan format JSON
Ini mengeluarkan array JSON dari pesan dengan metadata termasuk biaya dan durasi.
Gunakan format JSON streaming
Ini mengeluarkan 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 perlu 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.
Untuk detail lebih lanjut, lihat halaman referensi Perintah slash.
Buat perintah khusus proyek
Misalkan Anda ingin membuat perintah slash yang dapat digunakan kembali untuk proyek Anda yang dapat digunakan 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 diturunkan dari nama file (misalnya,
optimize.md
menjadi/optimize
) - Anda dapat mengorganisir perintah dalam subdirektori (misalnya,
.claude/commands/frontend/component.md
membuat/component
dengan “(project:frontend)” ditampilkan dalam deskripsi) - Perintah proyek tersedia untuk semua orang yang mengkloning repositori
- Konten file Markdown menjadi prompt yang dikirim ke Claude ketika perintah dipanggil
Tambahkan argumen perintah dengan $ARGUMENTS
Misalkan Anda ingin membuat perintah slash 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 menempatkan $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
Buat perintah slash personal
Misalkan Anda ingin membuat perintah slash personal yang bekerja di semua proyek Anda.
Buat direktori perintah di folder home Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom personal Anda
Tips:
- Perintah personal menampilkan “(user)” dalam deskripsi mereka ketika didaftar dengan
/help
- Perintah personal hanya tersedia untuk Anda dan tidak dibagikan dengan tim Anda
- Perintah personal bekerja di semua proyek Anda
- Anda dapat menggunakannya untuk alur kerja yang konsisten di berbagai basis kode
Tanyakan Claude tentang kemampuannya
Claude memiliki akses built-in ke dokumentasinya dan dapat menjawab pertanyaan tentang fitur dan keterbatasannya sendiri.
Contoh pertanyaan
Claude memberikan jawaban berbasis dokumentasi untuk pertanyaan-pertanyaan ini. Untuk contoh yang dapat dieksekusi dan demonstrasi hands-on, rujuk ke bagian alur kerja spesifik di atas.
Tips:
- Claude selalu memiliki akses ke dokumentasi Claude Code terbaru, terlepas dari versi yang Anda gunakan
- Ajukan pertanyaan spesifik untuk mendapatkan jawaban detail
- Claude dapat menjelaskan fitur kompleks seperti integrasi MCP, konfigurasi enterprise, dan alur kerja lanjutan
Tanyakan Claude tentang kemampuannya
Claude memiliki akses built-in ke dokumentasinya dan dapat menjawab pertanyaan tentang fitur dan keterbatasannya sendiri.
Contoh pertanyaan
Claude memberikan jawaban berbasis dokumentasi untuk pertanyaan-pertanyaan ini. Untuk contoh yang dapat dieksekusi dan demonstrasi langsung, rujuk ke bagian alur kerja spesifik di atas.
Tips:
- Claude selalu memiliki akses ke dokumentasi Claude Code terbaru, terlepas dari versi yang Anda gunakan
- Ajukan pertanyaan spesifik untuk mendapatkan jawaban detail
- Claude dapat menjelaskan fitur kompleks seperti integrasi MCP, konfigurasi enterprise, dan alur kerja lanjutan
Tanyakan Claude tentang kemampuannya
Claude memiliki akses built-in ke dokumentasinya dan dapat menjawab pertanyaan tentang fitur dan keterbatasannya sendiri.
Contoh pertanyaan
Claude memberikan jawaban berbasis dokumentasi untuk pertanyaan-pertanyaan ini. Untuk contoh yang dapat dieksekusi dan demonstrasi langsung, rujuk ke bagian alur kerja spesifik di atas.
Tips:
- Claude selalu memiliki akses ke dokumentasi Claude Code terbaru, terlepas dari versi yang Anda gunakan
- Ajukan pertanyaan spesifik untuk mendapatkan jawaban detail
- Claude dapat menjelaskan fitur kompleks seperti integrasi MCP, konfigurasi enterprise, dan alur kerja lanjutan
Langkah selanjutnya
Implementasi referensi Claude Code
Clone implementasi referensi development container kami.