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.

​

Quickstart: 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

​

Konfigurasi subagent

​

Pilih 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 badan markdown dalam subagent berbasis file. prompt mungkin kosong. Jika Anda memilih agent dengan prompt kosong dan tidak ada field memory sebagai agent sesi dengan --agent, system prompt sesi dibiarkan tidak berubah. prompt kosong memerlukan Claude Code v2.1.281 atau lebih baru.
• Field frontmatter: description, tools, disallowedTools, model, permissionMode, mcpServers, hooks, maxTurns, skills, initialPrompt, memory, effort, background, omitClaudeMd, dan isolation.
• Field yang diabaikan: color dan experimental tidak diterima di sini dan diabaikan daripada ditolak.

​

Tulis 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.

• Ini memblokir perintah yang mengarahkan git ke checkout utama.
• Ini menolak perintah ketika tidak dapat memverifikasi dari teks perintah bahwa git apa pun yang dijalankan perintah tetap di dalam worktree, misalnya ketika nama perintah dihitung saat runtime.

​

Referensi frontmatter

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

​

File subagent yang Claude Code lewati

• Tidak ada name: Claude Code memperlakukan file sebagai dokumentasi yang disimpan di samping agent Anda.
• --- pembuka yang bukan baris pertama file: Claude Code membaca file sebagai tidak memiliki frontmatter dan memperlakukannya sebagai dokumentasi.
• name yang dimulai dengan - atau berisi :: Claude Code melewati file dan menulis kesalahan ke debug log. Lihat baris name dalam tabel di atas.
• name tetapi tidak ada description: Claude Code melewati file dan menulis alasannya ke debug log.
• YAML yang tidak diuraikan: Claude Code tidak membaca field dari file, melewatinya, dan menulis kesalahan penguraian ke debug log.

​

Pilih model

• Model alias: gunakan salah satu alias yang tersedia: sonnet, opus, haiku, atau fable
• ID model lengkap: gunakan ID model lengkap seperti claude-opus-5-5 atau claude-sonnet-5. Menerima nilai yang sama seperti flag --model
• inherit: gunakan model yang sama seperti percakapan utama

1. Parameter model per-invokasi
2. Frontmatter model definisi subagent, di mana inherit memilih model percakapan utama
3. Variabel lingkungan CLAUDE_CODE_SUBAGENT_MODEL, ketika Anda mengaturnya ke alias model atau ID model
4. Model percakapan utama

• Model percakapan utama milik keluarga itu: subagent berjalan pada model persis percakapan utama, termasuk akhiran [1m] apa pun, jadi mendapat extended context window yang sama seperti percakapan utama.
• Claude Code tidak dapat mengetahui keluarga model percakapan utama, pada provider selain Anthropic API: ini dapat terjadi dengan application inference profile ARN di Amazon Bedrock yang Claude Code belum diselesaikan ke model pendukung. Kasus ini hanya mencakup alias opus, dan tidak berlaku ketika Anda mengatur ANTHROPIC_DEFAULT_OPUS_MODEL, karena opus kemudian diselesaikan ke model yang Anda atur.

• Ketika nilai yang diblokir adalah alias keluarga seperti opus, Claude Code menjalankan subagent pada versi terbaru keluarga itu yang allowlist izinkan, mengikuti substitution rules dan provider scope yang sama seperti /model. Sebelum v2.1.222, Claude Code menjalankan subagent pada model yang diwarisi untuk alias keluarga yang diblokir juga.
• Untuk nilai yang diblokir lainnya, pada provider di mana substitusi itu tidak beroperasi, atau ketika allowlist tidak mengizinkan versi keluarga, Claude Code menjalankan subagent pada model yang diwarisi sebagai gantinya. Jika Anda mengatur CLAUDE_CODE_SUBAGENT_MODEL, Claude Code mencoba model itu terlebih dahulu, di bawah aturan yang sama ini.

​

Jalankan setiap subagent pada satu model

• Jika Anda mengatur kedua variabel, subagent berjalan pada model dalam CLAUDE_CODE_SUBAGENT_MODEL.
• Jika Anda hanya mengatur CLAUDE_CODE_SUBAGENT_MODEL_FORCE, subagent berjalan pada model percakapan utama.

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

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

​

Kontrol kemampuan subagent

​

Tool yang tersedia

• Agent, ketika subagent berada di depth limit; dalam fork tool tetap terdaftar tetapi mengembalikan kesalahan sebagai gantinya dari spawning
• AskUserQuestion
• EndConversation, yang hanya dapat mengakhiri percakapan utama; lihat EndConversation tool behavior
• EnterPlanMode
• ExitPlanMode, kecuali permissionMode subagent adalah plan
• ScheduleWakeup
• WaitForMcpServers
• Workflow

---
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
---

​

Batasi subagent mana yang dapat di-spawn

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

tools: Agent, Read, Bash

​

Cakupan MCP server ke 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.

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

• Nama yang mereferensikan server yang sudah Anda konfigurasi
• Server inline dalam file agent dari ~/.claude/agents/, dalam satu yang Anda lewatkan dengan --agents atau opsi SDK agents, atau dalam satu yang managed settings sediakan

• --strict-mcp-config dan --bare
• Enterprise managed MCP configuration
• allowedMcpServers dan deniedMcpServers policies

​

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 atur. Di bawah auto mode, classifier mengevaluasi panggilan tool subagent dengan aturan blok dan izin percakapan utama. Ketika subagent selesai, classifier juga meninjau pekerjaan dan laporan finalnya sebelum laporan dikirimkan, seperti How auto mode handles subagents menjelaskan.
• Ketika percakapan utama berada dalam mode default, dontAsk, atau plan, subagent berjalan dalam mode izin yang Anda atur, kecuali bypassPermissions. Subagent yang mendeklarasikan bypassPermissions menyimpan mode percakapan utama sebagai gantinya. Pengecualian bypassPermissions memerlukan Claude Code v2.1.267 atau lebih baru.

​

Muat skills sebelumnya 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.

​

Aktifkan persistent memory

---
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 memory.
• System prompt subagent juga mencakup 200 baris pertama atau 25KB dari MEMORY.md dalam direktori memory, mana pun yang lebih dulu, dengan instruksi untuk mengkurasi MEMORY.md jika melebihi batas itu.
• Tool Read, Write, dan Edit secara otomatis diaktifkan sehingga subagent dapat mengelola file memory-nya.

• project adalah cakupan default yang direkomendasikan. Ini membuat pengetahuan subagent dapat dibagikan melalui version control.
• Minta subagent untuk berkonsultasi dengan memory-nya sebelum memulai pekerjaan: “Review PR ini, dan periksa memory Anda untuk pola yang telah Anda lihat sebelumnya.”
• Minta subagent untuk memperbarui memory-nya setelah menyelesaikan tugas: “Sekarang Anda selesai, simpan apa yang Anda pelajari ke memory Anda.” Seiring waktu, ini membangun basis pengetahuan yang membuat subagent lebih efektif.
• Sertakan instruksi memory langsung dalam file markdown subagent sehingga secara proaktif mempertahankan basis pengetahuan miliknya 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 bersyarat dengan hooks

---
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

​

Nonaktifkan subagent spesifik

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

claude --disallowedTools "Agent(Explore)"

​

Tentukan hooks untuk subagent

• Dalam frontmatter subagent: tentukan hooks yang berjalan hanya saat subagent itu aktif
• Dalam settings.json: tentukan hooks seluruh sesi yang juga menyala di dalam subagent. Peristiwa tool seperti PreToolUse dan PostToolUse menyala untuk panggilan tool subagent dengan cara yang sama seperti dalam percakapan utama, dan SubagentStart dan SubagentStop menyala ketika subagent dimulai atau selesai

​

Hook dalam 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 peristiwa 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. Prompt izin dilewatkan kepada Anda saat muncul.
• Subagent background berjalan secara bersamaan sementara Anda terus bekerja. Ketika subagent background mencapai panggilan alat yang memerlukan izin, Claude Code menampilkan prompt di sesi utama Anda dan menyebutkan subagent yang bertanya. Setujui untuk membiarkan subagent melanjutkan, atau tekan Esc untuk menolak panggilan alat itu saja tanpa menghentikan subagent.

• Jika anggota tim agen dalam proses yang menghasilkan subagent, Claude Code menjalankannya di foreground. Claude Code menolak dengan kesalahan untuk menghasilkan subagent anggota tim yang definisinya menetapkan background: true. Di mana fork mode mati dan Anda belum mematikan background tasks, Claude Code juga menolak dengan kesalahan ketika anggota tim menetapkan run_in_background: true.
• Jika Anda menetapkan CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ke 1, Claude Code menjalankan subagent di foreground, dalam setiap jenis sesi dan apakah fork mode aktif atau tidak.
• Di mana fork mode aktif, seperti yang terjadi secara default dalam sesi interaktif, Claude Code menjalankan subagent di background, subagent fork dan non-fork sama-sama, dan Claude tidak dapat meminta foreground.
• Di mana fork mode mati, Claude menjalankan subagent di background secara default dan di foreground ketika memerlukan hasil sebelum melanjutkan. Fork mode mati dalam mode non-interaktif dengan -p dan dalam Agent SDK kecuali Anda mengaktifkannya. Untuk menjaga subagent tertentu di background bahkan ketika Claude menginginkan hasil, atur bidang frontmatter background ke true.

• Di mana fork mode mati, minta Claude untuk menjalankan tugas di background atau di foreground
• Tekan Ctrl+B untuk menempatkan tugas yang sedang berjalan di background

• 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 batas laju, kelebihan beban, atau kesalahan server memotong subagent yang sudah menghasilkan output teks, alat 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 alat, gagal dengan Agent terminated early due to an API error, diikuti oleh detail kesalahan. Dalam v2.1.199, batas laju, kelebihan beban, atau kesalahan server yang memotong bentuk tool-calls-only mengembalikan hasil parsial kosong yang hanya berisi catatan cut-off sebagai gantinya.
• Background: subagent ditandai gagal, dan pesan yang Claude terima saat berakhir menyebutkan kesalahan API dan menyertakan output terakhir subagent, jadi pekerjaan parsial tidak hilang.

​

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 alat atau izin tertentu
• Pekerjaan mandiri dan dapat mengembalikan ringkasan

​

Biarkan subagent menghasilkan subagent mereka sendiri

{
  "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

• Prompt sistem: prompt agen itu sendiri ditambah detail lingkungan yang Claude Code tambahkan, bukan prompt sistem Claude Code. Subagent khusus mendefinisikan milik mereka dalam badan markdown atau bidang prompt. Agen 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 yang dikelola, dan file AGENTS.md apa pun yang dimuat sebagai instruksi proyek. Agen Explore dan Plan bawaan melewati ini. Subagent yang definisinya menetapkan omitClaudeMd hanya memuat file kebijakan yang dikelola, atau tidak ada sama sekali ketika definisi berasal dari pengaturan yang dikelola.
• Status Git: snapshot yang diambil di awal sesi induk. Tidak ada ketika direktori kerja bukan repositori Git atau ketika includeGitInstructions adalah false. Explore dan Plan melewatinya terlepas.
• Skills yang dimuat sebelumnya: konten lengkap dari skill apa pun yang dinamai dalam bidang skills agen. Agen bawaan tidak memuat skills sebelumnya.
• Daftar saudara: pengingat sistem yang mencantumkan main dan setiap agen bernama lainnya dalam sesi, masing-masing nilai to yang valid untuk SendMessage. Memerlukan Claude Code v2.1.206 atau lebih baru. Daftar muncul hanya ketika alat subagent mencakup SendMessage dan setidaknya satu agen lain memiliki nama, baik Claude menamakannya saat memunculkannya atau berjalan sebagai anggota tim agen. Ini adalah snapshot yang diambil ketika subagent dimulai, jadi agen yang dinamai nanti tidak muncul.

• Gaya output: subagent menjalankan prompt sistemnya sendiri, jadi gaya output Anda tidak membentuk responsnya, kecuali dalam fork.
• Memori otomatis: memori otomatis percakapan utama tidak dimuat. Untuk memberi subagent memori persisten miliknya sendiri, gunakan bidang memory.
• Ukuran jendela konteks: jendela konteks subagent diukur oleh modelnya sendiri, bukan induk. Mendelegasikan ke model dengan jendela yang lebih kecil memberikan subagent itu jendela yang lebih kecil.

​

Lanjutkan subagent

• Ketika subagent selesai, Claude menerima ID agennya.
• Agen bawaan Explore dan Plan adalah one-shot dan tidak mengembalikan ID agen, 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. Untuk subagent yang mengembalikan ID agen, Claude Code juga mencatat dalam hasil bahwa Claude dapat mengirim pesan ke subagent untuk melanjutkan dari tempat ia berhenti.

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]

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

​

Auto-compaction

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

​

Fork percakapan saat ini

/subtask draft unit tests for the parser changes so far

​

Amati dan arahkan fork yang sedang berjalan

​

Bagaimana fork berbeda dari subagent lainnya

​

Aktifkan atau nonaktifkan mode fork

• Claude dapat menelurkan fork dengan meminta tipe subagent fork. Ketika Claude tidak meminta tipe, Claude mendapatkan subagent general-purpose, jika sesi masih memiliki tipe tersebut. Subagent yang di-spawn dari definisi, seperti Explore, bekerja seperti biasanya.
• Claude Code menjalankan subagent yang Claude spawn di latar belakang, fork dan subagent non-fork sama-sama, terlepas dari kasus yang tetap di latar depan. Claude Code juga menghapus parameter run_in_background alat Agent, sehingga Claude tidak dapat meminta latar depan.

• 1 mengaktifkan mode fork dalam mode non-interaktif dan Agent SDK juga
• 0 menonaktifkan mode fork dalam setiap jenis sesi

​

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