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

Apa Itu Claude Code?

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

Berikut beberapa kemampuan kunci Claude Code:

• Pengeditan dan refactoring: Memodifikasi, mengoptimalkan, dan menyempurnakan codebase Anda dengan saran berbasis AI.
• Perbaikan bug: Mengidentifikasi dan menyelesaikan error, dependensi yang hilang, dan hambatan kinerja.
• 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 codebase tingkat enterprise, Claude Code dapat membantu dengan otomatisasi cerdas yang menyesuaikan gaya coding dan kebutuhan proyek Anda. Pembaruan terbaru menambahkan auto mode (lebih sedikit interupsi izin), plan mode (alur kerja berbasis desain), dan Routines (agen cloud terjadwal yang berjalan berdasarkan pemicu tanpa perlu mesin Anda aktif).

Berikut beberapa pengguna ideal untuk layanan ini:

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

Kini Claude Code menggunakan default Claude Opus 4.7 pada paket Max dan Team Premium. Pengguna Pro memulai dengan Sonnet 4.6 namun dapat beralih ke model Opus untuk tugas yang menuntut. Anda dapat mengganti 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 file dan dokumen sehari-hari di luar pengkodean. Tersedia bagi semua pelanggan berbayar (Pro, Max, Team, Enterprise) di aplikasi Claude Desktop.

Mari mulai dengan proyek praktik langsung.

Langkah 1: Menyiapkan Claude Code

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

Instal Claude Code dengan mudah 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 usang (deprecated), sehingga Anda sebaiknya menggunakan proses instalasi native seperti disebutkan di atas. Jika sebelumnya Anda menginstal melalui npm, Anda dapat bermigrasi dengan claude install.

Setelah terinstal, arahkan 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 menuju kode verifikasi yang harus dimasukkan di terminal tempat Claude Code berjalan. Setelah itu selesai, sebuah workspace “Claude Code” khusus akan dibuat secara otomatis untuk pelacakan penggunaan dan manajemen 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 seperangkat alat, termasuk autentikasi, langganan real-time, penyimpanan, dan API yang dihasilkan otomatis.

Mari mulai dengan mengkloning repositori dan menyiapkan lingkungan pengembangan kita.

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

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

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

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

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

Langkah 3: Mengidentifikasi Area untuk Kontribusi

Cara yang bagus untuk berkontribusi adalah dengan menelusuri tab Issues di GitHub. Di repositori Supabase, saya mengidentifikasi sebuah isu pada 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 error lainnya.

Langkah 4: Bereksperimen Dengan Claude Code

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

cd supabase
claude

Kini Claude Code memiliki akses ke setiap file dan folder di dalam folder Supabase-py. Sekarang, mari bereksperimen.

Melakukan refactoring kode

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

Prompt: Refactor kode di file client.py yang ada di folder Supabase.

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

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

• Pengaturan impor yang terorganisasi:  Claude Code mengelompokkan impor terkait ke dalam bagian logis (error autentikasi, tipe API, error fungsi), mengganti nama impor agar lebih jelas, dan menghapus alias berlebih demi konsistensi.
• Keterbacaan yang ditingkatkan: Menambahkan komentar bagian untuk mengklasifikasikan impor dan menghapus duplikasi pada daftar __all__ demi organisasi yang lebih rapi.
• Opsional klien yang disederhanakan: Juga mengurangi beberapa baris dengan menggabungkan impor serupa ke dalam satu pernyataan.

Berikut perbandingan berdampingan antara kode asli dan kode hasil refactor.

Mendokumentasikan kode

Selain refactoring, Claude Code dapat membuat, memperbarui, dan menstandarkan 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 file.
• Komentar bagian terperinci yang mengategorikan impor (tipe error, implementasi klien, layanan penyimpanan).
• Komentar inline untuk menjelaskan tipe error, fungsi klien, dan komponen penting.

Berikut perbandingan berdampingan antara kode hasil refactor dan kode yang telah didokumentasikan.

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

Setelah dokumentasi ditambahkan, Anda dapat memverifikasi kepatuhannya terhadap standar proyek dengan meminta Claude:

Prompt: Periksa apakah dokumentasinya mengikuti standar proyek kita.

Memperbaiki bug

Debugging bisa memakan waktu, tetapi Claude Code mempersingkat siklusnya dengan menganalisis pesan error, mengidentifikasi akar masalah, dan menyarankan perbaikan. Baik Anda menghadapi impor yang hilang, error 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 error kepada Claude.
2. Dapatkan rekomendasi perbaikan: Minta solusi yang memungkinkan dari Claude.
3. Terapkan dan verifikasi perbaikan:  Terapkan saran Claude dan periksa apakah masalahnya telah terselesaikan.

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

• Komentar type ignore: Menambahkan komentar # type: ignore untuk menekan peringatan IDE dan pemeriksaan tipe atas impor yang tidak terselesaikan.
• Kategorisasi error yang konsisten: Claude Code memastikan bahwa impor error dari autentikasi, database, penyimpanan, dan fungsi dikelompokkan dengan jelas.
• Menjaga keterbacaan kode: Komentar ditambahkan untuk menunjukkan alasan mengapa impor tertentu 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 dapat Anda coba dengan Claude.

Untuk pembahasan lebih mendalam, saya merekomendasikan panduan slash command Claude Code kami.

Fitur Lanjutan Claude Code

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

Claude Code hooks

Claude Code hooks adalah pemicu otomatis yang mengeksekusi perintah shell ketika peristiwa tertentu terjadi selama sesi Claude Code Anda. Hooks mengotomatisasi 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?

• Command: Apa yang dijalankan saat hook terpicu?

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

Use case umum untuk hooks meliputi berikut ini

• 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 pada file sensitif seperti konfigurasi produksi atau kunci API

• Dokumentasi: Menghasilkan dokumentasi API secara otomatis saat file sumber berubah

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

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

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

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

Claude Code plugins

Plugin adalah ekstensi yang menghubungkan Claude Code ke alat, layanan, dan API eksternal. Sementara hooks mengotomatisasi 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—subagen (asisten Claude khusus untuk tugas tertentu), server MCP (integrasi alat terstandar), dan hooks—ke dalam satu paket yang mengorkestrasi semuanya.

Sebuah plugin dapat menganalisis perubahan kode dan 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 file berubah

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

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

• Code review: Secara otomatis membuat pull request dan mengelola review di GitHub/GitLab

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

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

• Ekstensi IDE: Menambahkan perintah kustom dan pembantu navigasi

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

Fitur lanjutan lainnya

Claude Code menambahkan beberapa kemampuan besar lainnya pada 2026 yang memperluas cara dan tempat Anda dapat menggunakannya:

• Plan mode: Alur kerja berbasis desain di mana Claude membuat rencana implementasi terperinci sebelum menulis kode apa pun. Saya menggunakan ini untuk tugas yang tidak sepele.
• Auto mode: Pengaturan izin yang memungkinkan Claude bekerja dengan lebih sedikit interupsi, berguna untuk tugas panjang saat Anda tidak ingin menyetujui setiap penulisan file.
• Routines: Agen cloud terjadwal yang berjalan pada 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 dengannya dari ponsel atau perangkat lain.

Pemikiran Akhir

Dalam tutorial ini, saya menggunakan Claude Code untuk melakukan refactor, membuat dokumentasi, dan melakukan debug pada file di SDK Supabase Python. Kami meningkatkan keterbacaan kode, menambahkan dokumentasi terstruktur, dan menyelesaikan masalah impor.

Claude Code terus berkembang dengan fitur seperti plan mode, auto mode, dan Routines, jadi layak untuk Anda coba pada proyek Anda sendiri guna melihat bagaimana alat ini cocok 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 nol, saya merekomendasikan membaca tutorial kami tentang Spec-Driven Development with Claude Code.