Buat subagen kustom

• Pertahankan konteks dengan menjaga eksplorasi dan implementasi di luar percakapan utama Anda
• Terapkan batasan dengan membatasi alat mana yang dapat digunakan subagen
• Gunakan kembali konfigurasi di seluruh proyek dengan subagen tingkat pengguna
• Spesialisasi perilaku dengan prompt sistem yang terfokus untuk domain tertentu
• Kontrol biaya dengan merutekan tugas ke model yang lebih cepat dan lebih murah seperti Haiku

Subagent bawaan

• Untuk memblokir tipe bawaan tertentu, tambahkan ke permissions.deny seperti yang ditunjukkan dalam Nonaktifkan subagent tertentu.
• Untuk mencegah Claude mendelegasikan ke subagent apa pun, tolak alat Agent itu sendiri dengan permissions.deny.
• Untuk menghapus hanya subagent bawaan Explore dan Plan, atur CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1. Claude membaca dan mengeksplorasi file secara langsung alih-alih mendelegasikan ke mereka. Memerlukan Claude Code v2.1.198 atau lebih baru.
• Dalam mode non-interaktif dan Agent SDK, atur CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 untuk menghapus semua tipe bawaan dan menyediakan hanya milik Anda sendiri.

Mulai cepat: buat subagent pertama Anda

Create a personal code-improver subagent in ~/.claude/agents/ that scans
files and suggests improvements for readability, performance, and best
practices. It should explain each issue, show the current code, and
provide an improved version. Make it read-only and have it use Sonnet.

---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

You are a code improvement specialist. For each issue you find, explain
the problem, show the current code, and provide an improved version.

Use the code-improver agent to suggest improvements in this project

Mengonfigurasi subagent

Memilih cakupan subagent

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'

claude --agents @'
{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}
'@

• prompt: system prompt agent, setara dengan isi markdown dalam subagent berbasis file. prompt boleh kosong. Jika Anda memilih agent dengan prompt kosong dan tanpa field memory sebagai agent sesi dengan --agent, system prompt sesi dibiarkan tidak berubah. prompt kosong memerlukan Claude Code v2.1.281 atau yang lebih baru.
• Field frontmatter: description, tools, disallowedTools, model, permissionMode, mcpServers, hooks, maxTurns, autoCompactWindow, skills, initialPrompt, memory, effort, background, omitClaudeMd, dan isolation.
• Field yang diabaikan: color dan experimental tidak diterima di sini dan diabaikan alih-alih ditolak.

Menulis file subagent

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

• Claude Code memblokir perintah yang mengalihkan git ke checkout utama.
• Claude Code menolak perintah ketika tidak dapat memverifikasi dari teks perintah bahwa setiap git yang dijalankan perintah tetap berada di dalam worktree, misalnya ketika nama perintah dihitung saat runtime.

Referensi frontmatter

• Untuk menemukan field yang salah eja dalam subagent yang berhasil dimuat, jalankan claude --debug di shell Anda dan cari does not recognize or apply di log debug pada ~/.claude/debug/<session-id>.txt. Log debug menyebutkan hingga lima field tingkat atas dalam file subagent yang tidak dikenali Claude Code, beserta nama yang kemungkinan dimaksud ketika ada field yang didukung yang mirip. Memerlukan Claude Code v2.1.296 atau yang lebih baru.
• Untuk mengetahui mengapa file subagent tidak dimuat, lihat File subagent yang dilewati Claude Code.

---
name: repo-auditor
description: Audits a large repository and reports what it finds
experimental:
  cacheTtl: 1h
---

File subagent yang dilewati Claude Code

• Tidak ada name: Claude Code memperlakukan file tersebut sebagai dokumentasi yang disimpan di samping agent Anda.
• --- pembuka yang bukan baris pertama file: Claude Code membaca file tersebut sebagai tidak memiliki frontmatter dan memperlakukannya sebagai dokumentasi.
• name yang diawali dengan -, mengandung :, atau lebih panjang dari 256 karakter: Claude Code melewati file tersebut dan menulis error ke log debug.
• Ada name tetapi tidak ada description: Claude Code melewati file tersebut dan menulis alasannya ke log debug.
• YAML yang tidak dapat di-parse: Claude Code tidak membaca field apa pun dari file tersebut, melewatinya, dan menulis error parse ke log debug.

Memeriksa direktori agents sebelum sesi

Memilih model

• Alias model: sonnet, opus, haiku, atau fable
• ID model lengkap: nilai yang diterima flag --model, seperti claude-opus-5-5 atau claude-sonnet-5
• inherit: model percakapan utama, atau model subagent yang memunculkannya untuk subagent bertingkat

1. Parameter model per pemanggilan, yang dapat diberikan Claude saat memulai subagent. Pada panggilan tool Agent, parameter tersebut menerima alias model, bukan ID model lengkap atau inherit.
2. Field model dalam definisi subagent, termasuk inherit
3. Environment variable CLAUDE_CODE_SUBAGENT_MODEL
4. Model percakapan utama, atau model subagent yang memunculkannya untuk subagent bertingkat

Model yang digunakan subagent bertingkat

• Subagent dengan model: inherit atau tanpa field model
• Subagent bawaan Explore, Plan, dan general-purpose
• Fork

Memeriksa model subagent

Menjalankan setiap subagent pada satu model

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

• Fork
• Skill yang berjalan di subagent dengan model: inherit

Versi yang dipilih alias model

• Keluarga yang sama: misalnya, jika percakapan utama Anda berjalan pada claude-opus-4-7, subagent dengan model: opus juga berjalan pada versi tersebut. Untuk menjalankan versi lain, tetapkan ID model lengkap di field model.
• Keluarga tidak diketahui: Claude Code tidak dapat mengetahui keluarga model induk, misalnya dengan ARN Amazon Bedrock yang tidak dapat dicarinya. Kasus ini hanya berlaku untuk alias opus pada penyedia selain Anthropic API. Untuk memilih versi Opus, tetapkan ANTHROPIC_DEFAULT_OPUS_MODEL.

Ketika allowlist memblokir model subagent

1. Untuk alias keluarga yang diblokir, versi terbaru yang diizinkan dalam keluarga tersebut, pada penyedia yang mendukung substitusi ini
2. Model di CLAUDE_CODE_SUBAGENT_MODEL, jika Anda menetapkannya, dengan aturan yang sama ini
3. Model percakapan utama, atau model subagent yang memunculkannya untuk subagent bertingkat

Extended thinking di subagent

Memilih tingkat effort

Ketika subagent tidak memiliki field atau parameter effort

Mengontrol kemampuan subagent

Tool yang tersedia

• Agent, ketika subagent berada pada batas kedalaman; dalam fork tool tetap tercantum tetapi mengembalikan error alih-alih memunculkan subagent
• AskUserQuestion
• EndConversation, yang hanya dapat mengakhiri percakapan utama; lihat Perilaku tool EndConversation
• EnterPlanMode
• ExitPlanMode, kecuali permissionMode subagent adalah plan
• ScheduleWakeup
• WaitForMcpServers
• Workflow

Membatasi tool yang dapat digunakan subagent

---
name: safe-researcher
description: Research agent with restricted capabilities
tools: Read, Grep, Glob, Bash
---

---
name: no-writes
description: Inherits the available tools except file writes
disallowedTools: Write, Edit
---

---
name: local-only
description: Inherits every tool except those from the github MCP server
disallowedTools: mcp__github
---

Nama server MCP yang mengandung garis bawah ganda

• Di tools: tulis mcp__ diikuti nama lengkap server dan __*, seperti mcp__reports__v2__*. Tanpa __* di akhir, mcp__reports__v2 tidak cocok dengan tool mana pun dari server tersebut.
• Di disallowedTools: cari mcp__reports atau mcp__reports__*, entri yang menahan server bernama reports. Dengan salah satu entri tersebut, subagent juga kehilangan setiap tool reports__v2, karena nama tool tersebut juga diawali dengan mcp__reports__. Untuk hanya menahan tool dari server reports, cantumkan satu per satu, seperti mcp__reports__run_query.

Membatasi subagent yang dapat dimunculkan

---
name: coordinator
description: Coordinates work across specialized agents
tools: Agent(worker, researcher), Read, Bash
---

tools: Agent, Read, Bash

Membatasi server MCP pada subagent

---
name: browser-tester
description: Tests features in a real browser using Playwright
mcpServers:
  # Inline definition: scoped to this subagent only
  - playwright:
      type: stdio
      command: npx
      args: ["-y", "@playwright/mcp@latest"]
  # Reference by name: reuses an already-configured server
  - github
---

Use the Playwright tools to navigate, screenshot, and interact with pages.

• --strict-mcp-config dan --bare
• Konfigurasi MCP terkelola enterprise
• Kebijakan allowedMcpServers dan deniedMcpServers

Kepercayaan yang diperlukan untuk server MCP inline

• Kepercayaan yang tidak dihitung: kepercayaan folder induk, dan kepercayaan otomatis yang didapat sesi -p atau SDK untuk hook di file pengaturan
• Hingga saat itu: Claude Code melewati setiap server inline dalam file agent tersebut dan menulis key projects["<path>"].hasTrustDialogAccepted yang tepat untuk ~/.claude.json ke log debug
• Direktori --add-dir: direktori di luar repositori workspace tepercaya Anda memerlukan entri kepercayaannya sendiri, karena file .claude/agents/-nya tidak mewarisi kepercayaan workspace Anda

• Nama yang merujuk ke server yang sudah Anda konfigurasi
• Server inline dalam file agent dari ~/.claude/agents/, dalam file yang Anda berikan dengan --agents atau opsi agents SDK, atau dalam file yang disediakan oleh pengaturan terkelola

Mode izin

• Ketika percakapan utama berada dalam bypassPermissions, acceptEdits, atau auto mode, subagent berjalan dalam mode yang sama dan Claude Code mengabaikan permissionMode yang Anda tetapkan. Dalam auto mode, pengklasifikasi mengevaluasi panggilan tool subagent dengan aturan block dan allow percakapan utama. Ketika subagent selesai, pengklasifikasi juga meninjau pekerjaannya dan laporan akhirnya sebelum laporan dikirimkan, seperti yang dijelaskan di Cara auto mode menangani subagent. Jika subagent meminta izin saat percakapan utama berada dalam bypassPermissions, periksa apakah panggilan tool-nya termasuk tindakan yang tidak disetujui otomatis oleh mode mana pun.
• Ketika percakapan utama berada dalam mode plan, subagent tetap dalam plan mode apa pun permissionMode yang Anda tetapkan, kecuali jika subagent berjalan sebagai teammate tim agent di bawah aturan tim agent. Jika Anda menetapkan dontAsk, subagent juga tidak meminta persetujuan Anda: tindakan yang akan diminta persetujuannya oleh plan mode justru ditolak.
• Ketika percakapan utama berada dalam mode default atau dontAsk, subagent berjalan dalam mode izin yang Anda tetapkan. Subagent justru mempertahankan mode izin percakapan utama dalam kasus berikut:
  • Anda menetapkan bypassPermissions. Pengecualian bypassPermissions memerlukan Claude Code v2.1.267 atau yang lebih baru.
  • Anda menetapkan auto dan auto mode tidak tersedia untuk subagent, misalnya ketika file pengaturan menetapkan disableAutoMode atau model subagent tidak mendukung auto mode.

Memuat skill terlebih dahulu ke dalam subagent

---
name: api-developer
description: Implement API endpoints following team conventions
skills:
  - api-conventions
  - error-handling-patterns
---

Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

Mengaktifkan memori persisten

---
name: code-reviewer
description: Reviews code for quality and best practices
memory: user
---

You are a code reviewer. As you review code, update your agent memory with
patterns, conventions, and recurring issues you discover.

• System prompt subagent mencakup instruksi untuk membaca dan menulis ke direktori memori.
• System prompt subagent juga mencakup 200 baris pertama atau 25KB pertama dari MEMORY.md di direktori memori, mana yang lebih dulu tercapai, dengan instruksi untuk merapikan MEMORY.md jika melebihi batas tersebut.
• Tool Read, Write, dan Edit diaktifkan secara otomatis agar subagent dapat mengelola file memorinya.

Tips memori persisten

• project adalah cakupan default yang direkomendasikan. Cakupan ini membuat pengetahuan subagent dapat dibagikan melalui version control.
• Minta subagent untuk merujuk memorinya sebelum mulai bekerja: “Review this PR, and check your memory for patterns you’ve seen before.”
• Minta subagent untuk memperbarui memorinya setelah menyelesaikan tugas: “Now that you’re done, save what you learned to your memory.” Seiring waktu, ini membangun basis pengetahuan yang membuat subagent lebih efektif.
• Sertakan instruksi memori langsung di file markdown subagent agar subagent secara proaktif memelihara basis pengetahuannya sendiri:
  Update your agent memory as you discover codepaths, patterns, library
  locations, and key architectural decisions. This builds up institutional
  knowledge across conversations. Write concise notes about what you found
  and where.
  

Aturan kondisional dengan hook

---
name: db-reader
description: Execute read-only database queries
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

#!/bin/bash
# ./scripts/validate-readonly-query.sh

INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# Block SQL write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE)\b' > /dev/null; then
  echo "Blocked: Only SELECT queries are allowed" >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

Menonaktifkan subagent tertentu

{
  "permissions": {
    "deny": ["Agent(Explore)", "Agent(my-custom-agent)"]
  }
}

claude --disallowedTools "Agent(Explore)"

Mendefinisikan hook untuk subagent

• Di frontmatter subagent: definisikan hook yang hanya berjalan saat subagent tersebut aktif
• Di settings.json: definisikan hook tingkat sesi yang juga dipicu di dalam subagent. Event tool seperti PreToolUse dan PostToolUse dipicu untuk panggilan tool subagent dengan cara yang sama seperti di percakapan utama, dan SubagentStart serta SubagentStop dipicu saat subagent dimulai atau selesai

Hook di frontmatter subagent

---
name: code-reviewer
description: Review code changes with automatic linting
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-command.sh"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/run-linter.sh"
---

Hook tingkat proyek untuk event subagent

{
  "hooks": {
    "SubagentStart": [
      {
        "matcher": "db-agent",
        "hooks": [
          { "type": "command", "command": "./scripts/setup-db-connection.sh" }
        ]
      }
    ],
    "SubagentStop": [
      {
        "hooks": [
          { "type": "command", "command": "./scripts/cleanup-db-connection.sh" }
        ]
      }
    ]
  }
}

Bekerja dengan subagent

Pahami delegasi otomatis

Panggil subagent secara eksplisit

• Bahasa alami: sebutkan subagent dalam prompt Anda; Claude memutuskan apakah akan mendelegasikan
• @-mention: menjamin subagent berjalan untuk satu tugas
• Sesi-lebar: seluruh sesi berjalan sebagai subagent itu melalui flag --agent atau pengaturan agent

Use the test-runner subagent to fix failing tests
Have the code-reviewer subagent look at my recent changes

@"code-reviewer (agent)" look at the auth changes

claude --agent code-reviewer

claude --agent security-reviewer

claude --agent my-plugin:security-reviewer

{
  "agent": "code-reviewer"
}

Jalankan subagent di foreground atau background

• Subagent foreground memblokir percakapan utama sampai selesai. Permintaan izin diteruskan kepada Anda saat muncul.
• Subagent background berjalan secara bersamaan sementara Anda terus bekerja. Ketika subagent background mencapai panggilan tool yang memerlukan izin, Claude Code menampilkan permintaan izin di sesi utama Anda dan menyebutkan subagent yang bertanya. Setujui untuk membiarkan subagent melanjutkan, atau tekan Esc untuk menolak panggilan tool itu saja tanpa menghentikan subagent.

Subagent mana yang berjalan di background

• claude -p dan Agent SDK: Claude dapat menunggu, berdasarkan penilaiannya sendiri atau ketika Anda memintanya.
• Sesi terminal interaktif, VS Code, dan sesi aplikasi desktop di mesin Anda: agar Claude dapat menunggu subagent, matikan fork mode, yang aktif secara default.

Biarkan Claude menunggu subagent

1. Matikan fork mode dengan mengatur CLAUDE_CODE_FORK_SUBAGENT ke 0, misalnya dalam settings.json:
   {
     "env": {
       "CLAUDE_CODE_FORK_SUBAGENT": "0"
     }
   }
   
2. Jalankan claude lagi dari shell Anda, atau buka percakapan VS Code baru.
3. Minta Claude untuk menunggu ketika Anda memerlukan hasil terlebih dahulu, misalnya “run the reviewer subagent and wait for its report”.

Tool, izin, dan hasil subagent background

Subagent yang selesai di panel dan daftar tugas

• Ketika subagent selesai dengan sukses, Claude Code menghapus barisnya segera dan, kecuali dalam mode pembaca layar, menampilkan /tasks to see subagents di footer selama 30 detik. Selama 30 detik itu, jalankan /tasks dan tekan Enter pada subagent untuk membuka transkrip. Sebelum v2.1.232, Claude Code menyimpan baris selama 30 detik setelah subagent selesai, sama seperti yang gagal, dan tidak menampilkan petunjuk footer.
• Ketika subagent gagal atau Anda menghentikannya, Claude Code menyimpan barisnya selama 30 detik. Untuk menghapus baris lebih cepat, pilih dan tekan x.

Nama subagent

Kesalahan API dalam subagent

• Foreground: jika rate limit, kelebihan beban, atau kesalahan server memotong subagent yang sudah menghasilkan output teks, tool Agent mengembalikan output parsial itu dengan catatan bahwa subagent dipotong dan tidak menyelesaikan tugasnya. Subagent yang tidak menghasilkan apa pun, atau yang output-nya hanya panggilan tool, gagal dengan Agent terminated early due to an API error, diikuti oleh detail kesalahan.
• Background: subagent ditandai gagal, dan pesan yang Claude terima saat berakhir menyebutkan kesalahan API dan menyertakan output terakhir subagent, jadi pekerjaan parsial tidak hilang.

⚠ This agent switched to <model> because its earlier model could not be used.

Pemindaian output subagent

• Penyisipan backslash: pemindaian menyisipkan backslash ke dalam teks yang meniru output Claude Code itu sendiri, seperti tag <system-reminder> atau baris yang dimulai dengan Human: atau Assistant:, sehingga peniruan dibaca sebagai teks biasa daripada disalahartikan sebagai bagian dari percakapan.
• Baris penanda: pemindaian menambahkan baris yang dimulai dengan [harness: subagent output matched instruction-shaped pattern(s): ketika laporan meniru tag seperti <system-reminder> atau menyebutkan pengaturan izin seperti bypassPermissions atau --dangerously-skip-permissions. Penyebutan pengaturan izin mendapatkan baris penanda, tetapi teks itu sendiri tetap seperti yang ditulis.

Pola umum

Isolasi operasi volume tinggi

Use a subagent to run the test suite and report only the failing tests with their error messages

Jalankan penelitian paralel

Research the authentication, database, and API modules in parallel using separate subagents

Rantai subagent

Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them

Pilih antara subagent dan percakapan utama

• Tugas memerlukan bolak-balik yang sering atau penyempurnaan iteratif
• Beberapa fase berbagi konteks yang signifikan, seperti perencanaan, implementasi, dan pengujian
• Anda membuat perubahan cepat dan tertarget
• Latensi penting. Subagent yang bukan fork 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 tool atau izin tertentu
• Pekerjaan mandiri dan dapat mengembalikan ringkasan

Biarkan subagent menghasilkan subagent mereka sendiri

• Sesi terminal interaktif: hanya ringkasan subagent tingkat atas yang kembali kepada Anda, karena subagent yang meluncurkan subagent background menunggu hasil mereka sebelum selesai.
• claude -p dan Agent SDK: subagent yang menghasilkan menunggu selama fork mode aktif. Jika Anda mematikan fork mode, subagent bersarang dimulai di background sebagai gantinya. Subagent yang menghasilkan tidak menunggu subagent bersarang background, yang melaporkan ke percakapan utama Anda jika berjalan lebih lama daripada subagent yang menghasilkannya.

{
  "env": {
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
  }
}

Batas subagent bersamaan

• Fork dalam sesi yang Anda mulai dengan /subtask menempati slot saat berjalan dan tidak pernah diblokir oleh batas.
• Melanjutkan subagent yang sudah selesai menempati slot segar tanpa memeriksa batas, jadi resume dapat mendorong hitungan yang berjalan melampaui batas.

Kelola konteks subagent

Apa yang dimuat saat startup

• System prompt: prompt agent itu sendiri ditambah detail lingkungan yang Claude Code tambahkan, bukan system prompt Claude Code. Subagent khusus mendefinisikan milik mereka dalam badan markdown atau bidang prompt. Agent bawaan memiliki prompt yang telah ditentukan sebelumnya.
• Pesan tugas: prompt delegasi yang Claude tulis saat menyerahkan pekerjaan.
• File CLAUDE.md: setiap level dari hierarki CLAUDE.md yang dimuat percakapan utama, termasuk ~/.claude/CLAUDE.md, aturan proyek, CLAUDE.local.md, file kebijakan terkelola, dan file AGENTS.md apa pun yang dimuat sebagai instruksi proyek. Agent Explore dan Plan bawaan melewati ini. Subagent yang definisinya menetapkan omitClaudeMd hanya memuat file kebijakan terkelola, atau tidak ada sama sekali ketika definisi berasal dari pengaturan terkelola.
• Status Git: snapshot yang dibaca Claude Code dari repositori Anda saat subagent dimulai. Untuk subagent di worktree-nya sendiri dari repositori tersebut, snapshot menampilkan branch, status, dan commit terbaru worktree tersebut. Tidak ada di luar repositori Git atau kapan pun snapshot dimatikan; lihat includeGitInstructions. Explore dan Plan tetap melewatinya dalam kondisi apa pun.
• Skills yang dimuat sebelumnya: konten lengkap dari skill apa pun yang dinamai dalam bidang skills agent. Agent bawaan tidak memuat skills sebelumnya.
• Daftar saudara: system reminder yang mencantumkan main dan setiap agent bernama lainnya dalam sesi, masing-masing nilai to yang valid untuk SendMessage. Daftar muncul hanya ketika tool subagent mencakup SendMessage dan setidaknya satu agent lain memiliki nama, baik Claude menamakannya saat memunculkannya atau berjalan sebagai anggota tim agent. Ini adalah snapshot yang diambil ketika subagent dimulai, jadi agent yang dinamai nanti tidak muncul.

• Gaya output: subagent menjalankan system prompt-nya sendiri, jadi gaya output Anda tidak membentuk responsnya, kecuali dalam fork.
• Auto memory: auto memory percakapan utama tidak dimuat. Untuk memberi subagent memori persisten miliknya sendiri, gunakan bidang memory.
• Ukuran context window: context window subagent diukur oleh modelnya sendiri, bukan induk. Mendelegasikan ke model dengan window yang lebih kecil memberikan subagent itu window yang lebih kecil.

Lanjutkan subagent

• Ketika subagent selesai, Claude menerima ID agent-nya.
• Agent bawaan Explore dan Plan adalah one-shot dan tidak mengembalikan ID agent, jadi Claude tidak dapat melanjutkan mereka. Gunakan general-purpose atau subagent khusus ketika Anda perlu melanjutkan pekerjaan.
• Ketika subagent berhenti pada batas maxTurns, Claude Code menandai output yang dikembalikan sebagai parsial, dan Claude dapat melanjutkan subagent untuk meneruskan pekerjaannya.

Use the code-reviewer subagent to review the authentication module
[Agent completes]

Continue that code review and now analyze the authorization logic
[Claude resumes the subagent with full context from previous conversation]

• Compaction percakapan utama: ketika percakapan utama di-compact, 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: Claude Code menghapus transkrip subagent setelah periode retensi cleanupPeriodDays, 30 hari secara default, mengikuti aturan sweep retensi.

Kirim pesan ke subagent berdasarkan nama setelah restart

Auto-compaction

{
  "type": "system",
  "subtype": "compact_boundary",
  "compactMetadata": {
    "trigger": "auto",
    "preTokens": 167189
  }
}

Atur jendela auto-compact untuk satu subagent

---
name: log-reader
description: Reads long log files and reports the errors it finds
autoCompactWindow: 200000
---

• Nilai tidak berada di bawah jendela auto-compact yang seharusnya diwarisi subagent: untuk melakukan compaction lebih awal, atur nilai di bawah jendela tersebut.
• Anda menjalankan seluruh sesi sebagai subagent ini dengan --agent atau pengaturan agent: bidang ini tidak berpengaruh di sana. Untuk mengatur jendela sesi, lihat Atur jendela auto-compact.

Fork percakapan saat ini

• Input: fork melihat system prompt, tool, model, dan riwayat pesan yang sama dengan percakapan induknya
• Output: panggilan tool milik fork sendiri tetap berada di luar percakapan induknya dan hanya hasil akhirnya yang kembali

/subtask draft unit tests for the parser changes so far

Amati dan arahkan fork yang sedang berjalan

• /compact, /clear, dan /rewind bekerja pada percakapan utama, sehingga Claude Code meminta Anda untuk mengonfirmasi sebelum menjalankan salah satunya dari tampilan ini.
• /model dan /fast mengatur model dan fast mode percakapan utama, bukan milik agent yang dilihat, sehingga keduanya tidak berjalan dari tampilan ini. Sebuah pemberitahuan menjelaskan alasannya.

Bagaimana fork berbeda dari subagent lainnya

Nonaktifkan mode fork

• Hentikan fork saja: tambahkan "Agent(fork)" ke permissions.deny dalam pengaturan Anda.
• Nonaktifkan mode fork: atur CLAUDE_CODE_FORK_SUBAGENT ke 0, dengan mengikuti langkah-langkah di Biarkan Claude menunggu subagent.

Contoh subagent

Peninjau kode

---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)

Include specific examples of how to fix issues.

Debugger

---
name: debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
tools: Read, Edit, Bash, Grep, Glob
---

You are an expert debugger specializing in root cause analysis.

When invoked:
1. Capture error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify solution works

Debugging process:
- Analyze error messages and logs
- Check recent code changes
- Form and test hypotheses
- Add strategic debug logging
- Inspect variable states

For each issue, provide:
- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach
- Prevention recommendations

Focus on fixing the underlying issue, not the symptoms.

Data scientist

---
name: data-scientist
description: Data analysis expert for SQL queries, BigQuery operations, and data insights. Use proactively for data analysis tasks and queries.
tools: Bash, Read, Write
model: sonnet
---

You are a data scientist specializing in SQL and BigQuery analysis.

When invoked:
1. Understand the data analysis requirement
2. Write efficient SQL queries
3. Use BigQuery command line tools (bq) when appropriate
4. Analyze and summarize results
5. Present findings clearly

Key practices:
- Write optimized SQL queries with proper filters
- Use appropriate aggregations and joins
- Include comments explaining complex logic
- Format results for readability
- Provide data-driven recommendations

For each analysis:
- Explain the query approach
- Document any assumptions
- Highlight key findings
- Suggest next steps based on data

Always ensure queries are efficient and cost-effective.

Validator kueri database

---
name: db-reader
description: Execute read-only database queries. Use when analyzing data or generating reports.
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

You are a database analyst with read-only access. Execute SELECT queries to answer questions about the data.

When asked to analyze data:
1. Identify which tables contain the relevant data
2. Write efficient SELECT queries with appropriate filters
3. Present results clearly with context

You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

#!/bin/bash
# Blocks SQL write operations, allows SELECT queries

# Read JSON input from stdin
INPUT=$(cat)

# Extract the command field from tool_input using jq
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

if [ -z "$COMMAND" ]; then
  exit 0
fi

# Block write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE|REPLACE|MERGE)\b' > /dev/null; then
  echo "Blocked: Write operations not allowed. Use SELECT queries only." >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

Langkah berikutnya

• 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