Jika Anda memerlukan beberapa agen yang bekerja secara paralel dan berkomunikasi satu sama lain, lihat tim agen sebagai gantinya. Subagent bekerja dalam satu sesi; tim agen mengoordinasikan di seluruh sesi terpisah.
- Mempertahankan konteks dengan menjaga eksplorasi dan implementasi di luar percakapan utama Anda
- Menerapkan batasan dengan membatasi alat mana yang dapat digunakan subagent
- Menggunakan kembali konfigurasi di seluruh proyek dengan subagent tingkat pengguna
- Mengkhususkan perilaku dengan prompt sistem yang terfokus untuk domain tertentu
- Mengontrol biaya dengan merutekan tugas ke model yang lebih cepat dan lebih murah seperti Haiku
Subagent bawaan
Claude Code mencakup subagent bawaan yang Claude gunakan secara otomatis jika sesuai. Masing-masing mewarisi izin percakapan induk dengan pembatasan alat tambahan.- Explore
- Plan
- General-purpose
- Other
Agen cepat yang dioptimalkan hanya-baca untuk mencari dan menganalisis basis kode.
- Model: Haiku (cepat, latensi rendah)
- Alat: Alat hanya-baca (akses ditolak ke alat Write dan Edit)
- Tujuan: Penemuan file, pencarian kode, eksplorasi basis kode
Quickstart: buat subagent pertama Anda
Subagent didefinisikan dalam file Markdown dengan frontmatter YAML. Anda dapat membuatnya secara manual atau menggunakan perintah/agents.
Panduan ini memandu Anda melalui pembuatan subagent tingkat pengguna dengan perintah /agents. Subagent meninjau kode dan menyarankan perbaikan untuk basis kode.
Pilih lokasi
Pilih Create new agent, kemudian pilih Personal. Ini menyimpan subagent ke
~/.claude/agents/ sehingga tersedia di semua proyek Anda.Hasilkan dengan Claude
Pilih Generate with Claude. Ketika diminta, jelaskan subagent:Claude menghasilkan pengenal, deskripsi, dan prompt sistem untuk Anda.
Pilih alat
Untuk reviewer hanya-baca, batalkan pilihan semuanya kecuali Read-only tools. Jika Anda membiarkan semua alat dipilih, subagent mewarisi semua alat yang tersedia untuk percakapan utama.
Pilih model
Pilih model mana yang digunakan subagent. Untuk agen contoh ini, pilih Sonnet, yang menyeimbangkan kemampuan dan kecepatan untuk menganalisis pola kode.
Pilih warna
Pilih warna latar belakang untuk subagent. Ini membantu Anda mengidentifikasi subagent mana yang berjalan di UI.
Konfigurasi memori
Pilih User scope untuk memberikan subagent direktori memori persisten di
~/.claude/agent-memory/. Subagent menggunakan ini untuk mengumpulkan wawasan di seluruh percakapan, seperti pola basis kode dan masalah berulang. Pilih None jika Anda tidak ingin subagent mempertahankan pembelajaran.Konfigurasi subagent
Gunakan perintah /agents
Perintah/agents menyediakan antarmuka interaktif untuk mengelola subagent. Jalankan /agents untuk:
- Melihat semua subagent yang tersedia (bawaan, pengguna, proyek, dan plugin)
- Membuat subagent baru dengan setup terpandu atau generasi Claude
- Mengedit konfigurasi subagent yang ada dan akses alat
- Menghapus subagent khusus
- Melihat subagent mana yang aktif ketika duplikat ada
claude agents. Ini menunjukkan agen yang dikelompokkan berdasarkan sumber dan menunjukkan mana yang ditimpa oleh definisi prioritas lebih tinggi.
Pilih cakupan subagent
Subagent adalah file Markdown dengan frontmatter YAML. Simpan mereka di lokasi berbeda tergantung cakupan. Ketika beberapa subagent berbagi nama yang sama, lokasi prioritas lebih tinggi menang.| Lokasi | Cakupan | Prioritas | Cara membuat |
|---|---|---|---|
Flag CLI --agents | Sesi saat ini | 1 (tertinggi) | Lewatkan JSON saat meluncurkan Claude Code |
.claude/agents/ | Proyek saat ini | 2 | Interaktif atau manual |
~/.claude/agents/ | Semua proyek Anda | 3 | Interaktif atau manual |
Direktori agents/ plugin | Tempat plugin diaktifkan | 4 (terendah) | Diinstal dengan plugins |
.claude/agents/) ideal untuk subagent khusus untuk basis kode. Periksa mereka ke kontrol versi sehingga tim Anda dapat menggunakannya dan meningkatkannya secara kolaboratif.
Subagent pengguna (~/.claude/agents/) adalah subagent pribadi yang tersedia di semua proyek Anda.
Subagent yang ditentukan CLI dilewatkan sebagai JSON saat meluncurkan Claude Code. Mereka hanya ada untuk sesi itu dan tidak disimpan ke disk, menjadikannya berguna untuk pengujian cepat atau skrip otomasi. Anda dapat mendefinisikan beberapa subagent dalam satu panggilan --agents:
--agents menerima JSON dengan frontmatter yang sama bidang file-based subagent: description, prompt, tools, disallowedTools, model, permissionMode, mcpServers, hooks, maxTurns, skills, initialPrompt, memory, effort, background, dan isolation. Gunakan prompt untuk prompt sistem, setara dengan badan markdown dalam subagent berbasis file.
Subagent plugin berasal dari plugins yang telah Anda instal. Mereka muncul di /agents bersama subagent khusus Anda. Lihat referensi komponen plugin untuk detail tentang membuat subagent plugin.
Untuk alasan keamanan, subagent plugin tidak mendukung bidang frontmatter
hooks, mcpServers, atau permissionMode. Bidang-bidang ini diabaikan saat memuat agen dari plugin. Jika Anda membutuhkannya, salin file agen ke dalam .claude/agents/ atau ~/.claude/agents/. Anda juga dapat menambahkan aturan ke permissions.allow dalam settings.json atau settings.local.json, tetapi aturan-aturan ini berlaku untuk seluruh sesi, bukan hanya subagent plugin.Tulis file subagent
File subagent menggunakan frontmatter YAML untuk konfigurasi, diikuti oleh prompt sistem dalam Markdown:Subagent dimuat saat awal sesi. Jika Anda membuat subagent dengan menambahkan file secara manual, restart sesi Anda atau gunakan
/agents untuk memuatnya segera.Bidang frontmatter yang didukung
Bidang berikut dapat digunakan dalam frontmatter YAML. Hanyaname dan description yang diperlukan.
| Bidang | Diperlukan | Deskripsi |
|---|---|---|
name | Ya | Pengenal unik menggunakan huruf kecil dan tanda hubung |
description | Ya | Kapan Claude harus mendelegasikan ke subagent ini |
tools | Tidak | Alat yang dapat digunakan subagent. Mewarisi semua alat jika dihilangkan |
disallowedTools | Tidak | Alat untuk ditolak, dihapus dari daftar yang diwarisi atau ditentukan |
model | Tidak | Model untuk digunakan: sonnet, opus, haiku, ID model lengkap (misalnya, claude-opus-4-6), atau inherit. Default ke inherit |
permissionMode | Tidak | Mode izin: default, acceptEdits, dontAsk, bypassPermissions, atau plan |
maxTurns | Tidak | Jumlah maksimum putaran agentic sebelum subagent berhenti |
skills | Tidak | Skills untuk dimuat ke dalam konteks subagent saat startup. Konten skill lengkap disuntikkan, bukan hanya tersedia untuk invokasi. Subagent tidak mewarisi skills dari percakapan induk |
mcpServers | Tidak | MCP servers tersedia untuk subagent ini. Setiap entri adalah nama server yang mereferensikan server yang sudah dikonfigurasi (misalnya, "slack") atau definisi inline dengan nama server sebagai kunci dan konfigurasi MCP server lengkap sebagai nilai |
hooks | Tidak | Lifecycle hooks yang dibatasi pada subagent ini |
memory | Tidak | Cakupan memori persisten: user, project, atau local. Memungkinkan pembelajaran lintas sesi |
background | Tidak | Atur ke true untuk selalu menjalankan subagent ini sebagai background task. Default: false |
effort | Tidak | Tingkat usaha ketika subagent ini aktif. Menimpa tingkat usaha sesi. Default: mewarisi dari sesi. Opsi: low, medium, high, max (Opus 4.6 saja) |
isolation | Tidak | Atur ke worktree untuk menjalankan subagent dalam git worktree sementara, memberikannya salinan repositori yang terisolasi. Worktree secara otomatis dibersihkan jika subagent tidak membuat perubahan |
initialPrompt | Tidak | Auto-submitted sebagai putaran pengguna pertama ketika agen ini berjalan sebagai agen sesi utama (melalui --agent atau pengaturan agent). Commands dan skills diproses. Ditambahkan di depan prompt yang disediakan pengguna apa pun |
Pilih model
Bidangmodel mengontrol model AI mana yang digunakan subagent:
- Alias model: Gunakan salah satu alias yang tersedia:
sonnet,opus, atauhaiku - ID model lengkap: Gunakan ID model lengkap seperti
claude-opus-4-6atauclaude-sonnet-4-6. Menerima nilai yang sama dengan flag--model - inherit: Gunakan model yang sama dengan percakapan utama
- Dihilangkan: Jika tidak ditentukan, default ke
inherit(menggunakan model yang sama dengan percakapan utama)
model untuk invokasi spesifik itu. Claude Code menyelesaikan model subagent dalam urutan ini:
- Variabel lingkungan
CLAUDE_CODE_SUBAGENT_MODEL, jika diatur - Parameter
modelper-invokasi - Frontmatter
modeldefinisi subagent - Model percakapan utama
Kontrol kemampuan subagent
Anda dapat mengontrol apa yang dapat dilakukan subagent melalui akses alat, mode izin, dan aturan bersyarat.Alat yang tersedia
Subagent dapat menggunakan salah satu alat internal Claude Code. Secara default, subagent mewarisi semua alat dari percakapan utama, termasuk alat MCP. Untuk membatasi alat, gunakan bidangtools (allowlist) atau bidang disallowedTools (denylist). Contoh ini menggunakan tools untuk secara eksklusif mengizinkan Read, Grep, Glob, dan Bash. Subagent tidak dapat mengedit file, menulis file, atau menggunakan alat MCP apa pun:
disallowedTools untuk mewarisi setiap alat dari percakapan utama kecuali Write dan Edit. Subagent menyimpan Bash, alat MCP, dan semuanya yang lain:
disallowedTools diterapkan terlebih dahulu, kemudian tools diselesaikan terhadap kumpulan yang tersisa. Alat yang tercantum di keduanya dihapus.
Batasi subagent mana yang dapat dihasilkan
Ketika agen berjalan sebagai thread utama denganclaude --agent, agen dapat menelurkan subagent menggunakan alat Agent. Untuk membatasi jenis subagent mana yang dapat dihasilkan, gunakan sintaks Agent(agent_type) dalam bidang tools.
Dalam versi 2.1.63, alat Task diganti nama menjadi Agent. Referensi
Task(...) yang ada dalam pengaturan dan definisi agen masih berfungsi sebagai alias.worker dan researcher yang dapat dihasilkan. Jika agen mencoba menelurkan jenis lain, permintaan gagal dan agen hanya melihat jenis yang diizinkan dalam promptnya. Untuk memblokir agen tertentu sambil mengizinkan semua yang lain, gunakan permissions.deny sebagai gantinya.
Untuk mengizinkan penelur subagent apa pun tanpa pembatasan, gunakan Agent tanpa tanda kurung:
Agent dihilangkan dari daftar tools sepenuhnya, agen tidak dapat menelurkan subagent apa pun. Pembatasan ini hanya berlaku untuk agen yang berjalan sebagai thread utama dengan claude --agent. Subagent tidak dapat menelurkan subagent lain, jadi Agent(agent_type) tidak berpengaruh dalam definisi subagent.
Cakupan MCP servers ke subagent
Gunakan bidangmcpServers untuk memberikan subagent akses ke MCP servers yang tidak tersedia dalam percakapan utama. Server inline yang ditentukan di sini terhubung saat subagent dimulai dan terputus saat selesai. Referensi string berbagi koneksi sesi induk.
Setiap entri dalam daftar adalah definisi server inline atau string yang mereferensikan MCP server yang sudah dikonfigurasi dalam sesi Anda:
.mcp.json (stdio, http, sse, ws), dikunci dengan nama server.
Untuk menjaga MCP server di luar percakapan utama sepenuhnya dan menghindari deskripsi alatnya mengonsumsi konteks di sana, tentukan secara inline di sini daripada di .mcp.json. Subagent mendapatkan alat; percakapan induk tidak.
Mode izin
BidangpermissionMode mengontrol bagaimana subagent menangani prompt izin. Subagent mewarisi konteks izin dari percakapan utama dan dapat menimpa mode, kecuali ketika mode induk mengambil alih seperti yang dijelaskan di bawah.
| Mode | Perilaku |
|---|---|
default | Pemeriksaan izin standar dengan prompt |
acceptEdits | Auto-terima edit file |
dontAsk | Auto-tolak prompt izin (alat yang secara eksplisit diizinkan masih berfungsi) |
bypassPermissions | Lewati prompt izin |
plan | Plan mode (eksplorasi hanya-baca) |
bypassPermissions, ini mengambil alih dan tidak dapat ditimpa. Jika induk menggunakan auto mode, subagent mewarisi auto mode dan permissionMode apa pun dalam frontmatternya diabaikan: pengklasifikasi mengevaluasi panggilan alat subagent dengan aturan blok dan izin yang sama dengan sesi induk.
Preload skills ke dalam subagent
Gunakan bidangskills untuk menyuntikkan konten skill ke dalam konteks subagent saat startup. Ini memberikan subagent pengetahuan domain tanpa memerlukan penemuan dan pemuatan skills selama eksekusi.
Ini adalah kebalikan dari menjalankan skill dalam subagent. Dengan
skills dalam subagent, subagent mengontrol prompt sistem dan memuat konten skill. Dengan context: fork dalam skill, konten skill disuntikkan ke dalam agen yang Anda tentukan. Keduanya menggunakan sistem yang mendasar yang sama.Aktifkan memori persisten
Bidangmemory memberikan subagent direktori persisten yang bertahan di seluruh percakapan. Subagent menggunakan direktori ini untuk membangun pengetahuan seiring waktu, seperti pola basis kode, wawasan debugging, dan keputusan arsitektur.
| Cakupan | Lokasi | Gunakan ketika |
|---|---|---|
user | ~/.claude/agent-memory/<name-of-agent>/ | subagent harus mengingat pembelajaran di seluruh semua proyek |
project | .claude/agent-memory/<name-of-agent>/ | pengetahuan subagent spesifik proyek dan dapat dibagikan melalui kontrol versi |
local | .claude/agent-memory-local/<name-of-agent>/ | pengetahuan subagent spesifik proyek tetapi tidak boleh diperiksa ke dalam kontrol versi |
- Prompt sistem subagent mencakup instruksi untuk membaca dan menulis ke direktori memori.
- Prompt sistem subagent juga mencakup 200 baris pertama
MEMORY.mddalam direktori memori, dengan instruksi untuk mengkurasiMEMORY.mdjika melebihi 200 baris. - Alat Read, Write, dan Edit secara otomatis diaktifkan sehingga subagent dapat mengelola file memorinya.
Tips memori persisten
-
projectadalah cakupan default yang direkomendasikan. Ini membuat pengetahuan subagent dapat dibagikan melalui kontrol versi. Gunakanuserketika pengetahuan subagent berlaku secara luas di seluruh proyek, ataulocalketika pengetahuan tidak boleh diperiksa ke dalam kontrol versi. - Minta subagent untuk berkonsultasi dengan memorinya sebelum memulai pekerjaan: “Review PR ini, dan periksa memori Anda untuk pola yang telah Anda lihat sebelumnya.”
- Minta subagent untuk memperbarui memorinya setelah menyelesaikan tugas: “Sekarang setelah Anda selesai, simpan apa yang Anda pelajari ke memori Anda.” Seiring waktu, ini membangun basis pengetahuan yang membuat subagent lebih efektif.
-
Sertakan instruksi memori langsung dalam file markdown subagent sehingga secara proaktif mempertahankan basis pengetahuannya sendiri:
Aturan bersyarat dengan hooks
Untuk kontrol yang lebih dinamis atas penggunaan alat, gunakan hooksPreToolUse untuk memvalidasi operasi sebelum dijalankan. Ini berguna ketika Anda perlu mengizinkan beberapa operasi alat sambil memblokir yang lain.
Contoh ini membuat subagent yang hanya mengizinkan kueri database hanya-baca. Hook PreToolUse menjalankan skrip yang ditentukan dalam command sebelum setiap perintah Bash dijalankan:
Nonaktifkan subagent tertentu
Anda dapat mencegah Claude menggunakan subagent tertentu dengan menambahkannya ke arraydeny dalam pengaturan Anda. Gunakan format Agent(subagent-name) di mana subagent-name cocok dengan bidang nama subagent.
--disallowedTools:
Tentukan hooks untuk subagent
Subagent dapat mendefinisikan hooks yang berjalan selama siklus hidup subagent. Ada dua cara untuk mengonfigurasi hooks:- Dalam frontmatter subagent: Tentukan hooks yang hanya berjalan saat subagent tertentu itu aktif
- Dalam
settings.json: Tentukan hooks yang berjalan dalam sesi utama ketika subagent dimulai atau berhenti
Hooks dalam frontmatter subagent
Tentukan hooks langsung dalam file markdown subagent. Hooks ini hanya berjalan saat subagent spesifik itu aktif dan dibersihkan saat selesai. Semua hook events didukung. Peristiwa paling umum untuk subagent adalah:| Peristiwa | Input Matcher | Kapan itu terjadi |
|---|---|---|
PreToolUse | Nama alat | Sebelum subagent menggunakan alat |
PostToolUse | Nama alat | Setelah subagent menggunakan alat |
Stop | (tidak ada) | Ketika subagent selesai (dikonversi ke SubagentStop saat runtime) |
PreToolUse dan menjalankan linter setelah edit file dengan PostToolUse:
Stop dalam frontmatter secara otomatis dikonversi ke peristiwa SubagentStop.
Hooks tingkat proyek untuk peristiwa subagent
Konfigurasi hooks dalamsettings.json yang merespons peristiwa siklus hidup subagent dalam sesi utama.
| Peristiwa | Input Matcher | Kapan itu terjadi |
|---|---|---|
SubagentStart | Nama jenis agen | Ketika subagent mulai dijalankan |
SubagentStop | Nama jenis agen | Ketika subagent selesai |
db-agent dimulai, dan skrip cleanup ketika subagent apa pun berhenti:
Bekerja dengan subagent
Pahami delegasi otomatis
Claude secara otomatis mendelegasikan tugas berdasarkan deskripsi tugas dalam permintaan Anda, bidangdescription dalam konfigurasi subagent, dan konteks saat ini. Untuk mendorong delegasi proaktif, sertakan frasa seperti “use proactively” dalam bidang deskripsi subagent Anda.
Panggil subagent secara eksplisit
Ketika delegasi otomatis tidak cukup, Anda dapat meminta subagent sendiri. Tiga pola meningkat dari saran satu kali ke default sesi-lebar:- Bahasa alami: sebutkan subagent dalam prompt Anda; Claude memutuskan apakah akan mendelegasikan
- @-mention: menjamin subagent berjalan untuk satu tugas
- Sesi-lebar: seluruh sesi menggunakan prompt sistem subagent, pembatasan alat, dan model melalui flag
--agentatau pengaturanagent
@ dan pilih subagent dari typeahead, dengan cara yang sama Anda @-mention file. Ini memastikan subagent tertentu berjalan daripada meninggalkan pilihan kepada Claude:
<plugin-name>:<agent-name>. Anda juga dapat mengetik mention secara manual tanpa menggunakan picker: @agent-<name> untuk subagent lokal, atau @agent-<plugin-name>:<agent-name> untuk subagent plugin.
Jalankan seluruh sesi sebagai subagent. Lewatkan --agent <name> untuk memulai sesi di mana thread utama itu sendiri mengambil prompt sistem subagent, pembatasan alat, dan model:
--system-prompt melakukannya. File CLAUDE.md dan memori proyek masih dimuat melalui aliran pesan normal. Nama agen muncul sebagai @<name> di header startup sehingga Anda dapat mengonfirmasi itu aktif.
Ini berfungsi dengan subagent bawaan dan khusus, dan pilihan bertahan ketika Anda melanjutkan sesi.
Untuk subagent yang disediakan plugin, lewatkan nama yang dibatasi: claude --agent <plugin-name>:<agent-name>.
Untuk menjadikannya default untuk setiap sesi dalam proyek, atur agent dalam .claude/settings.json:
Jalankan subagent di foreground atau background
Subagent dapat berjalan di foreground (blocking) atau background (concurrent):- Subagent foreground memblokir percakapan utama sampai selesai. Prompt izin dan pertanyaan klarifikasi (seperti
AskUserQuestion) dilewatkan kepada Anda. - Subagent background berjalan secara bersamaan sementara Anda terus bekerja. Sebelum diluncurkan, Claude Code meminta izin alat apa pun yang akan dibutuhkan subagent, memastikan ia memiliki persetujuan yang diperlukan di muka. Setelah berjalan, subagent mewarisi izin ini dan auto-menolak apa pun yang tidak pra-disetujui. Jika subagent background perlu mengajukan pertanyaan klarifikasi, panggilan alat itu gagal tetapi subagent terus.
- Minta Claude untuk “run this in the background”
- Tekan Ctrl+B untuk menempatkan tugas yang sedang berjalan di background
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ke 1. Lihat Environment variables.
Pola umum
Isolasi operasi volume tinggi
Salah satu penggunaan paling efektif untuk subagent adalah mengisolasi operasi yang menghasilkan jumlah output besar. Menjalankan tes, mengambil dokumentasi, atau memproses file log dapat mengonsumsi konteks yang signifikan. Dengan mendelegasikan ini ke subagent, output verbose tetap dalam konteks subagent sementara hanya ringkasan relevan yang kembali ke percakapan utama Anda.Jalankan penelitian paralel
Untuk investigasi independen, hasilkan beberapa subagent untuk bekerja secara bersamaan:Rantai subagent
Untuk alur kerja multi-langkah, minta Claude untuk menggunakan subagent secara berurutan. Setiap subagent menyelesaikan tugasnya dan mengembalikan hasil ke Claude, yang kemudian melewatkan konteks relevan ke subagent berikutnya.Pilih antara subagent dan percakapan utama
Gunakan percakapan utama ketika:- Tugas memerlukan bolak-balik yang sering atau penyempurnaan iteratif
- Beberapa fase berbagi konteks yang signifikan (perencanaan → implementasi → pengujian)
- Anda membuat perubahan cepat dan tertarget
- Latensi penting. Subagent dimulai segar dan mungkin memerlukan waktu untuk mengumpulkan konteks
- Tugas menghasilkan output verbose yang Anda tidak butuhkan dalam konteks utama Anda
- Anda ingin menerapkan pembatasan alat atau izin tertentu
- Pekerjaan mandiri dan dapat mengembalikan ringkasan
/btw sebagai gantinya dari subagent. Ini melihat konteks penuh Anda tetapi tidak memiliki akses alat, dan jawabannya dibuang daripada ditambahkan ke riwayat.
Subagent tidak dapat menelurkan subagent lain. Jika alur kerja Anda memerlukan delegasi bersarang, gunakan Skills atau rantai subagent dari percakapan utama.
Kelola konteks subagent
Lanjutkan subagent
Setiap invokasi subagent membuat instance baru dengan konteks segar. Untuk melanjutkan pekerjaan subagent yang ada daripada memulai dari awal, minta Claude untuk melanjutkannya. Subagent yang dilanjutkan mempertahankan riwayat percakapan lengkap mereka, termasuk semua panggilan alat sebelumnya, hasil, dan penalaran. Subagent melanjutkan tepat di mana ia berhenti daripada memulai segar. Ketika subagent selesai, Claude menerima ID agennya. Claude menggunakan alatSendMessage dengan ID agen sebagai bidang to untuk melanjutkannya. Untuk melanjutkan subagent, minta Claude untuk melanjutkan pekerjaan sebelumnya:
~/.claude/projects/{project}/{sessionId}/subagents/. Setiap transkrip disimpan sebagai agent-{agentId}.jsonl.
Transkrip subagent bertahan secara independen dari percakapan utama:
- Pemadatan percakapan utama: Ketika percakapan utama dipadatkan, transkrip subagent tidak terpengaruh. Mereka disimpan dalam file terpisah.
- Persistensi sesi: Transkrip subagent bertahan dalam sesi mereka. Anda dapat melanjutkan subagent setelah memulai ulang Claude Code dengan melanjutkan sesi yang sama.
- Pembersihan otomatis: Transkrip dibersihkan berdasarkan pengaturan
cleanupPeriodDays(default: 30 hari).
Auto-compaction
Subagent mendukung pemadatan otomatis menggunakan logika yang sama dengan percakapan utama. Secara default, auto-compaction dipicu pada kapasitas sekitar 95%. Untuk memicu pemadatan lebih awal, aturCLAUDE_AUTOCOMPACT_PCT_OVERRIDE ke persentase yang lebih rendah (misalnya, 50). Lihat environment variables untuk detail.
Peristiwa pemadatan dicatat dalam file transkrip subagent:
preTokens menunjukkan berapa banyak token yang digunakan sebelum pemadatan terjadi.
Contoh subagent
Contoh-contoh ini mendemonstrasikan pola efektif untuk membangun subagent. Gunakan mereka sebagai titik awal, atau hasilkan versi yang disesuaikan dengan Claude.Peninjau kode
Subagent hanya-baca yang meninjau kode tanpa memodifikasinya. Contoh ini menunjukkan cara merancang subagent yang terfokus dengan akses alat terbatas (tidak ada Edit atau Write) dan prompt terperinci yang menentukan dengan tepat apa yang harus dicari dan cara memformat output.Debugger
Subagent yang dapat menganalisis dan memperbaiki masalah. Tidak seperti peninjau kode, yang ini mencakup Edit karena memperbaiki bug memerlukan memodifikasi kode. Prompt menyediakan alur kerja yang jelas dari diagnosis ke verifikasi.Data scientist
Subagent khusus domain untuk pekerjaan analisis data. Contoh ini menunjukkan cara membuat subagent untuk alur kerja khusus di luar tugas pengkodean khas. Ini secara eksplisit menetapkanmodel: sonnet untuk analisis yang lebih mampu.
Validator kueri database
Subagent yang memungkinkan akses Bash tetapi memvalidasi perintah untuk mengizinkan hanya kueri SQL hanya-baca. Contoh ini menunjukkan cara menggunakan hooksPreToolUse untuk validasi bersyarat ketika Anda memerlukan kontrol lebih halus daripada bidang tools.
command dalam konfigurasi hook Anda:
tool_input.command. Kode keluar 2 memblokir operasi dan mengirimkan pesan kesalahan kembali ke Claude. Lihat Hooks untuk detail tentang kode keluar dan Hook input untuk skema input lengkap.
Langkah berikutnya
Sekarang setelah Anda memahami subagent, jelajahi fitur terkait ini:- Distribusikan subagent dengan plugins untuk berbagi subagent di seluruh tim atau proyek
- Jalankan Claude Code secara terprogram dengan Agent SDK untuk CI/CD dan otomasi
- Gunakan MCP servers untuk memberikan subagent akses ke alat dan data eksternal