Claude Code: Panduan Ngoding Ditemani AI Agent untuk Developer Indonesia

Kamu ketik nama fungsi, editor nyodorin satu baris tebakan. Lumayan, tapi itu bukan bagian yang bikin capek. Yang bikin capek: buka lima file cuma buat ngerti kenapa satu bug muncul, nulis test yang mirip-mirip berulang, refactor 12 file gara-gara ganti satu tipe. Autocomplete nggak nolong di situ. Dia nggak paham proyekmu, cuma nebak baris berikutnya.

Claude Code main di liga lain. Dia agent yang hidup di terminal: baca struktur folder, buka file yang relevan, nulis kode, jalanin perintah, lihat error-nya, lalu benerin sendiri. Kamu ngobrol, dia yang kerja. Artikel ini bahas cara pakainya dari nol, bedanya sama Cursor, dan cara ngasih konteks biar hasilnya bukan tebakan ngawur.

Apa itu Claude Code, dan kenapa "agent di terminal" itu beda

Singkatnya: claude code adalah tool CLI dari Anthropic yang menjalankan model Claude sebagai agent coding, langsung di terminal. Kata kuncinya agent. Autocomplete melengkapi kalimat, agent menyelesaikan tugas. Bedanya ada di siapa yang pegang kemudi.

Waktu kamu bilang "tambahin endpoint reset password", agent bakal cari file router, baca pola endpoint yang sudah ada, nulis handler baru, bikin test-nya, jalanin test itu, dan kalau merah dia baca pesan error lalu perbaiki. Kamu nggak nunjuk file satu-satu. Dia yang jelajah sendiri, kamu tinggal review hasilnya.

Instalasi dan setup awal

Butuh Node.js kepasang. Install lewat npm, masuk ke folder proyek, terus jalanin. Tiga baris:

npm install -g @anthropic-ai/claude-code
cd ~/proyek/toko-kopi
claude

Pertama kali jalan, dia minta login ke akun Anthropic lewat browser. Sesudah itu kamu masuk ke sesi interaktif di dalam folder. Poin pentingnya: Claude Code selalu terikat ke folder tempat kamu jalanin. Folder itu jadi dunianya. Dia baca file di situ, nulis di situ, jalanin perintah di situ.

Perintah dasar yang sering kepakai di dalam sesi:

• Ketik permintaan biasa pakai bahasa manusia, Indonesia atau Inggris sama saja
• /clear untuk mulai obrolan baru tanpa bawa konteks lama yang bikin berat
• /init untuk minta Claude bikin draft file CLAUDE.md dari isi proyekmu
• Esc untuk menyela kalau dia lagi ke arah yang salah, jangan tunggu selesai
• Shift+Tab untuk muter mode permission: dari default yang minta izin tiap edit, ke auto-accept yang jalan tanpa nanya lagi, sampai plan mode yang cuma nyusun rencana tanpa nyentuh file

Buat percobaan pertama, mulai dari yang kecil. Suruh dia jelasin satu file: "jelasin apa yang dikerjain src/lib/auth.ts". Kamu langsung lihat dia baca file dulu sebelum jawab. Itu beda mendasar dari chatbot yang cuma nebak dari nama file.

Alur kerja inti: minta, review diff, iterasi kecil

Ritme yang enak itu selalu tiga langkah dan berulang. Ini inti kerja bareng agent, bukan sulap sekali jadi.

1. Minta satu hal yang jelas ruang lingkupnya, misalnya satu fitur atau satu perbaikan
2. Review diff yang dia usulkan sebelum diterapkan, baca beneran jangan asal Enter
3. Iterasi kecil: kalau ada yang meleset, koreksi spesifik, jangan ulang dari nol

Contoh permintaan yang enak dieksekusi agent, spesifik dan ada batas:

Tambah rate limit di endpoint POST /api/login.
Maksimal 5 percobaan per IP per menit.
Kalau kelewat, balas 429 dengan body { error: "terlalu banyak percobaan" }.
Pakai util yang sudah ada di src/lib/ratelimit.ts, jangan bikin library baru.
Tulis test-nya juga.

Perhatikan kalimat terakhir tiap baris: dia ngasih batas. "Pakai util yang sudah ada", "jangan bikin library baru". Batasan itu yang bikin diff-nya kecil dan gampang di-review. Waktu diff-nya muncul, baca. Kalau dia malah nambah dependency yang nggak kamu minta, bilang "hapus dependency itu, pakai fetch bawaan". Koreksi kecil, bukan tulis ulang.

Memberi konteks yang benar: CLAUDE.md plus struktur yang jelas

Ini bagian yang paling nentuin hasil bagus atau ngawur. Agent sepintar konteks yang kamu kasih. Cara paling ampuh: taruh file bernama CLAUDE.md di akar proyek. Isinya aturan main yang otomatis dia baca tiap sesi.

# Proyek: Toko Kopi Online

## Stack
- Next.js 15 (App Router), TypeScript
- Tailwind CSS, Prisma + PostgreSQL

## Aturan
- Default server component; pakai client component cuma kalau butuh interaktivitas
- Uang disimpan sebagai integer satuan sen, jangan pernah float
- Dilarang pakai tipe any; kalau ragu tipenya, tanya dulu
- Test pakai Vitest, taruh file *.test.ts di sebelah file aslinya

## Perintah
- Dev: npm run dev
- Test: npm run test
- Lint: npm run lint

File ini kayak onboarding buat rekan kerja baru. Tanpa itu, agent nebak konvensi dari nol dan sering meleset dari gaya timmu. Dengan itu, dia langsung nyambung. Kami bahas polanya lebih dalam di panduan file rules dan CLAUDE.md, termasuk cara bikin aturan yang nggak saling tabrakan.

Struktur folder juga konteks. Nama folder yang jelas, file yang nggak seribu baris, pemisahan yang masuk akal. Proyek yang rapi bikin agent nemu jalan cepat. Proyek yang berantakan bikin dia nyasar, sama persis kayak manusia baru masuk tim.

Claude Code vs Cursor: kapan pakai yang mana

Pertanyaan claude code vs cursor sering muncul, dan jawabannya bukan salah satu menang mutlak. Keduanya beda bentuk, beda enaknya.

Cursor itu editor, fork dari VS Code. Kekuatannya di edit visual: kamu lihat file, sorot baris, minta ubah di tempat, autocomplete-nya kencang. Enak buat kerja yang matamu perlu nempel di kode terus, ngoprek UI, nyetel detail per baris.

Claude Code itu agent di terminal. Kekuatannya di tugas yang mesti jelajah banyak file dan jalanin perintah: refactor lintas modul, benerin test yang gagal, bikin fitur dari ujung ke ujung. Karena di terminal, dia juga gampang dirangkai ke skrip dan otomasi.

• Ngoprek UI dan edit per baris sambil lihat file: Cursor lebih enak
• Refactor besar, ngejar bug lintas file, jalanin dan baca test: Claude Code
• Butuh masuk ke pipeline atau otomasi headless: Claude Code
• Banyak yang pakai dua-duanya: Cursor buat ngedit, Claude Code buat tugas berat

Yang mesti diingat, kelasnya beda dari editor autocomplete lama. Kalau kamu masih nimbang gaya kerja mana yang cocok, baca dulu vibe coding vs spec-driven development, karena pilihan tool itu turunan dari cara kamu mau kerja.

Kesalahan umum pemula

Tiga jebakan ini yang paling sering bikin orang kapok padahal masalahnya bukan di tool-nya.

1. Minta terlalu besar sekaligus. "Bikinin aplikasi e-commerce lengkap" itu resep berantakan. Pecah jadi potongan yang bisa di-review.
2. Konteks tipis. Nggak ada CLAUDE.md, nggak nyebut file yang relevan, lalu heran hasilnya nggak sesuai gaya tim. Agent nggak bisa baca pikiranmu.
3. Nggak ada aturan. Tanpa rules, tiap sesi dia bikin keputusan sendiri soal library, format, pola. Hasilnya nggak konsisten antar bagian.

Ada jebakan keempat yang halus: nge-Enter diff tanpa baca. Agent bagus, tapi bukan berarti bebas salah. Kamu tetap engineer yang tanggung jawab. Review itu bukan formalitas, itu pekerjaanmu. Dan kalau prompt-mu masih sering meleset, panduan bikin prompt buat AI coding ini worth dibaca.

Naik level: serahkan PRD utuh dan konektor MCP

Sejauh ini kita ngomongin tugas per potong. Tapi tugas kecil cuma sepotong dari gambar besar. Agent kerja paling bagus waktu dia tahu tujuannya, bukan cuma langkah berikutnya. Di sini PRD dan MCP masuk.

PRD (Product Requirements Document) itu dokumen yang jelasin apa yang mau dibangun dan kenapa: alur pengguna, aturan bisnis, batasan, kasus tepi. Kasih PRD utuh ke agent, dan konteksnya lompat jauh. Dia berhenti nebak maksud, mulai bikin keputusan yang nyambung ke tujuan. Cara nyusunnya ada di panduan membuat PRD.

MCP (Model Context Protocol) selangkah lagi ke depan. Ini standar yang nyambungin agent ke sumber luar, misalnya dokumen desain, database, atau tool internal, lewat satu konektor. Alih-alih kamu tempel-tempel konteks manual, agent narik sendiri yang dia butuh dari sumber. Skematik punya konektor MCP yang bikin PRD-mu bisa dibaca langsung sama agent tanpa copy-paste.

Gabungannya begini: kamu susun PRD di Skematik, sambungin lewat MCP, lalu suruh Claude Code kerjain. Agent nggak cuma tahu "bikin endpoint login", dia tahu login ini bagian dari alur onboarding yang mana, aturan sesinya apa, kasus tepi yang mesti dijaga apa. Beda kualitas keluarannya jauh. Lihat contoh nyatanya di galeri contoh biar kebayang bentuk PRD yang siap diserahkan.

Penutup: siapkan konteks dulu, baru serahkan

Claude Code bukan tombol ajaib. Dia rekan kerja yang sangat cepat dan sangat menurut pada konteks yang kamu kasih. Kasih konteks seadanya, keluarannya ya generik. Begitu konteksnya jelas, dia mulai ambil keputusan yang nyambung ke tujuanmu. Urutannya selalu sama: rapikan proyek, tulis CLAUDE.md, siapkan PRD, baru serahkan tugas.

Bagian tersulit bukan pakai agent-nya, tapi tahu persis apa yang mau dibangun. Di situ PRD jadi penentu. Susun sekali dengan benar, dan tiap permintaan ke Claude Code sesudahnya jadi lebih tajam.

Buka folder proyek, ketik claude, dan mulai dari satu tugas kecil hari ini. Kejelasan yang kamu tanam di depan bakal kebayar tiap kali agent-nya jalan.