ClaudeLevel menengahBaca sekitar 12 menit

Subagent di Claude

Satu tugas besar, dibagi ke asisten terpisah.

Subagent adalah asisten tambahan yang dipanggil Claude untuk mengerjakan satu tugas khusus di ruang terpisah, lalu mengirim ringkasan hasilnya ke percakapan utama. Halaman ini membahasnya dari nol: apa itu subagent, cara membuat satu subagent di Claude Code, cara menjalankan beberapa subagent sekaligus, hasil percobaan waktu dan token, dan cara memakainya di Claude Cowork.

Ditulis oleh Aurelius Ivan Wijaya. Terakhir diperbarui 22 Juli 2026.

Tekan tombol Mode presentasi di pojok untuk menjadikannya slide.

Claude · Modul Subagent

Apa itu subagent?

Satu asisten, satu tugas, satu ringkasan.

Alur langkah edukasiTugas besar masuk ke agen utama, diteruskan ke satu subagent, lalu kembali sebagai ringkasan.123Tugas besar masuk ke agen utama, diteruskan ke satu subagent, lalu kembali sebagai ringkasan.
Bayangkan satu tugas panjang di meja kerjamu. 20 detik: tulis satu tugas nyata yang mau kamu titipkan.

Bayangkan seorang manajer proyek menerima tugas besar. Ia menugaskan satu staf untuk mencari data. Staf itu bekerja di ruangannya sendiri, membuka banyak arsip, lalu menyerahkan satu lembar kesimpulan.

Begitulah cara kerja . Claude sebagai agen utama memanggil asisten tambahan untuk satu tugas khusus, asisten itu bekerja terpisah, dan yang kembali ke percakapan utama hanya ringkasan hasilnya.

Kenapa ini berguna

Percakapan utama tetap rapi karena semua detail pencarian tinggal di dalam subagent.

Konsep

Multiple subagent

Beberapa staf bekerja di waktu yang sama.

Sekarang proyeknya makin besar. Manajer menugaskan tiga staf sekaligus: satu mencari data penjualan, satu memeriksa laporan tahun lalu, satu merangkum komunikasi klien. Ketiganya bekerja bersamaan, lalu masing-masing menyerahkan ringkasannya. Inilah .

Lebih cepat

Beberapa tugas berjalan bersamaan, jadi total waktunya mendekati tugas yang paling lama saja.

Lebih rapi

Percakapan utama hanya menerima ringkasan dari tiap subagent.

Satu batasan penting

Para staf ini tidak saling bicara. Mereka hanya melapor ke agen utama. Kalau mereka perlu berdiskusi dulu sebelum melapor, itu konsep lain namanya Agent Team, dibahas di modul terpisah.

Praktik · Claude Code

Langkah 1: siapkan folder project

Subagent disimpan di dalam folder project.

Jendela File Explorer memperlihatkan folder bernama cahaya-topup di dalam folder Repositories.
Folder project bernama cahaya-topup. Nama dan lokasinya bebas. Buat sekarang, 60 detik.
  1. 1

    Buat satu folder project baru, misalnya cahaya-topup.

    Lokasinya bebas. Contoh di sini memakai folder Repositories.

  2. 2

    Ingat lokasinya, karena semua langkah berikutnya dijalankan dari folder ini.

Praktik · Claude Code

Langkah 2: buka terminal di folder itu

Terminal harus berada di dalam folder project.

Menu klik kanan di File Explorer dengan pilihan Open in Terminal disorot.
Di Windows: klik kanan di dalam folder, lalu pilih Open in Terminal.

Kalau lebih suka mengetik, pindah folder dari terminal

Ganti nama folder sesuai punyamu.

PowerShell
1cd C:\Users\<nama>\Repositories\cahaya-topup

Praktik · Claude Code

Langkah 3: jalankan Claude

Satu kata perintah untuk masuk ke Claude Code.

Jendela PowerShell dengan perintah claude diketik di dalam folder project.
Ketik claude lalu tekan Enter. Perhatikan path-nya sudah menunjuk ke folder project.
Di dalam folder project
1claude

Praktik · Claude Code

Tampilan ketika Claude siap

Kalau layarmu seperti ini, kamu sudah masuk.

Layar sambutan Claude Code menampilkan versi, model, dan path folder project.
Layar sambutan [[Claude Code]]. Di bagian bawah kotak terlihat folder project yang sedang aktif.

Cek dulu sebelum lanjut

Folder di layar sambutan harus sama dengan folder project kamu. Kalau beda, ketik /exit, pindah folder, lalu jalankan claude lagi.

Praktik · Claude Code

Langkah 4: minta Claude membuat subagent

Jelaskan tugasnya, Claude yang menyusun filenya.

Permintaan pembuatan subagent price-checker diketik di kolom input Claude Code.
Tulis tugas subagent-nya sejelas mungkin, lalu tekan Enter.
Contoh permintaan
1Buat subagent price-checker yang membandingkan harga top up game2di beberapa toko Indonesia lalu mengembalikan tabel perbandingan.

Pakai tugasmu sendiri

Ganti isi permintaannya dengan tugas yang kamu tulis di slide pertama. Ketik sekarang, 3 menit.

Versi panjang dalam bahasa Inggris, kalau mau menyalin persis
1Create a price-checker subagent that compares game top-up2prices (diamonds, UC, points, vouchers) across Indonesian3marketplaces and official channels for any game, discovers4relevant stores itself via web search, and returns a5comparison table flagging the cheapest legitimate option

Praktik · Claude Code

Subagent selesai dibuat

Claude melaporkan lokasi filenya.

Claude Code melaporkan bahwa definisi subagent price-checker sudah dibuat beserta ringkasan tugasnya.
Claude menyebut file yang dibuat dan alat apa saja yang boleh dipakai subagent itu.

Perhatikan dua hal di laporan itu: lokasi file yang dibuat, dan daftar alat yang boleh dipakai subagent tersebut. Subagent hanya bisa memakai alat yang disebut di situ.

Praktik · Claude Code

Langkah 5: cek filenya

Subagent tersimpan sebagai satu file teks biasa.

File Explorer membuka folder .claude/agents dan menampilkan file price-checker.md.
File price-checker.md ada di folder [[.claude/agents]]. Kalau file ini ada, subagent siap dipakai.

Lokasi file subagent

Folder .claude di dalam project berlaku untuk project itu saja. Folder di home berlaku untuk semua project.

Project, lalu global
1cahaya-topup\.claude\agents\price-checker.md2%USERPROFILE%\.claude\agents\price-checker.md

Filenya berbentuk markdown, jadi bisa kamu buka dan sunting sendiri kapan saja. Cara lain membuat subagent adalah menulis file ini langsung tanpa meminta Claude.

Praktik · Claude Code

Langkah 6: jalankan subagent-mu

Sekarang kita pakai subagent yang barusan kamu buat.

Panggil subagent yang baru kamu buat. Ganti nama dan isi tugasnya dengan punyamu.
1Pakai subagent <nama-subagent-kamu> untuk <tugas yang kamu tulis2di slide pertama>.
Kalau kamu tadi ikut contohnya persis
1Pakai subagent price-checker untuk cek harga termurah2top up 85 diamond Mobile Legends.
GIF

Claude Code memanggil subagent price-checker dan menampilkan tabel perbandingan harga sebagai hasil akhir.

Claude memanggil subagent-nya sendiri, lalu menyerahkan tabel hasilnya.

Giliran kamu

Jalankan sekarang, 4 menit. Pakai nama subagent yang tadi kamu buat, dan isi tugasnya dengan pekerjaanmu sendiri. Kalau muncul error, baca pesannya dari baris paling bawah.

Use case

Satu tugas, tiga cara

Bandingkan harga top up 5 game di 7 toko.

Tanpa subagent

Claude mengerjakan semua pencarian sendiri di percakapan utama, satu per satu.

1 subagent

Semua pencarian dititipkan ke satu subagent. Percakapan utama hanya menerima tabel akhirnya.

5 subagent paralel

Satu subagent memegang satu game, semuanya jalan bersamaan, hasilnya digabung jadi satu tabel.

Coba sendiri

Pakai tugas rutinmu sendiri sebagai gantinya, misalnya membandingkan harga dari beberapa pemasok.

Tebak dulu

Mana yang paling cepat?

Pilih satu sebelum lanjut.

A. Tanpa subagent

Nol waktu persiapan, tapi semua detail menumpuk di percakapan utama.

B. 1 subagent

Sekali waktu persiapan, dan context percakapan utama paling hemat.

C. 5 subagent paralel

Lima kali waktu persiapan, tapi kelimanya jalan bersamaan.

Catat dulu

Catat pilihanmu, lalu cocokkan dengan hasil pengukuran di slide berikutnya.

Hasil percobaan

Waktu dan pemakaian context

Angka dari satu kali percobaan di kelas.

Tanpa subagent

Waktu 7 menit 6 detik. Context percakapan utama terpakai 95 ribu token.

1 subagent

Waktu 8 menit 10 detik. Context percakapan utama terpakai 31,7 ribu token.

5 subagent paralel

Waktu 5 menit 24 detik. Context percakapan utama terpakai 47,9 ribu token.

Baca angkanya sebagai pembanding

Ini hasil satu kali percobaan di kelas pada Juli 2026 memakai Claude Code v2.1.216. Angka di sini hanya menghitung sesi utama, jadi token yang dipakai di dalam subagent belum ikut dijumlahkan. Kalau kamu ulangi sendiri, angkanya bisa berbeda karena kecepatan situs yang dibuka ikut berpengaruh.

Panduan pakai

Kapan memakai subagent?

Lihat dua hal: panjang prosesnya, dan bisa dibagi atau tidak.

Pakai satu subagent

Kalau prosesnya panjang dan penuh detail, tapi yang kamu butuhkan cuma kesimpulannya. Di percobaan tadi context utama turun dari 95 ribu ke 31,7 ribu token.

Pakai beberapa subagent

Kalau tugasnya bisa dibagi jadi bagian yang tidak saling menunggu, misalnya satu subagent satu game.

Kerjakan langsung saja

Kalau tugasnya pendek, sekali jalan, atau kamu perlu sering menjawab pertanyaan Claude di tengah proses.

Hindari membagi tugas berantai

Kalau subagent B baru bisa mulai setelah hasil A keluar, hasilnya tidak akan nyambung karena subagent tidak bisa saling bicara.

Jujur soal batasannya

Yang perlu kamu terima

Empat hal yang sering bikin kaget di awal.

Mulai dari nol

Subagent tidak tahu isi percakapan utama. Semua yang ia butuhkan harus ditulis ulang di perintahnya.

Ada waktu ekstra

Setiap pemanggilan butuh waktu persiapan di awal dan merangkum di akhir. Di percobaan tadi satu subagent malah lebih lambat daripada dikerjakan langsung.

Detail prosesnya hilang

Yang kembali cuma ringkasan. Kalau ada angka yang terlihat aneh, kamu sulit menelusuri asalnya.

Total token naik

Tiap subagent punya context sendiri, jadi total token yang terpakai lebih banyak daripada satu proses biasa. Angka di slide sebelumnya hanya menghitung sesi utama, belum menjumlahkan sesi subagent.

Claude Cowork

Subagent di Claude Cowork

Tanpa setup, cukup lewat permintaan biasa.

Claude Cowork menampilkan satu agent berjalan dengan daftar langkah dan situs yang dibuka.
Satu subagent di [[Claude Cowork]]. Langkah dan situs yang dibuka terlihat, termasuk yang gagal diambil.

Di Claude Cowork kamu tidak perlu membuat file subagent lebih dulu. Cukup tulis permintaannya, misalnya minta satu bagian dititipkan ke subagent, atau minta beberapa bagian dikerjakan bersamaan. Contoh di bawah memakai tugas yang lebih kecil: cek harga satu game di lima platform.

Claude Cowork

Lima subagent berjalan bersamaan

Apa yang terjadi di balik layar.

Claude Cowork menampilkan lima agent berjalan bersamaan, masing-masing memeriksa satu platform.
Lima subagent jalan bersamaan, satu platform per subagent.
  1. 1

    Claude memecah permintaanmu jadi lima tugas serupa, satu untuk tiap platform.

  2. 2

    Kelimanya jalan bersamaan, jadi total waktunya mendekati satu platform saja.

  3. 3

    Tiap subagent melapor sendiri. Yang gagal tetap dilaporkan sebagai tidak ditemukan.

    Hasil yang gagal tetap muncul supaya kamu tahu datanya belum lengkap.

  4. 4

    Semua hasil disatukan jadi satu tabel, dan platform termurah ditandai.

Penutup

Yang kamu punya sekarang

Isi empat baris ini sekarang.

  1. 1

    Nama subagent yang kamu buat hari ini.

  2. 2

    Satu kalimat tugasnya, pakai bahasamu sendiri.

  3. 3

    Satu pekerjaan nyata yang mau kamu kasih ke dia besok pagi.

    Ambil dari tugas yang kamu tulis di slide pertama.

  4. 4

    Screenshot hasil pertamanya, simpan buat catatanmu.

Pertanyaan umum

FAQ

Satu kartu, satu pertanyaan. Ketuk untuk membuka jawaban, geser untuk lanjut ke kartu berikutnya.

1 / 6

Apa itu subagent di Claude?

Subagent adalah asisten tambahan yang dipanggil Claude untuk mengerjakan satu tugas khusus di ruang terpisah. Setelah selesai, ia hanya mengirim ringkasan hasilnya ke percakapan utama.

Apa bedanya subagent dan multiple subagent?

Subagent berarti satu asisten mengerjakan satu tugas. Multiple subagent berarti beberapa asisten bekerja di waktu yang sama, masing-masing memegang satu bagian tugas.

Di mana file subagent disimpan?

Di folder .claude/agents di dalam project kalau subagent itu khusus untuk satu project, atau di folder .claude/agents pada folder home kalau mau dipakai di semua project. Formatnya file markdown.

Apakah subagent bisa saling berkomunikasi?

Tidak. Setiap subagent hanya melapor ke agen utama. Kalau antar bagian tugas perlu saling mengecek, konsep yang dipakai adalah Agent Team.

Apakah memakai subagent selalu lebih cepat?

Tidak selalu. Setiap pemanggilan subagent butuh waktu persiapan, jadi untuk tugas pendek mengerjakan langsung bisa lebih cepat. Keuntungan terbesarnya muncul saat tugas panjang dibagi ke beberapa subagent yang jalan bersamaan.

Apakah subagent bisa dipakai di Claude Cowork?

Bisa, dan tanpa setup tambahan. Cukup tulis permintaannya, misalnya minta satu bagian dititipkan ke subagent atau minta beberapa bagian dikerjakan bersamaan.

Ingin tim kamu dilatih langsung?

AI Training Indonesia membawakan pelatihan AI praktis untuk tim perusahaan, termasuk membangun dan memakai Skills di Claude.