Panduan Lengkap Claude Code untuk Pemula: Cheatsheet Developer

Jika Anda mendalami Claude Code, asisten pengkodean bertenaga AI dari Anthropic yang kuat, memiliki referensi yang jelas sangatlah penting. **Lembar Panduan Claude Code** ini ditujukan untuk pengembang yang menginginkan panduan praktis dan ramah pemula yang mencakup pengaturan, alur kerja, konfigurasi, dan tips lanjutan. Pada akhirnya, Anda akan merasa lebih percaya diri menggunakan Claude Code di lingkungan lokal Anda atau sebagai bagian dari proses CI/CD Anda.

Apa Itu Claude Code?

Claude Code adalah alat pengkodean AI berbasis CLI oleh Anthropic. Ini memungkinkan pengembang untuk menghasilkan, memfaktorkan ulang, menguji, dan mendokumentasikan kode menggunakan model canggih Claude. Daripada antarmuka obrolan sederhana, Claude Code berperilaku seperti IDE AI: ia memahami struktur repositori Anda, menerapkan batasan yang ditentukan dalam file konfigurasi, dapat menjalankan perintah bash, dan terintegrasi dengan alur kerja Git.

Instal Claude Code:

# MacOS/Linux:
curl -fsSL https://claude.ai/install.sh | bash

# Windows:
irm https://claude.ai/install.ps1 | iex

# NPM:
npm install -g @anthropic-ai/claude-code

# Homebrew:
brew install --cask claude-code

Mulai gunakan Claude Code:

cd your-project
claude

Komponen Utama Claude Code — Lembar Panduan Anda

Berikut adalah blok bangunan dan fitur penting yang ingin Anda ketahui saat memulai Claude Code:

1. CLAUDE.md — Manifes Agen

• File CLAUDE.md adalah “konstitusi” untuk agen Anda: ini mendefinisikan bagaimana Claude berperilaku di repositori Anda.
• Gunakan untuk mendokumentasikan alat yang disetujui, alur kerja umum, dan batasan.
• Praktik terbaik: Buat singkat, fokus pada batasan utama, dan hindari menyematkan dokumen yang sangat besar.

# MyProject CLAUDE.md

## Project Overview  
This is a Node.js + Express REST API for a task management application.  

## Technology Stack  
- Backend: Node.js (ES6), Express  
- Database: PostgreSQL  
- Testing: Jest  
- Linting & Style: ESLint, Prettier

## Development Commands  
- `npm install` — Install dependencies  
- `npm run dev` — Start development server  
- `npm run test` — Run all tests  
- `npm run lint` — Run linter  

## Coding Standards  
- Use 2-space indentation.  
- Always use `async / await` instead of `.then()` chains.  
- Functions must have JSDoc comments.  
- Prefer composition over inheritance.

## Git Workflow  
- Feature branches must follow this pattern: `feature/FOO`  
- Use `git rebase` instead of `merge` for updating branches.  
- When committing: write descriptive commit messages that follow the Conventional Commits format.

## File Structure Guidance  
- `src/` — Your main application code  
- `tests/` — Test files  
- `scripts/` — Utility or setup scripts  
- `migrations/` — Database migrations  

## Known Issues / Workarounds  
- `db.connect()` sometimes times out; in that case, retry twice.  
- For large JSON payloads, use streaming to avoid memory issues.

## Memory / Style Preferences  
- Always ask for clarification if the request is ambiguous.  
- Do not generate new `.md` files unless explicitly instructed.  
- Include a `co-authored-by Claude` line in generated commits.

2. Manajemen Konteks

a. Gunakan **/context** untuk memeriksa penggunaan token sesi Claude Anda saat ini.

b. Perintah untuk memulai ulang atau memperkecil konteks:

• /clear + /catchup: Menghapus semua percakapan lalu memuat ulang file dari commit atau branch.
• Alur “Dokumentasikan & Hapus”: minta Claude untuk membuang rencananya ke file Markdown, hapus memori, lalu muat ulang dari file tersebut.

3. Perintah Garis Miring

• Perintah garis miring adalah pintasan ke prompt yang telah ditentukan sebelumnya.
• Contoh:

• Jaga agar perintah garis miring minimal dan terfokus; jangan bergantung padanya untuk setiap tugas.

4. Mode Perencanaan

• Gunakan mode perencanaan saat memulai tugas kompleks. Claude akan menguraikan rencana sebelum menulis kode.
• Anda kemudian dapat meninjau, mengedit, atau menyetujui rencana tersebut sebelum meminta Claude untuk mengeksekusi.
• Ideal untuk pekerjaan fitur besar, refaktorisasi, atau perubahan arsitektur.

5. Subagen & Delegasi Tugas

• Claude Code mendukung subagen, memungkinkan Anda mendelegasikan sebagian pekerjaan ke “klon” agen utama.
• Shrivu lebih menyukai arsitektur “Master-Klon”: agen utama membuat klon melalui Task(...), daripada menggunakan subagen khusus yang kaku.
• Ini menjaga fleksibilitas sambil menghindari fragmentasi konteks.
• Akses subagen Claude Code menggunakan perintah garis miring: /agents.

6. Claude Skills vs. MCP — Apa Bedanya?

a. **Claude Skills** adalah “modul” pra-bangun yang mengajarkan Claude *bagaimana* melakukan tugas-tugas tertentu. Mereka ditulis dalam Markdown atau kode, dan mereka hanya dimuat saat dibutuhkan. Anda dapat menggunakan Skills untuk mendefinisikan alur kerja seperti memformat laporan, meringkas data, atau menegakkan gaya tim Anda.

b. **Model Context Protocol (MCP)**, di sisi lain, adalah protokol untuk menghubungkan Claude ke data dan alat eksternal — seperti database, basis kode Anda, atau sistem bisnis. Ini seperti “adapter universal” yang memungkinkan Claude mengakses dan bertindak berdasarkan sumber daya eksternal tanpa integrasi khusus per alat.

c. Perbedaan Utama:

1. Tujuan:

• Skills mengodekan *pengetahuan prosedural*.
• MCP menangani *konektivitas alat dan data*.

2. Efisiensi Token:

• Skills hanya dimuat saat dibutuhkan, menggunakan token yang relatif sedikit.
• Definisi alat MCP dapat menghabiskan ruang token yang signifikan jika banyak yang diaktifkan.

d. Kasus Penggunaan:

• Gunakan **Skills** untuk mengajarkan alur kerja khusus domain kepada Claude (misalnya, “saat menulis laporan status, selalu sertakan X, Y, Z”).
• Gunakan **MCP** saat Claude perlu *membaca/menulis data*, memanggil API, atau mengakses sistem eksternal seperti Git atau database.

Dalam praktiknya, keduanya bekerja paling baik bersama: **MCP** memberi Claude akses ke data Anda, dan **Skills** mengajarkan Claude cara menggunakan data tersebut dengan cara yang terstruktur dan berulang.

6. Hooks

a. Hooks adalah cara Anda untuk menegakkan aturan secara otomatis.

b. Dua jenis umum:

• **Block-at-submit**: Misalnya, hook PreToolUse dapat memblokir git commit kecuali pengujian telah berhasil.
• **Hint hooks**: Tidak memblokir; mereka memberikan panduan atau saran tanpa menghentikan eksekusi.

c. Hindari hook “block-at-write” — membiarkan Claude menyelesaikan rencananya lalu memvalidasinya lebih stabil.

# Example Hook in .claude/settings.toml

[[hooks]]
# The event that triggers the hook.
event = "PostToolUse" 

# (Optional) Conditions for the hook to run.
[hooks.matcher]
tool_name = "edit_file"
file_paths = ["*.py", "api/**/*.py"]

# The shell command to execute.
command = "ruff check --fix $CLAUDE_FILE_PATHS && black $CLAUDE_FILE_PATHS"

# (Optional) Whether to run the command in the background.
run_in_background = false 

7. CLI SDK

• **Claude Code SDK** memungkinkan Anda membuat skrip interaksi Claude: berguna untuk pemrosesan batch, membangun alat internal, atau membuat prototipe agen.
• Gunakan untuk menjalankan refaktor paralel, menghasilkan kode dari template, atau sebagai agen ringan di dalam alur kerja CI/CD.

Instalasi:

# Typescript:
npm install @anthropic-ai/claude-agent-sdk

# Python:
pip install claude-agent-sdk

8. Claude Code GitHub Actions (GHA)

• Anda dapat mengintegrasikan Claude Code langsung ke GitHub Actions.
• Gunakan untuk secara otomatis menghasilkan pull request, menegakkan standar kode, atau menjalankan pemeriksaan berbasis CLAUDE.md sebagai bagian dari pipeline CI Anda.
• Karena log disimpan, Anda dapat mengaudit perilaku agen dan meningkatkan file CLAUDE.md Anda seiring waktu.

9. Pengaturan & Konfigurasi

a. Di settings.json, Anda dapat mengonfigurasi:

• Proxy (HTTPS_PROXY) — berguna untuk men-debug lalu lintas CLI.
• Batas waktu (MCP_TOOL_TIMEOUT, BASH_MAX_TIMEOUT_MS) — tingkatkan ini jika Anda menjalankan tugas yang panjang.
• Kunci API (ANTHROPIC_API_KEY) — gunakan kunci Anda dari Anthropic atau skrip pembantu.
• Izin — kontrol alat sistem mana yang diizinkan untuk dieksekusi oleh Claude Code.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

Fitur Lanjutan & Tips Produktivitas

1. **Pengalihan Model**: Pilih Claude 4 Sonnet atau Opus tergantung pada tugas Anda. Sonnet cepat dan hemat biaya; Opus lebih mampu untuk perubahan kompleks, multi-file.
2. **Mode Berpikir** (Curang): Beberapa pengguna mengatur mode penalaran Claude ke `think`, `think hard`, `think harder`, atau `ultrathink` untuk menyesuaikan seberapa dalam ia bernalar.
3. **Perintah Kustom**: Definisikan perintah garis miring yang dapat digunakan kembali di `.claude/commands` dengan placeholder dinamis (`$argument`). Sangat bagus untuk pengujian, pembangunan, atau peninjauan.
4. **Riwayat Sesi**: Gunakan `claude --resume` atau `claude --continue` untuk melanjutkan sesi yang lebih lama. Claude menyimpan semua riwayat sesi secara lokal.
5. **Lingkaran Umpan Balik**: Tinjau perilaku agen melalui log GitHub Action atau data sesi historis dan perbarui `CLAUDE.md` Anda untuk memperbaiki kesalahpahaman atau menegakkan batasan yang lebih baik.

Pertanyaan yang Sering Diajukan (FAQ)

Q1. Apa tujuan dari CLAUDE.md?
Jwb: CLAUDE.md bertindak sebagai manifesto agen. Ini mendefinisikan aturan, alat, dan konvensi yang harus diikuti oleh Claude Code. Ini membantu menstandardisasi perilaku di seluruh repositori Anda.

Q2. Haruskah saya menggunakan subagen atau hanya tugas sederhana?
Jwb: Gunakan subagen jika Anda menginginkan alur kerja modular yang ketat. Namun banyak yang menganggap pola **Master-Klon** (menggunakan Task(...)) lebih fleksibel — Anda menjaga konteks saat mendelegasikan subtugas.

Q3. Bagaimana cara memulai ulang sesi Claude tanpa kehilangan segalanya?
Jwb: Gunakan /clear untuk mereset obrolan, lalu /catchup untuk memuat file dari branch Git Anda agar Claude memiliki konteks penuh kembali.

Q4. Apa itu hook, dan mengapa saya membutuhkannya?
Jwb: Hooks menegakkan aturan atau pemeriksaan saat Claude melakukan pekerjaan. Misalnya, hook block-at-submit dapat memastikan pengujian berhasil sebelum Git commit diizinkan.

Q5. Bagaimana saya bisa mengintegrasikan Claude Code ke dalam CI/CD?
Jwb: Gunakan Claude Code GitHub Action untuk menjalankan tugas, memvalidasi kode, menghasilkan pull request, atau menegakkan batasan `CLAUDE.md` Anda dalam pipeline otomatis.

Kesimpulan

Lembar Panduan **Claude Code** ini memberi Anda gambaran praktis dan terstruktur tentang cara menggunakan Claude Code secara efektif. Dari menulis file CLAUDE.md yang dibuat dengan baik hingga memanfaatkan perintah garis miring, subagen, hook, dan integrasi CI — pola-pola ini membentuk fondasi yang kuat untuk menggunakan Claude Code sebagai mitra pengembangan bertenaga AI yang andal.

Dengan menguasai fitur-fitur ini, pengembang baru dapat dengan cepat beradaptasi, dan insinyur yang lebih berpengalaman dapat menyederhanakan alur kerja mereka, menegakkan batasan, dan meningkatkan produktivitas yang dibantu Claude. Claude Code lebih dari sekadar alat pembuatan kode — ini adalah sistem yang dapat diprogram dan agensi yang beradaptasi dengan kebutuhan tim Anda.