Tutorial Claude Code

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

• 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

​

Memahami basis kode baru

​

Mendapatkan 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

> berikan saya gambaran umum tentang basis kode ini

> jelaskan pola arsitektur utama yang digunakan di sini

> apa saja model data utamanya?

> bagaimana autentikasi ditangani?

Tips:

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

​

Menemukan kode yang relevan

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

> temukan file yang menangani autentikasi pengguna

> bagaimana file-file autentikasi ini bekerja bersama?

> lacak proses login dari front-end ke 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.

> Saya melihat kesalahan saat menjalankan npm test

> sarankan beberapa cara untuk memperbaiki @ts-ignore di user.ts

> perbarui user.ts untuk menambahkan pemeriksaan null yang Anda sarankan

Tips:

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

​

Refaktor kode

​

Memodernisasi kode lama

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

> temukan penggunaan API yang sudah usang dalam basis kode kita

> sarankan cara merefaktor utils.js untuk menggunakan fitur JavaScript modern

> refaktor utils.js untuk menggunakan fitur ES2024 sambil mempertahankan perilaku yang sama

> jalankan pengujian untuk kode yang direfaktor

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.

> temukan fungsi di NotificationsService.swift yang tidak tercakup oleh pengujian

> tambahkan pengujian untuk layanan notifikasi

> tambahkan kasus pengujian untuk kondisi batas dalam layanan notifikasi

> jalankan pengujian baru dan perbaiki kegagalan apa pun

Tips:

• Minta pengujian yang mencakup kasus batas 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.

> ringkas perubahan yang telah saya buat pada modul autentikasi

> buat pr

> tingkatkan deskripsi PR dengan lebih banyak konteks tentang peningkatan keamanan

> tambahkan informasi tentang bagaimana perubahan ini diuji

Tips:

• Minta Claude langsung untuk membuatkan 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.

> temukan fungsi tanpa komentar JSDoc yang tepat di modul auth

> tambahkan komentar JSDoc ke fungsi yang belum didokumentasikan di auth.js

> tingkatkan dokumentasi yang dihasilkan dengan lebih banyak konteks dan contoh

> periksa apakah dokumentasi mengikuti standar proyek kita

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.

# 1. Seret dan lepas gambar ke jendela Claude Code
# 2. Salin gambar dan tempel ke CLI dengan ctrl+v
# 3. Berikan path gambar
claude "Analisis gambar ini: /path/to/your/image.png"

> Apa yang ditunjukkan gambar ini?
> Jelaskan elemen UI dalam tangkapan layar ini
> Apakah ada elemen bermasalah dalam diagram ini?

> Ini tangkapan layar kesalahannya. Apa yang menyebabkannya?
> Ini skema database kita saat ini. Bagaimana kita harus memodifikasinya untuk fitur baru?

> Hasilkan CSS untuk mencocokkan mockup desain ini
> Struktur HTML apa yang akan mereproduksi komponen ini?

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: Saat bekerja pada keputusan arsitektur yang kompleks, bug yang menantang, atau merencanakan implementasi multi-langkah yang memerlukan penalaran mendalam.

> Saya perlu mengimplementasikan sistem autentikasi baru menggunakan OAuth2 untuk API kami. Pikirkan secara mendalam tentang pendekatan terbaik untuk mengimplementasikan ini dalam basis kode kami.

> pikirkan tentang potensi kerentanan keamanan dalam pendekatan ini
> pikirkan lebih keras tentang kasus batas yang harus kita tangani

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 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 prompting 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
• Anda dapat menambahkan file CLAUDE.md ke salah satu dari:
  • Folder tempat Anda menjalankan Claude: Secara otomatis ditambahkan ke percakapan yang Anda mulai di folder tersebut
  • Direktori anak: Claude menarik ini sesuai permintaan
  • ~/.claude/CLAUDE.md: Preferensi khusus pengguna yang tidak ingin Anda masukkan ke kontrol sumber

​

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.

​

Mengonfigurasi 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

# 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 (dulu disebut project di versi lama)
  • project: Dibagikan dengan semua orang di proyek melalui file .mcp.json
  • user: Tersedia untuk Anda di semua proyek (dulu disebut global di versi lama)
• Atur variabel lingkungan dengan flag -e atau --env (misalnya, -e KEY=value)
• Konfigurasikan batas waktu startup server MCP menggunakan variabel lingkungan MCP_TIMEOUT (misalnya, MCP_TIMEOUT=10000 claude mengatur batas waktu 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 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 kontrol versi untuk berbagi server MCP dengan tim Anda
• Server bercakupan proyek memudahkan untuk memastikan semua orang di 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

​

Hubungkan 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

> jelaskan skema tabel pengguna kami
> apa pesanan terbaru dalam sistem?
> tunjukkan hubungan antara pelanggan dan faktur

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

​

Tambahkan 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 khusus proyek

​

Impor server MCP dari Claude Desktop

Kapan digunakan: Anda telah mengonfigurasi server MCP di Claude Desktop dan ingin menggunakan server yang sama di Claude Code tanpa mengonfigurasi 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)

​

Gunakan Claude Code sebagai server MCP

Kapan digunakan: Anda ingin menggunakan Claude Code sendiri sebagai server MCP yang dapat dihubungi 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

​

Tambahkan 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 menyalurkan data ke Claude, dan mendapatkan kembali data dalam format terstruktur.

cat build-error.txt | claude -p 'jelaskan secara ringkas akar penyebab kesalahan build ini' > output.txt

​

Membuat perintah garis miring kustom

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

​

Buat perintah khusus proyek

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

mkdir -p .claude/commands

echo "Analisis kinerja kode ini dan sarankan tiga optimasi spesifik:" > .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

​

Tambahkan argumen perintah dengan $ARGUMENTS

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

echo "Temukan dan perbaiki masalah #$ARGUMENTS. Ikuti langkah-langkah ini:
1. Pahami masalah yang dijelaskan dalam tiket
2. Temukan kode yang relevan dalam basis kode kita
3. Implementasikan solusi yang mengatasi akar penyebab
4. Tambahkan pengujian yang sesuai
5. Siapkan deskripsi PR yang ringkas" > .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 pengujian untuk fungsi tertentu, membuat dokumentasi untuk komponen, meninjau kode dalam file tertentu, atau menerjemahkan konten ke bahasa tertentu

​

Buat perintah garis miring pribadi

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

mkdir -p ~/.claude/commands

echo "Tinjau kode ini untuk kerentanan keamanan, fokus pada:" > ~/.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

​

Langkah selanjutnya