Tutorial Claude Code: Refactoring Codebase dengan AI Agent

Claude Code dari Anthropic hadir sebagai solusi yang mengubah cara developer bekerja dengan codebase. Berbeda dengan chatbot AI biasa, Claude Code adalah agent yang berjalan langsung di terminal dan bisa membaca, mengedit, serta menjalankan perintah di repository. Artikel ini akan membahas tutorial praktis menggunakan Claude Code untuk refactoring codebase enterprise, lengkap dengan perintah, shortcut, dan best practice yang bisa langsung diterapkan.

Apa itu Claude Code dan Mengapa Developer Membutuhkannya

Claude Code adalah AI agent yang dijalankan melalui command line interface. Tool ini dirancang untuk memahami konteks codebase secara mendalam, mulai dari struktur direktori, dependency, hingga logika bisnis yang tertanam di kode. Developer bisa meminta Claude Code untuk melakukan refactoring, debugging, atau bahkan menulis test suite baru tanpa meninggalkan terminal.

Keunggulan utama Claude Code terletak pada kemampuannya memproses file dalam jumlah besar sekaligus. Berbeda dengan Copilot yang berbasis snippet, Claude Code bisa menganalisis seluruh project dan memberikan rekomendasi perubahan yang konsisten di banyak file. Ini sangat berguna untuk refactoring skala besar, misalnya saat migrasi dari JavaScript ke TypeScript atau saat mengganti library state management. Konteks window yang besar memungkinkan Claude Code membaca ratusan file secara simultan tanpa kehilangan track terhadap dependensi antar modul.

Langkah 1: Instalasi dan Konfigurasi Awal

Untuk mulai menggunakan Claude Code, pastikan sistem telah terpasang Node.js versi 18 atau lebih baru. Install Claude Code melalui npm dengan perintah berikut:

npm install -g @anthropic-ai/claude-code

Setelah instalasi selesai, masuk ke direktori project dan jalankan:

claude

Pada pertama kali dijalankan, Claude Code akan meminta autentikasi dengan akun Anthropic. Ikuti proses login yang muncul di browser. Setelah login berhasil, Claude Code akan memindai seluruh file di repository untuk membangun konteks awal. Proses ini bisa memakan waktu beberapa menit untuk codebase besar, namun hanya dilakukan sekali pada session pertama.

Langkah 2: Memberikan Instruksi Refactoring dengan Natural Language

Claude Code menerima instruksi dalam bahasa natural. Misalnya, untuk refactoring komponen React dari class component ke functional component, cukup ketik:

Refactor all class components in src/components to functional components with hooks

Claude Code akan menampilkan daftar file yang akan dimodifikasi dan meminta konfirmasi sebelum menerapkan perubahan. Fitur ini menghindari perubahan yang tidak disengaja. Tekan Y untuk menerima atau N untuk menolak. Gunakan flag --yes jika ingin otomatis tanpa konfirmasi, meskipun ini tidak direkomendasikan untuk production codebase.

Saat memberikan instruksi, deskripsikan konteks sejelas mungkin. Alih-alih mengatakan "fix bugs", lebih baik spesifik seperti "fix memory leak in useEffect hook inside Dashboard component caused by missing cleanup function". Semakin spesifik instruksi, semakin akurat output yang dihasilkan oleh Claude Code.

Langkah 3: Menggunakan Slash Commands untuk Workflow Cepat

Claude Code menyediakan beberapa slash commands yang mempercepat workflow. Perintah paling sering digunakan adalah:

• /fix : Otomatis menganalisis error di terminal dan memberikan patch

• /test : Menjalankan test suite dan menganalisis failure

• /explain : Memberikan penjelasan mendalam tentang blok kode yang sedang aktif

• /commit : Menyusun pesan commit yang deskriptif berdasarkan perubahan di working directory

• /search : Mencari kode di seluruh repository dengan query semantik

Ketik slash command di prompt Claude Code, misalnya /fix saat ada error build, dan Claude akan langsung membaca stack trace serta mengusulkan solusi. Command /search sangat berguna saat bekerja dengan codebase yang belum pernah dilihat sebelumnya, karena bisa mencari fungsi berdasarkan deskripsi bahasa natural tanpa harus tahu nama exact function.

Langkah 4: Review dan Audit Perubahan Otomatis

Salah satu best practice menggunakan Claude Code adalah selalu melakukan review manual setelah AI mengusulkan perubahan. Gunakan perintah git diff untuk melihat apa yang berubah. Claude Code mendukung integrasi dengan git, sehingga setiap perubahan bisa langsung di-stage atau di-commit.

Untuk codebase enterprise, aktifkan mode --vision jika project memiliki asset gambar atau diagram yang perlu dianalisis. Meskipun refactoring umumnya berfokus pada kode, mode ini berguna saat bekerja dengan frontend yang memiliki desain kompleks. Selain itu, gunakan fitur --model untuk memilih model Claude yang lebih powerful (Claude 3.7 Sonnet) saat menangani refactoring yang melibatkan logic bisnis rumit.

Langkah 5: Mengintegrasikan Claude Code dengan CI/CD Pipeline

Claude Code bisa dijalankan di environment CI/CD untuk melakukan pre-flight check sebelum merge. Buat script di pipeline, misalnya di GitHub Actions:

name: Claude Code Refactor Check
on: [pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g @anthropic-ai/claude-code
      - run: claude --non-interactive /test

Perlu diperhatikan bahwa mode non-interactive memerlukan API key yang diset sebagai environment variable ANTHROPIC_API_KEY. Pastikan key tersebut disimpan dengan aman di secret repository. Untuk enterprise, pertimbangkan menggunakan separate API key dengan rate limit yang sesuai untuk pipeline CI/CD agar tidak mempengaruhi quota development daily usage.

Langkah 6: Optimasi Performa dan Memory Management

Saat bekerja dengan codebase enterprise yang memiliki ribuan file, Claude Code bisa mengonsumsi memory cukup besar. Untuk mengoptimasi, gunakan file .claudeignore untuk mengecualikan direktori yang tidak relevan seperti node_modules, .git, atau build artifacts. Formatnya mirip dengan .gitignore.

node_modules/
dist/
build/
*.log
.coverage/

Semakin kecil konteks yang dipindai, semakin cepat response time dan semakin hemat token API. Selain itu, jika refactoring hanya terfokus pada satu modul, arahkan Claude Code dengan path spesifik: Refactor src/modules/payment to use async/await pattern daripada meminta refactoring di seluruh repository.

Kesimpulan dan Best Practice

Claude Code membawa paradigma baru dalam workflow refactoring: agent AI yang berjalan di terminal dan memahami konteks penuh codebase. Namun, tool ini bukan pengganti keputusan engineer. Selalu review perubahan, jalankan test suite secara manual, dan jangan otomatisasi deploy tanpa approval manusia.

Untuk informasi lebih lanjut, kunjungi dokumentasi resmi Claude Code atau repository GitHub Claude Code.

Dengan penerapan yang tepat, Claude Code bisa mengurangi waktu refactoring codebase besar dari berminggu-minggu menjadi beberapa hari kerja, tanpa mengorbankan kualitas kode.