Praktik Terbaik Claude Code: Perencanaan, Transfer Konteks, TDD

Claude Code memberikan hasil terbaik ketika Anda menerapkan disiplin yang jarang diminta oleh alat pengembang lain. Jika Anda sudah menggunakannya cukup lama, Anda akan menyadari bahwa beberapa sesi menghasilkan tepat seperti yang Anda inginkan, sementara yang lain menghabiskan token tanpa arah. Tim Anthropic sendiri menemukan bahwa upaya tanpa panduan hanya berhasil sekitar 33% dari waktu, dan pembuat alat ini menghentikan 10–20% sesi. 

Perbedaannya terletak pada pola kerja yang Anda bangun di sekitar alatnya, bukan pada prompt yang Anda ketikkan.

Artikel ini membahas seperti apa pola-pola tersebut saat dipraktikkan, diambil dari alur kerja produksi di perusahaan seperti Abnormal AI, incident.io, dan Trail of Bits. 

Jika Anda butuh penyegar tentang penyiapan dan fitur inti, panduan kami tentang Claude Code 2.1 siap membantu. Semua yang dibahas di sini mengasumsikan Anda sudah memahami dasar-dasarnya dan ingin mendapatkan lebih banyak dari alat ini.

Untuk gambaran lebih luas tentang bagaimana agen bernalar dan di mana pola-pola tutorial ini cocok, saya sangat merekomendasikan mendaftar di jalur AI Agent Fundamentals kami, yang membahas semua prinsip dasarnya.

Mengapa Disiplin Perencanaan Mengubah Segalanya

Setiap keputusan yang dibuat Claude tanpa panduan mungkin memiliki akurasi tinggi, yang terdengar baik untuk satu pilihan, tetapi ketika dikalikan di seluruh fitur dengan banyak titik keputusan, peluang untuk mendapatkan semuanya benar menurun. Jika Anda mengasumsikan akurasi 80% untuk 20 keputusan, hasilnya 0,8^20, jadi hanya sekitar 1% peluang untuk fitur dengan implementasi benar sepenuhnya.

Perencanaan mereduksi 20 keputusan ambigu itu menjadi spesifikasi yang telah ditinjau, di mana masing-masing mendekati 100% karena Anda sudah menentukan pilihannya.

Merencanakan dengan alur kerja siklus anotasi

Alur perencanaan yang paling efektif dalam skala besar adalah siklus anotasi, seperti yang disarankan Boris Tane. Anda meminta Claude menyusun plan.md, membukanya di editor, dan menambahkan catatan inline di mana pun Claude mengambil keputusan yang keliru atau membiarkan sesuatu tetap ambigu: "gunakan drizzle:generate, bukan SQL mentah" atau "ini seharusnya PATCH, bukan PUT." 

Lalu Anda kirim kembali rencana yang telah dianotasi dengan frasa penjaga "address all notes, don't implement yet." Frasa penjaga ini penting karena tanpanya, Claude melewati rencana dan langsung mulai menulis kode. Siklus ini berulang sampai rencana tidak menyisakan ambiguitas, dan pada titik itu Claude mengimplementasikan dengan jauh lebih sedikit belokan salah karena setiap keputusan sudah ditetapkan.

# plan.md — annotation cycle
 
## Step 3: Database migration
Create a new migration for the users table.
> NOTE: use drizzle:generate, not raw SQL
> NOTE: add created_at with default NOW()
 
## Step 4: API endpoint
Add PUT /users/:id endpoint.
> NOTE: this should be PATCH, not PUT. Partial updates only.
 
# After annotating, send back with:
# "address all notes, don't implement yet"

Menggunakan mode rencana Claude Code

Jika siklus anotasi terasa berat, mode rencana bawaan Claude Code adalah opsi yang lebih ringan: 

1. Tekan Shift+Tab dua kali.
2. Iterasikan rencana dalam percakapan.
3. Beralih ke terima-otomatis dengan Shift+Tab sekali. 

Rencana disimpan ke ~/.claude/plans/, sehingga bertahan melewati kompaksi dan restart sesi, menjadikan mode rencana bawaan pilihan yang solid untuk sebagian besar tugas. Untuk fitur yang sangat besar, menulis spesifikasi lengkap di awal juga efektif: seorang pengembang menghabiskan dua jam untuk spesifikasi 12 langkah dan menghemat sekitar 6–10 jam waktu implementasi. 

Membawa perencanaan lebih jauh

Terlepas dari pendekatannya, menempelkan kode open-source yang bagus bersamaan dengan permintaan rencana terlihat jelas meningkatkan keluaran karena Claude bekerja lebih baik dengan referensi yang berfungsi daripada deskripsi abstrak.

Perencanaan juga dapat diskalakan secara horizontal melalui git worktrees. Para engineer di incident.io menjalankan 4–5 sesi Claude paralel pada branch terpisah, masing-masing mengerjakan rencananya sendiri. Seorang engineer menghabiskan $8 dalam kredit Claude dan menghasilkan implementasi yang meningkatkan waktu pembuatan API sebesar 18%, menghemat 30 detik pada alat yang digunakan seluruh tim setiap hari. 

Beberapa pengembang melangkah lebih jauh lagi, menjalankan worktree yang saling bersaing yang mengimplementasikan pendekatan berbeda untuk masalah yang sama dan membandingkan hasilnya.

Praktik Terbaik Arsitektur CLAUDE.md

File CLAUDE.md Anda memiliki anggaran yang mungkin tidak Anda ketahui. Analisis HumanLayer tentang internal Claude Code menemukan bahwa sistem menyisipkan pengingat di atas instruksi Anda: "Konteks ini mungkin relevan atau tidak untuk tugas Anda." 

Memahami sistem instruksi berlapis Claude Code

Claude secara aktif memfilter apa yang diikutinya alih-alih memperlakukan semuanya sebagai perintah yang persisten. Di atas itu, model frontier thinking mengikuti kira-kira 150–200 instruksi sebelum kepatuhannya turun, dan prompt sistem Claude Code sendiri memakan sekitar 50 di antaranya. Ini menyisakan sekitar 100–150 slot untuk aturan Anda. HumanLayer menjaga file mereka sendiri di bawah 60 baris.

Anda bisa mengamati anggaran ini saat berjalan. Tambahkan satu baris ke CLAUDE.md Anda yang berbunyi "always address me as Mr. Tinkleberry" dan lihat seberapa cepat Claude berhenti menggunakannya, biasanya dalam beberapa ribu token. Ketika nama itu menghilang, instruksi Anda diprioritaskan lebih rendah oleh mekanisme atensi, dan semua hal lain dalam CLAUDE.md Anda ikut kehilangan pengaruh.

Menggunakan pengungkapan progresif untuk referensi instruksi

Cara bekerja dalam anggaran ini adalah pengungkapan progresif. CLAUDE.md root Anda tetap singkat dan fokus pada aturan yang berlaku di mana-mana. Untuk hal yang spesifik domain, rujuk file terpisah tanpa meng-inline isinya: "Saat bekerja dengan sistem pembayaran, baca terlebih dahulu docs/payment-architecture.md." 

Claude membaca file yang dirujuk hanya ketika memasuki bagian kode tersebut, menjaga anggaran instruksi Anda tetap bebas untuk aturan prioritas tinggi. Satu perusahaan yang mengonsumsi miliaran token per bulan menyusun monorepo CLAUDE.md mereka seperti ini, dengan setiap tim dialokasikan anggaran token untuk bagiannya:

# Monorepo CLAUDE.md — progressive disclosure
 
## Python
- Always use type hints for function signatures
- Test with: pytest -x --tb=short
 
## <Internal CLI Tool>
- <usage example>
- Always validate input before processing
- Never use raw SQL, prefer the ORM
For <complex usage> or <error> see path/to/<tool>_docs.md

File CLAUDE.md subdirektori memperluas ini lebih jauh. Letakkan CLAUDE.md di src/persistence/ dengan instruksi khusus basis data, dan satu lagi di src/api/ dengan konvensi endpoint. 

Claude secara otomatis memuat file CLAUDE.md dari direktori kerja ke atas hingga root proyek, sehingga file subdirektori hanya aktif ketika Claude bekerja di area tersebut. Ini menjaga file root Anda tetap umum sambil memberi Claude panduan yang ditargetkan tepat di tempat yang dibutuhkan.

Satu kesalahan umum: jangan melakukan @-file dokumentasi ke dalam CLAUDE.md. Ini menanamkan seluruh file pada setiap run, menghabiskan anggaran instruksi Anda bahkan sebelum percakapan dimulai.

Manajemen Konteks di Claude Code

Claude Code memberi Anda 200K token konteks, tetapi jendela yang benar-benar dapat digunakan lebih kecil daripada yang terlihat. 

Sesi monorepo yang baru menghabiskan sekitar 20K token untuk memuat prompt sistem, definisi alat, dan CLAUDE.md sebelum Anda mengetik apa pun. Setiap server MCP menambahkan skema alat yang secara permanen mengonsumsi konteks, jadi batas praktisnya sekitar 5–8 server sebelum Anda mulai mengurangi ruang kerja nyata.

Yang membuat ini lebih buruk adalah seberapa awal kualitas mulai turun. Banyak praktisi secara independen menyepakati ambang yang sama: jangan biarkan konteks melampaui 60% kapasitas. 

Keluaran Claude mulai menurun pada 20–40% dari jendela, jauh sebelum batas apa pun aktif, karena mekanisme atensi memberikan bobot lebih rendah pada instruksi awal saat konteks terisi. 

Kompaksi otomatis aktif di sekitar 83,5%, dan bersifat lossy: seorang pengembang kehilangan 3 jam pekerjaan refaktor ketika kompaksi menghapus semua pengetahuan tentang keputusan migrasi di tengah sesi, hanya mempertahankan sekitar 20–30% detail.

Menggunakan pola Document & Clear

Pertahanan terbaik adalah pola Document & Clear. Saat konteks menjadi berat: 

1. Dump rencana dan progres Anda saat ini ke file markdown

2. Jalankan /clear untuk mereset sesi

3. Mulai baru dengan Claude membaca file tersebut

Dengan cara ini, Anda mendapatkan jendela 200K penuh hanya dengan hal-hal yang Anda pilih untuk dipertahankan, yang lebih baik daripada /compact karena Anda mengontrol persis apa yang bertahan. 

Perintah kustom /catchup membuat transisi lebih mulus: setelah membersihkan, perintah ini membaca semua file yang berubah di branch git saat ini, sehingga Claude melanjutkan dari titik terakhir tanpa riwayat percakapan lama.

<!-- .claude/commands/catchup.md -->
Rebuild context after a /clear. Read all files modified on the
current branch compared to main. For each file, understand the
changes made. Then summarize what's been implemented so far and
what work remains.
 
Changed files on this branch:
$ git diff --name-only main

Mentransfer konteks dengan skill kustom Claude Code

Saya menggunakan /transfer-context skill yang membawa ini lebih jauh. Ketika sesi mulai menurun, perintah ini mengekspor file serah-terima terstruktur dengan pekerjaan yang selesai, keputusan terbuka, jebakan yang harus dihindari, dan path file yang relevan. Sesi berikutnya membaca file itu dan melanjutkan dari titik terakhir, hanya dengan informasi yang penting tanpa beban percakapan.

Praktik terbaik lain untuk menghemat konteks

Anda juga dapat menghemat konteks secara proaktif dengan memuat alat secara malas (lazy load). Satu proyek memulihkan sekitar 15.000 token per sesi dengan menggunakan hook UserPromptSubmit untuk menyuntikkan definisi skill hanya ketika prompt pengguna memicu kata kunci yang relevan, alih-alih memuat semuanya di startup.

Aturan paling sederhana di balik semua ini: satu tugas per percakapan. Memulai baru memakan 20K token, yang tidak ada apa-apanya dibandingkan dengan penurunan kualitas dari sesi yang tercemar.

Hook Claude Code sebagai Pagar Pembatas Deterministik

Bahkan CLAUDE.md yang terstruktur dengan baik hanya diikuti sekitar 70% dari waktu. Untuk preferensi gaya pengkodean, itu tidak masalah. Untuk aturan keselamatan seperti "jangan push ke main" atau "jangan hapus data produksi", tidak demikian. Hook menutup kesenjangan itu menjadi 100% dengan menjalankan skrip shell pada titik tertentu dalam alur kerja Claude.

Ada dua tipe yang perlu diketahui. Hook Block-at-Submit berjalan sebagai event PreToolUse dan menghentikan aksi seketika: kode keluar 2 memblokir aksi dan memaksa Claude mencoba hal lain. Hook Hint memberikan umpan balik non-blokir, seperti menjalankan linter setelah setiap edit dan mengirimkan outputnya kembali tanpa mengganggu alur Claude.

Konfigurasi hook publik paling menyeluruh melakukan hal-hal berikut:

• Memblokir perintah rm -rf (menyarankan trash sebagai gantinya), 

• Mencegah push langsung ke main, 

• Mencatat semua mutasi dengan cap waktu, dan 

• Menjalankan gerbang anti-rasionalisasi. 

Gerbang itu menggunakan Haiku untuk meninjau respons Claude dari alasan mengada-ada seperti "masalah yang sudah ada" atau "di luar cakupan." Saat menangkap Claude menyatakan kemenangan prematur, gerbang menolak respons tersebut dengan umpan balik spesifik dan memaksa Claude terus bekerja. Setup yang lebih ringan menjalankan Prettier dan pengecekan TypeScript secara otomatis setelah setiap edit file:

{
  "hooks": {
	"PostToolUse": [
  	{
    	"matcher": "Edit|Write",
    	"hooks": [
      	{
        	"type": "command",
        	"command": "prettier --write \"$CLAUDE_FILE_PATHS\""
      	}
    	]
  	}
	]
  }
}

Satu jebakan yang harus dihindari: jangan pernah memblokir alat Edit atau Write di tengah rencana. Memblokir saat penulisan merusak penalaran multi-langkah karena Claude kehilangan jejak posisinya. Biarkan selesai menulis, lalu validasi melalui hook PostToolUse atau pemeriksaan pra-kommit. Tutorial hook Claude Code kami membahas lebih banyak pola jika Anda ingin membangunnya lebih jauh.

Test-Driven Development sebagai Strategi Koding Agen yang Optimal

Tanpa pengujian, satu-satunya cara Claude memverifikasi kerjanya adalah penilaiannya sendiri, yang menurun saat konteks terisi. Pengujian menciptakan orakel eksternal yang tetap akurat terlepas dari berapa lama sesi berjalan. 

Setiap siklus merah-ke-hijau memberi Claude umpan balik yang tidak ambigu, dan ia dapat mengiterasi seluruh suite tanpa intervensi manusia, menjadikan test-driven development (TDD) pola terkuat untuk bekerja dengan alat koding agen.

Alur kerja yang direkomendasikan Anthropic mengikuti urutan spesifik:

1. Write tests first
   > "Write tests for the auth module using pytest.
  	TDD approach, no mock implementations."
 
2. Confirm tests fail
   > "Run the tests. They should all fail."
 
3. Commit the failing tests as a checkpoint
 
4. Implement until green
   > "Write the implementation. Do not modify the tests.
  	Keep going until all tests pass."

Instruksi terakhir itu lebih penting daripada kelihatannya. Terkadang Claude akan mengubah pengujian agar lulus alih-alih memperbaiki implementasi. Melakukan commit pada pengujian sebelumnya memberi Anda jaring pengaman: jika Claude mengubahnya, diff menunjukkan apa yang berubah, dan Anda bisa mengembalikannya.

Untuk pekerjaan frontend, varian visual dari loop ini bekerja dengan baik: Jika Anda memberikan Claude mock desain plus server MCP Puppeteer, ia akan mengambil tangkapan layar setelah implementasi, membandingkannya dengan mock, dan mengiterasi. Loop verifikasi ini menghasilkan peningkatan kualitas 2–3x ketika Claude dapat memeriksa keluarannya sendiri terhadap target visual.

Ekonomi Biaya Claude Code dan Pemilihan Model

Data resmi Anthropic menempatkan biaya Claude Code rata-rata pada $6 per pengembang per hari dengan harga API, dengan 90% pengembang di bawah $12/hari. Secara bulanan, itu setara dengan sekitar $100–200 per pengembang pada Sonnet 4.6.

Paket langganan Max mengubah perhitungannya sepenuhnya. Seorang pengembang melacak 8 bulan penggunaan sekitar 10 miliar token dan menemukan biaya ekuivalen API-nya melebihi $15.000, sementara biaya langganan Max aktualnya sekitar $800: penghematan 93%. 

Lebih dari 90% tokennya adalah pembacaan cache, itulah sebabnya penetapan harga API terukur terasa jauh lebih mahal dibanding langganan flat. Titik impas untuk paket Max berada di sekitar $100–200/bulan dalam penggunaan ekuivalen API, ambang yang cepat terlampaui oleh pengguna harian.

Pemilihan model adalah optimalisasi tersendiri. Mode "opusplan" Claude Code merutekan Opus 4.6 untuk perencanaan dan beralih otomatis ke Sonnet 4.6 untuk pembuatan kode, memberi Anda penalaran setara Opus di tempat yang paling penting sambil menggunakan tarif Sonnet yang 5x lebih murah untuk token implementasi. 

Sonnet 4.6 lebih disukai dibanding Opus 4.5 oleh 59% pengguna Claude Code dalam pengujian internal Anthropic dan cenderung menghasilkan kode yang lebih bersih dengan lebih sedikit over-engineering. Untuk alur kerja berat subagen, CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5-20250929" menjalankan subagen di Sonnet sambil mempertahankan Opus untuk orkestrator.

Pastikan Anda menghindari tiga sumber pemborosan token terbesar: 

• Tidak membersihkan konteks antar tugas 

• Pembacaan file berulang akibat struktur CLAUDE.md yang buruk

• Prompt yang samar yang membuat Claude masuk ke loop coba-coba

Memperbaiki tiga hal ini saja biasanya memangkas penggunaan token hingga setengahnya.

Pemecahan Masalah Claude Code

Sebelum menutup, mari kita lihat masalah umum yang dihadapi pengembang saat bekerja dengan Claude Code dan cara mengatasinya.

Kehilangan konteks

Mode kegagalan yang paling berdampak adalah kehilangan konteks. Pola Document & Clear yang diperkenalkan di bagian manajemen konteks ada tepat untuk alasan ini: jangan pernah biarkan sesi panjang menjadi satu-satunya catatan atas apa yang telah Anda putuskan. Lakukan commit sering, dump progres ke file, dan perlakukan setiap sesi sebagai sesuatu yang dapat dibuang.

Halusinasi saat bekerja dengan teknologi niche

Claude juga dapat menghasilkan kode yang terlihat meyakinkan untuk teknologi yang tidak dikuasainya. Jika Anda bekerja dalam bahasa atau kerangka kerja yang tidak dapat Anda verifikasi sendiri, setiap keluaran perlu diperiksa ekstra. Seorang pengembang berkata: "Saya membuat diri saya dalam SEGUNUNG masalah menggunakan LLM dengan teknologi yang tidak saya kenal. Tetapi dengan sesuatu yang saya kuasai, LLM sangat meningkatkan kecepatan saya."

Over-engineering

Over-engineering adalah kecenderungan yang sering terjadi. Claude menulis abstraksi tambahan, fungsi pembantu yang tidak diminta, dan refaktor prematur kecuali Anda melarangnya. Menambahkan "gunakan pendekatan sesederhana mungkin" ke CLAUDE.md Anda membantu, dan menata basis kode berdasarkan domain masalah alih-alih lapisan teknis mengurangi beban kognitif bagi Claude dan manusia.

Hilangnya data kritis

Kegagalan paling dramatis yang pernah tercatat: saat membangun aplikasi fonik, Claude menghapus setiap file audio fonem yang seorang pengembang telah dapatkan izinnya secara pribadi dan menggantinya dengan suara hasil AI. Ia mengganti nama file, ia "menjadi yakin telah memberi label yang salah, meski sama sekali tidak mampu membedakan fonem yang relevan." 

Pelajaran yang didapat: Selalu commit atau cadangkan file yang tak tergantikan sebelum memberi Claude akses kepadanya.

Sesi tidak produktif

Saran Anthropic sendiri untuk sesi yang melenceng sangat jujur: simpan status Anda sebelum membiarkan Claude bekerja, biarkan berjalan, lalu terima hasilnya atau mulai baru alih-alih bergulat dengan koreksi. 

Seberapa jauh Anda mempercayakan commit kepada Claude bergantung pada cakupan pengujian dan toleransi risiko Anda. Beberapa pengembang melakukan commit lewat perintah garis miring puluhan kali per hari, dengan tinjauan PR sebagai gerbang. Untuk basis kode produksi dengan pengguna berbayar, meninjau setiap diff sepadan dengan friksinya.

Langsung Praktik dengan Claude Code

Untuk detail lebih lanjut, Ikhtisar Claude Code dari Anthropic adalah sumber resmi hulu yang menjadi dasar sebagian besar konten komunitas. Jika Anda ingin melanjutkan dari yang dibahas di sini dan mendapatkan pengalaman dengan beberapa fitur Claude Code, berikut beberapa tutorial kami yang layak dibaca:

• Panduan Claude Code 2.1 — lihat apa yang baru di versi 2.1, ikuti penyiapan Claude Code, dan jalankan serangkaian eksperimen terfokus
• Tutorial Hook Claude Code — dalami otomasi berbasis hook dan pelajari cara menggunakannya untuk tugas seperti pengujian, pemformatan, dan notifikasi
• Menggunakan Claude Code dengan Model Lokal Ollama — jalankan GLM 4.7 Flash secara lokal dengan Claude Code dan Ollama untuk menghindari vendor lock-in dan transfer data ke cloud
• Cara Membangun Plugin Claude Code — pelajari cara memasang ekstensi, memilih antara skill dan MCP, dan membangun plugin pencatat sesi kustom
• Claude Code Docker — pelajari cara menjalankan Claude Code di Docker untuk membangun lingkungan terisolasi, dan kuasai praktik pengkodean aman untuk agen AI
• Claude Code Router — pelajari cara menggunakan Claude Code Router untuk terhubung ke beberapa penyedia model dan menggunakan LLM yang tepat untuk setiap tugas

Beberapa proyek open-source juga membundel praktik yang dibahas dalam artikel ini menjadi konfigurasi siap pakai:

• obra/superpowers — kerangka kerja skill yang dapat dikomposisikan yang dilengkapi dengan penegakan TDD, brainstorming Socratic, perencanaan granular, dan tinjauan kode otomatis antar tugas. Kini menjadi plugin resmi di marketplace Anthropic.

• github/spec-kit — toolset Spec-Driven Development resmi GitHub. Menyusun pekerjaan sebagai Constitution → Specify → Plan → Tasks, menjadikan spesifikasi sebagai satu-satunya sumber kebenaran bagi agen pengodean apa pun.

• bmad-code-org/BMAD-METHOD — kerangka kerja agile lengkap dengan 12+ persona agen (Arsitek, QA, Scrum Master) dan 34+ alur kerja yang mencakup seluruh siklus pengembangan.

• wshobson/commands — 57 perintah garis miring siap produksi yang dapat Anda letakkan di .claude/commands/, termasuk 15 alur kerja multi-agen.

• awesome-claude-code — direktori andalan ekosistem untuk skill, hook, perintah, agen, dan plugin. Mulailah di sini jika Anda ingin menjelajah apa yang tersedia.

Kesimpulan

Setiap pola dalam artikel ini mengarah pada gagasan yang sama: batasi Claude secara agresif sebelum eksekusi, lalu beri cara untuk memverifikasi keluarannya sendiri. Perencanaan mereduksi ambiguitas. CLAUDE.md dan hook menetapkan batasan. Pengujian memberi verifikasi. Kebersihan konteks menjaga semuanya tetap berjalan lintas sesi.

Jika Anda memilih satu perubahan untuk memulai, jadikan itu Document & Clear. Biaya pembusukan konteks lintas sesi jauh lebih besar daripada 20K token yang diperlukan untuk memulai baru. Setelah itu:

• Tambahkan hook pra-commit yang memblokir commit saat pengujian gagal

• Mulai setiap tugas multi-file dengan rencana sebelum menyentuh kode

• Jaga CLAUDE.md Anda di bawah 100 instruksi dan gunakan file subdirektori untuk aturan spesifik domain

Kami baru-baru ini menambahkan jalur keterampilan baru tentang AI Engineering with LangChain. Konten kursusnya AI-native, sehingga Anda dapat belajar bersama agen tutor pribadi Anda. Saya merekomendasikan untuk mengeceknya agar Anda benar-benar mahir merekayasa alur kerja AI.