Apakah SubAgen dalam Kod Claude? Perkara yang Anda Perlu Tahu

Sub-agen (sering ditulis subagen or sub-agen) ialah salah satu kemajuan praktikal yang paling jelas dalam perkakas pembangun ejen: mereka membenarkan anda menyusun pasukan kecil pembantu AI khusus di dalam Kod Claude, masing-masing dengan peranan, alatan dan tetingkap konteksnya sendiri. Idea ini mudah tetapi berkuasa — daripada meminta satu model generalis untuk melakukan segala-galanya, anda menentukan ejen padat, satu tujuan yang diwakili oleh orkestra utama (sama ada secara automatik atau apabila anda memintanya secara eksplisit). Ini mengubah cara anda mengurus konteks, alatan dan pertukaran kos/kependaman bagi aliran kerja yang kompleks.

Apakah subagen?

Definisi pendek. Subagen ialah "personaliti" AI yang diprakonfigurasikan dan dikhususkan tugas yang Claude Code boleh mewakilkan tugas. Setiap subagen mempunyai gesaan sistem sendiri, tetingkap konteks (terpencil) sendiri, alat yang diberikan secara eksplisit, dan pilihan model pilihan. Subagen boleh dibuat pada peringkat projek atau pengguna dan dipanggil secara automatik oleh Claude atau secara eksplisit oleh pengguna.

Sifat utama subagen

Tujuan khusus dan segera sistem. Anda menerangkan peranan, kekangan dan pendekatan subagen dalam gesaan sistemnya supaya ia berkelakuan boleh diramal untuk domain sempitnya (contohnya, penyemak kod, penyahpepijat, saintis data).
Tetingkap konteks terpencil. Setiap subagen menyimpan sejarah dan konteks perbualannya sendiri, menghalang konteks utas utama daripada tercemar dengan butiran peringkat rendah. Ini penting untuk menskalakan aliran kerja yang sebaliknya meletihkan konteks perbualan tunggal.
Skop alat dan kebenaran. Anda boleh memberikan atau menyekat alat dalaman atau alat Protokol Konteks Model (MCP) luaran yang boleh digunakan oleh subagen. Ini adalah ciri keselamatan dan tadbir urus yang penting.
Konfigurasi sebagai kod. Subagen ditakrifkan sebagai fail Markdown dengan perkara hadapan YAML (nama, penerangan, alatan, model) dan disimpan sama ada pada peringkat projek (.claude/agents/) atau tahap pengguna (~/.claude/agents/). Definisi projek diutamakan.

Apakah itu Perwakilan automatik dan Seruan eksplisit

Claude Code boleh secara automatik agihkan tugas kepada subagen apabila anda meminta atau subagen description sepadan dengan tugas - atau anda boleh secara eksplisit meminta ejen (cth, > Use the code-reviewer subagent to check my recent changes). Buat description berorientasikan tindakan ("Use PROACTIVELY", "MUST BE USED") untuk mendorong perwakilan automatik, dua cara pelengkap untuk menggunakan subagen dalam Kod Claude:

Perwakilan automatik — Claude memeriksa permintaan dan mewakilkan kerja yang dipadankan kepada subagen secara proaktif.
Doa yang jelas — anda memanggil subagen mengikut nama dalam gesaan/arahan anda (contohnya, Use the code-reviewer subagent to check my changes).

Kedua-dua pendekatan mempunyai pertukaran UX dan kejuruteraan yang berbeza. Di bawah saya bongkar setiap satu.

Perwakilan automatik

Bagaimana ia kelihatan kepada pengguna. Anda mengeluarkan arahan peringkat tinggi (cth, "Sediakan audit keselamatan untuk perpustakaan baharu ini") dan Claude mengesan bahawa satu atau lebih subagen adalah sesuai berdasarkan description medan dalam konfigurasi mereka. Jika dikonfigurasikan untuk kegunaan proaktif, subagen dihantar secara automatik dan mengembalikan hasil sebagai output berstruktur.

Mengapa pasukan menggunakannya.

Ia merendahkan beban kognitif — anda tidak perlu mengingati atau menaip setiap nama subagen.
Ia mewujudkan onboarding yang lebih lancar untuk aliran kerja yang dikongsi di mana tugas tertentu harus sentiasa dikendalikan oleh pakar yang sama.

Kaveat.

Anda mesti membuat kejuruteraan description dan sistem menggesa dengan sengaja supaya Claude memilih subagen yang betul dengan pasti.
Delegasi yang terlalu bersemangat boleh meningkatkan penggunaan token dan bunyi bising jika banyak subagen mengaktifkan tugas yang serupa; reka huraian anda secara konservatif.

Doa yang jelas

Bagaimana ia kelihatan kepada pengguna. Anda secara jelas memanggil subagen: > Use the test-runner subagent to run the project tests. Orkestrasi adalah deterministik: Claude memanggil subagen yang dinamakan dengan kebenaran prakonfigurasi dan gesaannya.

Mengapa pasukan menggunakannya.

Kawalan penuh: anda memutuskan dengan tepat pakar mana yang akan dijalankan, yang memudahkan penyahpepijatan dan kebolehulangan.
Lebih mudah untuk membuat alasan tentang kos dan akses alat dalam CI atau skrip automatik.

Kaveat.

Lebih banyak menaip dan disiplin: pembangun atau automasi mesti mengetahui nama subagen yang betul.
Kurang oportunistik: anda kehilangan sedikit kemudahan apabila ejen utama akan mengesan subagen yang baik secara automatik.

Cara subagen berfungsi — gambaran keseluruhan teknikal

Di bawah ialah pandangan praktikal dan berorientasikan pelaksanaan pada perkara yang berlaku apabila anda membuat dan menggunakan subagen.

Mentakrifkan subagen (konfigurasi sebagai kod)

Subagen ialah fail Markdown dengan perkara hadapan YAML. Bidang penting termasuk:

name — id huruf kecil yang unik (ditanda sempang)
description — perihalan bahasa semula jadi yang digunakan untuk pemadanan perwakilan automatik
tools — senarai koma pilihan alat yang dibenarkan (atau ditinggalkan untuk mewarisi semua alat)
model — alias pilihan (sonnet, opus, haiku) Atau inherit untuk menggunakan model perbualan utama

Contoh kecil (konseptual, bukan verbatim daripada dokumen):

---
name: code-reviewer
description: Expert code reviewer. Proactively reviews code for quality, security, and maintainability.
tools: Read, Grep, Bash
model: inherit
---
You are a senior code reviewer. Focus on security, correctness, and maintainability.

Fail ini tinggal sama ada .claude/agents/ (skop projek) atau ~/.claude/agents/ (skop pengguna). Fail projek diutamakan, yang menjadikan perkongsian dan subagen mengawal versi menjadi mudah.

Pemilihan model dan alatan

Medan model: anda boleh memilih alias model tertentu untuk subagen atau biarkan ia mewarisi model perbualan utama. Itu membolehkan anda menggabungkan pertukaran kos/kualiti (contohnya, gunakan model yang lebih murah untuk subagen pengimbasan data yang besar dan model berkualiti tinggi untuk sintesis akhir).
Skop alat: memberikan setiap subagen set alat yang minimum mengurangkan jejari letupan dan memudahkan penaakulan tentang keselamatan. Alat termasuk primitif Kod Claude standard (Baca, Grep, Bash, Edit, dll.) dan penyepaduan yang disediakan oleh MCP.

Tingkah laku masa jalan dan pengendalian konteks

Apabila Claude mewakilkan kepada subagen, subagen itu menerima:

Gesaan sistemnya (kandungan YAML/Markdown).
Hanya konteks yang diperlukan (tetingkap konteksnya sendiri).
Akses alat seperti yang dibenarkan dalam konfigurasinya.

Oleh kerana setiap subagen menyimpan konteks terpencil, penyiasatan panjang atau analisis fail besar boleh diuraikan kepada banyak konteks kecil dan bukannya memaksa satu konteks untuk memegang segala-galanya — kemenangan besar untuk kebolehpercayaan dan kebolehtafsiran.

Corak seni bina untuk subagen

Seni bina yang paling biasa ialah a orkestra (ejen utama) yang menguraikan tugas peringkat tinggi, memutarkan berbilang sub-ejen, dan kemudian mensintesis atau mengesahkan outputnya. Dua corak kanonik muncul di alam liar:

1) Orkestra + Pakar

Satu ejen (the orkestra) menyelaraskan berbilang subagen secara selari atau bersiri. Pengaturcara memutuskan pakar mana yang hendak dipanggil, mengagregatkan output, mengesahkan konsistensi dan melakukan penyepaduan akhir. Ini ialah pendekatan biasa "wakil pengurus kepada ahli pasukan" dan sepadan dengan banyak contoh dan reka bentuk yang disyorkan dalam bahan Kod Claude. Faedah termasuk keselarian, pemisahan kebimbangan yang lebih jelas dan pembendungan ralat yang lebih mudah (subagen buggy hanya mempengaruhi skopnya).

Bila hendak menggunakannya: tugas kompleks dengan submasalah bebas (cth, "jana ujian", "jalankan analisis statik", "tulis semula modul", kemudian "sepadukan dan jalankan ujian hujung ke hujung").

Tukar ganti: logik orkestrasi boleh menjadi kompleks; perjalanan pergi balik tambahan mungkin meningkatkan sedikit kependaman.

2) Pakar Saluran Paip / Berantai

Di sini subagen disusun dalam urutan di mana output satu menjadi input seterusnya (cth, spec → scaffold → implement → test → optimize). Ini pada asasnya adalah komposisi fungsi yang dinyatakan sebagai ejen — berguna apabila anda memerlukan transformasi langkah demi langkah dan jaminan ketat tentang cara data mengalir antara peringkat. Ia lebih mudah dari segi konsep untuk aliran kerja linear dan kadangkala lebih mudah untuk dinyahpepijat.

Bila hendak menggunakannya: transformasi berbilang langkah yang menentukan (contohnya, menterjemah dokumen reka bentuk ke dalam kod perancah, kemudian ujian, kemudian pengoptimuman).

Tukar ganti: kurang semulajadi untuk tugas yang memerlukan penerokaan luas (penyelidikan, sumbang saran), dan satu pautan yang terputus boleh menghentikan keseluruhan saluran paip.

Apakah yang membezakan subagen daripada gesaan berasaskan peranan semata-mata?

1) Asingkan tetingkap konteks

Setiap subagen mendapat penimbal konteksnya sendiri yang menyimpan pertukaran, fail dan metadata yang berkaitan dengan peranannya. Itu menghalang konteks sesi utama daripada dicemari oleh mesej perantara yang bising, dan ini juga bermakna anda boleh mengekalkan — atau mengehadkan — sejarah untuk setiap keupayaan. Beginilah cara Claude Code membolehkan anda mengekalkan konteks isyarat tinggi yang tahan lama untuk tugasan khusus tanpa membayar kos token atau overhed kognitif untuk memasukkan segala-galanya ke dalam satu gesaan.

2) Gesaan dan persona sistem

Subagen dicipta dengan arahan peringkat sistem yang menentukan peranan, nada dan kekangan mereka (cth, "Bertindak hanya sebagai pakar pemfaktoran semula; jangan laksanakan arahan shell" atau "Jana ujian unit dalam gaya pytest; hanya gunakan antara muka awam"). Gesaan ini bertindak seperti perihalan kerja untuk subagen dan dikuatkuasakan pada masa jalan oleh masa jalan Claude Code.

3) Pengikatan alat dan skop kebenaran

Perbezaan praktikal yang kritikal: subagen boleh diberikan atau dinafikan akses kepada alatan tertentu — sistem fail, pelaksanaan proses, API luaran atau set data istimewa. Itu menjadikan subagen berkuasa untuk keistimewaan paling rendah reka bentuk: penjana dokumentasi boleh disekat daripada menjalankan arahan sewenang-wenangnya, manakala subagen CI diberikan kotak pasir terpencil. Banyak siaran komuniti menyokong subagen berpasangan dengan Model Context Protocol (MCP) atau pelayan MCP berasaskan cangkuk untuk mengurus akses selamat kepada rahsia dan I/O.

4) Pilihan model dan pertukaran prestasi kos

Oleh kerana subagen adalah modular, anda boleh menetapkan model asas yang berbeza bergantung pada kerumitan tugas. Gunakan model Sonnet berkeupayaan tinggi untuk penaakulan mendalam atau model Haiku yang ringan untuk tugasan yang pantas dan berulang. Penggunaan heterogen ini membantu mengimbangi kependaman, kos token dan keupayaan. Kemas kini produk dan artikel komuniti Anthropic menekankan penggunaan selari model yang lebih kecil untuk penskalaan kos efektif.

5) Corak komunikasi

Subagen berkomunikasi dengan orkestra (atau satu sama lain) melalui mesej atau fail berstruktur. Corak biasa termasuk:

mengembalikan muatan JSON berstruktur (diutamakan untuk orkestrasi program),
menulis ke fail berskop dalam ruang kerja kongsi,
atau menghantar semula mesej berformat terakhir kepada orkestra yang merangkumi skor keyakinan dan rasional.
Percubaan komuniti menunjukkan pasukan lebih suka penyerahan eksplisit yang boleh dibaca mesin untuk mengelakkan kekaburan.

Faedah Prestasi

Sub-agen bukan sekadar kekemasan reka bentuk — ia memberikan prestasi praktikal dan faedah berkualiti apabila digunakan dengan betul.

1) Mengurangkan masa jam dinding melalui selari

Dengan menghantar berbilang pekerja secara serentak (contohnya, seorang pekerja bagi setiap folder repositori, setiap perkhidmatan mikro atau setiap ketulan data), orkestra mengurangkan masa berlalu yang diperlukan untuk menyelesaikan tugasan komposit yang besar. Kes penggunaan seperti triging laporan pepijat, menjana dokumentasi untuk banyak modul atau mengaudit berbilang perkhidmatan adalah wajar. Percepatan yang ketara dalam aliran kerja pembangun apabila beban kerja benar-benar selari.

Dengan memberikan setiap peranan konteksnya sendiri, anda mengelakkan kembung segera dan mengurangkan risiko halusinasi yang disebabkan oleh bunyi sejarah yang tidak berkaitan. Ini bermakna lebih sedikit kegagalan berkaitan konteks dan output yang lebih konsisten untuk tugas khusus. Tulisan komuniti dan penyelidikan Anthropic sendiri menunjukkan bahawa persediaan berbilang ejen selalunya mengatasi ejen monolitik dalam tugasan yang luas. Satu penilaian dalaman Anthropic melaporkan peningkatan dramatik untuk tugasan gaya penyelidikan menggunakan seni bina ejen utama + subagen.

Kaveat: paralelisme menghasilkan keuntungan terbaik apabila sub-tugas adalah bebas. Jika pekerja mesti sentiasa menunggu antara satu sama lain atau berkongsi keadaan yang berat, anda akan melihat pulangan yang semakin berkurangan.

2) Penggunaan konteks yang lebih baik dan sisa token yang lebih rendah

Daripada memasukkan setiap hasil carian perantaraan ke dalam konteks global tunggal, pekerja hanya menyimpan perkara yang berkaitan di dalam tetingkap mereka sendiri dan mengembalikan output suling. Itu mengurangkan penggunaan token untuk orkestra dan mengurangkan risiko mencapai had konteks — kemenangan praktikal apabila anda bekerja dengan pangkalan kod yang besar, log panjang atau repositori dokumen yang besar. Pemadatan/Ringkasan SDK memanjangkan lagi ingatan berkesan ejen yang telah lama berjalan.

3) Peningkatan ketepatan daripada gesaan pakar

Sub-ejen yang dibina sebagai pakar berskop sempit boleh ditala (melalui gesaan sistem dan set alatnya) untuk mengoptimumkan ketepatan dalam domainnya: semakan keselamatan, gaya kod atau pengekstrakan pematuhan. Gesaan berskop sempit cenderung untuk mengurangkan halusinasi kerana ruang tindakan yang dibenarkan oleh ejen dan output yang dijangkakan adalah terhad. Organisasi melaporkan output berkualiti tinggi untuk tugas seperti semakan kod automatik apabila mereka menggunakan sub-ejen khusus domain dan bukannya meminta generalis untuk melakukan segala-galanya.

Cara pasukan sebenarnya menggunakan subagen — contoh aliran kerja

Di bawah adalah contoh konkrit untuk menjadikan ini kurang abstrak.

Contoh A — Saluran paip refactor (Orchestrator + Pakar)

Orchestrator menerima permintaan "refactor component X".
Panggilan Orkestra analysis-subagent (tiada menulis perm) untuk mengenal pasti tempat liputan kerumitan dan kebergantungan berisiko.
Panggilan Orkestra refactor-subagent (tulis perm ke kotak pasir seperti cawangan) untuk menghasilkan fail yang difaktorkan semula.
Panggilan Orkestra test-gen-subagent (baca sahaja pada kod) untuk menghasilkan ujian unit.
Orkestra menjalankan CI dengan ci-runner-subagent (pelaksanaan kotak pasir) dan agregat hasil untuk semakan manusia.
Corak ini mengasingkan setiap fasa, mengandungi risiko dan memastikan laluan audit sentiasa kemas.

Contoh B — Penyelidikan + prototaip (Paip)

literature-subagent mengikis dan meringkaskan rujukan (tiada penulisan fail, akses web terkawal).
prototype-subagent perancah PoC minimum daripada ringkasan.
benchmark-subagent menjalankan penanda aras mikro dalam kotak pasir dan melaporkan hasil.
Rantaian ini menguatkuasakan sifat urutan tugas penyelidikan sambil memastikan tanggungjawab jelas.

Amalan dan corak terbaik

Reka bentuk dan konfigurasi

Mulakan dengan peranan kecil dan sempit. Jadikan setiap subagen bertanggungjawab untuk satu kerja yang jelas. Tanggungjawab yang sempit menjadikan penyahpepijatan jauh lebih mudah.
Versi mengawal anda .claude/agents/ folder. Rawat definisi subagen seperti kod — semakan, ujian dan versi pin. Ini mengurangkan drift dan memudahkan audit.
Sematkan alatan dan model dengan sengaja. Penggunaan model: inherit apabila anda mahu tingkah laku yang konsisten dengan perbualan utama; tentukan alias model kos rendah untuk imbasan latar belakang. Kunci alat untuk meminimumkan permukaan serangan.

Corak operasi

Gunakan doa yang jelas untuk automasi deterministik. Jika anda menjalankan kerja atau cangkuk CI, hubungi subagen tertentu untuk memastikan hasil yang boleh diramal.
Gunakan perwakilan automatik dalam sesi interaktif. Untuk kerja penerokaan, biarkan Claude memilih subagen untuk mengurangkan geseran — tetapi buat description medan disengajakan supaya automasi tidak tercetus secara tidak dijangka.
Reka bentuk output berstruktur untuk sintesis. Paksa subagen untuk menulis ke fail atau menghasilkan JSON yang boleh dibaca oleh orkestra; yang memudahkan langkah mengurangkan dan pengauditan.

Pengujian, pemantauan, dan tadbir urus

Bina eval perwakilan. Jejaki di mana subagen gagal dan bina ujian yang menggunakan mod kegagalan tersebut. Anthropic mengesyorkan set ujian perwakilan dan penambahbaikan berulang.
Pantau penggunaan token dan alat. Instrumen penggunaan setiap subagen dan tambah makluman untuk mengesan kos lari atau keadaan had kadar.

Apabila TIDAK menggunakan subagen

Subagen berkuasa tetapi tidak selalunya alat yang betul.

Tugas mudah: Pendek kata, gesaan sekali sahaja atau transformasi remeh, subagen menambah kerumitan yang tidak perlu.
Kekangan kependaman yang ketat: Perjalanan pergi dan balik orkestra menambah overhed; jika anda memerlukan satu pusingan, respons kependaman yang sangat rendah, pendekatan monolitik mungkin lebih mudah.
Pasukan kecil dengan sedikit infra: Tanpa perkakas untuk rahsia, kebolehmerhatian dan kotak pasir, subagen boleh meningkatkan risiko operasi. Artikel komuniti menekankan permulaan kecil dan menambah subagen apabila anda memerlukan modulariti.

Tempat untuk menggunakan kod Claude cli paling disyorkan

Sangat teruja mengumumkan bahawa CometAPI kini menyokong sepenuhnya cli Claude Code yang berkuasa. Anda hanya perlu memasang Kod Claude dan mengesahkan dengan kunci API Comet dan alamat asas yang diperolehi untuk menggunakan model API Komet pada Kod Claude.

Mengapa menggunakan kod klaude melalui CometAPI?

Ciri Kecerdasan Buatan Teratas: Menjana, nyahpepijat dan mengoptimumkan kod dengan mudah menggunakan model yang dibina khusus untuk pembangun.

Pemilihan Model Fleksibel: Rangkaian model kami yang komprehensif membolehkan anda membangun dengan lebih lancar.
Penyepaduan Lancar: API sentiasa tersedia. Sepadukan Kod Claude terus ke dalam aliran kerja sedia ada anda dalam beberapa minit.
Menggunakan Kod Claude melalui CometAPI akan menjimatkan lebih banyak kos. API Claude yang disediakan oleh CometAPI adalah diskaun 20% daripada harga rasmi dan dikemas kini dengan model terkini oleh pihak rasmi.

Bersedia untuk menggunakan Claude Code cli? berunding dengan Panduan API untuk arahan terperinci.

Jika anda ingin mengetahui lebih banyak petua, panduan dan berita tentang AI, ikuti kami VK, X and Perpecahan!

Kesimpulan — mengapa subagen penting sekarang

Subagen membuat janji aliran kerja ejentik praktikal untuk pasukan: mereka membenarkan anda membuat alasan tentang peranan, kebenaran, konteks, kos dan keselarian secara eksplisit dan sebagai objek kelas pertama. Apabila digunakan dengan bijak, subagen membuka kunci halaju pembangun yang lebih tinggi, kualiti yang lebih baik pada tugasan berbilang langkah dan tadbir urus yang lebih boleh diramal. Sebaliknya ialah anda mesti mereka bentuk, menguji dan memantau subagen ini sama seperti perisian pengeluaran — tetapi pelaburan itu mengubah kejuruteraan segera menjadi amalan kejuruteraan yang boleh dipercayai.