Tutorial

Panduan ini menyediakan tutorial langkah demi langkah untuk alur kerja umum dengan Claude Code. Setiap tutorial mencakup instruksi yang jelas, contoh perintah, dan praktik terbaik untuk membantu Anda mendapatkan hasil maksimal dari Claude Code.

​

Daftar isi

• Melanjutkan percakapan sebelumnya
• Memahami basis kode baru
• Memperbaiki bug secara efisien
• Refaktor kode
• Bekerja dengan pengujian
• Membuat pull request
• Menangani dokumentasi
• Bekerja dengan gambar
• Menggunakan pemikiran diperpanjang
• Menyiapkan memori proyek
• Menyiapkan Model Context Protocol (MCP)
• Menggunakan Claude sebagai utilitas unix
• Membuat perintah garis miring kustom
• Menjalankan sesi Claude Code paralel dengan Git worktrees

​

Melanjutkan percakapan sebelumnya

​

Lanjutkan pekerjaan Anda dengan lancar

Kapan digunakan: Anda telah bekerja pada tugas dengan Claude Code dan perlu melanjutkan dari tempat Anda berhenti di sesi berikutnya.

Claude Code menyediakan dua opsi untuk melanjutkan percakapan sebelumnya:

• --continue untuk secara otomatis melanjutkan percakapan terbaru
• --resume untuk menampilkan pemilih percakapan

claude --continue

claude --continue --print "Continue with my task"

claude --resume

Cara kerjanya:

1. Penyimpanan Percakapan: Semua percakapan secara otomatis disimpan secara lokal dengan riwayat pesan lengkapnya
2. Deserialisasi Pesan: Saat melanjutkan, seluruh riwayat pesan dipulihkan untuk mempertahankan konteks
3. Status Alat: Penggunaan alat dan hasil dari percakapan sebelumnya dipertahankan
4. Pemulihan Konteks: Percakapan dilanjutkan dengan semua konteks sebelumnya tetap utuh

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

Contoh:

# Melanjutkan percakapan terbaru
claude --continue

# Melanjutkan percakapan terbaru dengan prompt tertentu
claude --continue --print "Show me our progress"

# Menampilkan pemilih percakapan
claude --resume

# Melanjutkan percakapan terbaru dalam mode non-interaktif
claude --continue --print "Run the tests again"

​

Memahami basis kode baru

​

Dapatkan gambaran umum basis kode dengan cepat

Kapan digunakan: Anda baru saja bergabung dengan proyek baru dan perlu memahami strukturnya dengan cepat.

cd /path/to/project 

claude 

> give me an overview of this codebase 

> explain the main architecture patterns used here 

> what are the key data models?

> how is authentication handled?

Tips:

• Mulai dengan pertanyaan luas, kemudian persempit ke area tertentu
• Tanyakan tentang konvensi pengkodean dan pola yang digunakan dalam proyek
• Minta glosarium istilah khusus proyek

​

Menemukan kode yang relevan

Kapan digunakan: Anda perlu menemukan kode yang terkait dengan fitur atau fungsionalitas tertentu.

> find the files that handle user authentication 

> how do these authentication files work together? 

> trace the login process from front-end to database 

Tips:

• Spesifik tentang apa yang Anda cari
• Gunakan bahasa domain dari proyek

​

Memperbaiki bug secara efisien

​

Mendiagnosis pesan kesalahan

Kapan digunakan: Anda menemui pesan kesalahan dan perlu menemukan dan memperbaiki sumbernya.

> I'm seeing an error when I run npm test 

> suggest a few ways to fix the @ts-ignore in user.ts 

> update user.ts to add the null check you suggested 

Tips:

• Beri tahu Claude perintah untuk mereproduksi masalah dan dapatkan stack trace
• Sebutkan langkah-langkah untuk mereproduksi kesalahan
• Beri tahu Claude jika kesalahan bersifat intermiten atau konsisten

​

Refaktor kode

​

Memodernisasi kode lama

Kapan digunakan: Anda perlu memperbarui kode lama untuk menggunakan pola dan praktik modern.

> find deprecated API usage in our codebase 

> suggest how to refactor utils.js to use modern JavaScript features 

> refactor utils.js to use ES2024 features while maintaining the same behavior 

> run tests for the refactored code 

Tips:

• Minta Claude untuk menjelaskan manfaat pendekatan modern
• Minta agar perubahan mempertahankan kompatibilitas mundur jika diperlukan
• Lakukan refaktor dalam peningkatan kecil yang dapat diuji

​

Bekerja dengan pengujian

​

Menambah cakupan pengujian

Kapan digunakan: Anda perlu menambahkan pengujian untuk kode yang belum tercakup.

> find functions in NotificationsService.swift that are not covered by tests 

> add tests for the notification service 

> add test cases for edge conditions in the notification service 

> run the new tests and fix any failures 

Tips:

• Minta pengujian yang mencakup kasus tepi dan kondisi kesalahan
• Minta pengujian unit dan integrasi jika sesuai
• Minta Claude menjelaskan strategi pengujian

​

Membuat pull request

​

Menghasilkan PR yang komprehensif

Kapan digunakan: Anda perlu membuat pull request yang terdokumentasi dengan baik untuk perubahan Anda.

> summarize the changes I've made to the authentication module 

> create a pr 

> enhance the PR description with more context about the security improvements 

> add information about how these changes were tested 

Tips:

• Minta Claude langsung untuk membuat PR untuk Anda
• Tinjau PR yang dihasilkan Claude sebelum mengirimkan
• Minta Claude untuk menyoroti potensi risiko atau pertimbangan

​

Menangani dokumentasi

​

Menghasilkan dokumentasi kode

Kapan digunakan: Anda perlu menambah atau memperbarui dokumentasi untuk kode Anda.

> find functions without proper JSDoc comments in the auth module 

> add JSDoc comments to the undocumented functions in auth.js 

> improve the generated documentation with more context and examples 

> check if the documentation follows our project standards 

Tips:

• Tentukan gaya dokumentasi yang Anda inginkan (JSDoc, docstrings, dll.)
• Minta contoh dalam dokumentasi
• Minta dokumentasi untuk API publik, antarmuka, dan logika kompleks

​

Bekerja dengan gambar

​

Menganalisis gambar dan tangkapan layar

Kapan digunakan: Anda perlu bekerja dengan gambar dalam basis kode Anda atau mendapatkan bantuan Claude untuk menganalisis konten gambar.

> What does this image show? 
> Describe the UI elements in this screenshot 
> Are there any problematic elements in this diagram? 

> Here's a screenshot of the error. What's causing it? 
> This is our current database schema. How should we modify it for the new feature? 

> Generate CSS to match this design mockup 
> What HTML structure would recreate this component? 

Tips:

• Gunakan gambar ketika deskripsi teks akan tidak jelas atau rumit
• Sertakan tangkapan layar kesalahan, desain UI, atau diagram untuk konteks yang lebih baik
• Anda dapat bekerja dengan beberapa gambar dalam satu percakapan
• Analisis gambar bekerja dengan diagram, tangkapan layar, mockup, dan lainnya

​

Menggunakan pemikiran diperpanjang

​

Memanfaatkan pemikiran diperpanjang Claude untuk tugas kompleks

Kapan digunakan: Ketika bekerja pada keputusan arsitektur yang kompleks, bug yang menantang, atau merencanakan implementasi multi-langkah yang memerlukan penalaran mendalam.

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase. 

> think about potential security vulnerabilities in this approach 
> think harder about edge cases we should handle 

Tips untuk mendapatkan nilai maksimal dari pemikiran diperpanjang:

Pemikiran diperpanjang paling berharga untuk tugas kompleks seperti:

• Merencanakan perubahan arsitektur yang kompleks
• Men-debug masalah rumit
• Membuat rencana implementasi untuk fitur baru
• Memahami basis kode yang kompleks
• Mengevaluasi pertukaran antara pendekatan yang berbeda

Cara Anda meminta pemikiran menghasilkan tingkat kedalaman pemikiran yang berbeda:

• “think” memicu pemikiran diperpanjang dasar
• frasa intensifikasi seperti “think more”, “think a lot”, “think harder”, atau “think longer” memicu pemikiran yang lebih dalam

Untuk tips prompt pemikiran diperpanjang lebih lanjut, lihat Tips pemikiran diperpanjang.

​

Menyiapkan memori proyek

​

Membuat file CLAUDE.md yang efektif

Kapan digunakan: Anda ingin menyiapkan file CLAUDE.md untuk menyimpan informasi proyek penting, konvensi, dan perintah yang sering digunakan.

> /init 

Tips:

• Sertakan perintah yang sering digunakan (build, test, lint) untuk menghindari pencarian berulang
• Dokumentasikan preferensi gaya kode dan konvensi penamaan
• Tambahkan pola arsitektur penting yang spesifik untuk proyek Anda
• Memori CLAUDE.md dapat digunakan untuk instruksi yang dibagikan dengan tim Anda dan untuk preferensi individual Anda. Untuk detail lebih lanjut, lihat Mengelola memori Claude.

​

Menyiapkan Model Context Protocol (MCP)

Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan LLM untuk mengakses alat dan sumber data eksternal. Untuk detail lebih lanjut, lihat dokumentasi MCP.

​

Mengkonfigurasi server MCP

Kapan digunakan: Anda ingin meningkatkan kemampuan Claude dengan menghubungkannya ke alat khusus dan server eksternal menggunakan Model Context Protocol.

# Sintaks dasar
claude mcp add <name> <command> [args...]

# Contoh: Menambahkan server lokal
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

# Sintaks dasar
claude mcp add --transport sse <name> <url>

# Contoh: Menambahkan server SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# Daftar semua server yang dikonfigurasi
claude mcp list

# Dapatkan detail untuk server tertentu
claude mcp get my-server

# Hapus server
claude mcp remove my-server

Tips:

• Gunakan flag -s atau --scope untuk menentukan di mana konfigurasi disimpan:
  • local (default): Hanya tersedia untuk Anda di proyek saat ini (sebelumnya disebut project)
  • project: Dibagikan dengan semua orang di proyek melalui file .mcp.json
  • user: Tersedia untuk Anda di semua proyek (sebelumnya disebut global)
• Atur variabel lingkungan dengan flag -e atau --env (misalnya, -e KEY=value)
• Konfigurasi timeout startup server MCP menggunakan variabel lingkungan MCP_TIMEOUT (misalnya, MCP_TIMEOUT=10000 claude mengatur timeout 10 detik)
• Periksa status server MCP kapan saja menggunakan perintah /mcp dalam Claude Code
• MCP mengikuti arsitektur client-server di mana Claude Code (client) dapat terhubung ke beberapa server khusus

​

Memahami cakupan server MCP

Kapan digunakan: Anda ingin memahami bagaimana cakupan MCP yang berbeda bekerja dan bagaimana berbagi server dengan tim Anda.

# Tambahkan server bercakupan lokal (default)
claude mcp add my-private-server /path/to/server

# Tentukan cakupan lokal secara eksplisit
claude mcp add my-private-server -s local /path/to/server

# Tambahkan server bercakupan proyek
claude mcp add shared-server -s project /path/to/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# Tambahkan server pengguna
claude mcp add my-user-server -s user /path/to/server

Tips:

• Server bercakupan lokal memiliki prioritas lebih tinggi daripada server bercakupan proyek dan pengguna dengan nama yang sama
• Server bercakupan proyek (dalam .mcp.json) memiliki prioritas lebih tinggi daripada server bercakupan pengguna dengan nama yang sama
• Sebelum menggunakan server bercakupan proyek dari .mcp.json, Claude Code akan meminta Anda untuk menyetujuinya untuk keamanan
• File .mcp.json dimaksudkan untuk dimasukkan ke dalam version control untuk berbagi server MCP dengan tim Anda
• Server bercakupan proyek memudahkan untuk memastikan semua orang dalam tim Anda memiliki akses ke alat MCP yang sama
• Jika Anda perlu mengatur ulang pilihan Anda untuk server bercakupan proyek mana yang diaktifkan atau dinonaktifkan, gunakan perintah claude mcp reset-project-choices

​

Terhubung ke server MCP Postgres

Kapan digunakan: Anda ingin memberikan Claude akses hanya-baca ke database PostgreSQL untuk kueri dan inspeksi skema.

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# Dalam sesi Claude Anda, Anda dapat bertanya tentang database Anda

> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices

Tips:

• Server MCP Postgres menyediakan akses hanya-baca untuk keamanan
• Claude dapat membantu Anda mengeksplorasi struktur database dan menjalankan kueri analitis
• Anda dapat menggunakan ini untuk dengan cepat memahami skema database dalam proyek yang tidak familiar
• Pastikan string koneksi Anda menggunakan kredensial yang sesuai dengan izin minimum yang diperlukan

​

Menambahkan server MCP dari konfigurasi JSON

Kapan digunakan: Anda memiliki konfigurasi JSON untuk satu server MCP yang ingin Anda tambahkan ke Claude Code.

# Sintaks dasar
claude mcp add-json <name> '<json>'

# Contoh: Menambahkan server stdio dengan konfigurasi JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

Tips:

• Pastikan JSON diescaped dengan benar di shell Anda
• JSON harus sesuai dengan skema konfigurasi server MCP
• Anda dapat menggunakan -s global untuk menambahkan server ke konfigurasi global Anda alih-alih yang spesifik proyek

​

Impor server MCP dari Claude Desktop

Kapan digunakan: Anda telah mengkonfigurasi server MCP di Claude Desktop dan ingin menggunakan server yang sama di Claude Code tanpa mengkonfigurasi ulang secara manual.

# Sintaks dasar 
claude mcp add-from-claude-desktop 

claude mcp list 

Tips:

• Fitur ini hanya berfungsi di macOS dan Windows Subsystem for Linux (WSL)
• Ini membaca file konfigurasi Claude Desktop dari lokasi standarnya di platform tersebut
• Gunakan flag -s global untuk menambahkan server ke konfigurasi global Anda
• Server yang diimpor akan memiliki nama yang sama seperti di Claude Desktop
• Jika server dengan nama yang sama sudah ada, mereka akan mendapatkan akhiran numerik (misalnya, server_1)

​

Menggunakan Claude Code sebagai server MCP

Kapan digunakan: Anda ingin menggunakan Claude Code sendiri sebagai server MCP yang dapat dihubungkan oleh aplikasi lain, menyediakan mereka dengan alat dan kemampuan Claude.

# Sintaks dasar
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Tips:

• Server menyediakan akses ke alat Claude seperti View, Edit, LS, dll.
• Di Claude Desktop, coba minta Claude untuk membaca file dalam direktori, membuat edit, dan lainnya.
• Perhatikan bahwa server MCP ini hanya mengekspos alat Claude Code ke klien MCP Anda, jadi klien Anda sendiri bertanggung jawab untuk mengimplementasikan konfirmasi pengguna untuk panggilan alat individual.

​

Menggunakan Claude sebagai utilitas unix

​

Menambahkan Claude ke proses verifikasi Anda

Kapan digunakan: Anda ingin menggunakan Claude Code sebagai linter atau peninjau kode.

Langkah-langkah:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

​

Pipe masuk, pipe keluar

Kapan digunakan: Anda ingin memasukkan data ke Claude, dan mendapatkan kembali data dalam format terstruktur.

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

​

Kontrol format output

Kapan digunakan: Anda memerlukan output Claude dalam format tertentu, terutama saat mengintegrasikan Claude Code ke dalam skrip atau alat lain.

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Tips:

• Gunakan --output-format text untuk integrasi sederhana di mana Anda hanya memerlukan 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 garis miring kustom

Claude Code mendukung perintah garis miring kustom yang dapat Anda buat untuk dengan cepat mengeksekusi prompt atau tugas tertentu.

​

Membuat perintah spesifik proyek

Kapan digunakan: Anda ingin membuat perintah garis miring yang dapat digunakan ulang untuk proyek Anda yang dapat digunakan oleh semua anggota tim.

mkdir -p .claude/commands

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md 

claude > /project:optimize 

Tips:

• Nama perintah berasal dari nama file (misalnya, optimize.md menjadi /project:optimize)
• Anda dapat mengorganisir perintah dalam subdirektori (misalnya, .claude/commands/frontend/component.md menjadi /project:frontend:component)
• Perintah proyek tersedia untuk semua orang yang mengkloning repositori
• Konten file Markdown menjadi prompt yang dikirim ke Claude ketika perintah dijalankan

​

Menambahkan argumen perintah dengan $ARGUMENTS

Kapan digunakan: Anda ingin membuat perintah garis miring yang fleksibel yang dapat menerima input tambahan dari pengguna.

echo "Find and fix issue #$ARGUMENTS. Follow these steps: 1.
Understand the issue described in the ticket 2. Locate the relevant code in
our codebase 3. Implement a solution that addresses the root cause 4. Add
appropriate tests 5. Prepare a concise PR description" >
.claude/commands/fix-issue.md 

claude > /project:fix-issue 123 

Tips:

• Placeholder $ARGUMENTS diganti dengan teks apa pun yang mengikuti perintah
• Anda dapat memposisikan $ARGUMENTS di mana saja dalam template perintah Anda
• Aplikasi berguna lainnya: menghasilkan kasus uji untuk fungsi tertentu, membuat dokumentasi untuk komponen, meninjau kode dalam file tertentu, atau menerjemahkan konten ke bahasa tertentu

​

Membuat perintah garis miring pribadi

Kapan digunakan: Anda ingin membuat perintah garis miring pribadi yang berfungsi di semua proyek Anda.

mkdir -p ~/.claude/commands 

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md 

claude > /user:security-review 

Tips:

• Perintah pribadi diawali dengan /user: alih-alih /project:
• Perintah pribadi hanya tersedia untuk Anda dan tidak dibagikan dengan tim Anda
• Perintah pribadi berfungsi di semua proyek Anda
• Anda dapat menggunakan ini untuk alur kerja yang konsisten di berbagai basis kode

​

Menjalankan sesi Claude Code paralel dengan Git worktrees

​

Menggunakan worktrees untuk lingkungan pengkodean yang terisolasi

Kapan digunakan: Anda perlu bekerja pada beberapa tugas secara bersamaan dengan isolasi kode lengkap antara instance Claude Code.

# Buat worktree baru dengan cabang baru git worktree add
../project-feature-a feature-a # Atau buat worktree dengan cabang yang ada
git worktree add ../project-bugfix bugfix-123 

# Navigasi ke worktree Anda 
cd ../project-feature-a # Jalankan Claude Code di lingkungan terisolasi ini claude 

cd ../project-bugfix claude

# Daftar semua worktrees git worktree list # Hapus worktree ketika selesai
git worktree remove ../project-feature-a 

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 worktrees berbagi riwayat Git dan koneksi remote yang sama
• Untuk tugas jangka panjang, Anda dapat memiliki Claude bekerja di satu worktree sementara Anda melanjutkan pengembangan di yang lain
• Gunakan nama direktori deskriptif untuk dengan mudah mengidentifikasi tugas mana 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

​

Langkah selanjutnya