Subagents

​

Apa itu subagents?

• Memiliki tujuan spesifik dan area keahlian
• Menggunakan jendela konteksnya sendiri terpisah dari percakapan utama
• Dapat dikonfigurasi dengan alat spesifik yang diizinkan untuk digunakan
• Mencakup prompt sistem khusus yang memandu perilakunya

​

Manfaat utama

​

Mulai cepat

/agents

> Use the code-reviewer subagent to check my recent changes

​

Konfigurasi subagent

​

Lokasi file

​

Plugin agents

• Plugin agents muncul di /agents bersama agents khusus Anda
• Dapat dipanggil secara eksplisit: “Use the code-reviewer agent from the security-plugin”
• Dapat dipanggil secara otomatis oleh Claude jika sesuai
• Dapat dikelola (dilihat, diperiksa) melalui antarmuka /agents

​

Konfigurasi berbasis CLI

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"
  }
}'

• Pengujian cepat konfigurasi subagent
• Subagents spesifik sesi yang tidak perlu disimpan
• Skrip otomasi yang memerlukan subagents khusus
• Berbagi definisi subagent dalam dokumentasi atau skrip

​

Format file

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
model: sonnet  # Optional - specify model alias or 'inherit'
---

Your subagent's system prompt goes here. This can be multiple paragraphs
and should clearly define the subagent's role, capabilities, and approach
to solving problems.

Include specific instructions, best practices, and any constraints
the subagent should follow.

​

Bidang konfigurasi

​

Pemilihan model

• Alias model: Gunakan salah satu alias yang tersedia: sonnet, opus, atau haiku
• 'inherit': Gunakan model yang sama dengan percakapan utama (berguna untuk konsistensi)
• Dihilangkan: Jika tidak ditentukan, menggunakan model default yang dikonfigurasi untuk subagents (sonnet)

​

Alat yang tersedia

• Hilangkan bidang tools untuk mewarisi semua alat dari thread utama (default), termasuk alat MCP
• Tentukan alat individual sebagai daftar yang dipisahkan koma untuk kontrol yang lebih terperinci (dapat diedit secara manual atau melalui /agents)

​

Mengelola subagents

​

Menggunakan perintah /agents (Direkomendasikan)

/agents

• Melihat semua subagents yang tersedia (bawaan, pengguna, dan proyek)
• Membuat subagents baru dengan setup terpandu
• Mengedit subagents khusus yang ada, termasuk akses alat mereka
• Menghapus subagents khusus
• Melihat subagents mana yang aktif ketika duplikat ada
• Kelola izin alat dengan mudah dengan daftar lengkap alat yang tersedia

​

Manajemen file langsung

# Create a project subagent
mkdir -p .claude/agents
echo '---
name: test-runner
description: Use proactively to run tests and fix failures
---

You are a test automation expert. When you see code changes, proactively run the appropriate tests. If tests fail, analyze the failures and fix them while preserving the original test intent.' > .claude/agents/test-runner.md

# Create a user subagent
mkdir -p ~/.claude/agents
# ... create subagent file

​

Menggunakan subagents secara efektif

​

Delegasi otomatis

• Deskripsi tugas dalam permintaan Anda
• Bidang description dalam konfigurasi subagent
• Konteks saat ini dan alat yang tersedia

​

Invokasi eksplisit

> Use the test-runner subagent to fix failing tests
> Have the code-reviewer subagent look at my recent changes
> Ask the debugger subagent to investigate this error

​

Subagents bawaan

​

Subagent Plan

• Model: Menggunakan Sonnet untuk analisis yang lebih mampu
• Alat: Memiliki akses ke alat Read, Glob, Grep, dan Bash untuk eksplorasi codebase
• Tujuan: Mencari file, menganalisis struktur kode, dan mengumpulkan konteks
• Invokasi otomatis: Claude secara otomatis menggunakan agent ini ketika dalam mode plan dan perlu meneliti codebase

User: [In plan mode] Help me refactor the authentication module

Claude: Let me research your authentication implementation first...
[Internally invokes Plan subagent to explore auth-related files]
[Plan subagent searches codebase and returns findings]
Claude: Based on my research, here's my proposed plan...

​

Contoh subagents

​

Pengulas 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 simple 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 just symptoms.

​

Ilmuwan data

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

​

Praktik terbaik

• Mulai dengan agents yang dihasilkan Claude: Kami sangat merekomendasikan membuat subagent awal Anda dengan Claude dan kemudian mengulanginya untuk menjadikannya milik pribadi Anda. Pendekatan ini memberikan hasil terbaik - fondasi yang solid yang dapat Anda sesuaikan dengan kebutuhan spesifik Anda.
• Desain subagents yang fokus: Buat subagents dengan tanggung jawab tunggal dan jelas daripada mencoba membuat satu subagent melakukan segalanya. Ini meningkatkan kinerja dan membuat subagents lebih dapat diprediksi.
• Tulis prompt terperinci: Sertakan instruksi spesifik, contoh, dan batasan dalam prompt sistem Anda. Semakin banyak panduan yang Anda berikan, semakin baik kinerja subagent.
• Batasi akses alat: Hanya berikan alat yang diperlukan untuk tujuan subagent. Ini meningkatkan keamanan dan membantu subagent fokus pada tindakan yang relevan.
• Kontrol versi: Periksa subagents proyek ke dalam kontrol versi sehingga tim Anda dapat mendapat manfaat dari dan meningkatkannya secara kolaboratif.

​

Penggunaan lanjutan

​

Chaining subagents

> First use the code-analyzer subagent to find performance issues, then use the optimizer subagent to fix them

​

Pemilihan subagent dinamis

​

Subagents yang dapat dilanjutkan

• Setiap eksekusi subagent diberi agentId unik
• Percakapan agent disimpan dalam file transkrip terpisah: agent-{agentId}.jsonl
• Anda dapat melanjutkan agent sebelumnya dengan memberikan agentId melalui parameter resume
• Ketika dilanjutkan, agent melanjutkan dengan konteks penuh dari percakapan sebelumnya

> Use the code-analyzer agent to start reviewing the authentication module

[Agent completes initial analysis and returns agentId: "abc123"]

> Resume agent abc123 and now analyze the authorization logic as well

[Agent continues with full context from previous conversation]

• Penelitian jangka panjang: Pecah analisis codebase besar menjadi beberapa sesi
• Penyempurnaan iteratif: Lanjutkan menyempurnakan pekerjaan subagent tanpa kehilangan konteks
• Alur kerja multi-langkah: Buat subagent bekerja pada tugas terkait secara berurutan sambil mempertahankan konteks

• Transkrip agent disimpan di direktori proyek Anda
• Perekaman dinonaktifkan selama resume untuk menghindari duplikasi pesan
• Agent sinkron dan asinkron dapat dilanjutkan
• Parameter resume menerima ID agent dari eksekusi sebelumnya

{
  "description": "Continue analysis",
  "prompt": "Now examine the error handling patterns",
  "subagent_type": "code-analyzer",
  "resume": "abc123"  // Agent ID from previous execution
}

​

Pertimbangan kinerja

• Efisiensi konteks: Agents membantu melestarikan konteks utama, memungkinkan sesi keseluruhan yang lebih lama
• Latensi: Subagents dimulai dengan slate bersih setiap kali dipanggil dan dapat menambah latensi saat mereka mengumpulkan konteks yang mereka butuhkan untuk melakukan pekerjaan mereka secara efektif.

​

Dokumentasi terkait

• Plugins - Perluas Claude Code dengan agents khusus melalui plugins
• Slash commands - Pelajari tentang perintah bawaan lainnya
• Settings - Konfigurasi perilaku Claude Code
• Hooks - Otomatiskan alur kerja dengan penanganan peristiwa