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
• Menggunakan alur kerja git lanjutan
• Bekerja dengan gambar
• Menyiapkan memori proyek
• Menggunakan Claude sebagai utilitas unix
• Menyiapkan Model Context Protocol (MCP)

​

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, kemudian persempit ke area tertentu
• Tanyakan tentang konvensi pengkodean dan pola 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:

• Bersikaplah 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 jika 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 increment 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 mengirim
• 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

​

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 folder tempat Anda menjalankan Claude, direktori induk (Claude membaca ini secara otomatis), atau direktori anak (Claude menarik ini sesuai permintaan)

​

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 'anda adalah linter. tolong lihat perubahan vs. main dan laporkan masalah apa pun yang terkait dengan kesalahan ketik. laporkan nama file dan nomor baris pada satu baris, dan deskripsi masalah pada baris kedua. jangan mengembalikan teks lain.'"
    }
}

​

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

​

Menyiapkan Model Context Protocol (MCP)

Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan LLM 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 <nama> <perintah> [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 dengan project (default) atau global untuk menentukan di mana konfigurasi disimpan
• Atur variabel lingkungan dengan flag -e atau --env (mis., -e KEY=value)
• MCP mengikuti arsitektur client-server di mana Claude Code (client) dapat terhubung ke beberapa server khusus

​

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
$ claude
> jelaskan skema tabel pengguna kita
> 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

​

Langkah selanjutnya