Tutorial Claude Code: Penyiapan, Refactoring, dan Debugging Secara Praktis

Apa itu Claude Code?

Claude Code adalah alat yang berjalan langsung di terminal Anda, memahami basis kode Anda dan membantu tugas pengembangan dengan perintah bahasa alami. Alat ini terintegrasi dengan lingkungan pengembangan Anda dengan penyiapan minimal, sehingga Anda bisa fokus menulis dan meningkatkan kode.

Berikut beberapa kemampuan utama Claude Code:

• Pengeditan dan refactoring: Memodifikasi, mengoptimalkan, dan meningkatkan basis kode Anda dengan saran bertenaga AI.
• Perbaikan bug: Mengidentifikasi dan menyelesaikan kesalahan, dependensi yang hilang, dan hambatan performa.
• Pemahaman kode: Ajukan pertanyaan tentang arsitektur, logika, dan dependensi kode Anda.
• Pengujian & linting otomatis: Menjalankan dan memperbaiki tes yang gagal, menjalankan perintah linting, dan meningkatkan kualitas kode.
• Integrasi Git: Menelusuri riwayat git, menyelesaikan konflik merge, membuat commit, dan menghasilkan pull request dengan mudah.

Baik saat mengerjakan proyek open-source maupun mengelola basis kode tingkat enterprise, Claude Code dapat membantu dengan automasi cerdas yang menyesuaikan gaya pengodean dan kebutuhan proyek Anda. Pembaruan terbaru menambahkan auto mode (lebih sedikit interupsi perizinan), plan mode (alur kerja design-first), dan Routines (agen cloud terjadwal yang berjalan berdasarkan pemicu tanpa mesin Anda aktif).

Berikut beberapa pengguna ideal untuk layanan ini:

• Pengembang Perangkat Lunak: Meningkatkan kualitas dan kemudahan pemeliharaan kode.
• Kontributor Open Source: Memahami dan meningkatkan basis kode yang belum familiar.
• Insinyur DevOps: Mengotomatiskan tugas code review dan linting.

Claude Code kini menggunakan Claude Opus 4.7 secara default pada paket Max dan Team Premium. Pengguna Pro memulai dengan Sonnet 4.6 namun dapat beralih ke model Opus untuk tugas yang menuntut. Anda bisa berganti model di tengah sesi dengan perintah /model atau menyesuaikan kedalaman penalaran dengan penggeser /effort. Anda juga dapat membangun agen AI mandiri menggunakan Claude Agents SDK.

Anthropic juga memperkenalkan Cowork untuk bantuan bergaya agen pada tugas berkas dan dokumen sehari-hari di luar pengodean. Tersedia untuk semua pelanggan berbayar (Pro, Max, Team, Enterprise) di aplikasi Claude Desktop.

Mari mulai dengan proyek praktis kita.

Langkah 1: Menyiapkan Claude Code

Untuk mulai menggunakan Claude Code, Anda memerlukan terminal, proyek kode untuk dikerjakan, dan berlangganan Claude (Pro/Max/Teams/Enterprise) atau akun Claude Console dengan penagihan aktif.

Instal Claude Code dengan menjalankan salah satu perintah berikut di terminal Anda, sesuai dengan sistem operasi dan terminal yang digunakan.

macOS / Linux / WSL: 

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

Windows PowerShell: 

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

Windows CMD:  

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Catatan: Instalasi melalui npm install -g @anthropic-ai/claude-code masih ada namun sudah tidak direkomendasikan (deprecated), sehingga Anda sebaiknya menggunakan proses instalasi native yang disebutkan di atas. Jika sebelumnya Anda menginstal via npm, Anda dapat bermigrasi dengan claude install.

Setelah terpasang, navigasikan ke direktori proyek Anda dan mulai Claude dengan menjalankan:

cd your-project-directory
claude

Untuk autentikasi, Anda akan ditanya apakah ingin menggunakan Claude Code berdasarkan langganan berbayar atau penagihan penggunaan API.

Selanjutnya, Anda akan menerima tautan login yang mengarah ke kode verifikasi yang harus dimasukkan di terminal tempat Claude Code berjalan. Setelah itu selesai, sebuah workspace "Claude Code" khusus akan otomatis dibuat untuk pelacakan penggunaan dan pengelolaan biaya.

Sekarang, Claude Code siap digunakan.

Langkah 2: Menyiapkan Lingkungan Pengembangan

Untuk demo ini, saya akan menggunakan pustaka Supabase Python supabase-py, klien Python open-source untuk berinteraksi dengan Supabase, layanan backend-as-a-service yang dibangun di atas PostgreSQL. Supabase menyediakan rangkaian alat, termasuk autentikasi, langganan real-time, penyimpanan, dan API yang dibuat otomatis.

Mari mulai dengan mengkloning repositori dan menyiapkan lingkungan pengembangan kita.

1. Buka terminal Anda, navigasikan ke direktori tempat Anda ingin mengkloning repositori Supabase-py (mis. cd Desktop), lalu jalankan perintah berikut:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. Selanjutnya, buat lingkungan virtual dan instal dependensi yang diperlukan dengan menjalankan perintah berikut di terminal Anda satu per satu

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

Lingkungan Python Anda kini disiapkan dengan semua dependensi yang diperlukan untuk menjalankan pustaka Supabase, dan repositori Anda siap dieksplorasi. 

Langkah 3: Mengidentifikasi Area Kontribusi

Cara yang bagus untuk berkontribusi adalah dengan menjelajahi tab Issues di GitHub. Dalam repositori Supabase, saya mengidentifikasi masalah di client.py terkait keterbacaan kode, struktur, dan kurangnya komentar yang bermakna.

Berikut yang akan kita lakukan dengan Claude Code:

• Kita akan melakukan refactor kode untuk meningkatkan keterbacaan, kemudahan pemeliharaan, dan struktur.
• Menambahkan docstring dan komentar inline yang bermakna untuk memperjelas tujuan berbagai komponen.
• Mengidentifikasi dan memperbaiki bug dengan menganalisis isu dan potensi kesalahan lainnya.

Langkah 4: Bereksperimen dengan Claude Code

Karena kita sudah berada di folder supabase-py, navigasikan ke direktori supabase yang berisi berkas client.py dan jalankan Claude Code:

cd supabase
claude

Claude Code kini memiliki akses ke setiap berkas dan folder di dalam folder Supabase-py. Sekarang, mari kita bereksperimen.

Melakukan refactoring kode

Sebagai bagian dari peningkatan SDK Supabase Python, mari lakukan refactor pada berkas client.py untuk meningkatkan keterbacaan, kemudahan pemeliharaan, dan organisasi. Cukup masukkan prompt berikut di baris perintah:

Prompt: Refactor kode di berkas client.py yang berada di folder Supabase.

Claude akan meminta konfirmasi sebelum melanjutkan. Tekan Enter untuk menyetujui perubahan. Setelah selesai, Claude Code akan memperbarui berkas, menampilkan modifikasi di terminal, dan memberikan ringkasan perubahan yang dibuat.

Dengan menggunakan Claude Code, kami menerapkan peningkatan berikut pada client.py:

• Mengorganisasi impor:  Claude Code mengelompokkan impor terkait ke dalam bagian logis (error autentikasi, tipe API, error fungsi), mengganti nama impor untuk kejelasan, dan menghapus alias berlebih agar konsisten.
• Meningkatkan keterbacaan: Menambahkan komentar bagian untuk mengklasifikasikan impor dan menghapus duplikasi dalam daftar __all__ agar lebih rapi.
• Menyederhanakan opsi klien: Juga mengurangi beberapa baris dengan menggabungkan impor serupa menjadi satu pernyataan.

Berikut perbandingan berdampingan antara kode asli dan yang telah direfaktor.

Mendokumentasikan kode

Selain refactoring, Claude Code dapat menghasilkan, memperbarui, dan menyeragamkan dokumentasi kode di seluruh proyek. Alat ini dapat mengidentifikasi bagian yang belum terdokumentasi, menghasilkan docstring atau komentar terstruktur, dan memeriksa kepatuhan terhadap standar dokumentasi proyek.

Kami menggunakan Claude Code untuk meningkatkan dokumentasi di client.py, menghasilkan:

• Docstring tingkat modul yang jelas yang menjelaskan tujuan berkas.
• Komentar bagian yang terperinci untuk mengategorikan impor (jenis error, implementasi klien, layanan penyimpanan).
• Komentar inline untuk menjelaskan jenis error, fungsi klien, dan komponen penting.

Berikut perbandingan berdampingan antara kode yang telah direfaktor dan yang sudah didokumentasikan.

Prompt: Dokumentasikan kode client.py dengan menambahkan komentar untuk meningkatkan pemahaman.

Setelah dokumentasi ditambahkan, Anda dapat memverifikasi kepatuhannya terhadap standar proyek dengan memberi prompt kepada Claude:

Prompt: Periksa apakah dokumentasi mengikuti standar proyek kami.

Memperbaiki bug

Debugging bisa memakan waktu, tetapi Claude Code memperpendek siklusnya dengan menganalisis pesan kesalahan, mengidentifikasi akar penyebab, dan menyarankan perbaikan. Baik Anda menghadapi impor yang hilang, kesalahan runtime, atau masalah logika, alat ini mempersempit ruang pencarian dan mengusulkan koreksi yang terarah.

Berikut cara menggunakan Claude Code untuk debugging:

1. Identifikasi masalah:  Bagikan pesan kesalahan kepada Claude.
2. Dapatkan rekomendasi perbaikan: Minta solusi yang mungkin dari Claude.
3. Terapkan dan verifikasi perbaikan:  Terapkan saran Claude dan periksa apakah masalahnya teratasi.

Claude Code melakukan pengaturan berikut untuk menyelesaikan masalah terkait impor dalam berkas client.py: 

• Komentar type ignore: Menambahkan komentar # type: ignore untuk meniadakan peringatan IDE dan pemeriksaan tipe atas impor yang tidak terselesaikan.
• Pengelompokan error yang konsisten: Claude Code memastikan impor error dari autentikasi, basis data, penyimpanan, dan fungsi dikelompokkan dengan jelas.
• Menjaga keterbacaan kode: Komentar ditambahkan untuk menunjukkan alasan beberapa impor diabaikan alih-alih dihapus.

Berikut perbandingan berdampingan antara kode asli dan kode yang telah diperbaiki.

Prompt: Saya melihat beberapa bug, seperti 'Import gotrue.errors' tidak dapat diselesaikan. Bantu saya memperbaiki semua error di client.py.

Perintah Claude Code

Berikut beberapa perintah yang bisa Anda coba dengan Claude.

Saya juga merekomendasikan untuk melihat tutorial resmi Anthropic dan panduan praktik terbaik Claude Code kami.

Fitur Lanjutan Claude Code

Setelah Anda nyaman dengan dasar-dasar refactoring dan debugging, Anda dapat memperluas kemampuan Claude Code dengan menyesuaikan perilakunya. Hooks dan Plugin memungkinkan Anda mengotomatiskan tugas berulang dan mengintegrasikan sistem eksternal.

Claude Code hooks

Claude Code hooks adalah pemicu otomatis yang mengeksekusi perintah shell saat peristiwa tertentu terjadi selama sesi Claude Code Anda. Hooks mengotomatiskan tugas berulang seperti pemformatan kode, menjalankan tes, dan pemeriksaan keamanan yang mungkin dilewati Claude.

Hooks menggunakan sistem event-action, di mana Anda mendefinisikan tiga hal:

• Event: Kapan hook dipicu?

• Matcher: Tindakan mana yang terpengaruh?

• Perintah: Apa yang dijalankan saat hook terpicu?

Sebagai contoh, sebuah hook dapat terpicu setelah Claude menulis berkas Python dan otomatis menjalankan black untuk memformat kode. Hooks menerima konteks JSON tentang apa yang terjadi, memungkinkan pengambilan keputusan cerdas berdasarkan jenis atau path berkas. Hooks dapat mengeluarkan output ke transkrip Claude atau mengirim pesan kesalahan langsung ke Claude untuk memblokir operasi.

Kasus penggunaan umum untuk hooks mencakup hal-hal berikut

• Pemformatan kode: Menjalankan linter dan formatter secara otomatis setelah penulisan kode

• Pengujian: Menjalankan rangkaian tes setelah modifikasi untuk menangkap bug lebih awal

• Keamanan: Memblokir modifikasi ke berkas sensitif seperti konfigurasi produksi atau kunci API

• Dokumentasi: Membuat dokumentasi API secara otomatis saat berkas sumber berubah

• Automasi Git: Membuat commit cerdas dan memvalidasi kebijakan perlindungan branch

• Notifikasi: Memberi tahu tim Anda melalui Slack saat berkas penting berubah

• Kepatuhan: Menegakkan header lisensi atau standar pengodean sebelum mengizinkan modifikasi

Siapkan hooks menggunakan perintah /hooks di Claude Code atau edit langsung ~/.claude/settings.json.

Plugin Claude Code

Plugin adalah ekstensi yang menghubungkan Claude Code ke alat, layanan, dan API eksternal. Sementara hooks mengotomatiskan perintah shell lokal, plugin terintegrasi dengan ekosistem pengembangan yang lebih luas seperti pipeline CI/CD, alat manajemen proyek, dan platform komunikasi tim.

Plugin dapat menggabungkan beberapa komponen—subagent (asisten Claude khusus untuk tugas tertentu), server MCP (integrasi alat standar), dan hooks—ke dalam satu paket yang mengorkestrasi semuanya bersama.

Sebuah plugin dapat menganalisis perubahan kode dan secara otomatis membuat isu di Jira, atau terhubung ke infrastruktur pengujian internal Anda. Plugin merespons event yang sama seperti hooks tetapi mengirim data ke layanan eksternal dan memproses respons untuk memengaruhi alur kerja Claude.

Berikut beberapa tugas yang sangat cocok untuk plugin Claude Code:

• Integrasi CI/CD: Memicu build, tes, dan deployment saat berkas berubah

• Manajemen proyek: Membuat atau memperbarui isu secara otomatis di Jira, GitHub, atau Linear

• Komunikasi tim: Mengirim pembaruan ke Slack atau Teams saat terjadi perubahan

• Code review: Membuat pull request secara otomatis dan mengelola review di GitHub/GitLab

• Analisis eksternal: Memanggil SonarQube, CodeClimate, atau Snyk untuk pemindaian kode tingkat enterprise

• Alat kustom: Terintegrasi dengan sistem dan alur kerja internal perusahaan

• Ekstensi IDE: Menambahkan perintah khusus dan pembantu navigasi

Instal plugin dari registry atau bangun secara internal untuk organisasi Anda, lalu konfigurasikan event mana yang mereka tanggapi. Hooks dan plugin bersama-sama menciptakan platform yang dapat diperluas yang menyesuaikan Claude Code dengan infrastruktur Anda yang ada.

Fitur lanjutan lainnya

Claude Code menambahkan beberapa kemampuan utama lainnya pada 2026 yang memperluas bagaimana dan di mana Anda dapat menggunakannya:

• Plan mode: Alur kerja design-first di mana Claude membuat rencana implementasi terperinci sebelum menulis kode apa pun. Saya menggunakan ini untuk tugas non-trivial.
• Auto mode: Pengklasifikasi perizinan yang memungkinkan Claude bekerja dengan lebih sedikit interupsi, berguna untuk tugas yang lebih panjang saat Anda tidak ingin menyetujui setiap penulisan berkas.
• Routines: Agen cloud terjadwal yang berjalan berdasarkan jadwal cron, event GitHub (seperti PR dibuka), atau panggilan webhook. Mesin Anda tidak perlu aktif.
• Integrasi IDE: Claude Code memiliki ekstensi resmi untuk VS Code, Cursor, dan JetBrains IDE dengan diff inline, checkpoint, dan dukungan multi-sesi.
• Kendali jarak jauh dan Channels: Menjalankan sesi Claude Code dan berinteraksi dari ponsel atau perangkat lain.

Penutup

Dalam tutorial ini, saya menggunakan Claude Code untuk melakukan refactor, mendokumentasikan, dan men-debug sebuah berkas di SDK Supabase Python. Kita meningkatkan keterbacaan kode, menambahkan dokumentasi terstruktur, dan menyelesaikan masalah impor.

Claude Code terus berkembang dengan fitur-fitur seperti plan mode, auto mode, dan Routines, jadi layak untuk Anda coba pada proyek sendiri guna melihat kecocokannya dengan alur kerja Anda.

Untuk melangkah lebih jauh, saya mendorong Anda membaca tutorial Claude Code Best Practices kami yang mengajarkan cara memaksimalkan jendela konteks Claude. Jika Anda ingin membangun proyek dari awal, saya sarankan membaca tutorial Spec-Driven Development with Claude Code.