Kode Claude Panduan Pengembang
Panduan komprehensif Anda untuk menggunakan Claude Code secara efektif. Pelajari alur kerja, praktik terbaik, dan tips untuk meningkatkan pengembangan Anda.
2Instalasi & Pengaturan
curl -fsSL https://claude.ai/install.sh | bashbrew install --cask claude-codeuntuk memperbarui:
brew upgrade --cask claude-codeirm https://claude.ai/install.ps1 | iex3Memulai
Perintah Dasar
| Perintah | Deskripsi |
|---|---|
claude | Mulai Kode Claude di direktori saat ini |
claude --dangerously-skip-permissions | Mulai tanpa permintaan izin (Direkomendasikan) |
/clear | Bersihkan konteks percakapan |
/init | Hasilkan file CLAUDE.md |
/permissions | Kelola izin alat |
Shift + Tab | Beralih antara mode Normal dan Rencana |
Escape | Menghentikan Claude |
Escape × 2 | Kembali untuk mengedit prompt sebelumnya |
Mode Operasi
Untuk tugas kecil dan rutin. Claude dapat menjalankan perintah dengan bebas tanpa persetujuan langkah demi langkah.
Untuk fitur yang lebih besar. Claude membuat rencana sebelum melaksanakan, memungkinkan Anda meninjau setiap langkah.
Memulai sesi:
# Arahkan ke proyek Anda
cd /path/to/your/project
# Mulai Claude Code
claude
# Atau mulai tanpa permintaan izin (hanya untuk lingkungan yang aman)
claude --dangerously-skip-permissions4Konsep Inti
Jendela Konteks
Claude menarik file yang relevan, dokumentasi, dan riwayat percakapan ke dalam konteksnya. Ingatlah ini:
- Gunakan
/clearsering antara tugas yang tidak terkait - Jelaskan secara spesifik file mana yang harus difokuskan
- Tempel tangkapan layar atau seret dan lepas gambar
- Berikan URL untuk Claude agar dapat mengambil dan membaca
Pemikiran yang Diperluas
Gunakan kata-kata spesifik untuk memicu analisis yang lebih mendalam:
| Frasa | Kedalaman Berpikir |
|---|---|
"think" | Berpikir dasar yang diperluas |
"berpikir keras" | Analisis lebih menyeluruh |
"berpikir lebih keras" | Analisis mendalam |
"berpikir ultra" | Anggaran pemikiran maksimum |
5Alur Kerja yang Direkomendasikan
Jelajahi → Rencanakan → Kode → Komit
Terbaik untuk sebagian besar tugas pengembangan:
1. Jelajahi
Baca modul otentikasi dan pahami cara kerja sesi pengguna. Jangan menulis kode apapun dulu.2. Rencana
Pikirkan dengan matang bagaimana menambahkan dukungan OAuth2. Buat rencana tetapi jangan mulai coding dulu.3. Kode
Sekarang implementasikan dukungan OAuth2 sesuai rencana Anda.4. Komit
Komit perubahan ini dengan pesan deskriptif dan buat PR.Pengembangan Berbasis Pengujian (TDD)
Ideal untuk perubahan yang dapat diverifikasi dengan tes:
- 1Tulis tes terlebih dahulu (secara eksplisit beri tahu Claude untuk tidak membuat implementasi tiruan)
- 2Verifikasi tes gagal
- 3Komit tes
- 4Implementasikan untuk lulus tes (beri tahu Claude untuk terus melanjutkan sampai semua lulus)
- 5Komit implementasi
Pengembangan Visual (Berbasis Tangkapan Layar)
Untuk pengembangan UI:
- 1Berikan Claude sebuah mock visual (tempelkan tangkapan layar atau berikan jalur file)
- 2Ask Claude to implement and screenshot the result
- 3Ulangi hingga implementasi sesuai dengan mock
- 4Komit jika sudah puas
Tanya Jawab Codebase
Saat orientasi atau menjelajah, tanyakan pada Claude:
- →"Bagaimana cara kerja autentikasi dalam proyek ini?"
- →"Kasus tepi apa yang ditangani oleh PaymentProcessor?"
- →"Mengapa kita menggunakan pustaka khusus ini untuk X?"
- →"Tunjukkan cara menambahkan endpoint API baru mengikuti pola yang ada"
6Konfigurasi Proyek (CLAUDE.md)
Apa itu CLAUDE.md?
File khusus yang secara otomatis dibaca Claude pada awal setiap sesi. Gunakan untuk mendokumentasikan perintah khusus proyek, gaya kode, instruksi pengujian, dan pola penting.
Template CLAUDE.md:
# Proyek: [Nama Proyek]
## Perintah Build & Run
- `npm run dev` — Mulai server pengembangan
- `npm run build` — Build untuk produksi
- `npm run test` — Jalankan rangkaian tes
- `npm run lint` — Jalankan linter
## Gaya Kode
- Gunakan mode ketat TypeScript
- Gunakan modul ES (import/export), bukan CommonJS
- Destrukturisasi impor jika memungkinkan
## Pengujian
- Tulis tes untuk semua fitur baru
- Jalankan tes tunggal: `npm test -- --grep "nama tes"`
- Pastikan semua tes lulus sebelum melakukan commit
## Alur Kerja Git
- Penamaan cabang: `feature/[ticket-id]-deskripsi-singkat`
- Pesan commit: Mulai dengan ID tiket
- Selalu rebase pada main sebelum membuat PR
## Struktur Proyek
- `/src/api` — Rute dan pengendali API
- `/src/services` — Logika bisnis
- `/src/models` — Model basis data| Lokasi | Lingkup |
|---|---|
./CLAUDE.md | Proyek saat ini (komit ke git) |
./CLAUDE.local.md | Proyek saat ini, pribadi (tambahkan ke .gitignore) |
~/.claude/CLAUDE.md | Semua sesi Claude Anda |
7Integrasi MCP
Apa itu MCP?
Model Context Protocol (MCP) memungkinkan Claude untuk berinteraksi dengan layanan eksternal seperti Jira, GitHub, Puppeteer, dan lainnya.
Konfigurasi Jira MCP (.mcp.json):
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-jira"],
"env": {
"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_USER": "${JIRA_USER}",
"JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
}
}
}
}Perintah Jira
- "Tunjukkan semua bug terbuka yang ditugaskan kepada saya"
- "Buat tugas di PROJ untuk fitur login"
- "Perbarui status PROJ-123 menjadi Sedang Berjalan"
- "Tambahkan komentar ke PROJ-456"
GitHub (melalui gh CLI)
- Buat permintaan tarik
- Tinjau kode
- Kelola masalah
- Menangani operasi git yang kompleks
Debugging MCP
Luncurkan dengan claude --mcp-debug untuk mengidentifikasi masalah konfigurasi.
8Perintah Kustom
Store prompt templates in .claude/commands/ untuk alur kerja yang dapat digunakan kembali.
.claude/commands/fix-github-issue.md:
Silakan analisis dan perbaiki masalah GitHub: $ARGUMENTS.
Ikuti langkah-langkah ini:
1. Gunakan `gh issue view` untuk mendapatkan detail masalah
2. Pahami masalah yang dijelaskan dalam isu
3. Cari basis kode untuk file yang relevan
4. Terapkan perubahan yang diperlukan untuk memperbaiki masalah
5. Tulis dan jalankan tes untuk memverifikasi perbaikan
6. Pastikan kode lulus linting dan pengecekan tipe
7. Buat pesan commit yang deskriptif
8. Push dan buat PR
Ingat untuk menggunakan GitHub CLI (`gh`) untuk semua tugas terkait GitHub.Penggunaan: Ketik /project:fix-github-issue 1234 untuk memperbaiki masalah #1234
9Praktik Terbaik
Instruksi Tidak Jelas
Tambahkan tes untuk modul penggunaInstruksi Khusus
Tulis tes untuk src/services/user.ts yang mencakup: pembuatan pengguna yang berhasil, penanganan email duplikat, validasi kata sandi (min 8 karakter, diperlukan karakter khusus). Gunakan Jest dan ikuti pola tes yang ada di __tests__/Berikan Instruksi yang Spesifik
Arah yang jelas di awal mengurangi koreksi jalur di kemudian hari.
Koreksi Kursus Lebih Awal
Tekan Escape untuk menghentikan, ketuk dua kali untuk kembali dan coba pendekatan yang berbeda.
Gunakan Subagen untuk Masalah Kompleks
Beri tahu Claude untuk menggunakan subagen untuk memverifikasi temuan sebelum mengusulkan solusi.
Manfaatkan Daftar Periksa untuk Tugas Besar
Untuk migrasi atau refaktorisasi, minta Claude membuat dan menyelesaikan daftar periksa.
Kelola Konteks dengan Bijak
Jalankan /clear di antara tugas yang tidak terkait dan jelaskan dengan jelas file mana yang harus difokuskan.
Tinjau Sebelum Menyimpan
Selalu tinjau perubahan Claude: "Tunjukkan ringkasan dari semua perubahan yang telah Anda buat."
Gunakan Git Secara Efektif
Biarkan Claude menangani git: pesan commit, rebasing, meninjau riwayat.
10Pemecahan Masalah
Claude langsung mulai coding
Solusi: Pisahkan secara eksplisit fase eksplorasi dan pengkodean:
Pertama, baca file yang relevan dan pahami implementasi saat ini.
Jangan menulis kode apapun sampai saya menyetujui rencana Anda.Konteks menjadi berantakan
Solusi: Gunakan /clear sering, terutama antara tugas yang berbeda.
Claude membuat perubahan yang tidak diinginkan
Solusi: Tekan Escape untuk menghentikan, beri tahu Claude untuk membatalkan perubahan, lalu lebih spesifik tentang ruang lingkup.
Masalah koneksi MCP
Solusi: Jalankan claude --mcp-debug untuk melihat log terperinci. Periksa variabel lingkungan dan akses jaringan.
Uji coba terus gagal
Solusi: Tell Claude to iterate:
Terus ulangi sampai semua tes lulus. Setelah setiap perubahan, jalankan tes dan sesuaikan pendekatan Anda berdasarkan kegagalan.11Kartu Referensi Cepat
Memulai Sesi
cd /your/project
claude # Normal start
claude --dangerously-skip-permissions # Skip promptsKunci Penting
Shift + TabUbah modeEscapeInterupsiEscape × 2Kembali#Tambahkan ke CLAUDE.mdPola Prompt
"Pikirkan dengan serius tentang..."Picu pemikiran yang mendalam
"Jangan menulis kode apapun dulu..."Paksa fase perencanaan
"Gunakan subagen untuk memverifikasi..."Aktifkan verifikasi paralel
"Teruskan sampai..."Peningkatan iteratif