Bagaimana Claude Code Bekerja: Dari Perintah Sampai Perubahan Kode

Di tulisan sebelumnya kita sudah berkenalan sekilas dengan Claude Code. Sekarang mari kita bongkar sedikit lebih dalam: apa yang sebenarnya terjadi antara saat kita mengetik permintaan dan saat kode di proyek kita berubah?

Loop agen: baca, pikir, bertindak, ulangi

Inti dari cara kerja Claude Code adalah sesuatu yang sering disebut sebagai agent loop atau putaran agen. Ini adalah siklus berulang di mana model:

1. Menerima instruksi kita beserta konteks percakapan sejauh ini
2. Memutuskan apakah perlu memakai sebuah tool (alat) untuk mengumpulkan informasi atau melakukan aksi
3. Menjalankan tool tersebut dan menerima hasilnya
4. Mengevaluasi hasil itu, lalu memutuskan langkah berikutnya — apakah sudah selesai, atau perlu tool lain lagi

Putaran ini bisa berulang banyak kali dalam satu permintaan. Kalau kita minta "cari kenapa halaman checkout error", Claude Code mungkin akan mencari file yang relevan, membaca beberapa di antaranya, menjalankan test yang berkaitan, membaca log error, lalu baru mengedit kode — semua sebagai rangkaian langkah yang saling terhubung, bukan satu jawaban instan.

Tools: "tangan dan mata" di dalam proyek

Claude Code punya beberapa kemampuan dasar (tools) yang bisa dipakainya sendiri sesuai kebutuhan, tanpa kita harus memintanya satu-satu:

• Membaca file — untuk memahami kode yang sudah ada sebelum mengubahnya
• Mencari di seluruh proyek — baik berdasarkan nama file (glob) maupun isi teks/kode (semacam pencarian grep)
• Mengedit dan menulis file — melakukan perubahan yang presisi, bukan menimpa seluruh berkas begitu saja
• Menjalankan perintah shell — misalnya menjalankan test, instalasi dependency, atau perintah git
• Mengambil konten dari web — berguna saat perlu memeriksa dokumentasi terbaru dari sebuah library

Yang menarik, Claude Code bisa menentukan sendiri tool mana yang paling relevan untuk setiap situasi. Ia tidak butuh kita menuliskan langkah-langkah teknis secara eksplisit — cukup jelaskan apa yang kita inginkan, dan ia akan menyusun sendiri bagaimana mencapainya.

Konteks proyek lewat file khusus

Salah satu hal yang cukup membantu adalah kemampuan Claude Code membaca semacam "catatan panduan" di dalam proyek — biasanya berupa file bernama CLAUDE.md di root direktori. Di file ini, tim bisa menuliskan konvensi penulisan kode, perintah build atau test yang biasa dipakai, struktur folder yang penting untuk diketahui, atau aturan lain yang spesifik untuk proyek tersebut.

Dengan begitu, setiap kali Claude Code bekerja di proyek itu, ia sudah "tahu" konteks dasarnya tanpa kita perlu menjelaskan ulang dari nol setiap sesi. Ini mirip seperti onboarding singkat untuk anggota tim baru — bedanya, Claude Code membacanya dalam sekejap.

Kenapa ia bertanya izin untuk hal-hal tertentu?

Ada perbedaan mendasar antara tindakan yang mudah dibatalkan dan yang sulit dibatalkan. Membaca file, misalnya, adalah tindakan yang benar-benar aman — tidak mengubah apa pun. Tapi menjalankan perintah yang menghapus data, mem-push kode ke repositori bersama, atau mengubah file di luar folder proyek adalah tindakan yang jauh lebih berisiko kalau ternyata keliru.

Karena itulah sistem izin bertingkat menjadi penting: tindakan berisiko rendah bisa berjalan lebih bebas, sementara tindakan berisiko tinggi tetap meminta konfirmasi eksplisit dari kita sebagai manusia yang bertanggung jawab atas keputusan akhir. Prinsip ini sejalan dengan cara kerja yang bijak untuk alat otomatis apa pun — beri kebebasan secukupnya untuk efisiensi, tapi tetap ada "rem tangan" untuk hal-hal yang konsekuensinya besar.

Mengapa hasil akhirnya terasa "koheren"?

Karena seluruh proses ini berjalan dalam satu sesi dengan konteks yang terus terjaga, hasil akhirnya cenderung terasa konsisten — variabel yang dipakai sesuai dengan yang sudah ada di proyek, gaya penulisan kode mengikuti pola yang sudah berlaku, dan perubahan yang dibuat memang mempertimbangkan bagian-bagian lain dari basis kode, bukan sekadar tempelan kode generik yang terpisah dari konteks.

Selanjutnya, di tulisan terakhir seri ini, kita akan membahas beberapa kebiasaan praktis yang bisa membuat sesi kerja bersama Claude Code terasa jauh lebih lancar dan efisien.