Mengelola Konteks Kode Claude: buku panduan praktis

CometAPI
AnnaSep 12, 2025
Mengelola Konteks Kode Claude: buku panduan praktis

Kode Claude Anthropic dan keluarga Claude yang lebih luas kini memberikan kontrol yang belum pernah terjadi sebelumnya kepada pengembang berapa model melihat dan seberapa dalam Alasannya. Pembaruan produk terbaru (terutama jendela konteks Sonnet 4 1 juta token dan kontrol "berpikir" Claude yang diperluas) menjadikan manajemen konteks lebih canggih dan penting: Anda dapat memproses seluruh repositori dalam satu sesi — tetapi hanya jika Anda menyusun perintah, berkas, dan status sesi dengan cermat. Artikel ini menjelaskan cara mengelola konteks Claude Code dengan andal: perintah & penggunaan, kontrol anggaran berpikir, pola CLAUDE.md, alur kerja subagen, kiat pengguna tingkat lanjut, pemecahan masalah, dan contoh kode konkret yang dapat Anda salin-tempel.

Apa itu Kode Claude?

Claude Code adalah Antropik CLI pengkodean agen — alat terminal-first yang menghubungkan lingkungan pengembangan Anda ke model Claude sehingga asisten dapat membaca repo Anda, menjalankan perintah, mengedit berkas, menjalankan pengujian, membuat komitmen, dan menjalankan alur kerja multi-langkah dari terminal. Alat ini dirancang agar AI dapat "hidup" di shell Anda dan bertindak berdasarkan basis kode Anda, dengan fitur-fitur seperti pemindaian repo, perintah slash, subagen (asisten khusus dengan konteks terisolasi), dan integrasi Model Context Protocol (MCP) untuk alat eksternal.


Mengapa saya harus mengelola konteks dari Claude Code?

Karena konteks = relevansi + biaya + keamanan. Jika tidak ditangani, sejarah yang panjang dapat menyebabkan:

  • Penggunaan token yang lebih tinggi (biaya lebih besar, respons lebih lambat).
  • Penyimpangan konteks (info lama/tidak relevan membingungkan keluaran).
  • Kebocoran informasi (rahasia atau log sensitif yang tersangkut dalam sesi).
    Mengelola konteks membuat keluaran tetap akurat, dapat diprediksi, dan lebih murah.

Bagaimana Claude Code mengatur dan memelihara konteks proyek?

Claude Code adalah CLI agen yang memperlakukan repositori, alat, dan konfigurasi Anda sebagai sumber konteks kelas satu. Ia membaca berkas proyek, CLAUDE.md, alat lokal, dan server MCP yang dikonfigurasi; juga mendukung subagen yang masing-masing memiliki jendela konteksnya sendiri (berguna untuk menghindari pencemaran pada percakapan utama). Gunakan ini untuk memisahkan strategi tingkat utama dari memori agen khusus (misalnya, test runner, peninjau kode).

Bagaimana Claude Code mencerna konteks repo dan file pembantu?

  • Ini memindai direktori kerja dan direktori tambahan apa pun yang Anda tambahkan (--add-dir).
  • Itu mencari .claude/ subfolder (perintah, agen) dan CLAUDE.md.
  • Anda dapat menghubungkan server Model Context Protocol (MCP) untuk akses alat eksternal; Claude Code dapat mewarisi alat tersebut ke dalam perangkatnya.

Metode apa yang dapat saya ambil untuk mengelola konteks dalam kode Claude?

  1. Kuasai perintah CLI dasar untuk konteks. Simpan perintah yang dapat digunakan kembali sebagai perintah garis miring di .claude/commands/ untuk menghindari penempelan perintah yang panjang berulang kali.
  2. Rancang berkas CLAUDE.md dengan tepat. Tambahkan CLAUDE.md ke akar repositori untuk menentukan tujuan, alat yang diizinkan, gaya, aturan eskalasi, dan perintah slash yang bermanfaat. (Claude Code membaca ini secara otomatis dan menggunakannya sebagai panduan yang valid.)
  3. Gunakan subagen untuk isolasi tugas—setiap subagen memiliki jendela konteks dan izin alatnya sendiri, yang mencegah sesi utama di-polling. Simpan subagen di .claude/agents/ dan kendalikan versinya.

Apa saja perintah dasar manajemen konteks?

Berikut adalah perintah-perintah yang paling sering Anda gunakan untuk mengelola status percakapan di Claude Code. Saya mencantumkan perilaku, contoh penggunaan, skenario yang direkomendasikan, dan petunjuk ke flag CLI terkait.


/clear — “memulai dari awal”

Apa yang dilakukannya: menghapus riwayat percakapan saat ini dari sesi sehingga perintah selanjutnya dimulai dari awal. Sesi REPL berlanjut, tetapi pesan bolak-balik dihapus dari konteks model. (File proyek dan CLAUDE.md tetap dapat diakses oleh Claude Code.)

Kapan harus digunakan

  • Setelah menyelesaikan fitur atau tiket dan Anda menginginkan sesi yang bersih untuk tugas yang tidak terkait.
  • Jika sesi telah mengumpulkan banyak putaran eksplorasi dan jawaban-jawabannya merendahkan.
  • Sebelum menyerahkan sesi ke pengguna/agen lain untuk menghindari kebocoran status percakapan sebelumnya.

penggunaan

# in the interactive REPL

/clear

Catatan & tips

  • /clear merusak riwayat percakapan sesi tersebut; gunakan /resume/--continue jika Anda ingin kembali ke sesi lama yang disimpan di disk.

/compact — “meringkas dan meringkas”

Apa yang dilakukannya: Memampatkan percakapan saat ini menjadi ringkasan yang lebih pendek yang mempertahankan fakta dan keputusan penting, lalu mengganti riwayat yang panjang dengan ringkasan tersebut agar sesi dapat berlanjut tanpa kehilangan konteks penting. Hal ini mengurangi penggunaan token sekaligus menjaga kontinuitas.

Kapan harus digunakan

  • Ketika Anda ingin mempertahankan status penting thread tetapi mengurangi jejak token.
  • Sebelum tugas baru yang panjang yang sebaliknya akan mendorong jendela konteks hingga mencapai batasnya.
  • Ketika Anda menginginkan “memori” sesi yang ringkas sambil tetap mempertahankan keputusan-keputusan penting.

penggunaan

# in the interactive REPL

/compact
# or with an instruction to guide the summary

/compact Summarize decisions, open TODOs, and config changes only

Catatan & tips

  • auto-compact, microcompact, dan perilaku pemadatan cerdas lainnya dapat berjalan secara otomatis ketika panjang percakapan mencapai batas di beberapa build atau pengaturan; fitur-fitur tersebut sedang diluncurkan dan mungkin muncul di instalasi atau lingkungan hosting Anda. (Komunitas dan catatan perubahan membahas perilaku pemadatan mikro dan pemadatan otomatis.)

--continue, --resume, dan kontrol sesi (tingkat CLI)

Apa yang mereka lakukan: mengontrol persistensi dan pemilihan sesi dari CLI.

  • claude --continue (Atau claude -c) — membuka kembali dan melanjutkan percakapan terkini di direktori proyek saat ini.
  • claude --resume (Atau claude -r <session-id>) — menampilkan pemilih interaktif (atau melanjutkan sesi tertentu berdasarkan ID). Berguna jika Anda telah menyimpan banyak sesi dan ingin memilih satu untuk melanjutkan.

Contoh penggunaan

# continue the most recent session

claude --continue

# open an interactive session picker

claude --resume

# resume by id (non-interactive)

claude --resume 550e8400-e29b-41d4-a716-446655440000

Pintasan mode interaktif yang penting untuk konteks (UX terminal)

  • Ctrl+L — membersihkan layar terminal (visual), tetapi terus riwayat percakapan. Gunakan /clear untuk benar-benar mengatur ulang sejarah.
  • Ctrl+D — keluar dari sesi (EOF).
  • Ctrl+C — batalkan pembangkitan saat ini.
    Ini adalah kontrol kenyamanan; mereka hanya memengaruhi perilaku terminal kecuali Anda menjalankannya secara eksplisit /clear or --continue/--resume.

Kontrol & bendera terkait konteks lainnya

  • --add-dir <path> — sertakan direktori tambahan untuk dibaca Claude (berguna untuk menentukan ruang lingkup yang dapat diakses Claude dan mengurangi pembacaan file yang tidak diperlukan).
  • --allowedTools — pra-izinkan alat sehingga Claude dapat menjalankannya tanpa permintaan izin berulang (mengurangi dialog izin alat yang bolak-balik dan berisik).
  • Perintah garis miring (/.claude/commands/ atau disediakan MCP) — menyimpan perintah yang sering digunakan dan hemat token; memanggil perintah garis miring lebih murah daripada menempelkan perintah panjang berulang kali.

Bagaimana saya harus mendesain file CLAUDE.md untuk mengontrol konteks proyek?

Apa itu CLAUDE.md dan mengapa itu penting

CLAUDE.md adalah prompt pra-penerbangan tingkat proyek yang dibaca Claude Code secara otomatis saat memulai di sebuah repo. Gunakan prompt ini untuk memasukkan fakta-fakta singkat, mudah ditindaklanjuti, dan stabil tentang proyek (kata benda, arsitektur, standar). Karena model memasukkan CLAUDE.md ke dalam prompt, berkas yang dirancang dengan baik mengurangi kebutuhan untuk menempelkan informasi yang sama berulang kali dan menghemat anggaran token yang berharga.

CLAUDE.md: templat praktis (disarankan)

Pertahankan aturan berikut: bagian yang pendek (100–200 baris jika memungkinkan), hierarkis (penimpaan global → proyek → subdir), dan dapat dibaca mesin.

# CLAUDE.md — top of repository

Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)

# Conventions

- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)

# What I'm asking Claude to do

- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.

Catatan:

  • Letakkan item bernilai tinggi (API, file penting, perintah infra, perintah uji) terlebih dahulu.
  • Gunakan terpisah CLAUDE.md file dalam subdirektori ketika modul yang berbeda memiliki konvensi yang berbeda; Claude akan menggabungkan dan memprioritaskan file yang lebih spesifik.

Bagaimana cara menyusun alur kerja dan subagen untuk mengelola konteks dan memparalelkan pekerjaan?

Apa itu subagen?

Subagen adalah pola Kode Claude di mana agen utama mendelegasikan tugas-tugas terpisah kepada agen bawahan (misalnya: frontend-agent, backend-agent, qa-agent) lalu agen utama merekonsiliasi output mereka. Subagen memungkinkan Anda bekerja di berbagai bagian sistem secara paralel tanpa memasukkan semuanya ke dalam satu obrolan.

Contoh alur kerja: implementasi fitur (agen paralel)

  1. main-agent membaca CLAUDE.md, membuat rencana.
  2. frontend-agent (subagent) mendapat konteks yang terfokus: kontrak UI, buku cerita, berkas tertentu.
  3. backend-agent (subagent) mendapatkan skema DB, kontrak API, dan mengimplementasikan titik akhir.
  4. qa-agent menjalankan tes, menulis kembali tes yang gagal ke main-agent.
  5. main-agent mengatur komitmen, permintaan penggabungan, dan pembaruan CLAUDE.md.

Pola CLI:

# start main session

claude --session main

# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)

claude --session frontend --cwd frontend/

Tip: Buat cakupan CLAUDE.md file di bawah subdirektori (frontend/CLAUDE.md, backend/CLAUDE.md) sehingga setiap subagen memulai dengan konteks minimal yang dibutuhkannya.

Contoh subagen: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---

You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.

Apa saja kiat pengguna berpengalaman untuk menjaga konteks tetap sehat dan biaya tetap rendah?

1) Jaga CLAUDE.md tetap ramping dan hierarkis

Hindari berkas CLAUDE.md monolitik berukuran besar. Gunakan satu berkas global untuk preferensi pengembang dan berkas modul kecil untuk spesifikasi area. Lihat templat sebelumnya.

2) Gunakan perintah garis miring untuk kata kerja, CLAUDE.md untuk kata benda

Jadikan CLAUDE.md tempat untuk fakta (file apa saja yang ada, arsitekturnya), dan perintah slash tempat untuk Prosedur (membuat pengujian, menjalankan refaktor). Ini mencegah pengiriman ulang logika prosedural setiap sesi. Kearifan komunitas menekankan pemisahan ini.

3) Mode verbose + mode rencana sebagai alat debugging

Jika Claude berperilaku tidak terduga, jalankan verbose untuk melihat konteks yang tepat, dan gunakan mode rencana untuk memaksakan rencana eksplisit yang dapat Anda setujui sebelum pengeditan.

4) Berpikir anggaran dengan cermat

Mulailah dengan token berpikir default/minimum dan tingkatkan hanya ketika tugas membutuhkan penalaran multi-langkah (refaktor kompleks, verifikasi formal). Gunakan anggaran yang lebih rendah untuk pengeditan rutin.

5) Output dan komitmen instrumen

Memiliki kait yang secara otomatis menjalankan pengujian dan melampirkan outputnya ke sesi (mode bash ! untuk menjalankan perintah shell dan menyertakan output sebagai konteks). Gunakan kait komit untuk membuat komit atomik yang jelas dengan pesan.

Bagaimana cara saya memecahkan masalah ketika konteks "terputus" atau Claude lupa instruksi?

Gejala umum dan solusinya

  • Gejala: Claude mengabaikan CLAUDE.md atau instruksi sebelumnya.
  • perbaikan: Konfirmasikan bahwa berkas berada di direktori kerja sesi saat ini; periksa subdir CLAUDE.md yang lebih spesifik yang menimpanya; gunakan mode verbose untuk melihat perintah saat ini.
  • Gejala: Performa menurun selama sesi yang panjang (model “melupakan” bagian awal).
  • perbaikan: Padatkan sesi: ekstrak fakta stabil ke dalam CLAUDE.md, atau snapshot bagian percakapan ke dalam berkas dan rujuk alih-alih mengulang. Pertimbangkan juga untuk memulai kembali sesi singkat dan hanya sampaikan konteks yang ringkas.
  • Gejala: Berpikir luas memakan waktu terlalu lama atau menghabiskan waktu.
  • perbaikan: Turunkan thinking_budget, bagi tugas menjadi submasalah yang lebih kecil, atau jalankan analisis batch offline jika Anda membutuhkan anggaran yang sangat besar. Anthropic merekomendasikan batching ketika anggaran berpikir optimal melebihi ~32 ribu token untuk menghindari batas waktu.

Kesimpulan

Mengelola konteks di Claude Code sekarang menjadi masalah multidimensi: pilihan model, desain subagen, CLAUDE.md disiplin, anggaran pemikiran, dan arsitektur perkakas semuanya saling berinteraksi. Mulailah dengan meluangkan 1–2 jam untuk menyusun rencana yang jelas. CLAUDE.md, perancah 2–3 subagen yang terfokus, dan tambahkan instrumentasi penggunaan untuk token dan anggaran pemikiran — Anda akan melihat peningkatan langsung dalam keandalan, prediktabilitas biaya, dan produktivitas tim.

Gunakan Kode Claude melalui CometAPI

CometAPI adalah platform API terpadu yang menggabungkan lebih dari 500 model AI dari penyedia terkemuka—seperti seri GPT OpenAI, Gemini Google, Claude Anthropic, Midjourney, Suno, dan lainnya—menjadi satu antarmuka yang ramah bagi pengembang. Dengan menawarkan autentikasi yang konsisten, pemformatan permintaan, dan penanganan respons, CometAPI secara drastis menyederhanakan integrasi kapabilitas AI ke dalam aplikasi Anda. Baik Anda sedang membangun chatbot, generator gambar, komposer musik, atau alur kerja analitik berbasis data, CometAPI memungkinkan Anda melakukan iterasi lebih cepat, mengendalikan biaya, dan tetap tidak bergantung pada vendor—semuanya sambil memanfaatkan terobosan terbaru di seluruh ekosistem AI.

Kami gembira mengumumkan bahwa CometAPI kini sepenuhnya mendukung Claude Code yang canggih. Anda hanya perlu menginstal Claude Code dan mengautentikasi dengan kunci API Comet dan alamat dasar yang diperoleh untuk menggunakan model API Comet pada Claude Code.

Mengapa menggunakan kode claude melalui CometAPI?

Fitur-fitur utama Kecerdasan Buatan: Mudah menghasilkan, men-debug, dan mengoptimalkan kode menggunakan model yang dibuat khusus untuk pengembang.

  • Pemilihan Model yang Fleksibel: Berbagai model kami yang komprehensif memungkinkan Anda mengembangkan dengan lebih lancar.
  • Integrasi yang Lancar: API selalu tersedia. Integrasikan Claude Code langsung ke alur kerja Anda yang sudah ada dalam hitungan menit.
  • Menggunakan Claude Code melalui CometAPI akan menghemat lebih banyak biayaAPI yang disediakan oleh CometAPI menawarkan diskon 20% dari harga resmi dan diperbarui dengan model terbaru oleh pihak resmi. Model terbaru adalah Claude Karya 4.1.

Siap menggunakan Kode Claude? konsultasikan Panduan API untuk petunjuk rinci.

Lihat Juga Bagaimana Cara Menginstal dan Menjalankan Kode Claude melalui CometAPI?

Baca Selengkapnya

500+ Model dalam Satu API

Diskon hingga 20%