> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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. 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.
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](/id/agents).
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](#quick-start): berikan Claude tugas untuk dikerjakan di latar belakang, periksa, dan campur tangan ketika diperlukan
* [Pantau sesi dengan tampilan agen](#monitor-sessions-with-agent-view), termasuk ikon status, mengintip dan membalas, melampirkan, mengorganisir, dan pintasan keyboard
* [Kirim agen baru](#dispatch-new-agents) dari tampilan agen, dari dalam sesi, atau dari shell Anda
* [Kelola sesi dari shell](#manage-sessions-from-the-shell)
* [Bagaimana sesi latar belakang dihosting](#how-background-sessions-are-hosted) 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.
Dari shell Anda, jalankan:
```bash theme={null}
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.
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](#permission-mode-model-and-effort) 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](#limitations) sebelum mengirim banyak sekaligus.
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.
Tekan `Enter` atau `→` pada baris untuk melampirkan ketika Anda menginginkan percakapan lengkap. Sesi mengambil alih terminal sebagai sesi Claude Code interaktif penuh. Tekan `←` pada prompt kosong untuk melepaskan dan kembali ke tabel.
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.
Secara default, 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. Untuk membatasi daftar ke satu proyek, berikan `--cwd` (memerlukan Claude Code v2.1.141 atau lebih baru):
```bash theme={null}
claude agents --cwd ~/projects/my-app
```
Ini menampilkan hanya sesi yang dimulai di bawah direktori itu. Sesi yang telah [berpindah ke worktree](#how-file-edits-are-isolated) di bawah `~/projects/my-app/.claude/worktrees/` masih dihitung sebagai milik `~/projects/my-app`.
Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda [mengirimnya ke latar belakang](#from-inside-a-session). [Subagents](/id/sub-agents) dan [teammates](/id/agent-teams) yang sesi hasilkan tidak tercantum sebagai baris terpisah.
```text theme={null}
Disematkan
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
Siap untuk ditinjau
∙ jump physics Opened PR with collision fix PR #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`](/id/scheduled-tasks) yang tidur di antara iterasi. Baris menunjukkan jumlah jalannya dan hitungan mundur |
Label `PR #N` yang dapat muncul di tepi kanan baris adalah [status permintaan tarik](#pull-request-status) yang dibuka sesi, bukan bagian dari ikon status. Ketika sesi telah membuka lebih dari satu permintaan tarik, label menunjukkan hitungan sebagai gantinya, seperti `3 PRs`.
Judul tab terminal menunjukkan jumlah menunggu-masukan saat tampilan agen terbuka: `2 awaiting input · claude agents` ketika sesi membutuhkan masukan, atau `claude agents` ketika tidak ada.
Sesi latar belakang tidak memerlukan terminal apa pun yang terbuka untuk terus bekerja. [Proses supervisor](#the-supervisor-process) 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. Sesi juga dipertahankan ketika mesin Anda tidur. Proses mereka dilanjutkan saat bangun dan supervisor terhubung kembali ke mereka alih-alih memperlakukan celah waktu sebagai menganggur. Mematikan masih menghentikan sesi yang berjalan; lihat [Sesi menampilkan gagal setelah shutdown](#sessions-show-as-failed-after-shutdown) untuk cara memulihkannya.
Ringkasan baris
Ringkasan satu baris di setiap baris dihasilkan oleh [model kelas Haiku](/id/model-config) 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.
Dari v2.1.161, ketika sesi menjalankan dua atau lebih item kerja paralel, seperti subagents, perintah shell latar belakang, atau monitor, hitungan `done/total` seperti `2/5` muncul sebelum teks ringkasan.
Setiap penyegaran adalah satu permintaan kelas Haiku pendek melalui penyedia normal Anda, ditagih dan ditangani di bawah [persyaratan penggunaan data](/id/data-usage) yang sama dengan sesi itu sendiri. Pada penyedia pihak ketiga seperti Bedrock, Vertex AI, Microsoft Foundry, dan gateway khusus, permintaan kembali ke model utama sesi ketika tidak ada model Haiku yang dikonfigurasi. Atur [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/id/model-config#environment-variables) untuk memilih model untuk ringkasan ini pada penyedia tersebut.
Status permintaan tarik
Ketika sesi membuka permintaan tarik, label `PR #1234` muncul di tepi kanan baris, tertaut ke permintaan tarik di terminal yang mendukung hyperlink. Label bertahan ketika Anda mengirim tindak lanjut ke sesi, sehingga permintaan tarik tetap terlihat sementara baris kembali ke kemajuan langsung.
Ketika sesi telah membuka lebih dari satu permintaan tarik, label menunjukkan hitungan sebagai gantinya, seperti `3 PRs`, berwarna oleh permintaan tarik terbuka yang paling membutuhkan perhatian. Buka [panel intip](#peek-and-reply) untuk melihat semuanya.
Nomor permintaan tarik berwarna berdasarkan statusnya:
| Warna | 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, kolom ini adalah tempat Anda mengambil hasilnya: tinjau dan gabungkan permintaan tarik ketika nomornya 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.
Dari v2.1.161, ketika sesi menjalankan item kerja paralel, panel juga menyebutkan yang paling lama berjalan dan berapa lama sudah berjalan, sehingga Anda dapat melihat apa yang ditunggu sesi tanpa melampirkan.
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.
Dari v2.1.145, dengan [dikte suara](/id/voice-dictation) diaktifkan, tahan atau ketuk tombol push-to-talk Anda saat input balasan difokuskan untuk mendikte balasan alih-alih mengetiknya. Hal yang sama berlaku dalam input pengiriman di bagian bawah tampilan agen.
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. 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](/id/commands), pintasan keyboard, dan fitur berfungsi.
Sesi yang dilampirkan selalu dirender dalam [mode layar penuh](/id/fullscreen), terlepas dari pengaturan `tui` Anda, karena sesi latar belakang tidak memiliki scrollback terminal untuk ditambahkan. Gulir dengan `PgUp`, `PgDn`, atau roda mouse, dan tekan `Ctrl+O` untuk mode transkrip. Gulir asli terminal Anda dan mode salinan tmux hanya menampilkan viewport saat ini, sama seperti ketika Anda menjalankan aplikasi layar penuh apa pun.
Tekan `←` pada prompt kosong untuk melepaskan dan kembali ke tampilan agen. Jika dialog memiliki fokus dan tidak merespons `←`, tekan `Ctrl+Z` untuk melepaskan segera.
`Ctrl+C` mempertahankan perilaku interupsi standarnya saat dilampirkan: ini membatalkan respons yang sedang berjalan atau perintah shell `!` daripada melepaskan. Menekan `Ctrl+C` dua kali pada prompt kosong melepaskan, sama seperti di sesi apa pun.
Melepaskan tidak pernah menghentikan sesi latar belakang: `←`, `Ctrl+Z`, `/exit`, dan `Ctrl+C` ganda atau `Ctrl+D` ganda semuanya membiarkannya berjalan. Untuk mengakhiri sesi dari dalamnya, jalankan `/stop`.
Menekan `←` pada prompt kosong berfungsi dari sesi Claude Code apa pun, bukan hanya yang Anda lampirkan dari tampilan agen. Ini mengirim sesi saat ini ke latar belakang dan membuka tampilan agen dengan sesi itu yang dipilih, sehingga Anda dapat beralih sesi tanpa meninggalkan terminal. Baris dibuat bahkan dari sesi segar tanpa riwayat percakapan, jadi `→` kembali ke sana. Ketika baris itu adalah satu-satunya, tampilan agen menampilkan petunjuk onboarding di bawahnya. Anda dapat mematikan pintasan ini di `/config` (pengaturan `leftArrowOpensAgents`).
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](#read-session-state) 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 dan [menjaga proses tetap berjalan](#the-supervisor-process) saat menganggur
* 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. Jika Claude [membuat worktree](#how-file-edits-are-isolated) untuk sesi, menghapus menghapus worktree itu juga, termasuk perubahan yang tidak dikomitkan di dalamnya, jadi dorong atau komitkan pekerjaan yang ingin Anda simpan terlebih dahulu. Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat. Transkrip percakapan tetap berada di mesin lokal Anda 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:` | Sesi yang menjalankan agen bernama |
| `s:` | Sesi dalam status tertentu, seperti `s:working`. Juga menerima `s:blocked` untuk semua yang menunggu Anda |
| `#` atau URL PR | Sesi yang bekerja pada permintaan tarik itu |
| URL lainnya | Sesi yang prompt pertamanya berisi URL 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 direktori sesi yang difokuskan |
| `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 `$VISUAL` atau `$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 |
| :------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ` ` | Jika kata pertama cocok dengan nama [subagent](/id/sub-agents) kustom, subagent itu berjalan sebagai agen utama sesi dengan konfigurasi dari frontmatter-nya |
| `@` | Sebutkan subagent kustom di mana saja dalam prompt untuk menjalankannya sebagai agen utama |
| `@` | Sebutkan repositori di bawah direktori tempat Anda membuka tampilan agen untuk menjalankan sesi di sana |
| `/` | Sarankan [skills](/id/skills) dan [commands](/id/commands) untuk dikirim sebagai prompt |
| `! ` | Jalankan perintah shell sebagai pekerjaan latar belakang alih-alih memulai sesi Claude. Pekerjaan muncul sebagai baris yang dapat Anda lampirkan, tonton, dan lepaskan |
| `#` 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 |
Serangkaian kecil perintah berjalan dalam tampilan agen itu sendiri alih-alih mengirim: `/exit` dan `/quit` menutup tampilan agen, `/logout` menandatangani Anda keluar, dan `/model` menetapkan [model pengiriman](#set-the-model). Skills, perintah Anda sendiri, dan built-in yang memperluas prompt seperti `/init` dikirim ke sesi latar belakang baru sebagai prompt pertamanya. Perintah built-in lainnya menampilkan petunjuk `attach to a session to run it` sebagai gantinya.
Mengemas tugas berulang sebagai [skill](/id/skills) 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 `@` dalam prompt untuk menjalankan sesi di sana.
* Dari shell, `cd` ke direktori dan jalankan `claude --bg ""`.
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. Jika Claude sedang merespons ketika Anda menjalankan `/bg`, respons berlanjut dalam sesi latar belakang.
Melepaskan dari sesi interaktif memulai proses segar yang dilanjutkan dari percakapan yang disimpan, jadi menjalankan subagent, [monitor](/id/tools-reference#monitor-tool), 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.
Bendera konfigurasi dari peluncuran asli dibawa ke sesi yang dilepaskan ke latar belakang, sehingga server MCP, pengaturan, dan model fallback-nya tetap berlaku:
* `--mcp-config` dan `--strict-mcp-config`
* `--settings`
* `--add-dir`
* `--plugin-dir`
* `--fallback-model`
* `--allow-dangerously-skip-permissions`
Direktori yang Anda tambahkan selama sesi dengan [`/add-dir`](/id/permissions#additional-directories-grant-file-access-not-configuration) juga dibawa ke sesi.
Membawa `--allow-dangerously-skip-permissions` melalui membuat `bypassPermissions` dapat dijangkau dalam sesi yang dilepaskan ke latar belakang, tetapi tidak memberikan apa pun yang baru. Mode masih memerlukan penerimaan interaktif satu kali yang sama seperti yang dijelaskan dalam [Mode izin, model, dan upaya](#permission-mode-model-and-effort) sebelum sesi apa pun dapat menggunakannya.
Dari shell Anda
Berikan `--bg` atau bentuk panjangnya `--background` untuk memulai sesi yang langsung masuk ke latar belakang:
```bash theme={null}
claude --bg "investigate the flaky SettingsChangeDetector test"
```
Untuk menjalankan subagent tertentu sebagai agen utama sesi, gabungkan `--bg` dengan `--agent`:
```bash theme={null}
claude --agent code-reviewer --bg "address review comments on PR 1234"
```
Berikan `--name` untuk menetapkan nama tampilan sesi dalam tampilan agen alih-alih yang dibuat secara otomatis:
```bash theme={null}
claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"
```
Setelah melepaskan ke latar belakang, Claude mencetak ID pendek sesi dan perintah untuk mengelolanya. Ketika Anda memberikan `--name`, nama muncul setelah ID pendek:
```text theme={null}
backgrounded · 7c5dcf5d · flaky-test-fix
claude agents list sessions
claude attach 7c5dcf5d open in this terminal
claude logs 7c5dcf5d show recent output
claude stop 7c5dcf5d stop this session
```
Jalankan perintah shell
Untuk menjalankan perintah shell sebagai pekerjaan latar belakang alih-alih sesi Claude, ketik `!` sebagai karakter pertama dari input pengiriman tampilan agen. `!` ditampilkan sebagai awalan dan semua yang Anda ketik setelahnya adalah perintah. Contoh berikut mengirim `pytest -x` dari kotak input tampilan agen:
```text theme={null}
! pytest -x
```
Tekan `Enter` untuk memulai pekerjaan. Pekerjaan yang sama juga dapat diluncurkan langsung dari shell Anda dengan `--exec`:
```bash theme={null}
claude --bg --exec 'pytest -x'
```
Perintah berjalan sebagai pekerjaan yang didukung PTY dan muncul sebagai baris dalam tampilan agen, dengan baris output terbaru sebagai statusnya. Pekerjaan shell menjalankan perintah sebagai pengganti Claude, jadi tidak ada model yang dipanggil dan output tidak dikirim ke sesi apa pun.
Untuk melihat output, lampirkan ke baris, tekan `Space` untuk mengintip tanpa melampirkan, atau jalankan `claude logs ` dari shell Anda. Output yang ditangkap tetap berada dalam memori dan tidak ditulis ke disk. Baris dan outputnya dibersihkan secara otomatis sekitar lima menit setelah perintah keluar, jadi bacalah sebelum itu jika Anda memerlukan hasilnya.
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](/id/worktrees) yang terisolasi di bawah `.claude/worktrees/`, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri.
Claude melewati worktree ketika:
* Sesi sudah berada di dalam linked git worktree, baik Claude membuatnya di bawah `.claude/worktrees/` atau Anda membuatnya dengan `git worktree add` di tempat lain
* Direktori kerja bukan repositori git dan tidak ada [`WorktreeCreate` hook](/id/hooks#worktreecreate) yang dikonfigurasi
* Penulisan berada di luar direktori kerja
Untuk mematikan isolasi worktree untuk repositori tempat git worktree tidak praktis, atur [`worktree.bgIsolation`](/id/settings#worktree-settings) ke `"none"`. Sesi latar belakang kemudian mengedit salinan kerja Anda secara langsung tanpa pindah ke worktree terlebih dahulu. Tambahkan pengaturan ke `.claude/settings.json` proyek:
```json theme={null}
{
"worktree": {
"bgIsolation": "none"
}
}
```
Pengaturan `worktree.bgIsolation` memerlukan Claude Code v2.1.143 atau lebih baru.
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. Jika Anda menggunakan sistem kontrol versi yang berbeda, konfigurasikan [`WorktreeCreate` hook](/id/worktrees#non-git-version-control) dan Claude mengisolasi pengeditan dengan cara yang sama seperti yang dilakukannya untuk git.
Menghapus sesi dalam tampilan agen (`Ctrl+X` dua kali) menghapus worktree yang Claude buat untuk sesi itu, termasuk perubahan yang belum dikomit, jadi gabungkan atau dorong perubahan yang ingin Anda simpan terlebih dahulu. Menghapus dari shell dengan [`claude rm`](#manage-sessions-from-the-shell) menyimpan worktree yang memiliki perubahan yang belum dikomit dan mencetak jalurnya sehingga Anda dapat membersihkannya sendiri. Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat baik cara apa pun.
Untuk menemukan jalur worktree sesi, intip sesi atau lampirkan dan periksa direktori kerjanya.
Sebuah [subagent](/id/sub-agents) yang sesi latar belakang spawn mewarisi direktori kerja sesi, jadi pengeditan filenya mendarat di worktree sesi daripada salinan kerja Anda. Untuk memberikan subagent worktree terpisah sendiri, atur [`isolation: worktree`](/id/sub-agents#supported-frontmatter-fields) dalam frontmatter-nya atau berikan `isolation: "worktree"` saat spawn-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 berasal dari pengaturan [`model`](/id/settings#available-settings) dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih [`/model`](/id/model-config), atau edit pengaturan secara langsung. Untuk menimpanya untuk seluruh sesi tampilan agen, berikan `--model` saat membuka tampilan agen. Lihat [Mode izin, model, dan upaya](#permission-mode-model-and-effort).
Untuk mengubah default pengiriman dari dalam tampilan agen, ketik `/model` diikuti dengan nama model dalam input pengiriman dan tekan `Enter`. Header diperbarui untuk menampilkan model itu dengan penanda `(session)`, dan sesi yang Anda kirim setelahnya menggunakannya. Ketik `/model default` untuk menghapus penimpaan dan kembali ke default pengiriman. Penimpaan ini berlangsung untuk sisa dari `claude agents` saat ini, tidak menulis ke file pengaturan Anda, dan memerlukan Claude Code v2.1.172 atau lebih baru. {/* min-version: 2.1.172 */} Contoh berikut mengirim satu sesi pada Opus dan yang berikutnya pada Sonnet:
```text theme={null}
/model opus
refactor auth
/model sonnet
run the test suite
```
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, buka `/model`, dan tekan `s` pada model untuk beralih hanya untuk sesi itu. Perubahan bertahan jika sesi direspawn.
* Kirim [subagent](/id/sub-agents) yang frontmatter-nya menetapkan bidang `model`.
Mode izin, model, dan upaya
Sesi latar belakang membaca [pengaturan](/id/settings) dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai `claude` di sana. Ini mencakup nilai [`env`](/id/settings#available-settings) dalam pengaturan proyek, jadi `ANTHROPIC_MODEL` atau variabel penyedia yang ditetapkan di sana berlaku untuk sesi latar belakang di direktori itu.
Pemilihan penyedia cloud, seperti `CLAUDE_CODE_USE_BEDROCK` atau `CLAUDE_CODE_USE_VERTEX`, dan alias `ANTHROPIC_DEFAULT_*_MODEL` mengikuti shell yang mengirim sesi. Variabel endpoint gateway seperti `ANTHROPIC_BASE_URL` dan `ANTHROPIC_AUTH_TOKEN` pasangannya tidak. Lihat [proses supervisor](#the-supervisor-process) untuk cara sesi latar belakang bersumber pengaturan penyedia dan kredensial.
[Mode izin](/id/permissions) tergantung pada cara Anda memulai sesi. Melepaskan sesi yang ada dengan `/bg` atau `←` mempertahankan mode izin saat ini, jadi sesi yang Anda alihkan ke `acceptEdits` atau `auto` tetap dalam mode itu setelah detach. Mengirim dari input tampilan agen atau menjalankan `claude --bg` dari shell Anda menggunakan `defaultMode` dari pengaturan direktori itu, atau `permissionMode` dari [frontmatter subagent](/id/sub-agents#supported-frontmatter-fields) yang dikirim.
Mode izin, model, dan upaya yang sesi latar belakang dimulai dengan, bersama dengan [bendera konfigurasi yang dibawanya](#from-inside-a-session), semuanya bertahan ketika supervisor kemudian [menghentikan dan memulai ulang](#the-supervisor-process) prosesnya. Sesi yang Anda luncurkan dengan `claude --bg --dangerously-skip-permissions` atau `claude --bg --permission-mode bypassPermissions` tetap dalam `bypassPermissions` setelah restart itu alih-alih kembali ke `defaultMode` direktori, dan model atau upaya yang Anda ubah di tengah sesi dengan `/model` atau `/effort` disimpan.
Untuk menetapkan default untuk setiap sesi yang Anda kirim dari tampilan agen, berikan salah satu dari `--permission-mode`, `--model`, `--effort`, atau `--agent` saat membukanya:
```bash theme={null}
claude agents --permission-mode plan --model opus --effort high
```
`--agent` menetapkan [subagent](/id/sub-agents) yang digunakan ketika prompt pengiriman tidak menyebutkan satu, baik dengan `@name` atau sebagai kata pertama. Ini default ke pengaturan [`agent`](/id/settings#available-settings) jika satu diatur, jika tidak agen catch-all bawaan `claude`. Menyebutkan subagent dalam input pengiriman menimpa keduanya.
`claude agents` juga menerima `--dangerously-skip-permissions` sebagai singkatan untuk `--permission-mode bypassPermissions`, dan `--allow-dangerously-skip-permissions` untuk membuat `bypassPermissions` tersedia dalam siklus `Shift+Tab` setiap sesi yang dikirim tanpa memulai dalam mode itu. Keduanya cocok dengan [bendera CLI tingkat atas](/id/cli-reference).
Bendera ini ditambahkan di seluruh rilis. Versi sebelumnya menolaknya dengan kesalahan unknown-option.
| Bendera atau pengaturan | Versi minimum |
| :--------------------------------------------------------------------------- | :------------------------------------ |
| `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions` | v2.1.142 {/* min-version: 2.1.142 */} |
| `--allow-dangerously-skip-permissions` | v2.1.143 {/* min-version: 2.1.143 */} |
| `--agent`, dan menghormati pengaturan `agent` untuk sesi yang dikirim | v2.1.157 {/* min-version: 2.1.157 */} |
Sebelum v2.1.157, tampilan agen mengabaikan pengaturan `agent` dan mengirim agen bawaan `claude`.
Default aktif muncul di footer di bawah input pengiriman.
Tanpa bendera ini, sesi menggunakan `defaultMode` dari pengaturan direktori itu atau `permissionMode` dari [frontmatter subagent](/id/sub-agents#supported-frontmatter-fields) 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, plugins, dan server MCP
Tampilan agen menerima bendera konfigurasi yang sama dengan `claude` untuk memuat pengaturan, plugins, server MCP, dan direktori tambahan. Bendera ini memerlukan Claude Code v2.1.142 atau lebih baru. Setiap bendera 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.
| Bendera | Efek |
| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- |
| [`--settings `](/id/settings) | Menimpa pengaturan untuk tampilan agen dan sesi yang dikirim |
| [`--add-dir `](/id/permissions#additional-directories-grant-file-access-not-configuration) | Memberikan akses file ke direktori tambahan |
| [`--plugin-dir `](/id/plugins) | Memuat plugin dari direktori lokal |
| [`--mcp-config `](/id/mcp) | 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:
```bash theme={null}
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 agents --cwd ` | Buka tampilan agen yang dibatasi pada sesi yang dimulai di bawah `` |
| `claude agents --json` | Cetak sesi aktif sebagai array JSON dan keluar: setiap sesi langsung, ditambah sesi latar belakang yang masih bekerja atau terblokir bahkan ketika prosesnya telah keluar. Tambahkan `--all` untuk juga menyertakan sesi latar belakang yang telah selesai. Setiap entri memiliki `cwd`, `kind`, dan `startedAt`. Entri latar belakang juga memiliki `id`, dapat digunakan dengan `claude attach`/`logs`/`stop`, dan `state`: salah satu dari `working`, `blocked`, `done`, `failed`, atau `stopped`. `pid` dan `status` hanya ada saat proses masih hidup, ditambah `waitingFor` ketika status adalah `waiting`, yang mengatakan apa sesi diblokir, seperti `permission prompt` atau `input needed`; `sessionId` dan `name` muncul ketika diatur. Gabungkan dengan `--cwd ` untuk memfilter |
| `claude attach ` | Lampirkan ke sesi di terminal ini |
| `claude logs ` | Cetak output terbaru sesi |
| `claude stop ` | Hentikan sesi. Juga menerima `claude kill` |
| `claude respawn ` | Mulai ulang sesi, baik yang sedang berjalan maupun yang dihentikan, dengan percakapannya tetap utuh, misalnya untuk mengambil biner Claude Code yang telah diperbarui |
| `claude respawn --all` | Mulai ulang setiap sesi yang sedang berjalan, misalnya untuk memindahkan semua sesi ke biner Claude Code yang telah diperbarui sekaligus |
| `claude rm ` | Hapus sesi dari daftar. Menghapus worktree yang dibuat Claude untuk sesi jika tidak ada perubahan yang belum di-commit; jika tidak, mencetak jalur worktree sehingga Anda dapat membersihkannya. Membiarkan worktree yang Anda buat sendiri tetap ada. Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui `claude --resume` |
| `claude daemon status` | Cetak status [supervisor](#the-supervisor-process), versi, direktori soket, dan jumlah pekerja |
| `claude daemon stop --any` | Hentikan proses supervisor dan sesi latar belakang yang dihosting. Lewatkan `--keep-workers` untuk membiarkan sesi latar belakang tetap berjalan sehingga supervisor berikutnya dapat terhubung kembali ke sesi tersebut. `claude agents` atau `claude --bg` berikutnya memulai supervisor baru |
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](#from-inside-a-session).
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 menjaga satu proses worker yang sudah dipanaskan sebelumnya siap sehingga pengiriman dari tampilan agen atau `claude --bg` dimulai tanpa penundaan peluncuran dingin. Ketika Anda mengirim, supervisor menugaskan worker yang sudah dipanaskan sebelumnya ke sesi Anda, menerapkan direktori, pengaturan, dan kredensial sesi itu ke dalamnya, dan kemudian memulai pengganti untuk pengiriman berikutnya. Jika tidak ada worker yang sudah dipanaskan sebelumnya yang sehat tersedia, supervisor meluncurkan proses segar sebagai gantinya.
Supervisor dan sesinya mengautentikasi dengan kredensial yang sama dengan sesi interaktif Anda dan tidak membuat koneksi jaringan tambahan di luar API model. Variabel pemilihan penyedia seperti `CLAUDE_CODE_USE_BEDROCK` dan alias `ANTHROPIC_DEFAULT_*_MODEL` dibaca dari shell yang mengirim setiap sesi dan diterapkan ke workernya.
{/* min-version: 2.1.174 */}Sesi latar belakang tidak mewarisi variabel titik akhir gateway seperti `ANTHROPIC_BASE_URL`, variabel URL dasar Bedrock, Vertex, dan Foundry yang setara, atau `ANTHROPIC_AUTH_TOKEN` yang berpasangan dari shell yang memulai supervisor atau dari shell pengiriman. Sesi menggunakan kredensial yang disimpan Anda dan nilai `env` apa pun dalam [pengaturan](/id/settings) direktori proyek sebagai gantinya. Untuk mengarahkan sesi latar belakang dalam proyek ke [gateway LLM](/id/llm-gateway), atur `ANTHROPIC_BASE_URL` dalam blok `env` `settings.json` `.claude/` proyek itu daripada mengekspornya di shell Anda. Sebelum v2.1.174, sesi latar belakang mewarisi variabel-variabel ini dari shell peluncuran supervisor, sehingga dapat menggunakan gateway yang telah Anda konfigurasi di shell itu alih-alih yang dikonfigurasi untuk direktori proyek.
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. Perintah shell latar belakang yang berjalan, subagen, alur kerja dinamis, atau monitor dihitung sebagai pekerjaan aktif, jadi proses yang berjalan lama seperti server dev membuat sesi tetap hidup.
Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Sesi yang Anda [pin](#organize-the-list) dengan `Ctrl+T` dikecualikan dan membuat prosesnya tetap berjalan saat idle. Transkrip dan status tetap di disk, dan lain kali Anda melampirkan, mengintip, atau membalas sesi yang dihentikan, 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.
Baris kosong yang tersisa dari menekan `←` yang tidak pernah diberi prompt dihapus sepenuhnya setelah sekitar lima menit sehingga daftar membersihkan dirinya sendiri. Sesi yang dimulai dengan `claude --bg` dan sesi yang menunggu prompt pengaturan seperti dialog kepercayaan tidak dihapus dengan cara ini.
Ketika host kekurangan memori, supervisor menghentikan sesi idle non-pin terlebih dahulu dan menghentikan sesi pin idle hanya jika itu tidak membebaskan apa pun.
Supervisor memantau biner Claude Code yang diinstal di disk dan memulai ulang ke versi baru setelah [auto-updater](/id/setup#auto-updates) 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. Sesi pin idle juga dimulai ulang di tempat ke versi baru sehingga mengambil pembaruan tanpa Anda melampirkan kembali.
Tempat status disimpan
Status sesi disimpan di bawah direktori konfigurasi Claude Code Anda. Jika Anda menetapkan [`CLAUDE_CONFIG_DIR`](/id/env-vars), 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//state.json` | Status per-sesi ditampilkan di tampilan agen |
| `~/.claude/jobs//tmp/` | Direktori awal per-sesi. Penulisan di sini tidak meminta izin. Dihapus ketika sesi dihapus |
Setiap sesi latar belakang memiliki variabel lingkungan `CLAUDE_JOB_DIR` yang diatur ke direktori `~/.claude/jobs/` nya, jadi perintah shell yang dijalankan sesi dapat menulis file sementara ke `$CLAUDE_JOB_DIR/tmp` tanpa bertabrakan dengan sesi paralel.
Untuk memeriksa status ini tanpa membaca file secara langsung, jalankan `claude daemon status`. Ini melaporkan apakah supervisor dapat dijangkau, ID proses dan versinya, direktori soket, dan berapa banyak sesi latar belakang yang aktif. `/doctor` mencakup ringkasan pemeriksaan yang sama.
Perintah ini juga memperingatkan ketika supervisor yang berjalan berada pada versi yang berbeda dari `claude` yang Anda panggil, yang terjadi setelah pembaruan yang belum dimulai ulang oleh supervisor. Peringatan menunjukkan kedua versi dan memberi tahu Anda untuk menjalankan `claude daemon stop --any` untuk mengambil versi baru. Ketika Claude Code diinstal sebagai layanan OS, perintah yang disarankan adalah `claude daemon stop` tanpa flag.
Di Windows, `claude daemon status` menampilkan kesalahan file yang mendasar ketika file kunci pipa daemon terkunci atau tidak dapat dibaca alih-alih melaporkan kegagalan koneksi generik.
Matikan tampilan agen
Untuk mematikan agen latar belakang dan tampilan agen sepenuhnya, atur pengaturan `disableAgentView` [setting](/id/settings) ke `true` atau atur variabel lingkungan `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Administrator dapat memberlakukan ini melalui [pengaturan terkelola](/id/permissions#managed-settings).
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](#turn-off-agent-view) oleh pengaturan atau variabel lingkungan.
Tampilan agen terbuka tanpa sesi
Sebelum Anda mengirim sesi pertama Anda, tampilan agen menampilkan petunjuk onboarding singkat dengan contoh prompt sebagai pengganti daftar sesi. Ketik prompt dalam input di bagian bawah dan tekan `Enter` untuk mengirim sesi pertama Anda.
Tidak dapat membuka agen karena pekerjaan sedang berjalan di latar belakang
Jika menekan `←` untuk menempatkan sesi saat ini di latar belakang menunjukkan `Cannot open agents — N still running in the background`, sesi memiliki pekerjaan yang sedang berlangsung seperti subagen, alur kerja dinamis, 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](#from-inside-a-session) 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 shutdown
Mematikan atau memulai ulang mesin Anda menghentikan sesi latar belakang yang sedang berjalan, sehingga sesi tersebut menampilkan sebagai gagal saat Anda berikutnya membuka tampilan agen. Lampirkan, intip, atau balas sesi apa pun dan sesi itu dimulai ulang dari tempat ia berhenti.
Sleep saja tidak menyebabkan hal ini. Sesi dipertahankan di seluruh sleep dan supervisor terhubung kembali ke sesi tersebut saat bangun.
Tampilan agen mengatakan layanan latar belakang tidak merespons
Jika melampirkan, mengintip, atau `claude logs` melaporkan bahwa layanan latar belakang tidak merespons, proses supervisor kemungkinan besar telah macet. Hentikan dan biarkan `claude agents` berikutnya memulai yang baru. Untuk menjaga sesi latar belakang Anda tetap berjalan melalui restart, berikan `--keep-workers`:
```bash theme={null}
claude daemon stop --any --keep-workers
```
Supervisor baru terhubung kembali ke sesi yang sedang berjalan. Tanpa `--keep-workers`, perintah mengakhiri sesi latar belakang juga. Bendera `--any` mengonfirmasi Anda ingin menghentikan supervisor yang dimulai sesuai permintaan daripada sebagai layanan yang diinstal, yang merupakan default.
Di Windows, jika supervisor tidak merespons permintaan stop, perintah mencetak ID prosesnya. Akhiri proses itu dengan `taskkill /PID ` untuk menyelesaikan pemulihan. Sesi latar belakang masih dipertahankan saat Anda memberikan `--keep-workers`.
Pengiriman gagal dengan `Could not resolve authentication method`
{/* min-version: 2.1.174 */}Jika pengiriman latar belakang gagal dengan `Could not resolve authentication method` sementara sesi interaktif mengautentikasi secara normal, worker yang menerima pengiriman tidak mengambil kredensial. Pada v2.1.174 dan yang lebih baru, supervisor menyediakan snapshot kredensial segar saat menugaskan [worker yang sudah dipanaskan sebelumnya](#the-supervisor-process), jadi kesalahan ini berarti tidak ada kredensial yang disimpan tersedia untuk proses supervisor itu sendiri. Konfirmasi Anda telah menjalankan `/login` atau mengonfigurasi kunci API, kemudian hentikan supervisor:
```bash theme={null}
claude daemon stop --any --keep-workers
```
`claude agents` atau `claude --bg` berikutnya memulai supervisor segar yang membaca kredensial yang disimpan Anda. Jika Anda mengautentikasi dengan variabel lingkungan seperti `ANTHROPIC_API_KEY` daripada `/login`, jalankan perintah berikutnya dari shell tempat variabel diatur.
Lihat [referensi kesalahan](/id/errors#could-not-resolve-authentication-method) untuk daftar lengkap penyebab dan perbaikan. Sebelum v2.1.174, worker yang sudah dipanaskan sebelumnya yang duduk menganggur dapat menampilkan kesalahan ini saat ditugaskan ke pengiriman bahkan ketika kredensial Anda valid. Tingkatkan untuk memulihkan.
Sesi latar belakang tidak dapat membaca Desktop, Documents, atau Downloads di macOS
Di macOS, host sesi latar belakang berjalan sebagai prosesnya sendiri dan meminta akses ke folder yang dilindungi secara terpisah dari terminal Anda. Jika sesi latar belakang melaporkan `Operation not permitted` saat membaca `~/Desktop`, `~/Documents`, `~/Downloads`, atau lokasi yang dilindungi lainnya, berikan akses di System Settings di bawah Privacy & Security > Files and Folders, atau aktifkan Full Disk Access untuk entri tersebut.
Dengan installer asli, entri muncul sebagai Claude Code dan pemberian akses tetap ada di seluruh pembaruan. Dengan metode instalasi lain seperti Homebrew atau npm, entri menampilkan jalur biner dan mungkin perlu diberikan akses lagi setelah memperbarui.
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, menunggu Anda, atau [disematkan](#organize-the-list) tidak dihentikan dengan cara ini, jadi semat sesi dengan `Ctrl+T` untuk menjaganya tetap responsif.
`.claude/worktrees/` penuh
Menghapus sesi dalam tampilan agen menghapus worktree yang dibuat Claude untuk sesi tersebut. `claude rm` menyimpan worktree yang memiliki perubahan yang belum dikomit dan mencetak jalurnya. Daftar entri sisa dengan `git worktree list` di direktori proyek dan hapus masing-masing dengan `git worktree remove `. Lihat [Bersihkan worktrees](/id/worktrees#clean-up-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. Sesi ini dipertahankan di seluruh tidur tetapi berhenti jika mesin dimatikan.
* **Worktrees yang dibuat Claude dihapus dengan sesi di tampilan agen**: gabungkan atau dorong perubahan sebelum menghapus sesi yang mengedit file di worktree-nya sendiri. `claude rm` menyimpan worktree yang memiliki perubahan yang belum dilakukan; worktree yang Anda buat sendiri dibiarkan di tempat.
Untuk cara lain menjalankan Claude secara paralel, lihat:
* [Jalankan agen secara paralel](/id/agents): bandingkan tampilan agen dengan subagents, tim agen, dan worktrees
* [Tim agen](/id/agent-teams): koordinasikan beberapa sesi yang saling berpesan
* [Claude Code di web](/id/claude-code-on-the-web): jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal