Kelola banyak agen dengan tampilan agen

Kirim dan kelola banyak sesi Claude Code dari satu layar. Tampilan agen menunjukkan apa yang dilakukan setiap sesi dan mana yang membutuhkan masukan Anda.

Tampilan agen, dibuka dengan claude agents, adalah satu layar untuk semua sesi latar belakang Anda: apa yang sedang berjalan, apa yang membutuhkan masukan Anda, dan apa yang sudah selesai. Kirim sesi baru, pantau keadaan mereka sekilas alih-alih menggulir transkrip, dan campur tangan hanya ketika ada yang membutuhkan Anda. Sesi terus berjalan di latar belakang tanpa terminal yang terpasang.

Gunakan tampilan agen ketika Anda memiliki beberapa tugas independen yang dapat dikerjakan Claude sekaligus, seperti memperbaiki bug, meninjau permintaan tarik, atau menyelidiki log. Ketika Anda ingin menyelesaikan masalah bersama-sama, lampirkan ke sesi dan gunakan Claude Code secara interaktif seperti biasanya.

Sesi dalam tampilan agen berjalan secara independen dan hanya melaporkan kepada Anda. Untuk membandingkan dengan subagen, tim agen, dan worktrees, lihat Jalankan agen secara paralel.

Halaman ini mencakup:

• Mulai cepat
• Pantau sesi dengan tampilan agen, termasuk ikon status, mengintip dan membalas, melampirkan, mengorganisir, dan pintasan keyboard
• Kirim agen baru dari tampilan agen, dari dalam sesi, atau dari shell
• Kelola sesi dari shell
• Bagaimana sesi latar belakang dihosting oleh proses supervisor

Mulai cepat

Panduan ini membuka tampilan agen, mengirim sesi, membalas dari panel intip, dan melampirkan untuk percakapan lengkap.

claude agents

Untuk membawa sesi interaktif yang ada ke tampilan agen, jalankan /bg di dalamnya, atau tekan ← pada prompt kosong untuk mengirim sesi ke latar belakang dan buka tampilan agen dalam satu langkah. Sesi terus berjalan di latar belakang dan muncul sebagai baris. Untuk memulai sesi latar belakang baru langsung dari shell, jalankan claude --bg "<prompt>".

Anda dapat menggunakan claude agents sebagai titik masuk utama Anda alih-alih claude: kirim setiap tugas dari tampilan agen, lampirkan ketika Anda menginginkan percakapan lengkap, dan tekan ← untuk kembali ke tabel.

Pantau sesi dengan tampilan agen

Jalankan claude agents untuk membuka tampilan agen. Ini mengambil alih terminal penuh dan mencantumkan setiap sesi yang dikelompokkan berdasarkan status, dengan sesi yang disematkan dan yang membutuhkan Anda di bagian atas. Setiap baris menunjukkan nama sesi, aktivitas saat ini, dan berapa lama yang lalu sesi terakhir berubah.

Daftar mencakup setiap sesi latar belakang di bawah direktori konfigurasi Anda, terlepas dari proyek atau worktree mana yang sedang dikerjakan, jadi sesi yang dimulai di satu repositori dan sesi lain yang dimulai di worktree berbeda keduanya muncul bersama. Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda mengirimnya ke latar belakang, dan subagents yang berjalan di dalam sesi tidak tercantum sebagai baris terpisah.

Disematkan
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Siap untuk ditinjau
  ∙ jump physics              github.com/anthropics/example/pull/2048    ●  2h

Membutuhkan masukan
  ✻ power-up design           needs input: double jump or wall climb?       1m

Bekerja
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Selesai
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

Ikon setiap baris membawa dua sinyal. Indikator memberi tahu Anda status sesi, dan bentuk ikon memberi tahu Anda apakah proses yang mendasarinya masih berjalan. Status-statusnya adalah:

Bentuk ikon memberi tahu Anda apakah proses yang mendasarinya masih berjalan. ✻, atau ✽ animasi saat Claude bekerja, berarti sesi masih hidup dan Anda dapat membalasnya segera. ∙ berarti proses telah keluar, tetapi Anda masih dapat mengintip, membalas, atau melampirkan: Claude memulai ulang sesi dari tempat ia berhenti. ✢ adalah sesi /loop yang tidur di antara iterasi, dengan baris menunjukkan jumlah jalannya dan hitungan mundur ke iterasi berikutnya.

Sesi latar belakang tidak memerlukan terminal apa pun yang terbuka untuk terus bekerja. Proses supervisor terpisah menjalankannya, jadi Anda dapat menutup tampilan agen, menutup shell, atau memulai sesi interaktif baru dan pekerjaan yang dikirim terus berlanjut.

Sesi bertahan di disk: menutup terminal atau pembaruan otomatis tidak akan kehilangannya, dan membuka kembali claude agents menunjukkan semuanya. Jika mesin Anda tidur atau dimatikan, sesi yang berjalan berhenti; mulai ulang dengan claude respawn --all.

Ringkasan satu baris di setiap baris dihasilkan oleh model kelas Haiku yang dikonfigurasi sehingga baris dapat memberi tahu Anda apa yang dilakukan sesi, apa yang dibutuhkannya, atau apa yang dihasilkannya tanpa membuka transkrip. Saat sesi secara aktif bekerja, ringkasan menyegarkan paling banyak sekali setiap 15 detik, ditambah sekali ketika setiap giliran berakhir. Setiap penyegaran adalah satu permintaan kelas Haiku pendek melalui penyedia normal Anda, ditagih dan ditangani di bawah persyaratan penggunaan data yang sama dengan sesi itu sendiri.

Ketika sesi membuka permintaan tarik, titik status muncul di tepi kanan baris, tertaut ke permintaan tarik di terminal yang mendukung hyperlink. Ketika sesi telah membuka lebih dari satu permintaan tarik, jumlahnya muncul sebelum titik dan warna mencerminkan mana pun yang paling membutuhkan perhatian.

Untuk sebagian besar tugas, baris ini adalah tempat Anda mengambil hasilnya: tinjau dan gabungkan permintaan tarik ketika titik berubah menjadi hijau.

Intip dan balas

Tekan Space pada baris yang dipilih untuk membuka panel intip. Ini menunjukkan apa yang dibutuhkan sesi dari Anda, output terakhirnya, dan permintaan tarik apa pun yang dibukanya. Sebagian besar waktu ini cukup, dan Anda tidak perlu membuka transkrip lengkap.

Ketik balasan di panel intip dan tekan Enter untuk mengirimnya ke sesi itu. Ketika sesi mengajukan pertanyaan pilihan ganda, panel intip menunjukkan opsi dan Anda dapat menekan tombol angka untuk memilih satu. Untuk sesi terhalang lainnya, tekan Tab untuk mengisi input dengan balasan yang disarankan yang dapat Anda edit sebelum mengirim. Awali balasan dengan ! untuk mengirim perintah Bash sebagai gantinya.

Gunakan ↑ dan ↓ untuk mengintip sesi yang berdekatan tanpa menutup panel, atau → untuk melampirkan.

Lampirkan ke sesi

Tekan Enter atau → pada baris yang dipilih untuk melampirkan, atau tekan Alt+1 hingga Alt+9 untuk melampirkan langsung ke sesi ke-N dalam grup yang difokuskan. Tampilan agen diganti oleh sesi interaktif lengkap, persis seolah-olah Anda telah menjalankan claude di direktori itu. Ketika Anda melampirkan, Claude memposting ringkasan singkat tentang apa yang terjadi saat Anda pergi.

Saat dilampirkan, sesi berperilaku seperti sesi Claude Code lainnya: setiap perintah, pintasan keyboard, dan fitur berfungsi.

Tekan ← pada prompt kosong untuk melepaskan dan kembali ke tampilan agen. Jika dialog memiliki fokus dan tidak merespons ←, tekan Ctrl+Z untuk melepaskan segera.

Melepaskan tidak pernah menghentikan sesi latar belakang: ←, Ctrl+C, Ctrl+D, Ctrl+Z, dan /exit semuanya membiarkannya berjalan. Untuk mengakhiri sesi dari dalamnya, jalankan /stop.

Setelah Anda telah mengirim atau mengirim sesi ke latar belakang, menekan ← pada prompt kosong berfungsi dari sesi Claude Code apa pun, bukan hanya yang Anda lampirkan. Ini mengirim sesi saat ini ke latar belakang dan membuka tampilan agen dengan sesi itu yang dipilih sebelumnya, sehingga Anda dapat beralih sesi tanpa meninggalkan terminal. Anda dapat mematikan pintasan ini di /config.

Atur daftar

Tampilan agen mengelompokkan sesi berdasarkan status, dengan sesi yang membutuhkan masukan di atas sesi yang bekerja atau selesai. Tekan Ctrl+S untuk beralih ke pengelompokan berdasarkan direktori sebagai gantinya. Pilihan Anda disimpan di seluruh jalankan. Dalam grup, sematkan sesi ke atas dengan Ctrl+T, atur ulang dengan Shift+↑ dan Shift+↓, atau tekan Enter pada header grup untuk menutupnya. Untuk menghapus sesi, tekan Ctrl+X untuk menghentikannya dan Ctrl+X lagi dalam dua detik untuk menghapusnya. Menekan Ctrl+X pada header grup menghapus setiap sesi dalam grup itu setelah konfirmasi.

Sesi yang selesai lebih lama dilipat menjadi baris "… N more" untuk menjaga daftar tetap pendek. Kegagalan dan sesi dengan permintaan tarik terbuka selalu tetap terlihat.

Filter daftar

Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:

Pintasan keyboard

Tekan ? di tampilan agen untuk melihat setiap pintasan. Yang paling umum:

Kirim agen baru

Anda dapat mengirim sesi latar belakang baru dari tampilan agen, mengirim sesi interaktif yang ada ke latar belakang, atau memulai satu langsung dari shell.

Dari tampilan agen

Ketik prompt dalam input di bagian bawah tampilan agen dan tekan Enter untuk memulai sesi latar belakang baru. Sesi diberi nama secara otomatis dari prompt. Anda dapat mengganti namanya nanti dengan Ctrl+R. Tempel gambar ke dalam prompt untuk menyertakan tangkapan layar atau diagram dengan tugas.

Awali atau sebutkan bagian dari prompt untuk mengontrol bagaimana sesi dimulai:

Ketik / untuk mengirim skill. Mengemas tugas berulang sebagai skill memungkinkan Anda memulai alur kerja yang sama berkali-kali dari tampilan agen tanpa mengetik ulang prompt. Tekan Tab pada input kosong untuk menelusuri setiap subagent yang dapat dikirim, atau untuk menerapkan saran yang disorot ketika saran ditampilkan.

Ketika @name yang sama cocok dengan subagent dan repositori saudara, subagent memiliki prioritas. Bentuk kata pertama tanpa @ juga berlaku untuk nama subagent apa pun, jadi prompt yang dimulai dengan kata yang cocok dengan salah satu nama subagent Anda mengirim subagent itu. Gunakan bentuk @ ketika Anda ingin eksplisit.

Kirim ke direktori tertentu

Sesi baru berjalan di direktori tempat Anda membuka tampilan agen. Untuk menargetkan direktori berbeda:

• Buka claude agents di direktori itu.
• Buka claude agents di direktori induk yang menyimpan beberapa repositori dan sebutkan satu dengan @<repo> dalam prompt untuk menjalankan sesi di sana.
• Dari shell, cd ke direktori dan jalankan claude --bg "<prompt>".

Ketika tampilan agen dikelompokkan berdasarkan direktori, direktori baris yang disorot menjadi target pengiriman, sehingga Anda dapat menggulir ke grup dan mengirim ke dalamnya tanpa mengetik ulang jalur.

Dari dalam sesi

Jalankan /background atau aliasnya /bg untuk melepaskan percakapan saat ini dan membiarkannya berjalan. Berikan prompt seperti /bg run the test suite and fix any failures untuk mengirim satu instruksi lagi sebelum melepaskan.

Dari shell

Berikan --bg untuk memulai sesi yang langsung masuk ke latar belakang:

claude --bg "investigate the flaky SettingsChangeDetector test"

Untuk menjalankan subagent tertentu sebagai agen utama sesi, gabungkan --bg dengan --agent:

claude --agent code-reviewer --bg "address review comments on PR 1234"

Setelah mengirim ke latar belakang, Claude mencetak ID pendek sesi dan perintah untuk mengelolanya:

backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

Bagaimana pengeditan file diisolasi

Setiap sesi latar belakang, baik dimulai dari tampilan agen, /bg, atau claude --bg, dimulai di direktori kerja Anda tetapi diblokir dari menulis file di sana. Ketika sesi perlu mengedit file, Claude memindahkannya ke git worktree yang terisolasi di bawah .claude/worktrees/ secara otomatis, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri. Blokir tidak berlaku ketika sesi sudah berada di dalam worktree, ketika direktori kerja bukan repositori git, atau untuk penulisan di luar direktori kerja.

Worktree dihapus ketika Anda menghapus sesi, jadi gabungkan atau dorong perubahan yang ingin Anda simpan sebelum Anda menghapus. Untuk menemukan jalur worktree sesi, intip sesi atau lampirkan dan periksa direktori kerjanya.

Untuk membuat subagent selalu berjalan di worktree-nya sendiri terlepas dari cara dimulainya, atur isolation: worktree dalam frontmatter-nya.

Mode izin dan pengaturan

Sesi yang dikirim membaca pengaturan dan mode izin dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai claude di sana. Mengirim dari input tampilan agen tidak melewatkan mode izin, jadi sesi menggunakan defaultMode dari pengaturan direktori itu atau permissionMode dari frontmatter subagent yang dikirim.

Untuk menetapkan mode dari shell, berikan --permission-mode dengan claude --bg. Menggunakan bypassPermissions atau auto dengan cara ini ditolak sampai Anda telah menerima mode itu dengan menjalankan claude dengannya sekali secara interaktif, karena mode tersebut memungkinkan sesi yang tidak Anda tonton bertindak tanpa persetujuan.

Kelola sesi dari shell

Setiap sesi latar belakang memiliki ID pendek yang dapat Anda gunakan dari shell. Perintah ini berguna untuk scripting atau ketika Anda tidak ingin membuka tampilan agen.

Bagaimana sesi latar belakang dihosting

Sesi latar belakang dihosting oleh proses supervisor per-pengguna, terpisah dari terminal Anda dan dari tampilan agen. Ini dimulai secara otomatis pertama kali Anda mengirim sesi ke latar belakang atau membuka tampilan agen, dan Anda tidak mengelolanya secara langsung. Supervisor dan sesinya mengautentikasi dengan kredensial yang sama dengan sesi interaktif Anda dan tidak membuat koneksi jaringan tambahan di luar API model.

Setiap sesi latar belakang adalah proses Claude Code-nya sendiri, induk ke supervisor daripada ke terminal Anda. Sesi yang secara aktif bekerja, menunggu masukan Anda, atau memiliki terminal yang terpasang membuat prosesnya tetap berjalan. Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Transkrip dan status tetap di disk, dan lain kali Anda melampirkan, mengintip, atau membalas, supervisor memulai proses segar dari tempat ia berhenti. Ketika setiap sesi selesai dan tidak ada terminal yang terhubung, supervisor itu sendiri keluar dan dimulai lagi lain kali Anda mengirim sesi ke latar belakang atau membuka tampilan agen.

Supervisor menonton biner Claude Code yang diinstal di disk dan memulai ulang ke versi baru setelah auto-updater reguler menggantinya. Ini adalah pengawasan file lokal, bukan pemeriksaan jaringan. Sesi latar belakang adalah proses terlepas, jadi mereka terus berjalan melalui restart dan supervisor baru terhubung kembali ke mereka.

Status sesi disimpan di bawah direktori konfigurasi Claude Code Anda. Jika Anda menetapkan CLAUDE_CONFIG_DIR, supervisor menggunakan direktori itu alih-alih ~/.claude dan berjalan sebagai instans terpisah dengan sesinya sendiri.

Untuk mematikan agen latar belakang dan tampilan agen sepenuhnya, atur pengaturan disableAgentView setting ke true atau atur variabel lingkungan CLAUDE_CODE_DISABLE_AGENT_VIEW. Administrator dapat memberlakukan ini melalui pengaturan terkelola.

Troubleshooting

Tampilan agen terbuka tanpa sesi

Tampilan agen kosong sampai Anda mengirim sesi pertama Anda. Ketik prompt dalam input di bagian bawah dan tekan Enter.

Sesi menampilkan sebagai dihentikan setelah mesin Anda bangun

Sesi latar belakang tidak bertahan tidur atau shutdown. Lampirkan, intip, atau balas sesi yang dihentikan apa pun dan sesi itu dimulai ulang dari tempat ia berhenti. Untuk memulai ulang semuanya sekaligus, jalankan claude respawn --all.

Sesi lambat merespons setelah melampirkan

Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Melampirkan memulai proses segar dari tempat ia berhenti, yang membutuhkan waktu sebentar. Sesi yang bekerja atau menunggu Anda tidak pernah dihentikan dengan cara ini.

.claude/worktrees/ penuh

Worktrees dihapus ketika Anda menghapus sesi yang membuatnya. Jika sesi berakhir tanpa membersihkan, daftar entri sisa dengan git worktree list di direktori proyek dan hapus masing-masing dengan git worktree remove <path>. Lihat Bersihkan worktrees.

Keterbatasan

Tampilan agen adalah pratinjau penelitian. Keterbatasan saat ini yang perlu diperhatikan:

• Batas laju berlaku: sesi latar belakang mengurangi penggunaan langganan Anda sama seperti sesi interaktif, jadi menjalankan sepuluh agen secara paralel menggunakan kuota sepuluh kali lebih cepat daripada menjalankan satu.
• Sesi bersifat lokal: sesi latar belakang berjalan di mesin Anda dan berhenti jika mesin tidur atau dimatikan.
• Worktrees dihapus dengan sesi: gabungkan atau dorong perubahan sebelum menghapus sesi yang mengedit file di worktree-nya sendiri.

Langkah berikutnya

Sekarang Anda memahami tampilan agen, jelajahi fitur terkait ini:

• Jalankan agen secara paralel: bandingkan tampilan agen dengan subagents, tim agen, dan worktrees
• Subagents: tentukan konfigurasi agen yang dapat digunakan kembali dengan prompt, alat, dan isolasi kustom
• Agent teams: koordinasikan beberapa sesi yang saling berpesan
• Claude Code di web: jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal