Subagen

Subagen kustom di Claude Code adalah asisten AI khusus yang dapat dipanggil untuk menangani jenis tugas tertentu. Mereka memungkinkan pemecahan masalah yang lebih efisien dengan menyediakan konfigurasi khusus tugas dengan prompt sistem yang disesuaikan, alat dan jendela konteks terpisah.

​

Apa itu subagen?

Subagen adalah kepribadian AI yang telah dikonfigurasi sebelumnya yang dapat didelegasikan tugas oleh Claude Code. Setiap subagen:

• Memiliki tujuan dan area keahlian tertentu
• Menggunakan jendela konteks sendiri yang terpisah dari percakapan utama
• Dapat dikonfigurasi dengan alat khusus yang diizinkan untuk digunakan
• Menyertakan prompt sistem kustom yang memandu perilakunya

Ketika Claude Code menemukan tugas yang sesuai dengan keahlian subagen, ia dapat mendelegasikan tugas tersebut kepada subagen khusus, yang bekerja secara independen dan mengembalikan hasil.

​

Manfaat utama

​

Mulai cepat

Untuk membuat subagen pertama Anda:

/agents

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

​

Konfigurasi subagen

​

Lokasi file

Subagen disimpan sebagai file Markdown dengan frontmatter YAML di dua lokasi yang mungkin:

Ketika nama subagen bertentangan, subagen tingkat proyek mengambil prioritas atas subagen tingkat pengguna.

​

Format file

Setiap subagen didefinisikan dalam file Markdown dengan struktur ini:

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
---

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.

​

Field konfigurasi

​

Alat yang tersedia

Subagen dapat diberikan akses ke alat internal Claude Code mana pun. Lihat dokumentasi alat untuk daftar lengkap alat yang tersedia.

Anda memiliki dua opsi untuk mengkonfigurasi alat:

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

Alat MCP: Subagen dapat mengakses alat MCP dari server MCP yang dikonfigurasi. Ketika field tools dihilangkan, subagen mewarisi semua alat MCP yang tersedia untuk thread utama.

​

Mengelola subagen

​

Menggunakan perintah /agents (Direkomendasikan)

Perintah /agents menyediakan antarmuka komprehensif untuk manajemen subagen:

/agents

Ini membuka menu interaktif di mana Anda dapat:

• Melihat semua subagen yang tersedia (built-in, pengguna, dan proyek)
• Membuat subagen baru dengan pengaturan terpandu
• Mengedit subagen kustom yang ada, termasuk akses alat mereka
• Menghapus subagen kustom
• Melihat subagen mana yang aktif ketika ada duplikat
• Dengan mudah mengelola izin alat dengan daftar lengkap alat yang tersedia

​

Manajemen file langsung

Anda juga dapat mengelola subagen dengan bekerja langsung dengan file mereka:

# Buat subagen proyek
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

# Buat subagen pengguna
mkdir -p ~/.claude/agents
# ... buat file subagen

​

Menggunakan subagen secara efektif

​

Delegasi otomatis

Claude Code secara proaktif mendelegasikan tugas berdasarkan:

• Deskripsi tugas dalam permintaan Anda
• Field description dalam konfigurasi subagen
• Konteks saat ini dan alat yang tersedia

​

Pemanggilan eksplisit

Minta subagen tertentu dengan menyebutkannya dalam perintah Anda:

> 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

​

Contoh subagen

​

Code reviewer

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

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.

​

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

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 agen yang dihasilkan Claude: Kami sangat merekomendasikan menghasilkan subagen awal Anda dengan Claude dan kemudian mengulanginya untuk membuatnya secara pribadi milik Anda. Pendekatan ini memberikan hasil terbaik - fondasi yang solid yang dapat Anda sesuaikan dengan kebutuhan spesifik Anda.

• Rancang subagen yang terfokus: Buat subagen dengan tanggung jawab tunggal yang jelas daripada mencoba membuat satu subagen melakukan segalanya. Ini meningkatkan kinerja dan membuat subagen lebih dapat diprediksi.

• Tulis prompt yang detail: Sertakan instruksi khusus, contoh, dan batasan dalam prompt sistem Anda. Semakin banyak panduan yang Anda berikan, semakin baik subagen akan berkinerja.

• Batasi akses alat: Hanya berikan alat yang diperlukan untuk tujuan subagen. Ini meningkatkan keamanan dan membantu subagen fokus pada tindakan yang relevan.

• Kontrol versi: Periksa subagen proyek ke dalam kontrol versi sehingga tim Anda dapat mengambil manfaat dan meningkatkannya secara kolaboratif.

​

Penggunaan lanjutan

​

Menghubungkan subagen

Untuk alur kerja yang kompleks, Anda dapat menghubungkan beberapa subagen:

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

​

Pemilihan subagen dinamis

Claude Code secara cerdas memilih subagen berdasarkan konteks. Buat field description Anda spesifik dan berorientasi tindakan untuk hasil terbaik.

​

Pertimbangan kinerja

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

​

Dokumentasi terkait

• Perintah slash - Pelajari tentang perintah built-in lainnya
• Pengaturan - Konfigurasi perilaku Claude Code
• Hooks - Otomatisasi alur kerja dengan event handler