Desent

Panduan Kode Claude

Desent Solutions GmbH

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

macOS / Linux (Direkomendasikan)
curl -fsSL https://claude.ai/install.sh | bash
Homebrew
brew install --cask claude-code

untuk memperbarui:

brew upgrade --cask claude-code
Windows
irm https://claude.ai/install.ps1 | iex

3Memulai

Perintah Dasar

PerintahDeskripsi
claudeMulai Kode Claude di direktori saat ini
claude --dangerously-skip-permissionsMulai tanpa permintaan izin (Direkomendasikan)
/clearBersihkan konteks percakapan
/initHasilkan file CLAUDE.md
/permissionsKelola izin alat
Shift + TabBeralih antara mode Normal dan Rencana
EscapeMenghentikan Claude
Escape × 2Kembali untuk mengedit prompt sebelumnya

Mode Operasi

Mode Normal

Untuk tugas kecil dan rutin. Claude dapat menjalankan perintah dengan bebas tanpa persetujuan langkah demi langkah.

Mode Rencana

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-permissions

4Konsep Inti

Jendela Konteks

Claude menarik file yang relevan, dokumentasi, dan riwayat percakapan ke dalam konteksnya. Ingatlah ini:

  • Gunakan /clear sering 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:

FrasaKedalaman 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

1

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.
2

Pengembangan Berbasis Pengujian (TDD)

Ideal untuk perubahan yang dapat diverifikasi dengan tes:

  1. 1Tulis tes terlebih dahulu (secara eksplisit beri tahu Claude untuk tidak membuat implementasi tiruan)
  2. 2Verifikasi tes gagal
  3. 3Komit tes
  4. 4Implementasikan untuk lulus tes (beri tahu Claude untuk terus melanjutkan sampai semua lulus)
  5. 5Komit implementasi
3

Pengembangan Visual (Berbasis Tangkapan Layar)

Untuk pengembangan UI:

  1. 1Berikan Claude sebuah mock visual (tempelkan tangkapan layar atau berikan jalur file)
  2. 2Ask Claude to implement and screenshot the result
  3. 3Ulangi hingga implementasi sesuai dengan mock
  4. 4Komit jika sudah puas
4

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.

Perintah buildGaya kodeInstruksi pengujianAlur kerja GitStruktur proyek

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
LokasiLingkup
./CLAUDE.mdProyek saat ini (komit ke git)
./CLAUDE.local.mdProyek saat ini, pribadi (tambahkan ke .gitignore)
~/.claude/CLAUDE.mdSemua 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 pengguna

Instruksi 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__/
1

Berikan Instruksi yang Spesifik

Arah yang jelas di awal mengurangi koreksi jalur di kemudian hari.

2

Koreksi Kursus Lebih Awal

Tekan Escape untuk menghentikan, ketuk dua kali untuk kembali dan coba pendekatan yang berbeda.

3

Gunakan Subagen untuk Masalah Kompleks

Beri tahu Claude untuk menggunakan subagen untuk memverifikasi temuan sebelum mengusulkan solusi.

4

Manfaatkan Daftar Periksa untuk Tugas Besar

Untuk migrasi atau refaktorisasi, minta Claude membuat dan menyelesaikan daftar periksa.

5

Kelola Konteks dengan Bijak

Jalankan /clear di antara tugas yang tidak terkait dan jelaskan dengan jelas file mana yang harus difokuskan.

6

Tinjau Sebelum Menyimpan

Selalu tinjau perubahan Claude: "Tunjukkan ringkasan dari semua perubahan yang telah Anda buat."

7

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 prompts

Kunci Penting

Shift + TabUbah mode
EscapeInterupsi
Escape × 2Kembali
#Tambahkan ke CLAUDE.md

Pola 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