CLAUDE.md Setelah Opus 5: Mengapa Instruksi Panjang Kini Menghalangi Claude

Informasi tentang cara bekerja dengan Ailoot tersedia di dokumentasi.

Apa yang berubah pada Claude setelah peluncuran Opus 5?#

Opus 5 dirilis pada 24 Juli 2026, dan langsung menjadi model default di Claude Code. Model itu sendiri—harga, tolok ukur, dan mode upayanya—dibahas secara terperinci dalam panduan terpisah, “Haruskah Anda Beralih ke Claude Opus 5?”. Artikel ini membahas hal lain: peluncuran model tersebut juga mengubah cara berbicara dengannya secara efektif.

Anthropic menerbitkan analisis di blog Claude. Inti pesannya seperti ini:

Frasa kuncinya adalah “terlalu membatasi.” Saat model masih lebih lemah, mereka membutuhkan penyangga: lakukan ini, jangan lakukan itu, ini contohnya, ulangi sekali lagi. Opus 5 tidak lagi membutuhkan penyangga itu, dan lebih buruknya, penyangga tersebut bisa mulai menghalangi. Anthropic menyatakan prinsip baru ini secara sederhana: biarkan Claude menggunakan pertimbangannya sendiri.

Apa artinya bagi Anda dalam praktik?

• CLAUDE.md Anda adalah jenis prompt sistem yang sama, tetapi untuk proyek Anda. Jika Anthropic memangkas miliknya sendiri sebesar 80 persen, kemungkinan milik Anda juga terlalu gemuk.
• Daftar aturan yang panjang tidak lagi menjamin kepatuhan. Sebaliknya, semakin banyak barisnya, semakin kurang cermat model mengikutinya (selengkapnya di bawah, beserta angka dari dokumentasi).
• Mekanisme baru telah hadir—memori otomatis dan skills—yang mengambil alih sebagian pekerjaan yang sebelumnya harus Anda tuliskan secara manual di CLAUDE.md.

Inti utamanya: pekerjaan terpenting terjadi sebelum prompt—pada apa yang Anda masukkan ke dalam konteks model sebelum permintaan pertama. Pembaruan Opus 5 pada dasarnya merupakan konfirmasi resmi Anthropic atas gagasan yang sama. Namun kali ini, ada angka konkret dan alat baru. Saya akan membahasnya satu per satu.

Mengapa CLAUDE.md yang panjang kini menghalangi?#

Begini cara kerjanya. CLAUDE.md adalah file berisi aturan yang dibaca Claude pada awal setiap sesi. Panduan terpisah, “Cara Menyiapkan CLAUDE.md”, menjelaskan cara menyusunnya dari awal; artikel ini membahas kebalikannya: apa yang sekarang perlu dihapus darinya. Semua yang Anda tulis di sana masuk ke konteks sebelum permintaan pertama Anda dan tetap berada di sana sepanjang percakapan. Konteks tidak tak terbatas—dan setiap baris aturan tambahan menghabiskan ruang yang seharusnya bisa digunakan untuk tugas Anda.

Dokumentasi Claude Code mengatakannya dengan lugas:

Poin kedua lebih penting daripada yang pertama: file panjang mengurangi kepatuhan terhadap instruksi. Model mulai kurang menyimak. Ini jebakan yang hampir selalu dialami pemula. Logikanya tampak sangat masuk akal: saya ingin Claude menyimak, jadi saya akan menulis lebih banyak aturan. Dalam praktiknya, yang terjadi justru sebaliknya. Semakin panjang daftarnya, semakin tercerai-berai perhatian model, dan semakin sering ia melewatkan suatu aturan.

Begini perubahan pendekatannya:

Ada masalah kedua juga: kontradiksi. Seiring bertambahnya isi file, hampir pasti terkumpul aturan yang saling bertentangan. Di satu tempat tertulis “selalu tulis tes,” di tempat lain “jangan sentuh folder tes.” Dokumentasi memperingatkan bahwa jika dua aturan bertentangan, Claude mungkin memilih salah satunya secara acak. Dengan kata lain, file yang membengkak membuat perilaku model kurang dapat diprediksi.

Aturan sederhana: CLAUDE.md adalah catatan singkat tentang hal yang tidak bisa disimpulkan Claude sendiri. Selain itu, hanya akan menyita perhatiannya.

Apa yang sebaiknya dipertahankan di CLAUDE.md, dan apa yang perlu dihapus?#

Dokumentasi memberikan kriteria yang jelas untuk memutuskan apakah suatu aturan layak dimasukkan ke CLAUDE.md. Tambahkan jika:

1. Claude melakukan kesalahan yang sama untuk kedua kalinya.
2. Pemeriksaan kode menemukan sesuatu yang seharusnya diketahui model tentang proyek ini.
3. Anda mengetik koreksi yang sama di obrolan untuk kedua kalinya.
4. Orang baru di tim akan membutuhkan konteks yang sama agar tidak merusak proyek.

Prinsip umumnya adalah mempertahankan kendala khusus proyek dan menghapus hal yang sudah jelas. Claude Code bahkan memiliki pemeriksaan bawaan claude doctor yang menyarankan perapian CLAUDE.md yang membengkak. Pemeriksaan itu memangkas detail yang bisa disimpulkan model dari basis kode—struktur folder, daftar dependensi, gambaran umum arsitektur—dan mempertahankan kendala, alasan, serta konvensi yang berbeda dari default.

Aturan penting kedua adalah kekhususan. Kata-kata yang samar tidak efektif. Bandingkan:

Perbedaannya sederhana. Model bisa menafsirkan “format dengan benar” sesuka hati. “Gunakan indentasi 2 spasi” dapat diperiksa dengan jelas. Setiap aturan di CLAUDE.md seharusnya merupakan sesuatu yang bisa Anda periksa dan lihat—apakah aturan itu diikuti atau tidak.

Ketiga, hapus hal yang sudah jelas. Jika Anda menulis “tulis kode yang bersih” atau “ikuti praktik terbaik” di CLAUDE.md, itu hanya kebisingan. Model sudah mengetahuinya, dan baris itu menghabiskan ruang serta memecah perhatiannya. Anthropic secara tegas menyarankan agar konteks tidak dihabiskan untuk hal yang sudah jelas.

Di mana sebaiknya memindahkan aturan yang tidak cocok di CLAUDE.md?#

Di sinilah alat yang paling sering diremehkan berperan. Jika sebelumnya semua instruksi harus tersimpan di CLAUDE.md, kini prosedur panjang memiliki tempat tersendiri: skills. Panduan terpisah, “Cara Memilih Skills Claude Code”, menjelaskan cara memilih yang tepat tanpa menambahkan terlalu banyak.

Perbedaannya mendasar. CLAUDE.md dimuat sepenuhnya pada awal setiap sesi. Skill tidak. Dokumentasi menjelaskannya begini:

Ini disebut pengungkapan progresif—memuat informasi sesuai kebutuhan. Idenya adalah memberikan konteks kepada model secara bertahap, pada saat yang tepat. Anthropic memindahkan instruksi terperincinya—misalnya, instruksi untuk peninjauan kode—ke dalam skills dan menghapusnya dari prompt sistem.

Kriteria untuk memindahkan sesuatu ke skill sederhana: suatu bagian CLAUDE.md telah berkembang dari fakta menjadi prosedur. Catatan satu baris, “Build dijalankan melalui npm run build,” adalah fakta dan tempatnya di CLAUDE.md. Sepuluh langkah tentang “cara menerbitkan proyek” adalah prosedur dan tempatnya di skill.

Prinsip praktis: serahkan apa pun yang Anda lakukan lebih dari beberapa kali. Jelaskan sekali cara menyusun, misalnya, laporan klien mingguan, ubah penjelasan itu menjadi skill, dan Anda tidak perlu menjelaskannya lagi. Skill itu tersedia tanpa menghabiskan konteks dan dapat dipanggil dengan nama menggunakan perintah seperti /otchet.

Hal-hal yang berguna untuk dipindahkan ke skills:

• Prosedur beberapa langkah (penerbitan, penyusunan laporan, pemeriksaan sebelum rilis).
• Instruksi panjang yang jarang dibutuhkan, tetapi perlu dimuat secara utuh.
• Apa pun yang Anda salin dari satu obrolan ke obrolan lain untuk kedua atau ketiga kalinya.

Ada juga pilihan perantara: aturan khusus folder. Jika suatu instruksi hanya berlaku untuk satu bagian proyek, Anda dapat menaruhnya di .claude/rules/ dan mengaitkannya dengan file yang relevan. Dengan begitu, instruksi itu hanya dimuat saat Claude bekerja dengan file-file tersebut, bukan terus-menerus berada di dalam konteks.

Apa itu memori otomatis, dan mengapa menggunakannya pada 2026?#

Mekanisme baru kedua yang mengurangi beban CLAUDE.md adalah memori otomatis. Idenya, Claude kini tidak hanya mengingat apa yang Anda tulis, tetapi juga apa yang ia amati sendiri. Panduan terpisah, “Memori Claude vs. CLAUDE.md”, menjelaskan perbedaan cara kerjanya dari CLAUDE.md.

Perbedaan antara kedua jenis memori:

Begini cara kerjanya: saat Claude mengerjakan tugas Anda, ia memperhatikan detail yang berguna—perintah untuk menjalankan build, kendala saat debugging, hal yang Anda minta agar dilakukan secara berbeda—lalu menyimpannya dalam catatan. Claude akan membawanya kembali pada sesi berikutnya. Penting: ia menyimpan secara selektif, hanya hal yang dianggapnya berguna di kemudian hari.

Catatan tersebut berada di folder terpisah untuk setiap proyek, dengan file indeks bernama MEMORY.md. Anda dapat melihat dan mengeditnya dengan perintah /memory. Catatan itu berupa file teks biasa, jadi Anda dapat membaca, mengedit, atau menghapusnya kapan saja.

Perubahan praktisnya bagi Anda: kini Claude mencatat sebagian hal yang sebelumnya Anda tambahkan sendiri ke CLAUDE.md setelah setiap kesalahan. Itu membuat file aturan Anda semakin singkat—dan itu bagus.

Mengapa Opus 5 membantah instruksi Anda?#

Ada sisi lain dari hal ini.

Model yang diberi kebebasan untuk menggunakan pertimbangannya, menurut definisi, terkadang akan tidak menyetujui perintah kaku jika melihat pilihan yang lebih baik dalam konteks.

Apa artinya bagi Anda jika sudah beralih ke Opus 5 dan ada yang tidak beres:

1. Periksa kembali skills dan plugin lama Anda. Penyiapan yang dibuat untuk model sebelumnya mungkin bertentangan dengan logika baru. Hal yang dulu berjalan lancar seperti jarum jam kini layak diuji lagi.
2. Hapus kata-kata yang paling kaku. Model generasi kelima menangani perintah seperti “jangan pernah lakukan X, selalu lakukan hanya Y” dengan lebih buruk daripada kata-kata fleksibel yang menjelaskan alasannya.
3. Perhatikan bagian tempat model berhenti terlalu cepat. Terkadang ini menandakan bahwa suatu instruksi bertentangan dengan dirinya sendiri atau berbenturan dengan aturan dalam CLAUDE.md yang membengkak.

Cara menulis ulang CLAUDE.md untuk Opus 5: langkah demi langkah#

Berikut proses untuk menangani CLAUDE.md yang diwarisi dari model-model sebelumnya.

1. Jalankan pemeriksaan bawaan

   Ketik claude doctor di proyek. Perintah ini akan menyarankan apa yang perlu dihapus dari file yang membengkak dan apa yang perlu dipertahankan.

2. Hapus hal yang sudah jelas

   Hapus setiap baris yang bisa disimpulkan Claude dari kode itu sendiri: struktur folder, daftar pustaka, dan frasa umum seperti “tulis kode yang bersih.”

3. Hapus kontradiksi

   Telusuri file dari atas ke bawah dan temukan aturan yang bertentangan. Pertahankan satu aturan dan hapus aturan yang bertentangan dengannya.

4. Pindahkan prosedur ke skills

   Pindahkan apa pun yang berkembang dari fakta menjadi instruksi langkah demi langkah ke skill terpisah. Sisakan tautan satu baris di CLAUDE.md.

5. Buat aturan yang tersisa menjadi spesifik

   Rumuskan ulang setiap aturan agar dapat diperiksa: “format dengan benar” menjadi “gunakan indentasi 2 spasi.”

6. Aktifkan memori otomatis dan periksa panjangnya

   Pastikan memori otomatis berfungsi (/memory) dan file memiliki kurang dari 200 baris. Jika tidak, ada hal lain yang perlu dipindahkan.

Agar tidak perlu melakukan perapian awal secara manual, minta Claude mengerjakannya. Berikut prompt yang dapat Anda gunakan sebagai titik awal—salin, lalu tempelkan ke sesi yang dibuka di proyek Anda:

Read my CLAUDE.md and my code. Your task is to make CLAUDE.md shorter and more useful for a fifth-generation model.

Go through the file and divide all the rules into three groups:

KEEP - project-specific pitfalls and conventions you cannot infer from the code yourself.

DELETE - obvious things you already know, and anything that can be inferred from the code.

MOVE TO A SKILL - multi-step procedures that currently live as text in CLAUDE.md.

For group 1, rephrase vague rules so they are concrete and verifiable.
Find rules that contradict each other and show them separately.
Return a new version of CLAUDE.md under 200 lines, plus a list of what you propose moving to skills.
Do not change any files until I confirm.

Perhatikan baris terakhir: “Jangan mengubah apa pun sampai saya mengonfirmasi.” Dengan model yang kini menggunakan pertimbangannya, ini penting: minta model menunjukkan rencana terlebih dahulu, lalu biarkan keputusan tetap di tangan Anda.

Mengapa konteks lebih penting daripada prompt?#

Jika kita mengesampingkan rincian tentang Opus 5 dan melihat gambaran besarnya, seluruh analisis ini membahas satu gagasan: konteks lebih penting daripada prompt. Pekerjaan terpenting terjadi sebelum permintaan—saat Anda menyusun lingkungan tempat model akan bekerja.

CLAUDE.md, skills, dan memori otomatis adalah bagian-bagian dari satu hal: apa yang dilihat Claude sebelum pesan pertama Anda. Anda bisa terus-menerus mengutak-atik susunan kata dalam permintaan, tetapi jika konteks disusun dengan buruk—CLAUDE.md yang membengkak, aturan yang bertentangan, tanpa struktur—hasilnya tetap tidak konsisten.

Berikut pemeriksaan sederhana: tanpa otak pertama, otak kedua tidak akan membantu. Dalam artikel ini, “otak kedua” berarti struktur pengetahuan tentang proyek yang dibaca model pada setiap permintaan. Namun, ini hanya berfungsi jika didukung oleh pemahaman Anda yang jelas tentang tugas tersebut. Alat memperkuat pemikiran Anda, dan di situlah perannya berakhir.

Pembaruan Opus 5 memperjelas logika ini. Anthropic menunjukkan melalui karyanya sendiri bahwa ketika model cukup cerdas, aturan tambahan justru merugikan, dan keunggulannya ada pada mereka yang menyusun konteks dengan cermat. Keterampilan ini akan tetap berguna pada setiap model berikutnya, baik Opus 6 maupun model lainnya.

Dari mana sebaiknya Anda mulai sekarang?#

Jangan menundanya sampai “nanti.” Langkah pertama yang paling sederhana adalah membuka CLAUDE.md sekarang juga dan bertanya dengan jujur pada diri sendiri tentang setiap baris: apakah ini kendala yang tidak bisa disimpulkan Claude, atau hal yang sudah jelas dan saya tambahkan untuk berjaga-jaga? Semua yang termasuk kelompok kedua layak dipertimbangkan untuk dihapus.

Selanjutnya, rapikan file dengan prompt di bagian sebelumnya, pindahkan prosedur panjang ke skills, dan periksa apakah memori otomatis sudah aktif. Pekerjaan satu malam, dan konteks Anda akan menjadi landasan yang ringkas dan tepat bagi model.

Anda dapat menerapkannya pada proyek Anda sendiri: CLAUDE.md, otak kedua, dan skills untuk tugas-tugas Anda.

Kenali Ailoot.