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
Memahami 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 dari 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:
Minta subagen spesifik secara eksplisit
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
- Tools apa 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
Menggunakan Plan Mode untuk analisis kode yang aman
Plan Mode menginstruksikan Claude untuk membuat rencana dengan menganalisis basis kode dengan operasi read-only, sempurna untuk menjelajahi basis kode, merencanakan perubahan kompleks, atau meninjau kode dengan aman.
Kapan menggunakan Plan Mode
- Implementasi multi-langkah: Ketika fitur Anda memerlukan pengeditan banyak file
- Eksplorasi kode: Ketika Anda ingin meneliti basis kode secara menyeluruh sebelum mengubah apa pun
- Pengembangan interaktif: Ketika Anda ingin beriterasi pada arah dengan Claude
Cara menggunakan Plan Mode
Aktifkan Plan Mode selama sesi
Anda dapat beralih ke Plan Mode selama sesi menggunakan Shift+Tab untuk berpindah melalui mode izin.
Jika Anda dalam Normal Mode, Shift+Tab akan terlebih dahulu beralih ke Auto-Accept Mode, ditunjukkan dengan ⏵⏵ accept edits on
di bagian bawah terminal. Shift+Tab berikutnya akan beralih ke Plan Mode, ditunjukkan dengan ⏸ plan mode on
.
Mulai sesi baru dalam Plan Mode
Untuk memulai sesi baru dalam Plan Mode, gunakan flag --permission-mode plan
:
Jalankan query “headless” dalam Plan Mode
Anda juga dapat menjalankan query dalam Plan Mode secara langsung dengan -p
(yaitu, dalam “headless mode”):
Contoh: Merencanakan refaktor kompleks
Claude akan menganalisis implementasi saat ini dan membuat rencana komprehensif. Perbaiki dengan tindak lanjut:
Konfigurasi Plan Mode sebagai default
Lihat dokumentasi pengaturan untuk opsi konfigurasi lainnya.
Bekerja dengan tes
Misalkan Anda perlu menambahkan tes untuk kode yang tidak 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 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 metode ini:
- Drag dan drop gambar ke dalam jendela Claude Code
- Salin gambar dan paste ke dalam 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 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
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 menyediakan 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 dalam direktori file dan direktori induk ke konteks
- Referensi direktori menampilkan daftar file, bukan konten
- Anda dapat mereferensikan beberapa file dalam satu pesan (misalnya, “@file1.js dan @file2.js”)
Menggunakan extended thinking
Misalkan Anda bekerja pada keputusan arsitektur 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 extended thinking, yang akan terlihat di interface.
Perbaiki pemikiran dengan prompt tindak lanjut
Tips untuk mendapatkan nilai maksimal dari extended thinking:
Extended thinking paling berharga untuk tugas kompleks seperti:
- Merencanakan perubahan arsitektur kompleks
- Men-debug masalah rumit
- Membuat rencana implementasi untuk fitur baru
- Memahami basis kode kompleks
- Mengevaluasi trade-off antara pendekatan berbeda
Cara Anda meminta thinking menghasilkan tingkat kedalaman thinking yang bervariasi:
- “think” memicu extended thinking dasar
- frasa intensifikasi seperti “keep thinking”, “think more”, “think a lot”, atau “think longer” memicu thinking yang lebih dalam
Untuk tips prompting extended thinking lainnya, lihat Tips Extended thinking.
Claude akan menampilkan proses thinkingnya 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 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 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 untuk 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 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 yang lain
- Gunakan nama direktori yang deskriptif untuk dengan 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
Tambahkan 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
Kontrol format output
Misalkan Anda memerlukan output Claude dalam format spesifik, terutama saat 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 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.
Membuat 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 dalam proyek Anda
Buat file Markdown untuk setiap perintah
Gunakan perintah kustom Anda dalam Claude Code
Tips:
- Nama perintah berasal 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
Menambahkan 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
Membuat 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 menggunakan ini untuk alur kerja konsisten di berbagai basis kode
Bertanya kepada 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
Kloning implementasi referensi development container kami.