Cara Refactor Kode Lama (Legacy Code) Pakai AI: Claude Code & Cursor 2026
Punya kode warisan dari developer sebelumnya yang bikin merinding? Variabel bernama data2_final_fix_beneran, fungsi 500 baris, dan komentar “jangan diubah, nanti error”? Kamu tidak sendirian. Hampir semua developer Indonesia yang kerja di perusahaan atau handle project lama menghadapi masalah yang sama: legacy code.
Kabar baiknya, di 2026 ini refactor kode lama bukan lagi pekerjaan berhari-hari. Dengan Claude Code dan Cursor, pekerjaan yang dulu makan seminggu bisa selesai dalam hitungan jam — asal kamu tahu caranya. Di artikel ini kita bahas langkah demi langkah, plus prompt siap pakai yang bisa langsung kamu copas.
Kenapa artikel ini penting buat kamu yang pakai AI untuk ngoding? Karena refactor adalah salah satu use case AI coding yang paling “worth it” — dan kalau kamu mau mulai, panduan setup Cursor dan Claude Code dengan API hemat bisa jadi langkah pertama.
Kenapa Legacy Code Itu Menyeramkan (dan Kenapa AI Tepat Mengatasinya)
Legacy code punya tiga masalah utama:
- Tidak ada dokumentasi. Orang yang nulis sudah resign, dan satu-satunya “dokumentasi” adalah ingatan dia yang ikut resign.
- Takut menyentuh. Kode jalan “entah kenapa”, dan mengubah satu baris bisa merusak lima fitur lain.
- Volume besar. Refactor manual butuh baca ribuan baris kode, hal yang sangat melelahkan untuk manusia tapi murah untuk AI.
AI coding tools menyelesaikan masalah ini dengan kelebihan yang tidak dimiliki manusia: AI tidak bosan membaca 10.000 baris kode, tidak punya asumsi salah dari ingatan lama, dan bisa menjelaskan kode yang bahkan tidak pernah dia tulis.
Persiapan Sebelum Refactor
Jangan langsung menyuruh AI “refactor semua kode ini”. Itu resep bencana. Ikuti persiapan ini dulu:
1. Pastikan Ada Test Suite (atau Bikin Dulu)
Ini aturan emas refactor: tanpa test, refactor itu nebak-nebakan. Sebelum menyentuh apapun:
- Kalau sudah ada test, pastikan semua test lulus sebelum mulai.
- Kalau belum ada, minta AI bikin test dulu untuk fitur yang akan direfactor. Prompt-nya:
Baca file [nama file] dan buatkan unit test yang mencakup semua
perilaku kode saat ini. Jangan ubah logika kodenya, hanya tulis
test yang memverifikasi perilaku existing. Jelaskan asumsi kamu
tentang edge case yang belum jelas.
Sekarang kamu punya jaring pengaman. Kalau refactor merusak sesuatu, test akan berteriak.
2. Kerjakan di Branch Terpisah
Buat branch khusus seperti refactor/payment-module. Jangan pernah refactor langsung di branch utama, apalagi produksi.
3. Pahami Dulu Struktur dengan AI
Sebelum mengubah apapun, minta AI memetakan kode:
Analisis struktur folder ini dan buat ringkasan:
1. Arsitektur umum yang dipakai (MVC, modular, monolit, dll)
2. Modul mana yang paling kritis
3. Daftar technical debt yang kamu temukan, urutkan dari
paling berisiko
4. Bagian mana yang sebaiknya JANGAN disentuh dulu
Hasil prompt ini biasanya langsung membuka mata. Kode yang terasa “chaos” ternyata punya pola — dan AI pandai menemukan pola itu dalam hitungan menit.
Strategi Refactor: Sedikit-Sedikit, Bukan Sekali Habis
Kesalahan terbesar pemula: minta AI refactor seluruh codebase sekali jalan. Hasilnya? Diff raksasa yang mustahil di-review, dan kamu tidak tahu mana perubahan yang aman atau berbahaya.
Strategi yang benar adalah strangler fig pattern — refactor bertahap satu modul per satu modul:
Langkah 1: Mulai dari Modul Paling Kecil yang Ada Test-nya
Pilih satu file atau satu modul kecil. Idealnya yang:
- Punya test yang sudah lulus
- Tidak terlalu banyak ketergantungan (dependency) ke modul lain
- Sering berubah (artinya penting untuk bisnis)
Langkah 2: Minta AI Menjelaskan Sebelum Mengubah
Jelaskan apa yang dilakukan fungsi [nama fungsi] ini baris
demi baris. Apa saja input yang diharapkan, output yang
dihasilkan, dan side effect yang tersembunyi?
Langkah ini penting — kamu perlu memahami kode dulu sebelum menyetujui perubahan. AI jelasin kode jauh lebih cepat dari kamu baca sendiri.
Langkah 3: Refactor Satu Jenis Perubahan dalam Satu Sesai
Prompt refactor yang bagus itu spesifik. Contoh urutan yang disarankan:
Refactor file ini dengan SATU perubahan saja: ekstrak fungsi
besar menjadi fungsi-fungsi kecil yang punya nama deskriptif.
Jangan mengubah logika, jangan mengubah nama variabel publik,
jangan menambah fitur baru. Tampilkan hasilnya sebagai diff.
Setelah itu, satu per satu:
Sekarang ganti nama variabel yang ambigu (data, temp, x)
menjadi nama yang deskriptif. Logika tetap sama.
Sekarang hapus kode mati (dead code) dan komentar yang
sudah tidak relevan. Tunjukkan mana yang kamu hapus dan kenapa.
Dengan memecah jadi langkah kecil, setiap diff mudah di-review dan risiko regresi jauh lebih rendah.
Langkah 4: Jalankan Test Setiap Sesi
Setiap selesai satu perubahan, jalankan test. Kalau ada yang merah, tunjukkan error ke AI:
Test [nama test] gagal dengan error ini: [paste error].
Perbaiki refactor kamu tanpa mengubah perilaku test.
Refactor dengan Claude Code di Terminal
Claude Code unggul untuk refactor skala besar karena bisa membaca seluruh codebase dan menjalankan perintah terminal sendiri. Alur kerja yang terbukti efektif:
- Buka terminal di folder project, jalankan
claude. - Minta dia menganalisis codebase dan menulis hasil analisis ke file
REFACTOR_PLAN.md. - Review rencana itu, edit sesuai kebutuhanmu.
- Suruh dia eksekusi rencana modul per modul, commit setiap selesai satu modul.
Keuntungan pendekatan ini: setiap commit punya pesan jelas, dan kalau ada masalah di modul ke-4, kamu bisa rollback tanpa merusak modul 1-3.
Kalau kamu belum pernah setup Claude Code, panduan lengkapnya ada di tutorial setup Claude Code dengan API key — termasuk cara pakai dengan API hemat tanpa langganan mahal.
Refactor dengan Cursor
Cursor lebih cocok untuk refactor iteratif sambil kamu melihat kodenya langsung:
- Buka file target, tekan
Ctrl+K(inline edit) untuk perubahan kecil. - Gunakan chat dengan konteks file (
@file) untuk perubahan yang butuh diskusi. - Untuk perubahan lintas banyak file, pakai Composer/Agent mode.
Trik pro di Cursor: buat file .cursorrules berisi standar kode tim kamu (misal: “selalu pakai TypeScript strict, larang any, maksimal 30 baris per fungsi”). Dengan begitu semua refactor otomatis mengikuti standar tim. Kalau belum familiar, baca tutorial setup cursorrules dan project rules yang sudah pernah kita bahas.
Kesalahan Umum yang Harus Dihindari
- “Refactor semuanya sekarang juga.” Sudah dibahas — pecah jadi langkah kecil.
- Menerima usulan AI tanpa baca diff. AI kadang “membersihkan” kode dengan cara mengubah perilaku. Selalu baca diff-nya.
- Refactor sambil nambah fitur. Jangan. Refactor = logika tetap sama. Nambah fitur itu pekerjaan terpisah.
- Lupa commit sering-sering. Commit kecil dan sering adalah nyawamu.
- Tidak menjaga API key kamu. Refactor sering melibatkan kode yang berisi key dan secret. Setelah selesai, pastikan tidak ada key yang ke-commit ke repo. Tips lengkapnya ada di artikel cara mengamankan API key AI.
Berapa Biaya Refactor Pakai AI?
Hitungan kasar: menganalisis dan merefactor modul 2.000 baris kode biasanya memakan puluhan ribu token. Kalau pakai API key dengan model hemat, biayanya bisa di bawah harga segelas kopi — bandingkan dengan 2-3 hari kerja manual. Kalau refactor-nya rutin, langganan Claude Pro atau Cursor Pro lebih masuk akal. Perbandingan biaya selengkapnya bisa dibaca di artikel review Cursor Pro untuk developer.
Penutup
Refactor legacy code pakai AI di 2026 ini seperti punya partner senior yang tidak pernah lelah: dia baca semua kodenya, jelaskan yang membingungkan, dan kerjakan perubahan membosankan sambil kamu fokus di keputusan arsitektur. Kuncinya cuma satu: disiplin — test dulu, branch terpisah, langkah kecil, review setiap diff.
Mulai dari modul terkecil project kamu hari ini, dan rasakan bedanya. Selamat refactor!