Freelancer developer jarang punya rekan yang bisa meninjau pekerjaannya, dan proyek klien sering datang dengan basis kode yang belum dikenal. Subagent Claude Code membantu di dua titik itu: ia menyisir kode di ruang kerjanya sendiri dan hanya mengembalikan ringkasan, sehingga percakapan utama tidak penuh dengan keluaran pencarian dan log.
Artikel ini menjelaskan apa itu subagent, cara membuatnya, tiga subagent yang menurut kami paling berguna untuk pekerjaan klien, cara membatasi izinnya, dan kapan sebaiknya tidak dipakai. Kami merujuk pada dokumentasi resmi untuk fitur dan batas teknis; nama bidang, model, dan angka batas dapat berubah, jadi periksa dokumentasi terbaru sebelum menyalin konfigurasi.
Daftar isi
- Apa itu subagent dan mengapa berguna
- Cara membuat subagent
- Tiga subagent untuk pekerjaan klien
- Membatasi alat dan izin
- Kapan subagent justru merugikan
- Review kode otomatis sebagai bagian layanan
- FAQ
Apa itu subagent dan mengapa berguna
Menurut dokumentasi resmi Claude Code, subagent adalah asisten AI khusus untuk jenis tugas tertentu. Setiap subagent berjalan di jendela konteksnya sendiri dengan system prompt khusus, akses alat tertentu, dan izin yang independen. Claude mendelegasikan tugas ke subagent ketika tugas itu cocok dengan deskripsinya, lalu subagent mengembalikan hasilnya.
Manfaat yang paling relevan bagi freelancer adalah menjaga konteks. Dokumentasi menjelaskan bahwa subagent cocok untuk pekerjaan sampingan yang akan membanjiri percakapan utama dengan hasil pencarian, log, atau isi berkas yang tidak akan dirujuk lagi. Subagent mengerjakannya di konteksnya sendiri dan hanya mengembalikan ringkasan. Hasilnya, sesi utama tetap fokus pada pekerjaan inti.
Manfaat lain: membatasi alat, memakai ulang konfigurasi antarproyek, mengkhususkan perilaku dengan prompt yang terfokus, dan mengendalikan biaya dengan mengarahkan tugas ke model yang lebih cepat dan murah. Dokumentasi juga mencatat bahwa permintaan subagent dihitung dalam batas pemakaian yang sama dengan percakapan utama, jadi subagent bukan cara menghindari batas.
Claude Code sudah menyediakan beberapa subagent bawaan. Contohnya Explore, agen baca-saja yang cepat untuk mencari dan menganalisis basis kode, dan Plan, agen riset baca-saja yang dipakai dalam mode rencana untuk mengumpulkan konteks sebelum menyajikan rencana. Ada pula agen serbaguna yang memiliki semua alat. Banyak pekerjaan harian sudah terbantu oleh yang bawaan tanpa membuat apa pun.
Untuk freelancer, nilai praktisnya sederhana: tugas yang tadinya membuat sesi penuh dan pelan, seperti memetakan modul asing atau meninjau banyak berkas, menjadi lebih ringkas. Namun, seperti alat lain, subagent bukan sihir, dan ada situasi ketika ia memperlambat pekerjaan.
Cara membuat subagent
Menurut dokumentasi, subagent adalah berkas Markdown dengan frontmatter YAML. Bagian isi berkas menjadi system prompt subagent. Subagent hanya menerima prompt itu ditambah detail lingkungan dasar, bukan seluruh system prompt Claude Code, sehingga instruksimu harus mandiri dan lengkap.
Dua bidang wajib adalah nama dan deskripsi. Deskripsi menentukan kapan Claude mendelegasikan tugas ke subagent itu, jadi tulislah dengan tajam: kapan dipakai, untuk jenis tugas apa, dan apa yang tidak ditangani. Deskripsi yang kabur membuat delegasi tidak konsisten. Bidang opsional meliputi daftar alat yang diizinkan, daftar alat yang dilarang, model, mode izin, jumlah giliran maksimum, dan lainnya.
Lokasi berkas menentukan cakupan. Dokumentasi menyebut berkas di direktori agen proyek berlaku untuk proyek itu, sedangkan berkas di direktori agen tingkat pengguna berlaku di semua proyekmu. Bila ada nama yang bentrok, lokasi berprioritas lebih tinggi yang menang. Untuk freelancer, pola yang masuk akal: simpan subagent umum seperti reviewer di tingkat pengguna, dan simpan yang khusus proyek di proyek.
Mulailah dengan satu subagent dan perbaiki sampai berguna, baru tambah yang lain. Dokumentasi mengingatkan agar deskripsi tetap singkat dan memindahkan detail ke system prompt, karena gabungan deskripsi yang terlalu panjang memunculkan peringatan saat mulai dan menghabiskan anggaran konteks.
Uji subagent dengan tugas nyata kecil. Lihat apakah Claude memanggilnya pada saat yang tepat, apakah ringkasan yang kembali cukup bermakna, dan apakah ia melewati batas yang kamu tetapkan. Perubahan pada berkas biasanya langsung berlaku dalam hitungan detik, sehingga siklus perbaikan cepat. Catat versi prompt yang bekerja baik di CLAUDE.md atau dokumentasi proyek agar bisa dipakai ulang.
Tiga subagent untuk pekerjaan klien
Subagent pertama adalah peninjau kode. Beri ia akses baca saja, dan tugasnya meninjau perubahan terbaru dari sudut kualitas, keamanan, dan keterbacaan, lalu mengembalikan daftar temuan berurutan menurut tingkat keparahan, lengkap dengan lokasi berkas. Tegaskan dalam prompt agar ia membedakan masalah nyata dari preferensi gaya, dan agar tidak mengubah kode. Review kode otomatis seperti ini menangkap kesalahan yang terlewat oleh pembuatnya sendiri.
Subagent kedua adalah penelusur basis kode. Saat menerima proyek warisan, kamu perlu memahami struktur, alur data, dan titik masuk. Subagent baca-saja yang bertugas memetakan modul dan menjawab pertanyaan spesifik, misalnya di mana logika diskon dihitung, akan menghemat banyak waktu. Minta ia menyebut berkas dan baris sumber agar jawabannya dapat diverifikasi.
Subagent ketiga adalah penguji. Tugasnya menjalankan rangkaian uji, membaca hasil, dan melaporkan kegagalan secara ringkas dengan dugaan penyebab. Keluaran uji yang panjang adalah contoh klasik hal yang mengotori konteks utama, jadi mendelegasikannya sangat masuk akal. Beri izin menjalankan perintah uji saja, bukan perintah bebas.
Untuk ketiganya, tuliskan format laporan yang diharapkan: ringkas, terstruktur, dan menyebut bukti. Laporan tanpa bukti memaksamu memeriksa ulang dari nol, yang menghilangkan manfaatnya. Dokumentasi juga mengingatkan bahwa banyak subagent yang masing-masing mengembalikan hasil panjang tetap dapat memakan konteks utama, jadi minta ringkasan, bukan salinan.
Terakhir, jangan menganggap temuan subagent sebagai kebenaran. Ia bisa keliru atau melewatkan masalah. Anggap sebagai pembaca pertama yang cepat, lalu putuskan sendiri. Tanggung jawab atas kode yang kamu serahkan ke klien tetap pada kamu, bukan pada alat.
Membatasi alat dan izin
Prinsip yang sama berlaku seperti di mana pun: beri akses sekecil mungkin. Dokumentasi menjelaskan bahwa kamu dapat menetapkan daftar alat yang diizinkan untuk subagent, dan bila daftar itu dihilangkan, subagent mewarisi semua alat yang tersedia bagi subagent. Karena itu, selalu tulis daftar alat secara eksplisit untuk subagent yang menyentuh proyek klien.
Peninjau dan penelusur cukup dengan alat baca dan pencarian. Penguji butuh akses menjalankan perintah, tetapi tetap sebaiknya dibatasi. Subagent yang boleh menulis berkas sebaiknya dipakai hanya pada tugas yang jelas batasnya, dan idealnya pada cabang terpisah agar mudah dibatalkan. Dokumentasi juga menyebut opsi isolasi menggunakan worktree, yang bisa kamu pelajari untuk tugas yang mengubah kode.
Perhatikan data klien. Basis kode sering mengandung kunci, token, dan data pelanggan di berkas konfigurasi atau data uji. Jangan biarkan subagent membaca berkas rahasia tanpa perlu, dan pastikan rahasia tidak ikut terkirim sebagai bagian dari ringkasan. Bahas kebijakan ini dengan klien sebelum mulai, termasuk apakah kontrak mengizinkan penggunaan alat AI pada kodenya.
Dokumentasi juga mengingatkan bahwa laporan subagent dipindai untuk teks yang menyerupai instruksi, tetapi pemindaian itu tidak menggantikan pembatasan akses. Artinya, sumber risiko bukan hanya subagent itu sendiri, melainkan isi yang ia baca, seperti komentar dalam kode atau dokumen yang disisipi instruksi tersembunyi. Karena itu, tindakan yang berdampak tetap harus melewati persetujuanmu.
Terakhir, ketahui batas tim dan organisasi. Beberapa klien memiliki kebijakan keamanan yang membatasi alat apa yang boleh dipakai pada kode mereka. Tanyakan lebih dulu dan dokumentasikan jawabannya. Menjelaskan alur kerja yang aman justru dapat menjadi nilai jual saat berhadapan dengan klien yang berhati-hati.
Kapan subagent justru merugikan
Dokumentasi sendiri memberi tahu batasnya. Subagent memulai dari konteks kosong dan tidak melihat riwayat percakapanmu; Claude menulis pesan delegasi dan subagent bekerja dari situ. Akibatnya, tugas yang butuh bolak-balik sering dan banyak konteks bersama lebih baik dikerjakan di percakapan utama.
Ada juga biaya waktu. Subagent perlu mengumpulkan konteks dari awal, jadi untuk perubahan kecil yang sudah kamu pahami, memanggilnya malah lebih lambat daripada mengerjakannya langsung. Gunakan subagent untuk pekerjaan yang besar, terpisah, dan menghasilkan keluaran panjang yang tidak perlu kamu baca seluruhnya.
Hasil yang kembali juga memakan konteks. Bila kamu menjalankan banyak subagent yang masing-masing mengembalikan laporan panjang, keuntungan penghematan konteks bisa hilang. Atur prompt agar laporan ringkas, dan batasi jumlah subagent yang berjalan bersamaan sesuai kebutuhan, bukan sebanyak mungkin.
Kekeliruan lain adalah membuat terlalu banyak subagent yang tumpang tindih. Deskripsi yang mirip membuat delegasi tidak konsisten, dan kamu sendiri sulit mengingat mana yang melakukan apa. Dua atau tiga subagent yang tajam lebih berguna daripada belasan yang kabur.
Terakhir, subagent tidak mengganti pemahamanmu. Freelancer yang menyerahkan sepenuhnya pemahaman proyek kepada ringkasan otomatis berisiko tidak bisa menjawab pertanyaan klien atau memperbaiki masalah di luar rencana. Gunakan alat untuk mempercepat, bukan untuk menghindari belajar. Klien membayar tanggung jawabmu, bukan sekadar keluaran kode.
Review kode otomatis sebagai bagian layanan
Kamu bisa menjadikan kemampuan ini bagian dari layanan. Paket pertama: audit kode singkat untuk klien yang ingin tahu kondisi proyek warisannya. Kamu memetakan struktur, mencatat risiko keamanan dan hutang teknis, lalu menyerahkan laporan dengan prioritas. Subagent mempercepat pengumpulan, sedangkan penilaian dan rekomendasi adalah pekerjaanmu.
Paket kedua: jaminan mutu sebelum rilis. Sebelum menyerahkan pekerjaan, jalankan peninjauan otomatis dan uji, perbaiki temuan, dan lampirkan ringkasan hasil. Klien melihat bukti proses, bukan hanya kode. Praktik ini mengurangi pengerjaan ulang dan memperkuat kepercayaan.
Paket ketiga: pemeliharaan berkala. Setiap bulan atau triwulan kamu memeriksa dependensi, menjalankan peninjauan, dan melaporkan perubahan yang perlu perhatian. Ini pendapatan berulang yang masuk akal bagi freelancer, selama lingkup dan batas tanggung jawab dinyatakan tegas.
Untuk harga, hitung dari nilai dan waktu nyata: pemetaan, penilaian, pengujian, dan komunikasi dengan klien. Jangan menetapkan harga dari kecepatan alat. Untuk angka konkret, lihat tarif pasar developer di segmenmu dan sesuaikan dengan kompleksitas proyek.
Jujurlah soal peran AI dan batasnya. Jelaskan bahwa peninjauan otomatis membantu tetapi tidak menjamin bebas kesalahan, terutama kerentanan keamanan. Untuk sistem yang menangani pembayaran atau data sensitif, sarankan audit keamanan oleh ahli. Janji “kode pasti aman” adalah janji yang tidak boleh dibuat siapa pun.
Terakhir, dokumentasikan alur kerja dan konfigurasimu. Daftar subagent, prompt, dan aturan izin yang kamu pakai adalah aset yang bisa dijelaskan kepada klien dan dipakai ulang di proyek berikutnya, tanpa harus membongkar rahasia dagangmu.
FAQ
Apa bedanya subagent dengan percakapan Claude Code biasa?
Menurut dokumentasi resmi, subagent berjalan di jendela konteksnya sendiri dengan system prompt, akses alat, dan izin tersendiri, lalu mengembalikan hasil ke percakapan utama. Ini menjaga konteks utama tetap bersih.
Apakah subagent bisa menghemat biaya?
Dokumentasi menyebut kamu bisa mengarahkan tugas ke model yang lebih cepat dan murah, tetapi permintaan subagent tetap dihitung dalam batas pemakaian yang sama. Penghematan bergantung pada cara kamu menggunakannya.
Apakah subagent bisa mengubah kode klien tanpa izin?
Hanya bila diberi alat untuk itu. Batasi alat secara eksplisit, gunakan akses baca saja untuk peninjau dan penelusur, dan jalankan tugas penulisan pada cabang terpisah dengan persetujuanmu.
Berapa banyak subagent yang sebaiknya dibuat?
Mulailah dengan satu sampai tiga yang tugasnya tajam dan tidak tumpang tindih. Tambah hanya bila ada kebutuhan berulang yang jelas.
Bolehkah memakai Claude Code pada kode klien?
Itu tergantung kontrak dan kebijakan klien. Tanyakan lebih dulu, dokumentasikan izinnya, dan hindari mengekspos rahasia seperti kunci atau data pelanggan. Untuk hal hukum, konsultasikan dengan penasihat hukum.