Kelola banyak agen dengan tampilan agen

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. Setiap sesi latar belakang adalah percakapan Claude Code lengkap yang terus berjalan tanpa terminal yang terpasang, sehingga Anda dapat membukanya, membalas, dan pergi kapan saja.

Tampilan agen di terminal: header menunjukkan Claude Code v2.1.140, model, direktori kerja, dan ringkasan jumlah. Sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai, dengan input pengiriman di bagian bawah dan footer petunjuk keyboard.

Gunakan tampilan agen ketika Anda memiliki beberapa tugas independen yang dapat dikerjakan Claude tanpa Anda menonton setiap langkah. Kirim perbaikan bug, tinjauan permintaan tarik, dan investigasi tes yang tidak stabil sebagai tiga baris, terus bekerja di jendela lain, dan periksa kembali ketika baris menunjukkan bahwa itu membutuhkan Anda atau memiliki hasil. Ketika Anda ingin bekerja lebih langsung di sesi agen mana pun, lampirkan ke baris untuk memasuki percakapan lengkap. Untuk membandingkan tampilan agen dengan subagen, tim agen, dan worktrees, lihat Jalankan agen secara paralel.

Tampilan agen adalah pratinjau penelitian dan memerlukan Claude Code v2.1.139 atau lebih baru. Periksa versi Anda dengan claude --version. Antarmuka dan pintasan keyboard mungkin berubah seiring dengan evolusi fitur.

Halaman ini mencakup:

Mulai cepat: berikan Claude tugas untuk dikerjakan di latar belakang, periksa, dan campur tangan ketika diperlukan
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 Anda
Kelola sesi dari shell
Bagaimana sesi latar belakang dihosting oleh proses supervisor

Mulai cepat

Panduan ini mencakup loop tampilan agen inti: kirim tugas, tonton barisnya diperbarui saat Claude bekerja, intip untuk memeriksanya dan balas, serta lampirkan untuk percakapan lengkap. Sesi yang Anda kirim terus berjalan setelah Anda menutup tampilan agen, jadi Anda dapat pergi dan kembali ke sesi tersebut.

Buka tampilan agen

Dari shell Anda, jalankan:

claude agents

Tampilan agen terbuka dengan input di bagian bawah dan tabel yang terisi saat sesi dimulai. Tekan Esc kapan saja untuk kembali ke shell Anda. Sesi Anda terus berjalan saat Anda pergi dan muncul kembali saat Anda membuka tampilan agen berikutnya.

Kirim sesi

Ketik prompt yang menjelaskan tugas dan tekan Enter. Sesi latar belakang baru dimulai pada tugas tersebut dan muncul sebagai baris yang menunjukkan apakah sedang bekerja, menunggu Anda, atau selesai. Sesi baru menggunakan model yang ditampilkan di header tampilan agen dan mode izin yang sama seperti yang Anda dapatkan saat menjalankan claude di direktori tersebut.Setiap prompt yang Anda masukkan di sini memulai sesi baru sendiri. Mengetik prompt lain dan menekan Enter meluncurkan sesi kedua bersama yang pertama daripada mengirim tindak lanjut ke sesi tersebut. Anda dapat menjalankan beberapa secara paralel dengan cara ini.Setiap sesi menggunakan kuota langganan Anda secara independen, jadi lihat Batasan sebelum mengirim banyak sekaligus.

Intip dan balas

Pilih baris dengan tombol panah dan tekan Space untuk membuka panel intip. Panel ini menampilkan output terbaru sesi atau pertanyaan yang sedang ditunggu, bukan transkrip lengkap. Ketik balasan dan tekan Enter untuk mengirimnya tanpa meninggalkan tampilan agen.

Lampirkan dan lepaskan

Tekan Enter atau → pada baris untuk melampirkan ketika Anda menginginkan percakapan lengkap. Sesi mengambil alih terminal persis seolah-olah Anda telah menjalankan claude. Tekan ← pada prompt kosong untuk melepaskan dan kembali ke tabel.

Bawa sesi yang ada ke dalam

Untuk memindahkan sesi yang sudah Anda buka ke tampilan agen, jalankan /bg di dalamnya, atau tekan ← pada prompt kosong untuk mengirimnya ke latar belakang dan membuka tampilan agen dalam satu langkah. Sesi terus berjalan dan muncul sebagai baris bersama yang Anda kirim.

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 menampilkan setiap sesi latar belakang yang telah Anda mulai, di seluruh semua proyek Anda. Sesi yang bekerja di satu repositori dan sesi lain di worktree berbeda keduanya muncul di sini, terlepas dari direktori mana yang Anda buka tampilan agen dari. Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda mengirimnya ke latar belakang. Subagents dan teammates yang sesi hasilkan tidak tercantum sebagai baris terpisah.

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

Siap untuk ditinjau
  ∙ jump physics              github.com/example/game/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

Baca status sesi

Setiap baris dimulai dengan ikon yang warna dan animasinya menunjukkan status sesi:

Status	Ikon ditampilkan sebagai	Artinya
Bekerja	Animasi	Claude secara aktif menjalankan alat atau menghasilkan respons
Membutuhkan masukan	Kuning	Claude menunggu pertanyaan spesifik atau keputusan izin dari Anda
Menganggur	Redup	Sesi tidak memiliki apa pun untuk dilakukan dan siap untuk prompt berikutnya Anda
Selesai	Hijau	Tugas selesai dengan sukses
Gagal	Merah	Tugas berakhir dengan kesalahan
Dihentikan	Abu-abu	Sesi dihentikan dengan `Ctrl+X` atau `claude stop`

Secara terpisah, bentuk ikon menunjukkan apakah proses yang mendasarinya sedang berjalan:

Bentuk	Artinya
`✻` atau `✽` animasi	Proses sesi masih hidup dan merespons segera
`∙`	Proses telah keluar. Anda masih dapat mengintip, membalas, atau melampirkan, dan Claude memulai ulang dari tempat ia berhenti
`✢`	Sesi `/loop` yang tidur di antara iterasi. Baris menunjukkan jumlah jalannya dan hitungan mundur

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. Status sesi bertahan di disk melalui pembaruan otomatis dan restart supervisor. Jika mesin Anda tidur atau dimatikan, sesi yang berjalan berhenti; mulai ulang dengan claude respawn --all.

Ringkasan baris

Ringkasan satu baris di setiap baris dihasilkan oleh model kelas Haiku 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.

Status permintaan tarik

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.

Warna titik	Status permintaan tarik
Kuning	Menunggu pemeriksaan atau tinjauan, atau pemeriksaan gagal
Hijau	Pemeriksaan lulus dan tidak ada tinjauan yang memblokir
Ungu	Digabungkan
Abu-abu	Draf atau ditutup

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. 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 sehingga yang membutuhkan masukan berada di atas, dengan Siap untuk ditinjau dan Membutuhkan masukan di atas Bekerja dan Selesai. Nama grup ini tidak memetakan satu-ke-satu ke status di atas: sesi bergerak ke Siap untuk ditinjau ketika memiliki permintaan tarik terbuka, dan Selesai mengumpulkan sesi yang selesai, gagal, dan dihentikan bersama-sama. Tekan Ctrl+S untuk mengelompokkan berdasarkan direktori sebagai gantinya. Pilihan Anda bertahan di seluruh jalankan. Dalam grup:

Tekan Ctrl+T untuk menyematkan sesi ke atas
Tekan Shift+↑ atau Shift+↓ untuk mengatur ulang sesi
Tekan Ctrl+R untuk mengganti nama sesi
Tekan Enter pada header grup untuk menutupnya

Untuk menghapus sesi dari daftar, 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. Menghapus menghapus sesi dari tampilan agen dan membersihkan worktree nya, termasuk perubahan yang tidak dikomitkan di dalamnya, jadi dorong atau komitkan pekerjaan yang ingin Anda simpan sebelum menghapus. Transkrip percakapan tetap di disk dan tetap tersedia melalui claude --resume. 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 sesi

Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:

Filter	Menampilkan
`a:<name>`	Sesi yang menjalankan agen bernama
`s:<state>`	Sesi dalam status tertentu, seperti `s:working`. Juga menerima `s:blocked` untuk semua yang menunggu Anda
`#<number>` atau URL PR	Sesi yang bekerja pada permintaan tarik itu

Pintasan keyboard

Tekan ? di tampilan agen untuk melihat setiap pintasan dalam konteks. Tabel di bawah merangkumnya.

Pintasan	Tindakan
`↑` / `↓`	Pindah antar baris
`Enter`	Lampirkan ke sesi yang dipilih, atau kirim jika ada teks dalam input
`Space`	Buka atau tutup panel intip untuk sesi yang dipilih
`Shift+Enter`	Kirim dan lampirkan segera
`→`	Lampirkan ke sesi yang dipilih
`Alt+1`..`Alt+9`	Lampirkan ke sesi 1–9 dalam grup saat ini
`Tab`	Pada input kosong, telusuri semua subagents. Jika tidak, terapkan saran yang disorot
`Ctrl+S`	Alihkan pengelompokan antara status dan direktori
`Ctrl+T`	Sematkan atau lepas sematkan sesi yang dipilih
`Ctrl+R`	Ganti nama sesi yang dipilih
`Ctrl+G`	Buka prompt pengiriman di `$EDITOR` Anda
`Ctrl+X`	Hentikan sesi; tekan lagi dalam dua detik untuk menghapusnya
`Shift+↑` / `Shift+↓`	Atur ulang sesi yang dipilih
`Esc`	Tutup panel intip, hapus input, atau keluar
`Ctrl+C`	Hapus input; tekan dua kali untuk keluar
`?`	Tampilkan semua pintasan

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; ubah 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:

Input	Efek
`<agent-name> <prompt>`	Jika kata pertama cocok dengan nama subagent kustom, subagent itu berjalan sebagai agen utama sesi dengan konfigurasi dari frontmatter-nya
`@<agent-name>`	Sebutkan subagent kustom di mana saja dalam prompt untuk menjalankannya sebagai agen utama
`@<repo>`	Sebutkan repositori di bawah direktori tempat Anda membuka tampilan agen untuk menjalankan sesi di sana
`/<skill>`	Sarankan skills untuk dikirim sebagai prompt
`#<number>` atau URL permintaan tarik	Jika sesi sudah bekerja pada PR itu, pilih saja alih-alih mengirim
`Shift+Enter`	Kirim dan lampirkan segera ke sesi baru

Mengemas tugas berulang sebagai skill memungkinkan Anda memulai alur kerja yang sama dari tampilan agen berulang kali tanpa mengetik ulang prompt. Ketika @name yang sama cocok dengan subagent dan repositori saudara, subagent memiliki prioritas. Kecocokan kata pertama tanpa @ juga berlaku, jadi prompt yang dimulai dengan salah satu nama subagent Anda mengirim subagent itu daripada memperlakukan kata sebagai teks biasa. Gunakan bentuk @ ketika Anda ingin eksplisit, atau mulai prompt dengan kata berbeda untuk menghindari kecocokan.

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 memindahkan percakapan saat ini ke sesi latar belakang. Berikan prompt seperti /bg run the test suite and fix any failures untuk memberikan satu instruksi lagi terlebih dahulu. Melepaskan dari sesi interaktif memulai proses segar yang dilanjutkan dari percakapan yang disimpan, jadi menjalankan subagent, monitor, dan perintah latar belakang tidak ditransfer ke sesi itu. Claude meminta Anda untuk mengonfirmasi sebelum melepaskan ketika ada yang berjalan. Setelah berada di latar belakang, sesi dapat memulai subagent, monitor, dan perintah latar belakang baru, dan yang tersebut terus berjalan di seluruh detach dan reattach berikutnya.

Dari shell Anda

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 melepaskan 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. Sebelum mengedit file, Claude memindahkan sesi ke git worktree yang terisolasi di bawah .claude/worktrees/, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri. Claude melewati ini ketika sesi sudah berada di bawah .claude/worktrees/, ketika direktori kerja bukan repositori git, atau untuk penulisan di luar direktori kerja. Di luar repositori git, sesi menulis ke direktori kerja secara langsung dan tidak diisolasi satu sama lain, jadi hindari mengirim sesi paralel yang mengedit file yang sama. 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.

Atur model

Nama model yang ditampilkan di header tampilan agen adalah default pengiriman. Sesi baru yang Anda mulai dari input menggunakan model ini, yang merupakan pengaturan yang sama yang /model kontrol dalam sesi apa pun. Untuk menimpanya untuk seluruh sesi tampilan agen, berikan --model saat membuka tampilan agen. Lihat Mode izin, model, dan upaya. Setiap sesi latar belakang dapat berjalan pada model berbeda. Untuk menimpanya untuk satu sesi:

Dari shell, berikan --model dengan claude --bg.
Lampirkan ke sesi yang berjalan dan jalankan /model di sana. Perubahan bertahan jika sesi direspawn.
Kirim subagent yang frontmatter-nya menetapkan bidang model.

Mode izin, model, dan upaya

Sesi yang dikirim membaca pengaturan dan mode izin dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai claude di sana. Untuk menetapkan default untuk setiap sesi yang Anda kirim dari tampilan agen, berikan salah satu dari --permission-mode, --model, atau --effort saat membukanya:

claude agents --permission-mode plan --model opus --effort high

Default aktif muncul di footer di bawah input pengiriman. Tanpa flag ini, sesi menggunakan defaultMode dari pengaturan direktori itu atau permissionMode dari frontmatter subagent yang dikirim, dan model yang ditampilkan di header tampilan agen. Menggunakan bypassPermissions atau auto 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. Hal yang sama berlaku apakah Anda meneruskan mode ke claude agents atau ke claude --bg --permission-mode.

Pengaturan, plugin, dan server MCP

Tampilan agen menerima flag konfigurasi yang sama dengan claude untuk memuat pengaturan, plugin, server MCP, dan direktori tambahan. Setiap flag berlaku untuk tampilan agen itu sendiri dan diteruskan ke setiap sesi yang Anda kirim darinya, jadi plugin atau server MCP yang Anda muat dengan cara ini tersedia di sesi tersebut juga.

Flag	Efek
`--settings <file-or-json>`	Menimpa pengaturan untuk tampilan agen dan sesi yang dikirim
`--add-dir <path>`	Memberikan akses file ke direktori tambahan
`--plugin-dir <path>`	Memuat plugin dari direktori lokal
`--mcp-config <file-or-json>`	Memuat server MCP dari file konfigurasi atau string JSON
`--strict-mcp-config`	Gunakan hanya server MCP dari `--mcp-config`, abaikan konfigurasi MCP lainnya

Ulangi --add-dir, --plugin-dir, atau --mcp-config sekali per nilai. Bentuk yang dipisahkan spasi, seperti --add-dir a b c, tidak didukung dengan claude agents. Contoh berikut membuka tampilan agen dengan penimpaan pengaturan dan satu direktori tambahan:

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

Kelola sesi dari shell

Setiap sesi latar belakang memiliki ID pendek yang dapat Anda gunakan dari shell. ID dicetak ketika Anda memulai sesi dengan claude --bg, dan ID setiap sesi adalah nama direktorinya di bawah ~/.claude/jobs/. Perintah-perintah ini berguna untuk scripting atau ketika Anda tidak ingin membuka tampilan agen.

Perintah	Tujuan
`claude agents`	Buka tampilan agen
`claude attach <id>`	Lampirkan ke sesi di terminal ini
`claude logs <id>`	Cetak output terbaru sesi
`claude stop <id>`	Hentikan sesi. Juga menerima `claude kill`
`claude respawn <id>`	Mulai ulang sesi yang dihentikan dengan percakapannya tetap utuh
`claude respawn --all`	Mulai ulang setiap sesi yang dihentikan
`claude rm <id>`	Hapus sesi dari daftar. Membersihkan worktree-nya jika tidak ada perubahan yang belum di-commit

Bagaimana sesi latar belakang dihosting

Setiap sesi yang tercantum dalam tampilan agen dianggap sebagai sesi latar belakang, terlepas dari apakah Anda saat ini terhubung ke sesinya atau tidak. Sebaliknya, sesi yang dimulai dengan menjalankan claude secara langsung terikat pada terminal itu dan berakhir ketika terminal ditutup, kecuali Anda mengirimnya ke latar belakang.

Proses supervisor

Sesi latar belakang dihosting oleh proses supervisor per-pengguna, terpisah dari terminal Anda dan dari tampilan agen. Supervisor 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, dikelola oleh supervisor daripada terikat pada 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 membutuhkannya. Supervisor memantau 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.

Tempat status disimpan

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.

Jalur	Isi
`~/.claude/daemon.log`	Log supervisor
`~/.claude/daemon/roster.json`	Daftar sesi latar belakang yang berjalan, digunakan untuk terhubung kembali setelah restart
`~/.claude/jobs/<id>/state.json`	Status per-sesi ditampilkan di tampilan agen

Matikan tampilan agen

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

`claude agents` menampilkan subagen alih-alih membuka tampilan agen

Jika claude agents mencetak hitungan diikuti oleh subagen yang dikonfigurasi dan kemudian keluar, tampilan agen tidak tersedia di lingkungan Anda. Versi sebelumnya tidak membuka tampilan agen di setiap lingkungan, termasuk saat terhubung melalui Bedrock, Vertex AI, atau Foundry. Jalankan claude update untuk menginstal versi terbaru. Jika tampilan agen masih tidak terbuka setelah memperbarui, periksa apakah telah dimatikan oleh pengaturan atau variabel lingkungan.

Tampilan agen terbuka tanpa sesi

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

Tidak dapat membuka agen karena tugas latar belakang sedang berjalan

Jika menekan ← untuk menempatkan sesi saat ini di latar belakang menunjukkan Cannot open agents — N background task(s) running, sesi memiliki pekerjaan yang sedang berlangsung seperti subagen, alur kerja, atau perintah shell latar belakang, dan pintasan tidak akan diam-diam meninggalkannya. Jalankan /tasks untuk melihat apa yang sedang berjalan, kemudian /bg untuk mengonfirmasi peninggalannya. Lihat Dari dalam sesi untuk apa yang ditransfer dan apa yang tidak saat Anda menempatkan di latar belakang.

Prompt ditolak karena terlalu pendek

Input pengiriman mengharapkan deskripsi tugas, bukan pembuka percakapan. Prompt yang lebih pendek dari empat karakter ditolak dengan petunjuk Too short sehingga keystroke yang tersesat tidak memulai sesi. Jelaskan apa yang ingin Anda lakukan sesi, seperti investigate the flaky checkout test.

Sesi menampilkan sebagai gagal setelah mesin Anda bangun

Sesi latar belakang tidak bertahan tidur atau shutdown, jadi sesi yang sedang berjalan menampilkan sebagai gagal setelah Anda bangun. Lampirkan, intip, atau balas sesi 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 dengan keterbatasan berikut:

Batas laju berlaku: sesi latar belakang menggunakan kuota langganan Anda sama seperti sesi interaktif, jadi menjalankan sepuluh agen secara paralel menggunakan kuota kira-kira 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.

Sumber daya terkait

Untuk cara lain menjalankan Claude secara paralel, lihat:

Jalankan agen secara paralel: bandingkan tampilan agen dengan subagents, tim agen, dan worktrees
Tim agen: koordinasikan beberapa sesi yang saling berpesan
Claude Code di web: jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal

Agen dan pekerjaan paralel

Alat dan plugin

Otomasi

Pemecahan Masalah

Kelola banyak agen dengan tampilan agen

Mulai cepat

Pantau sesi dengan tampilan agen

Baca status sesi

Ringkasan baris

Status permintaan tarik

Intip dan balas

Lampirkan ke sesi

Atur daftar

Filter sesi

Pintasan keyboard

Kirim agen baru

Dari tampilan agen

Kirim ke direktori tertentu

Dari dalam sesi

Dari shell Anda

Bagaimana pengeditan file diisolasi

Atur model

Mode izin, model, dan upaya

Pengaturan, plugin, dan server MCP

Kelola sesi dari shell

Bagaimana sesi latar belakang dihosting

Proses supervisor

Tempat status disimpan

Matikan tampilan agen

Troubleshooting

`claude agents` menampilkan subagen alih-alih membuka tampilan agen

Tampilan agen terbuka tanpa sesi

Tidak dapat membuka agen karena tugas latar belakang sedang berjalan

Prompt ditolak karena terlalu pendek

Sesi menampilkan sebagai gagal setelah mesin Anda bangun

Sesi lambat merespons setelah melampirkan

`.claude/worktrees/` penuh

Keterbatasan

Sumber daya terkait

Agen dan pekerjaan paralel

Alat dan plugin

Otomasi

Pemecahan Masalah

Documentation Index

​Mulai cepat

​Pantau sesi dengan tampilan agen

​Baca status sesi

​Ringkasan baris

​Status permintaan tarik

​Intip dan balas

​Lampirkan ke sesi

​Atur daftar

​Filter sesi

​Pintasan keyboard

​Kirim agen baru

​Dari tampilan agen

​Kirim ke direktori tertentu

​Dari dalam sesi

​Dari shell Anda

​Bagaimana pengeditan file diisolasi

​Atur model

​Mode izin, model, dan upaya

​Pengaturan, plugin, dan server MCP

​Kelola sesi dari shell

​Bagaimana sesi latar belakang dihosting

​Proses supervisor

​Tempat status disimpan

​Matikan tampilan agen

​Troubleshooting

​claude agents menampilkan subagen alih-alih membuka tampilan agen

​Tampilan agen terbuka tanpa sesi

​Tidak dapat membuka agen karena tugas latar belakang sedang berjalan

​Prompt ditolak karena terlalu pendek

​Sesi menampilkan sebagai gagal setelah mesin Anda bangun

​Sesi lambat merespons setelah melampirkan

​.claude/worktrees/ penuh

​Keterbatasan

​Sumber daya terkait

Mulai cepat

Pantau sesi dengan tampilan agen

Baca status sesi

Ringkasan baris

Status permintaan tarik

Intip dan balas

Lampirkan ke sesi

Atur daftar

Filter sesi

Pintasan keyboard

Kirim agen baru

Dari tampilan agen

Kirim ke direktori tertentu

Dari dalam sesi

Dari shell Anda

Bagaimana pengeditan file diisolasi

Atur model

Mode izin, model, dan upaya

Pengaturan, plugin, dan server MCP

Kelola sesi dari shell

Bagaimana sesi latar belakang dihosting

Proses supervisor

Tempat status disimpan

Matikan tampilan agen

Troubleshooting

`claude agents` menampilkan subagen alih-alih membuka tampilan agen

Tampilan agen terbuka tanpa sesi

Tidak dapat membuka agen karena tugas latar belakang sedang berjalan

Prompt ditolak karena terlalu pendek

Sesi menampilkan sebagai gagal setelah mesin Anda bangun

Sesi lambat merespons setelah melampirkan

`.claude/worktrees/` penuh

Keterbatasan

Sumber daya terkait