Manajemen konteks Claude Code: /context, /compact, CLAUDE.md, dan Obsidian

Anda memulai sesi Claude Code dengan permintaan yang jelas. Satu jam kemudian, Claude membaca ulang file yang sudah diperiksa, mengikuti keputusan lama, atau kehilangan satu baris error penting di tengah build log. Bagi pemula, keadaan ini tampak seperti kemampuan model tiba-tiba menurun.

Penyebab yang lebih sering adalah context window yang terlalu penuh. Context window adalah ruang kerja terbatas yang menampung percakapan, isi file, output command, instruksi proyek, definisi tool, dan jawaban Claude. Ketika investigasi lama dan log berulang memenuhi ruang tersebut, fakta yang masih relevan makin sulit dipertahankan.

Manajemen konteks bukan sekadar trik menghemat token. Ini adalah kebiasaan untuk menentukan informasi yang dibutuhkan sekarang, aturan yang harus disimpan sebagai panduan proyek, hasil yang cukup diringkas, dan waktu yang tepat untuk mengakhiri percakapan. Panduan ini memberi alur kerja praktis tanpa menganggap Anda sudah memahami token, memory file, atau penyimpanan sesi.

Ringkasan utama

• Jalankan /context untuk melihat isi context window sebelum menebak penyebab sesi yang mulai tidak fokus.
• Gunakan /compact jika tugasnya masih sama tetapi percakapannya sudah terlalu besar. Tambahkan focus instruction agar keputusan penting tetap menonjol.
• Gunakan /clear ketika berpindah ke tugas yang tidak berkaitan. Percakapan lama tetap tersimpan dan dapat dilanjutkan; percakapan baru dimulai tanpa history lama lalu memuat kembali project memory.
• Gunakan /memory untuk melihat dan mengedit persistent instruction serta auto memory. Gunakan /context, bukan /memory, untuk memastikan memory file mana yang benar-benar sudah dimuat.
• Gunakan /usage untuk melihat biaya sesi, batas plan, dan aktivitas. /cost adalah alias-nya, sedangkan /stats adalah alias yang membuka tab Stats.
• Tulis verification receipt sebelum compact atau handoff agar keputusan, perubahan, hasil test, dan langkah berikutnya tidak hilang.

Bayangkan context window sebagai meja kerja

Meja yang rapi hanya berisi tugas saat ini, beberapa file relevan, error singkat, dan acceptance criteria. Meja yang penuh berisi pendekatan yang sudah ditinggalkan, build log lengkap, riset yang tidak berkaitan, pembacaan file berulang, serta instruksi yang saling bertentangan.

Isi context	Penyebab membengkak	Kebiasaan yang lebih baik
Riwayat percakapan	Pertanyaan sampingan dan keputusan lama tetap terbawa	Pisahkan tugas yang tidak berkaitan dan catat keputusan terbaru
File yang dibaca	Satu folder atau generated file dibaca seluruhnya	Cari dulu, lalu baca file atau rentang yang relevan
Output tool	Retry dan log panjang menumpuk	Simpan baris penyebab dan hasil akhirnya
CLAUDE.md dan rules	Instruksi terlalu luas, duplikat, atau bertentangan	Ringkas aturan yang selalu aktif dan scope aturan khusus
Skills dan tool descriptions	Capability yang tidak diperlukan memakai context awal	Aktifkan kemampuan yang diperlukan untuk pekerjaan itu

Claude Code dapat melakukan auto-compaction saat window mendekati batas. Mekanisme ini mencegah sesi berhenti begitu saja, tetapi summary otomatis tetap harus memilih informasi mana yang penting. Manual compaction dengan fokus yang jelas sebelum berpindah fase memberi target yang lebih baik.

Fungsi sebenarnya dari setiap command

Masukkan command berikut pada awal message di sesi interaktif Claude Code. Bentuknya mirip, tetapi masing-masing menjawab masalah yang berbeda.

/context: periksa context saat ini

/context menampilkan penggunaan context dalam colored grid serta saran optimasi untuk tool yang berat, memory yang besar, dan peringatan kapasitas. Jalankan /context all untuk breakdown per item yang lebih lengkap. Ini adalah tampilan diagnostik, bukan command pembersihan; membuka grid tidak menghapus apa pun.

/context
/context all

Ambil baseline saat memulai pekerjaan panjang, periksa kembali setelah investigasi besar, dan jalankan sebelum /compact agar Anda tahu apa yang perlu diprioritaskan dalam summary.

/compact [instructions]: ringkas dan lanjutkan tugas yang sama

/compact mengganti conversation history dengan structured summary sehingga percakapan yang sama memiliki ruang lebih banyak. Teks opsional setelah command memberi tahu summarizer informasi yang harus diprioritaskan.

/compact preserve the accepted API contract, changed files, failing test, commands already run, and next action

Gunakan jika objective belum berubah, misalnya bug autentikasi yang sama masih dikerjakan tetapi fase discovery menghasilkan transcript panjang. Jangan berasumsi setiap kalimat akan bertahan. Aturan yang wajib dipatuhi harus sudah berada di CLAUDE.md, specification, atau handoff note.

/clear [name]: mulai percakapan untuk tugas lain

/clear membuat percakapan baru dengan conversational context kosong. Nama untuk percakapan sebelumnya bersifat opsional. Project memory dimuat kembali, sedangkan percakapan sebelumnya tetap tersimpan untuk /resume.

/clear auth-fix-complete

Anda juga dapat kembali dengan claude --resume, atau memakai claude --continue untuk sesi terbaru di directory tersebut. Gunakan clear ketika objective, file, atau decision history benar-benar berbeda. Jika rekan yang tidak membaca transcript lama justru lebih mudah memahami tugas berikutnya, batas tugas itu cocok untuk clear.

/memory: lihat persistent guidance

/memory menampilkan lokasi CLAUDE.md dan CLAUDE.local.md, menyediakan akses untuk membuka atau membuat file tersebut, menunjukkan auto-memory entries, dan menyediakan toggle auto memory. Project CLAUDE.md dapat di-commit sebagai panduan tim. Auto memory adalah informasi lokal per repository yang dipelihara Claude dan dibagikan antar-worktree repository yang sama, bukan otomatis antar-mesin.

/memory

Daftar di /memory tidak membuktikan setiap file sudah aktif di context saat ini. Jalankan /context, lalu periksa bagian Memory files untuk konfirmasi.

/usage, /cost, dan /stats: periksa konsumsi, bukan context

/usage menampilkan biaya sesi, batas pemakaian plan, dan statistik aktivitas. Pada subscription plan yang mendukungnya, rincian juga dapat mencakup skills, subagents, plugins, dan MCP servers. /cost adalah alias untuk /usage. /stats juga alias dan membuka tab Stats.

/usage
/cost
/stats

Consumption dan context bukan pengukuran yang sama. Usage menjawab berapa banyak yang telah dipakai; context menjawab informasi apa yang saat ini memenuhi ruang kerja model. Compact atau clear tidak membatalkan penggunaan yang sudah terjadi.

Diagram keputusan berikut menghubungkan empat command tersebut dalam satu alur kerja. Periksa keadaan dengan /context terlebih dahulu; window yang penuh tidak otomatis berarti tugasnya sudah berubah.

flowchart TD
    A["Periksa window dengan /context"] --> B{"Apakah tugas berikutnya masih sama?"}
    B -->|"Ya"| C["Jalankan /compact dengan focus instruction"]
    B -->|"Tidak"| D["Tulis receipt lalu jalankan /clear"]
    C --> E["Lanjutkan tugas yang sama"]
    D --> F["Mulai dengan brief baru"]

Tetapkan context budget sebelum mulai

Jangan memulai dengan instruksi “baca seluruh repository lalu perbaiki.” Berikan brief kecil yang berisi objective, scope, exclusion, completion criteria, verification command, dan keputusan yang harus mendapat persetujuan manusia. Struktur ini membuat pembacaan file pertama lebih sengaja dan memberi kerangka yang stabil saat sesi nanti di-compact.

## Task brief
- Objective: Perbaiki redirect loop untuk expired session.
- In scope: src/auth/, tests/auth/session.test.ts
- Out of scope: redesign UI dan migrasi identity provider
- Done when: expired session redirect satu kali ke /login dan regression test lulus
- Verify with: npm test -- tests/auth/session.test.ts
- Human approval required for: perubahan cookie lifetime atau public API behavior

Lakukan pencarian sempit sebelum meminta Claude membaca file. Command berikut dapat di-copy-paste lalu disesuaikan dengan repository Anda:

rg -n "expired session|redirect loop|set-cookie" src tests
git diff --stat
git status --short
npm test -- tests/auth/session.test.ts

Urutan ini penting. rg menemukan file yang mungkin relevan, status dan diff menunjukkan pekerjaan yang tidak boleh tertimpa, lalu focused test memberi finish line yang dapat diukur.

Tinggalkan handoff receipt sebelum compact

Receipt bukan transcript kedua. Isinya adalah state minimum yang diperlukan manusia atau agent lain agar dapat melanjutkan tanpa mengulang discovery. Catat outcome, bukan seluruh output. Kalimat “focused test gagal di session.test.ts:84 karena ada dua redirect” berguna; dua ratus baris stack trace yang sama tidak berguna.

## Handoff receipt
- Objective:
- Current diagnosis:
- Decisions already accepted:
- Files changed:
- Commands run and results:
- Uncommitted user changes to preserve:
- Remaining risk:
- Next action:

Simpan receipt dalam project doc jika perlu dibagikan, atau masukkan versi ringkasnya ke focus instruction /compact.

Apa yang bertahan setelah compaction

Compaction tidak memperlakukan semua informasi dengan cara yang sama. Informasi paling rapuh adalah detail yang hanya sekali disebut di chat. Detail itu mungkin masuk summary, tetapi bagian kecilnya dapat hilang.

Mekanisme	Perilaku setelah /compact
System prompt dan output style	Tetap sama karena bukan conversation history
CLAUDE.md di project root dan unscoped rules	Di-inject kembali dari disk
Auto memory	Di-inject kembali dari disk
Rules dengan frontmatter paths:	Tidak hadir sampai Claude membaca matching file lagi
Nested CLAUDE.md dalam subdirectory	Tidak hadir sampai file di subdirectory itu dibaca lagi
Skill bodies yang dipanggil	Di-inject kembali dalam batas per-skill dan total yang didokumentasikan
Hooks	Tetap berjalan sebagai code; bukan conversational context

Jika suatu aturan harus diikuti pada setiap sesi, simpan di project-root CLAUDE.md atau persistent file yang sesuai. Aturan khusus directory tetap sebaiknya scoped, tetapi ingat bahwa aturan itu kembali setelah matching file dibaca. Anda juga dapat menambahkan compact instruction yang ringkas:

# CLAUDE.md

## Compact instructions
- Preserve the current objective, accepted decisions, and out-of-scope areas.
- Preserve changed files, verification commands, test results, and blockers.
- Keep only log lines that explain the root cause.
- Preserve uncommitted user changes and the next safe action.

Jangan menjadikan CLAUDE.md manual proyek lengkap. File tersebut sendiri memakai context pada awal setiap percakapan.

Batas tanggung jawab agent dan manusia

Manajemen konteks yang sehat membutuhkan pembagian keputusan. Claude dapat mencari, merangkum, menjalankan test, dan mengusulkan perubahan. Manusia tetap memiliki keputusan yang konsekuensinya tidak dapat disimpulkan secara aman hanya dari repository.

Claude Code dapat menangani	Manusia harus memutuskan
Menemukan file relevan dan menyaring root cause dari log	Objective bisnis dan trade-off yang dapat diterima
Melaporkan tekanan context dan menyarankan waktu compact	Apakah dua tugas benar-benar berkaitan
Menulis handoff receipt dari pekerjaan yang diamati	Operasi destruktif, penggunaan credential, atau perubahan production
Menjalankan verification command yang disepakati	Perubahan security policy, public behavior, atau data retention
Memperbarui documented rule setelah ada persetujuan	Konflik requirement antar-stakeholder

Jangan meminta agent menentukan informasi yang tidak boleh hilang lalu membiarkan keputusan itu hanya ada di percakapan yang sudah penuh. Manusia menentukan durable constraint; agent mencatatnya di lokasi yang disepakati dan memverifikasi bahwa file tersebut dimuat.

Empat kasus penggunaan konkret

Kasus penggunaan 1: refactor autentikasi lintas-file

Skenario: Riset menyentuh middleware, cookie utility, integration test, dan deployment setting. Membaca semua file dan semua kegagalan test dalam satu percakapan membuat tahap implementasi lebih sulit.

Batas agent: Gunakan search untuk memetakan alur autentikasi, pisahkan riset dokumentasi yang luas ke subagent atau research note, lalu kembalikan contract terpilih, target file, dan focused test output ke context utama.

Checkpoint manusia: Setujui perubahan cookie lifetime, logout behavior, dan compatibility guarantee. Mulai dengan task brief, jalankan /context setelah discovery, tulis design yang diterima ke receipt, lalu compact dengan fokus pada contract dan regression test sebelum mengedit.

Kasus penggunaan 2: debugging deployment yang gagal

Skenario: Beberapa retry menghasilkan log hampir sama. Satu baris penyebab terkubur di antara package installation output dan warning.

Batas agent: Bandingkan attempt, isolasi causal error pertama, catat environment dan exact failing command, lalu keluarkan output duplikat dari working summary.

Checkpoint manusia: Setujui perubahan credential, provider configuration, atau rollback. Compact jika incident yang sama masih dikerjakan; clear hanya setelah deployment terverifikasi atau saat berpindah ke feature yang tidak berkaitan.

Kasus penggunaan 3: menulis dan meninjau artikel teknis

Skenario: Source research, editorial rule, code verification, translation note, dan rendered-page check dapat memenuhi writing context.

Batas agent: Simpan source note dalam research file, editorial rule yang durable dalam CLAUDE.md, dan artikel akhir dalam MDX. Bawa hanya fakta yang sudah terkonfirmasi dan pertanyaan yang belum terjawab ke writing session.

Checkpoint manusia: Pilih audience, commercial promise, dan primary CTA. Agent boleh memperbaiki kalimat, tetapi tidak boleh mengarang pengalaman, benchmark, atau hasil pelanggan. Untuk alur terkait, baca praktik CLAUDE.md, optimasi token, dan integrasi Obsidian.

Kasus penggunaan 4: berpindah dari bug fix ke feature baru

Skenario: Bug fix selesai, tetapi terminal yang sama langsung dipakai untuk meminta dashboard feature yang tidak berkaitan.

Batas agent: Laporkan final diff dan test result, lalu sarankan task boundary yang bersih.

Checkpoint manusia: Pastikan tidak ada follow-up bug fix yang perlu dibawa. Jalankan /clear bug-fix-complete, lalu mulai dashboard dengan brief baru. Jika detail lama diperlukan, gunakan /resume alih-alih membawa seluruh transcript.

Jebakan umum, risiko, dan perbaikannya

Kesalahan 1: menganggap /compact sebagai backup sempurna

Summary bersifat selektif sehingga constraint kecil yang hanya disebut sekali dapat hilang. Perbaikan: simpan durable rule di CLAUDE.md atau specification, lalu catat accepted decision dalam handoff receipt.

Kesalahan 2: memakai /clear saat tugas masih aktif

Conversational working set hilang dan diagnosis yang sama mungkin harus diulang. Perbaikan: jika objective dan acceptance test belum berubah, compact dengan focus instruction. Clear hanya pada task boundary yang nyata.

Kesalahan 3: mengira /memory menunjukkan file yang sudah dimuat

Nested memory dan path-scoped rule mungkin belum aktif. Perbaikan: jalankan /context, periksa Memory files, dan baca matching file setelah compaction ketika rule tersebut dibutuhkan.

Kesalahan 4: menaruh enforcement hanya di CLAUDE.md

CLAUDE.md adalah contextual guidance, bukan hard security boundary. Perbaikan: gunakan permissions dan hooks untuk action yang wajib diblokir atau divalidasi; pakai CLAUDE.md untuk workflow guidance yang ringkas.

Kesalahan 5: menjadikan auto memory sebagai dokumentasi tim

Auto memory bersifat machine-local. Perbaikan: pindahkan convention bersama ke committed CLAUDE.md, rules, atau docs; sisakan preference lokal dan repeated learning di auto memory.

Kesalahan 6: menyamakan usage dengan context yang tersedia

Plan usage yang masih rendah tidak berarti working window masih bersih. Perbaikan: gunakan /context untuk memutuskan narrow, delegate, compact, atau clear; gunakan /usage untuk memonitor consumption dan limit.

Rutinitas lima langkah

1. Brief: Tulis objective, scope, exclusion, completion test, dan approval manusia.
2. Narrow: Cari dulu, lalu load hanya file dan output yang diperlukan untuk keputusan berikutnya.
3. Inspect: Jalankan /context setelah discovery besar atau ketika Claude mulai mengulang pekerjaan.
4. Record: Catat accepted decision, changed file, verification result, dan next action.
5. Choose: Gunakan /compact untuk tugas yang sama, /clear untuk tugas baru, dan /resume saat kembali ke saved work.

Untuk prompt dan operating template yang dapat dipakai ulang dalam workflow ini, lihat Claude Code practical prompt guide.

Referensi resmi

• Memahami context window
• Referensi commands
• Cara Claude mengingat proyek
• Mengelola sessions

Yang kami verifikasi

Dalam revisi ini, nama command dan perilaku alias dicocokkan dengan commands reference resmi: /cost dan /stats sama-sama mengarah ke /usage, sedangkan /stats membuka tab Stats. Tabel resmi context window dipakai untuk memeriksa bahwa root CLAUDE.md serta auto memory di-inject kembali setelah compaction, tetapi nested CLAUDE.md dan path-scoped rules menunggu matching file dibaca. Kemampuan melanjutkan conversation yang tersimpan setelah /clear diperiksa melalui sessions documentation, sedangkan scope memory file diperiksa melalui memory documentation. Command shell di atas juga diperiksa ulang secara sintaks; path yang spesifik proyek tetap harus disesuaikan dengan repository Anda.