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 berbahasa alami. Alat ini terintegrasi dengan lingkungan pengembangan Anda dengan penyiapan minimal, sehingga Anda dapat fokus menulis dan meningkatkan kode.

Berikut beberapa kemampuan utama Claude Code:

• Mengedit dan melakukan refactoring: Memodifikasi, mengoptimalkan, dan meningkatkan codebase Anda dengan saran berbasis AI.
• Perbaikan bug: Mengidentifikasi dan menyelesaikan error, dependensi yang hilang, dan hambatan performa.
• Pemahaman kode: Ajukan pertanyaan tentang arsitektur, logika, dan dependensi kode Anda.
• Pengujian & linting otomatis: Menjalankan dan memperbaiki uji 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 otomasi cerdas yang beradaptasi dengan gaya pengkodean dan kebutuhan proyek Anda. Pembaruan terbaru menambahkan auto mode (lebih sedikit interupsi izin), plan mode (alur kerja dengan desain lebih dulu), dan Routines (agen cloud terjadwal yang berjalan berdasarkan pemicu tanpa harus menyalakan mesin Anda).

Berikut beberapa pengguna ideal untuk layanan ini:

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

Claude Code kini menggunakan bawaan Claude Opus 4.7 pada paket Max dan Team Premium. Pengguna Pro memulai dengan Sonnet 4.6 tetapi dapat beralih ke model Opus untuk tugas berat. Anda bisa 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 untuk semua pelanggan paket berbayar (Pro, Max, Team, Enterprise) di aplikasi Claude Desktop.

Jika Anda membandingkan Claude Code dengan agen terminal xAI, Grok Build vs. Claude Code kami menguji keduanya pada tugas yang sama.

Mari mulai dengan proyek praktik langsung.

Langkah 1: Menyiapkan Claude Code

Untuk memulai dengan Claude Code, Anda memerlukan terminal, sebuah 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 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, sehingga Anda sebaiknya menggunakan proses instalasi native yang disebutkan di atas. Jika sebelumnya Anda memasang melalui npm, Anda dapat melakukan migrasi dengan claude install.

Setelah terpasang, masuk ke direktori proyek Anda dan jalankan Claude dengan perintah:

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 khusus “Claude Code” 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 serangkaian 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, masuk 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 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 sekarang siap 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. Di repositori Supabase, saya mengidentifikasi sebuah isu di client.py terkait keterbacaan kode, struktur, dan kurangnya komentar yang bermakna.

Berikut yang akan kita lakukan dengan Claude Code:

• Kita akan melakukan refactoring 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, masuk ke direktori supabase yang berisi file client.py dan jalankan Claude Code:

cd supabase
claude

Claude Code sekarang 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 kita lakukan refactoring pada file client.py untuk meningkatkan keterbacaan, kemudahan pemeliharaan, dan pengorganisasian. Cukup masukkan prompt berikut di baris perintah:

Prompt: Lakukan refactoring kode di file client.py yang berada 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 perbaikan berikut pada client.py:

• Mengatur impor:  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.
• Meningkatkan keterbacaan: Alat ini menambahkan komentar bagian untuk mengklasifikasikan impor dan menghapus duplikasi dalam daftar __all__ demi organisasi yang lebih bersih.
• Menyederhanakan opsi klien: Alat ini 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 menstandarkan dokumentasi kode di seluruh proyek. Alat ini dapat mengidentifikasi bagian yang belum terdokumentasi, membuat 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 mengkategorikan impor (tipe error, implementasi klien, layanan penyimpanan).
• Komentar inline untuk menjelaskan tipe error, fungsi klien, dan komponen penting.

Berikut perbandingan berdampingan antara kode yang 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 Anda dengan memberikan prompt kepada Claude:

Prompt: Periksa apakah dokumentasinya mengikuti standar proyek kami.

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 kepada Claude.
3. Terapkan dan verifikasi perbaikan:  Terapkan saran Claude dan periksa apakah masalah telah teratasi.

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

• Komentar type ignore: Menambahkan komentar # type: ignore untuk menekan peringatan IDE dan pemeriksaan tipe atas impor yang tidak terselesaikan.
• Kategori error yang konsisten: Claude Code memastikan bahwa 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 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.

Untuk bahasan lebih mendalam, saya sarankan membaca panduan slash command 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 menjalankan perintah shell saat peristiwa tertentu terjadi selama sesi Claude Code Anda. Hooks mengotomatiskan tugas berulang seperti pemformatan kode, menjalankan uji, 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 dipicu?

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

Kasus penggunaan umum untuk hooks meliputi berikut ini

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

• Pengujian: Jalankan rangkaian uji setelah modifikasi untuk menangkap bug lebih awal

• Keamanan: Blokir modifikasi pada file sensitif seperti konfigurasi produksi atau kunci API

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

• Otomasi Git: Buat commit cerdas dan validasi kebijakan perlindungan branch

• Notifikasi: Beritahu tim Anda melalui Slack saat file penting berubah

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

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

Plugin Claude Code

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

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

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, uji, dan deployment saat file berubah

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

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

• Tinjauan kode: Membuat pull request otomatis dan mengelola ulasan di GitHub/GitLab

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

• Alat kustom: Mengintegrasikan sistem dan alur kerja milik 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 tanggapi. Hooks dan plugin bersama-sama membentuk platform yang dapat diperluas yang menyesuaikan Claude Code dengan infrastruktur Anda.

Fitur lanjutan lainnya

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

• Plan mode: Alur kerja berorientasi desain di mana Claude membuat rencana implementasi terperinci sebelum menulis kode. Saya menggunakannya untuk tugas yang tidak sepele.
• Auto mode: Pengklasifikasi izin yang memungkinkan Claude bekerja dengan lebih sedikit interupsi, berguna untuk tugas panjang ketika 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 menyala.
• 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.

Penutup

Di tutorial ini, saya menggunakan Claude Code untuk melakukan refactoring, dokumentasi, dan debugging pada sebuah 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 ada baiknya bereksperimen pada proyek Anda sendiri untuk melihat kecocokannya dengan alur kerja Anda.

Untuk langkah berikutnya, saya mendorong Anda membaca tutorial Praktik Terbaik Claude Code yang mengajarkan cara memaksimalkan jendela konteks Claude. Jika Anda ingin membangun proyek dari nol, saya sarankan membaca tutorial kami tentang Spec-Driven Development dengan Claude Code.