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. Tampilan agen menjalankan sesi di mesin Anda dan Anda mengirim masing-masing; untuk membuat Claude memulai dan melacak sesi paralel di cloud dari satu percakapan, lihat Projects.

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.

claude agents

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.

Di dalam sesi claude biasa, petunjuk ← footer prompt menghitung agen latar belakang yang menunggu Anda, seperti ← 2 agents, dan kembali ke ← for agents ketika tidak ada yang memerlukan input. Hitungan di atas 99 ditampilkan sebagai 99+. Hitungan menyegarkan sekitar setiap sepuluh detik saat terminal difokuskan dan segera ketika fokus kembali. Warna berubah sebentar ketika bergerak dan ketika agen selesai, dan ketika sesi latar belakang selesai sementara tidak ada yang memerlukan input Anda, warna tersebut secara singkat menampilkan jumlah yang selesai, seperti ← 2 done. Kedua kilatan ini mati ketika pengaturan prefersReducedMotion aktif, dan petunjuk tersembunyi dalam mode pembaca layar.

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 usianya, dihitung dari saat sesi dibuat; usia sesi yang selesai membeku pada berapa lama waktu yang dibutuhkan untuk menjalankannya.

Nama tersebut berwarna dengan warna yang ditetapkan oleh /color dalam sesi itu, termasuk ketika Anda mengirim sesi ke latar belakang dengan ← atau /background.

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:

claude agents --cwd ~/projects/my-app

Ini menampilkan hanya sesi yang dimulai di bawah direktori itu. Sesi yang telah berpindah ke worktree di bawah ~/projects/my-app/.claude/worktrees/ masih dihitung.

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          Menggambar bingkai sprite walk-cycle          3m

Siap untuk ditinjau
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Membutuhkan masukan
  ✻ power-up design           double jump atau wall climb?                    1m

Bekerja
  ✽ collision detection       Menambahkan pemeriksaan swept-AABB ke CollisionSystem   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:

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

Label #N atau !N yang dapat muncul di tepi kanan baris adalah tautan ke permintaan tarik atau permintaan penggabungan sesi, bukan bagian dari ikon status.

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.

Untuk membaca status sesi dari skrip atau program lain, gunakan claude agents --json daripada file di bawah ~/.claude/jobs/.

Saat tampilan agen terbuka, Claude Code juga mengirim notifikasi melalui saluran notifikasi terminal yang dikonfigurasi ketika sesi latar belakang lokal mulai membutuhkan masukan Anda, selesai, atau gagal. Sesi yang berjalan sesuai jadwal, seperti sesi /loop, hanya memberitahu ketika mereka membutuhkan masukan Anda. Notifikasi menggunakan pengaturan preferredNotifChannel yang sama dengan sisa Claude Code dan menjalankan hook Notification dengan tipe agent_needs_input atau agent_completed.

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. 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 atau dihentikan setelah shutdown untuk cara memulihkannya.

Sesi yang sedang merespons ketika mesin tidur dapat kembali tidak responsif. Ketika Anda membuka sesi yang telah berhenti merespons, supervisor memulai ulang prosesnya dan sesi melanjutkan respons yang terputus dari tempat ia berhenti.

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, teks baris diperbarui paling banyak sekali setiap 15 detik dari output terbaru sesi itu sendiri tanpa mengirim permintaan model, dan model menulis ringkasan segar ketika setiap giliran berakhir.

Baris yang bekerja menunjukkan apa yang dikatakan sesi sedang dilakukan, dan baris yang diblokir menunjukkan pertanyaan yang diajukannya. Selama giliran yang panjang, model juga menulis ulang ringkasan setiap beberapa menit sehingga baris yang sibuk tidak terus menampilkan ringkasan yang sudah ketinggalan zaman. Teks ringkasan mengisi lebar sisa baris; buka panel intip untuk membaca kalimat yang dipotong tepi terminal.

Ketika daftar dikelompokkan berdasarkan direktori, ringkasan dibuka dengan status sesi sebagai kata berwarna, seperti Needs input · double jump or wall climb?. Dalam pengelompokan status default, header grup sudah menamai status, jadi baris hanya menampilkan ringkasan.

Ringkasan akhir giliran dan setiap penulisan ulang pertengahan giliran adalah satu permintaan kelas Haiku pendek melalui penyedia normal Anda, ditagih dan ditangani di bawah persyaratan penggunaan data yang sama dengan sesi itu sendiri. Pembaruan 15 detik antara penulisan ulang model menggunakan kembali output sesi itu sendiri dan tidak mengirim permintaan. Pada penyedia pihak ketiga atau gateway tanpa model Haiku yang dikonfigurasi, permintaan menggunakan model utama sesi sebagai gantinya; atur ANTHROPIC_DEFAULT_HAIKU_MODEL untuk memilih satu.

Status permintaan tarik

Ketika sesi membuka permintaan tarik, Claude Code menambahkan label di tepi kanan baris, tertaut ke permintaan tarik:

• Claude Code menulis label sebagai #1234 untuk permintaan tarik dan sebagai !1234 untuk permintaan penggabungan GitLab.
• Claude Code memancarkan tautan bahkan ketika tidak dapat mendeteksi dukungan hyperlink, misalnya melalui SSH atau tmux. Atur FORCE_HYPERLINK=0 untuk merender label sebagai teks biasa.
• Setelah Anda mengirim tindak lanjut ke sesi, Claude Code menyimpan label sementara baris kembali ke kemajuan langsung.

Sesi yang bekerja pada permintaan tarik yang ada tertaut ke sana dengan cara yang sama. Claude Code menemukan permintaan tarik secara berbeda tergantung pada perintah yang dijalankan Claude:

• Ketika Claude mengedit, mengomentari, menutup, atau menandai permintaan tarik siap dengan gh, Claude Code menautkan permintaan tarik yang dinamai output perintah itu sendiri. Perintah gh yang output tertangkapnya tidak menamai permintaan tarik tidak membuat tautan; gh pr merge adalah kasus umum, karena mencetak hasilnya hanya ke terminal interaktif.
• Ketika Claude memeriksa permintaan tarik dengan gh pr checkout atau mendorong ke cabang, Claude Code mencari cabang dengan gh pr view dan menautkan permintaan tariknya yang terbuka.
• Permintaan tarik tidak perlu ada ketika Claude mendorong: Claude Code mencoba ulang pencarian cabang setelah hingga lima perintah git, gh, glab, atau curl berikutnya berjalan di direktori yang sama, jadi permintaan tarik yang dibuat setelah dorong, termasuk yang dibuat Claude melalui REST API GitHub, tertaut ketika percobaan ulang menemukannya.

Ketika sesi tertaut ke 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 untuk melihat semuanya.

Nomor permintaan tarik berwarna berdasarkan statusnya:

Untuk tugas yang berakhir dalam permintaan tarik, periksa label ini untuk 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 membuka dengan kalimat yang baris potong di tepi terminal, dan kalimat mana itu tergantung pada status sesi:

• Sesi yang menunggu Anda: pertanyaan pasti yang diajukannya, di atas input balasan
• Sesi yang selesai: hasilnya
• Sesi yang bekerja: kalimat status lengkapnya

Permintaan tarik apa pun yang tertaut ke sesi tercantum selanjutnya. Untuk sesi yang menunggu Anda, baris seperti waiting 3m di bawahnya menunjukkan berapa lama ia telah menunggu, dan itu adalah satu-satunya waktu yang ditampilkan di panel. Usia di tepi kanan baris adalah angka yang berbeda: itu dihitung dari saat sesi dimulai.

Sebagian besar waktu panel intip 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 dengan pilihan yang telah ditentukan, panel intip menunjukkannya sebagai daftar bernomor dan Anda dapat menekan tombol angka untuk memilih satu. Prompt izin ditampilkan sebagai teks yang menjelaskan apa yang ingin dijalankan sesi, tanpa opsi bernomor. Ketik balasan untuk menjawabnya, atau lampirkan untuk menjawab dengan prompt standar. 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.

Ketika hook PermissionRequest atau PreToolUse mengembalikan output yang tidak dapat divalidasi Claude Code untuk panggilan yang diminta sesi, baris menunjukkan acara hook dan hook output invalid: dengan kesalahan validasi sebelum teks permintaan yang tertunda. Untuk hook yang gagal dengan cara lain, baris mengatakan hook gagal. Sesi masih menunggu permintaan yang sama.

Balasan yang tidak dapat dikirim, karena layanan latar belakang tidak dapat dijangkau atau pengiriman gagal, disimpan dan dikirim ke sesi sebagai prompt berikutnya ketika prosesnya dimulai lagi, dan pesan kesalahan mengatakan balasan disimpan. Balasan dengan awalan ! tidak disimpan, karena teks yang disimpan akan mencapai sesi sebagai prompt biasa daripada menjalankan sebagai perintah Bash.

Dengan dikte suara 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: perintah, pintasan keyboard, dan fitur semuanya berfungsi, dengan pengecualian di bawah.

Saat Anda melampirkan, /install-github-app dan daftar pengaturan /mcp berfungsi secara normal, karena manusia di terminal dapat menyelesaikan dialog mereka. Ketika tidak ada yang dilampirkan, perintah ini tidak dapat membuka dialog mereka, jadi sesi muncul di bawah Needs input dalam tampilan agen dengan baris seperti open this session to manage MCP servers, dan balasan transkrip mengatakan hal yang sama. Lampirkan dan jalankan perintah lagi untuk melanjutkan; baris needs-input hilang ketika Anda melampirkan. /mcp reconnect <server>, /mcp enable, dan /mcp disable berfungsi tanpa melampirkan kedua cara.

Sesi yang dilampirkan selalu dirender dalam mode layar penuh, 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, atau jalankan /exit, untuk melepaskan dan kembali ke tampilan agen, apakah Anda membuka sesi dari tampilan agen atau dengan claude attach <id> dari shell Anda.

← juga melepaskan saat overlay /btw terbuka. Memerlukan Claude Code v2.1.257 atau lebih baru. Pertanyaan samping yang masih menjawab terus berjalan saat Anda pergi. Lain kali Anda melampirkan, overlay dibuka kembali dengannya, atau dengan jawabannya.

Di Windows, jika Anda menekan ← dalam sekitar setengah detik setelah melampirkan, Claude Code menunjukkan Ambiguous ←, press again to detach, karena dalam jendela itu terminal dapat mengirimkan ulang tekan dari sebelum Anda melampirkan. Tekan ← lagi untuk melepaskan.

Ctrl+Z juga melepaskan tetapi kembali ke tempat Anda memulai: tampilan agen jika Anda melampirkan dari sana, atau shell Anda jika Anda menjalankan claude attach. Gunakan Ctrl+Z ketika dialog memiliki fokus dan tidak merespons ←.

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.

Alihkan sesi tanpa meninggalkan terminal

Dalam sesi yang berjalan di latar depan, sesi yang Anda mulai di terminal daripada melampirkan dari tampilan agen, menekan ← pada prompt kosong mengirimnya ke latar belakang dan membuka tampilan agen dengan baris itu dipilih, sehingga Anda dapat beralih sesi tanpa meninggalkan terminal. Tekan tunggal yang sama melepaskan sesi yang dilampirkan.

Jika Anda menekan ← tepat setelah Anda menghapus yang terakhir dari teks prompt atau bergerak melalui riwayat prompt, Claude Code meminta Anda untuk mengonfirmasi: tekan pertama menunjukkan Press ← again to open agents, atau Press ← again to go back to agents dalam sesi yang dilampirkan, dan tekan kedua beralih.

Ketika ← mengirim sesi latar depan ke latar belakang, tampilan agen menunjukkan Your conversation moved to the background di atas daftar, dengan baris sesi itu sudah dipilih. Dari sana:

• Tekan Enter untuk membuka kembali percakapan.
• Tekan Esc untuk membatalkan switch dan kembali ke percakapan. Jika Esc menunjukkan Still starting — try again in a moment, sesi latar belakang belum siap, jadi tekan Esc lagi dalam sebentar.
• Tekan Ctrl+C dua kali untuk keluar ke shell Anda.

Ketika Claude Code tidak dapat membuka kembali percakapan, itu keluar dan mencetak perintah claude --resume yang melanjutkannya.

Daftar tugas Claude bergerak ke sesi latar belakang dengan percakapan, jadi daftar periksa tetap utuh ketika Anda kembali ke baris itu.

Baris yang Anda tekan ← dari juga menyimpan nama yang tebal dan tidak redup setelah Anda memindahkan pilihan dengan tombol panah atau mouse, sehingga Anda dapat mengetahui sesi mana yang Anda datang darinya.

Jika alat sedang berjalan saat Anda menekan ←, Claude Code menunggu hingga sekitar sepuluh detik agar alat selesai sebelum mengirim ke latar belakang, dan respons berlanjut dalam sesi latar belakang. Tekan ← lagi untuk mengirim ke latar belakang segera alih-alih menunggu. Ketika pekerjaan yang sedang berlangsung tidak dapat dibawa ke sesi latar belakang, dialog Background this session? muncul terlebih dahulu, sama seperti dengan /background.

Batas sepuluh detik tidak berlaku saat subagents latar depan yang dimulai Claude dalam percakapan masih berjalan. Claude Code terus menunggu sehingga pekerjaan mereka terbawa, dan menampilkan pemberitahuan Still backgrounding after the current tool saat menunggu. Tekan ← lagi untuk mengirim ke latar belakang tanpa menunggu, yang memulai ulang subagents itu dari awal. Claude Code tidak menunggu subagents yang alur kerja dinamis jalankan. Ketika alur kerja memiliki subagents yang berjalan, Claude Code menunjukkan dialog Background this session? sebagai gantinya.

Claude Code tidak mengirim sesi ke latar belakang saat Anda memiliki teks yang belum dikirim dalam input prompt, karena teks tetap berada di kotak input terminal Anda dan tidak akan pindah ke sesi latar belakang. Jika Anda mengetik ke dalam input saat Claude Code menunggu untuk mengirim sesi ke latar belakang, itu membatalkan switch dengan Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.

Menekan ← membuat baris sesi bahkan ketika percakapan belum memiliki pesan, jadi → masih kembali ke sana.

Anda dapat mematikan pintasan ini dengan pengaturan leftArrowOpensAgents di /config.

Atur daftar

Tampilan agen mengelompokkan sesi sehingga yang membutuhkan masukan berada di atas, dengan Ready for review dan Needs input di atas Working dan Completed. Nama grup ini tidak memetakan satu-ke-satu ke status di atas: sesi bergerak ke Ready for review ketika memiliki permintaan tarik terbuka, dan Completed 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 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.

Tekan kedua menghapus sesi bahkan ketika upaya penghentian gagal, misalnya karena layanan latar belakang tidak merespons: konfirmasi tetap aktif selama dua detik lagi, dan penghapusan mengakhiri proses sesi itu sendiri. Tekan Esc untuk membatalkan konfirmasi tanpa menghapus.

Kecuali dalam kasus yang dipertahankan yang tercakup dalam Apa yang menghapus sesi menghapus, menghapus menghapus sesi dari daftar, dan worktree yang dibuat Claude untuk itu dihapus, dipertahankan, atau dibiarkan di tempat tergantung pada cara Anda menghapus dan apa yang dipegang worktree. Transkrip percakapan selalu tetap berada di mesin lokal Anda, tersedia melalui claude --resume.

Untuk membawa sesi kembali pada Claude Code v2.1.212 atau lebih baru, ketik /resume dalam input pengiriman. Pemilih terbuka dengan sesi masa lalu dari repositori yang Anda buka tampilan agen dari, terbaru terlebih dahulu, termasuk sesi yang Anda hapus dari daftar; sesi yang sudah memiliki baris tidak tercantum. ↑/↓ memindahkan pilihan, Enter melanjutkan sesi yang dipilih sebagai sesi latar belakang sehingga bergabung kembali dengan daftar sebagai baris, dan Esc menutup pemilih.

Pemilih terbuka hanya untuk /resume yang kosong. Lanjutan, scoped, atau restricted resume tidak dapat dilayani oleh pemilih, jadi tampilan agen menunjukkan petunjuk attach to a session to run it sebagai gantinya ketika:

• /resume menamai id atau istilah pencarian
• tampilan dibatasi dengan --cwd
• tampilan dimulai dengan --safe-mode
• tampilan dibuka dengan bendera seperti --permission-mode atau --settings

Sesi yang selesai yang tidak muat di layar dilipat menjadi baris … N more. Kegagalan dan sesi dengan permintaan tarik terbuka selalu tetap terlihat. Grup Completed mengisi ruang vertikal yang tersisa setelah grup langsung, dan di terminal pendek header dikompakkan menjadi baris ringkasan tunggal sehingga sesi yang bekerja atau membutuhkan masukan tetap terlihat.

Filter sesi

Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:

Pintasan keyboard

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

Ctrl+S, Ctrl+T, dan Ctrl+G mengikuti keybindings.json Anda. Ikat ulang atau lepas ikat Ctrl+S dan Ctrl+T dengan tindakan agents:switchView dan agents:togglePin dalam konteks Agents, dan Ctrl+G melalui pengikatan chat:externalEditor konteks Chat. Pintasan lain dalam tabel tidak dapat diikat ulang.

Dispatch new agents

You can dispatch new background sessions from agent view, send or copy an existing interactive session to the background, or start one directly from the shell.

From agent view

Type a prompt in the input at the bottom of agent view and press Enter to start a new background session. The session is named automatically from the prompt; rename it later with Ctrl+R.

Nama otomatis adalah label pendek yang ditulis oleh model kelas Haiku. Nama yang diterima sesi nanti juga muncul di barisnya, termasuk judul yang dihasilkan yang diterima sesi ketika Anda menerima rencana dalam sesi itu.

Tempel gambar ke dalam prompt untuk menyertakan tangkapan layar atau diagram dengan tugas.

Teks yang ditempel lebih panjang dari 800 karakter atau lebih dari tiga baris runtuh menjadi placeholder [Pasted text #N] sehingga input tetap pada satu baris; teks lengkap dikirim ketika Anda mengirim. Untuk meninjau atau mengedit teks yang runtuh sebelum mengirim, tempel teks yang sama lagi dan placeholder akan berkembang kembali ke dalam input.

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

Serangkaian kecil perintah berjalan di agent view itu sendiri alih-alih mengirim:

• /exit dan /quit menutup agent view
• /logout menandatangani Anda keluar
• /model menetapkan model pengiriman
• /login membuka dialog masuk sehingga Anda dapat masuk lagi tanpa melampirkan ke sesi
• Bare /resume, atau alias /continue miliknya, membuka pemilih sesi masa lalu repositori untuk membawa satu kembali sebagai sesi latar belakang. Memerlukan Claude Code v2.1.212 atau lebih baru

Skills, perintah Anda sendiri, dan built-in yang memperluas prompt seperti /init dikirim ke sesi latar belakang baru sebagai prompt pertama mereka. Perintah built-in lainnya menunjukkan petunjuk attach to a session to run it sebagai gantinya. Semua yang Anda ketik tetap berada di input di sebelah petunjuk sehingga Anda dapat mengeditnya.

Mengemas tugas berulang sebagai skill memungkinkan Anda memulai alur kerja yang sama dari agent view berulang kali tanpa mengetik ulang prompt.

Ketika @name yang sama cocok dengan subagent dan repositori saudara, subagent mengambil prioritas. Kecocokan kata pertama bare juga berlaku, jadi prompt yang kebetulan 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 yang berbeda untuk menghindari kecocokan.

Dispatch to a specific directory

Sesi baru berjalan di direktori tempat Anda membuka agent view. Untuk menargetkan direktori yang berbeda, gunakan salah satu dari ini:

• Buka claude agents di direktori itu.

• Buka claude agents di direktori induk dan sebutkan repositori anak dengan @<repo> dalam prompt. Mengetik @ mencantumkan target ini:

  • Repositori Git satu level di bawah direktori peluncuran
  • git worktrees terdaftar dari repositori yang Anda luncurkan yang berada di dalam pohon direktorinya, seperti yang dibuat Claude di bawah .claude/worktrees/, diberi label dengan cabang yang diperiksa. Worktrees yang ditambahkan di luar repositori, seperti dengan git worktree add ../feature, tidak terdaftar
  • Direktori apa pun yang sudah memiliki sesi dalam daftar

  Direktori yang namanya berisi spasi tidak terdaftar.

• Dari shell, cd ke dalam direktori dan jalankan claude --bg "<prompt>".

Ketika agent view dikelompokkan berdasarkan direktori, pengiriman mengirim prompt ke direktori baris yang dipilih, sehingga Anda dapat memilih grup dan mengirim ke dalamnya tanpa mengetik ulang jalur.

From inside a session

Dua perintah memindahkan pekerjaan dari sesi yang Anda masuki ke latar belakang: /background mengirim percakapan saat ini ke sana dan membebaskan terminal Anda, dan /fork mengirim salinan sementara Anda terus bekerja di mana Anda berada.

Send the session to the background

Jalankan /background atau alias /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 merespons ketika Anda menjalankan /bg, respons berlanjut dalam sesi latar belakang.

Keluar dari sesi yang masih memiliki pekerjaan latar belakang yang berjalan, seperti subagents, perintah shell latar belakang, alur kerja, atau monitors, menunjukkan dialog Background work is running alih-alih berhenti segera. Pilih Move to background and exit untuk mengirim sesi dengan cara yang sama /background lakukan dan kembali ke shell Anda. Opsi tidak ditampilkan ketika agent view dimatikan.

Jika sesi latar belakang dalam daftar sudah memiliki nama percakapan, Claude Code memberi nomor nama baris baru, seperti my-session (2), dan membiarkan nama baris yang ada sendirian. Untuk mengganti nama baris baru, pilih di agent view dan tekan Ctrl+R.

Copy the session with /fork

Jalankan /fork untuk menyalin percakapan saat ini ke sesi latar belakang baru sementara yang asli terus berjalan. Salinan dimulai dengan semua yang ada dalam percakapan hingga saat itu; lihat poin di bawah untuk tempat salinan berjalan. Ini juga membawa model, mode izin, tingkat upaya, dan direktori atau hibah izin "jangan tanya lagi" apa pun yang Anda tambahkan selama sesi. Salinan muncul sebagai barisnya sendiri di agent view.

Setelah fork, dua percakapan independen: tidak ada yang dilakukan salinan memasuki percakapan asli dengan sendirinya, meskipun dalam sesi di mana cross-session messaging diaktifkan, sesi Claude mana pun dapat secara eksplisit mengirim pesan ke yang lain.

Menyalin sesi memerlukan Claude Code v2.1.212 atau lebih baru; pada v2.1.161 melalui v2.1.211, /fork memulai forked subagent sebagai gantinya, yang sekarang /subtask. Ketika agent view dimatikan, /fork mempertahankan perilaku subagent yang di-fork dan /subtask tidak tersedia.

Berikan prompt seperti /fork open a draft pull request with the work so far dan salinan mulai bekerja padanya segera. Tanpa prompt, salinan menunggu instruksi pertamanya: pilih barisnya di claude agents dan tekan Space untuk mengirim satu, atau jalankan claude attach <id>. Baris yang dipilih menunjukkan space to send it a prompt sementara menunggu.

Konfirmasi /fork adalah satu baris yang menunjukkan status salinan, seperti session running, nama baris agent-view-nya, dan ID sesinya untuk claude attach. Klik nama untuk beralih ke salinan: sesi ini pindah ke latar belakang, sama seperti menekan ←, dan agent view membuka sesi salinan.

Kecuali ketika salinan mengedit di tempat, Claude Code menginstruksikannya untuk membuat worktree miliknya sendiri sebelum membuat perubahan kode. Di luar repositori git, hanya salinan yang dipindahkan keluar dari worktree yang dibuat hook yang mendapat instruksi; tanpa WorktreeCreate hook, salinan mengedit di tempat. Salinan yang dipindahkan keluar dari worktree Anda juga diberitahu untuk tidak pernah mengedit, menjalankan perintah di, atau memasuki worktree itu, apa pun pengaturan isolasi.

Tempat salinan dimulai tergantung di mana sesi saat ini berjalan:

• Seperti sesi yang dikirim apa pun, salinan bergerak ke worktree miliknya sendiri sebelum mengedit file. Dalam hal ini konfirmasi tidak menyebutkan tempat salinan berjalan.
• Ketika sesi Anda pindah ke worktree tertaut setelah dimulai, salinan dimulai kembali di mana sesi berada sebelum pindah dan, kecuali mengedit di tempat, membuat perubahan kodenya di worktree miliknya sendiri di sana. Ketika worktree Anda diperiksa pada cabang, instruksi itu juga memberitahu salinan yang tugasnya dibangun di atas pekerjaan Anda untuk mendasarkan cabang barunya pada milik Anda, karena cabang Anda tetap diperiksa di worktree Anda. Konfirmasi berakhir dengan runs in the origin tree.
• Ketika Anda meluncurkan sesi di dalam worktree tertaut dari repositori yang memiliki pohon kerja utama, salinan dimulai di pohon kerja utama itu, dengan aturan worktree-of-its-own yang sama tetapi tidak ada instruksi cabang. Konfirmasi berakhir dengan runs in the origin tree di sini juga.
• Sesi yang diluncurkan di dalam worktree dari tata letak repositori bare tidak memiliki pohon kerja utama untuk kembali, jadi salinan tetap di mana ia berada, dan konfirmasi berakhir dengan edits this checkout. Catatan yang sama muncul ketika isolasi worktree dimatikan dalam sesi yang tidak berada di dalam worktree tertaut, karena salinan kemudian mengedit file yang Anda buka.

Sesi yang dimulai dengan bendera peluncuran yang tidak akan diwariskan salinan, seperti prompt sistem yang diganti atau allowlist --tools, tidak dapat di-fork; Claude Code mengatakan demikian alih-alih membuat salinan sebagian. Sesi yang dikirim dari agent view fork secara normal: salinan diluncurkan dengan definisi agen dan instruksi yang ditambahkan yang sama seperti sesi yang berasal darinya.

What carries over when you background

Backgrounding memulai proses segar yang dilanjutkan dari percakapan yang disimpan, dan pekerjaan yang sedang berlangsung pindah ke sana: menjalankan perintah shell latar belakang, subagents yang di-background, alur kerja dinamis, tugas terjadwal yang Anda buat dengan /loop, dan balasan otomatis Claude terhadap komentar artefak semuanya terbawa dan terus berjalan di sana. Subagent bergerak bersama dengan semua yang dimulainya, jadi ia hanya terbawa ketika semua pekerjaan itu dapat pindah juga. Untuk menghentikan pekerjaan yang sedang berlangsung alih-alih membawanya, atur variabel lingkungan CLAUDE_DISABLE_ADOPT=1; Claude Code kemudian meminta Anda untuk mengonfirmasi sebelum backgrounding.

Ketika alur kerja dinamis masih memiliki subagents yang berjalan, Claude Code meminta sebelum backgrounding dengan dialog Background this session?, yang mengatakan berapa banyak subagents yang akan dimulai ulang. Pilih Stay untuk membiarkan mereka selesai terlebih dahulu. Jika Anda mengonfirmasi, Claude Code memutar ulang jalankan dalam sesi latar belakang: subagents yang masih berjalan dimulai dari awal, jadi token yang mereka gunakan sejauh ini dihabiskan lagi. Lihat Resume after a pause untuk subagents mana yang mengembalikan hasil yang disimpan dan mana yang berjalan lagi.

Claude Code menghentikan pekerjaan yang tidak dapat terbawa, seperti monitor yang berjalan, dan menghentikan subagent yang di-background yang memiliki monitor bersama dengannya. Ketika pekerjaan apa pun seperti itu berjalan, Claude Code menunjukkan dialog Background this session? sehingga Anda dapat mengonfirmasi sebelum menghentikan pekerjaan.

Setelah berada di latar belakang, sesi dapat memulai subagents, monitors, dan perintah latar belakang baru, dan yang tersebut terus berjalan di seluruh detach dan reattach nanti.

Bendera konfigurasi dari peluncuran asli terbawa ke sesi yang di-background, jadi 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 juga terbawa. Membawa --allow-dangerously-skip-permissions membuat bypassPermissions dapat dijangkau dalam sesi yang di-background, tetapi tidak memberikan apa pun yang baru: mode masih memerlukan penerimaan interaktif satu kali yang dijelaskan dalam Permission mode, model, and effort.

From your shell

Berikan --bg atau bentuk panjangnya --background untuk memulai sesi yang langsung masuk ke latar belakang:

claude --bg "investigate the flaky SettingsChangeDetector test"

Prompt adalah argumen posisional, bukan nilai -p. Claude Code menolak --bg dikombinasikan dengan -p atau --print sebelum sesi apa pun dibuat, karena --print tidak pernah memulai sesi interaktif yang claude agents lampirkan.

Untuk menjalankan subagent spesifik yang telah Anda tentukan, seperti code-reviewer, sebagai agen utama sesi, gabungkan --bg dengan --agent:

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

Jika nama tidak cocok dengan salah satu subagents Anda, peluncuran gagal: Claude Code mencetak peringatan no agent named dan masih melaporkan sesi sebagai backgrounded, tetapi sesi keluar segera dengan kesalahan --agent '<name>' not found.

Ketika sesi yang di-background nanti dilanjutkan atau dimulai ulang, Claude Code memulihkan agen dan pembatasan alatnya; untuk prompt sistemnya, lihat System prompt flags in resumed conversations. Ini mencari direktorinya sendiri untuk agen terlebih dahulu, asalkan Anda telah mempercayai ruang kerja itu, jadi agen yang bersifat proyek masih dimuat ketika sesi dilanjutkan dari direktori lain. Jika agen tidak lagi ada, sesi berlanjut dengan alat default dan transkrip-nya terbuka dengan peringatan yang menyebutkan agen.

Untuk melanjutkan percakapan yang ada di latar belakang, berikan ID sesi lengkapnya dengan --resume:

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

Pada Claude Code v2.1.257 atau lebih baru, Claude Code baik melanjutkan sesi itu di bawah ID yang sama, atau memulai salinan di bawah ID baru dan mencetak baris note: yang menjelaskan mengapa ia tidak dapat melanjutkan di tempat. Ketika sesi berlanjut di tempat, claude agents menunjukkan satu baris untuknya.

Ketika Anda menggabungkan --bg dengan --continue, bare --resume, atau --resume dengan nama atau jalur file, Claude Code selalu memulai salinan seperti itu. Tambahkan --fork-session untuk memulai salinan dengan sengaja, tanpa catatan.

Berikan --name untuk menetapkan nama tampilan sesi dalam agent view alih-alih yang dihasilkan otomatis:

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

Setelah backgrounding, Claude mencetak ID pendek sesi dan perintah untuk mengelolanya. Ketika layanan yang menghosting sesi latar belakang belum berjalan, --bg mungkin pertama kali mencetak Starting background service… di atas output ini. Ketika Anda memberikan --name, nama muncul setelah ID pendek:

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

Run a shell command

Untuk menjalankan perintah shell sebagai pekerjaan latar belakang alih-alih sesi Claude, berikan --exec. Contoh berikut menjalankan pytest -x sebagai pekerjaan latar belakang:

claude --bg --exec 'pytest -x'

Dari agent view, kirim jenis pekerjaan yang sama dengan mengetik ! sebagai karakter pertama dari input pengiriman: ! menunjukkan sebagai awalan, semuanya setelahnya adalah perintah, dan Enter memulai pekerjaan.

Perintah berjalan sebagai pekerjaan yang didukung PTY dan muncul sebagai baris di agent view, 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 <id> dari shell Anda. Output yang ditangkap tetap 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.

How file edits are isolated

Setiap sesi latar belakang, baik dimulai dari agent view, /bg, atau claude --bg, dimulai di direktori kerja Anda. Sebelum mengedit file, Claude memindahkan sesi ke git worktree terisolasi di bawah .claude/worktrees/, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri. Setelah sesi berada di worktree-nya, Claude Code menegakkan isolasi worktree untuk sesi dan untuk subagents apa pun yang dihasilkannya.

Claude melewati worktree ketika:

• Sesi sudah berada di dalam git worktree tertaut, baik Claude membuatnya di bawah .claude/worktrees/ atau Anda membuatnya dengan git worktree add di tempat lain
• File yang Claude edit berada di dalam git worktree tertaut, seperti yang dibuat sesi atau subagent-nya dengan git worktree add
• Direktori kerja bukan repositori git dan tidak ada WorktreeCreate hook yang dikonfigurasi
• Penulisan berada di luar direktori kerja

Untuk mematikan isolasi worktree untuk repositori di mana git worktrees tidak praktis, atur worktree.bgIsolation 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:

{
  "worktree": {
    "bgIsolation": "none"
  }
}

Di luar repositori git, sesi menulis ke direktori kerja secara langsung dan tidak terisolasi satu sama lain, jadi hindari pengiriman sesi paralel yang mengedit file yang sama. Jika Anda menggunakan sistem kontrol versi yang berbeda, konfigurasikan WorktreeCreate hook dan Claude mengisolasi edit dengan cara yang sama seperti untuk git.

Ketika hook gagal di direktori yang bukan repositori git, Claude melewati isolasi untuk direktori itu dan mengedit direktori kerja di tempat. Di dalam repositori git, Claude Code memblokir penulisan ke checkout bersama sampai Claude memindahkan sesi ke worktree.

Untuk menemukan jalur worktree sesi, intip sesi atau lampirkan dan periksa direktori kerjanya.

Subagent yang dihasilkan sesi latar belakang mewarisi direktori kerja sesi, jadi edit file-nya mendarat di worktree sesi daripada salinan kerja Anda. Untuk memberikan subagent worktree terpisah miliknya sendiri, atur isolation: worktree dalam frontmatter-nya atau berikan isolation: "worktree" ketika memunculkannya.

Ketika sesi latar belakang telah membuat perubahan kode di worktree Claude masuki, Claude Code menginstruksikan Claude untuk menyimpan pekerjaan sebelum selesai, sehingga bertahan jika Anda menghapus sesi dan worktree-nya:

• Commit and push: Claude melakukan commit tanpa bertanya, dan mendorong cabang ketika repositori memiliki remote.
• Draft pull request: Claude membuka satu ketika tugas memanggilnya, dan label #N muncul di baris.
• Never: mendorong ke main atau master, force-pushing, dan merging.
• Instruksi git Anda mengambil prioritas: jika tugas, CLAUDE.md, atau memory mengatakan Anda menangani committing atau pushing sendiri, Claude membiarkan git untuk Anda.

Sesi yang mengedit checkout yang tidak mengisolasi dirinya sendiri masih meminta sebelum committing atau switching branches. Ini berlaku ketika isolasi diatur ke "none", ketika pergerakan worktree gagal, atau ketika sesi dimulai di dalam worktree yang sudah ada.

Apa pun tugasnya, Claude mengakhiri pekerjaan dengan laporan yang mengatakan apa yang dilakukannya dan di mana pekerjaan itu: jalur, cabang, permintaan tarik, atau jawabannya sendiri.

What deleting a session removes

Hapus sesi dengan Ctrl+X dua kali dalam agent view atau dengan claude rm. Kecuali dalam kasus yang disimpan di bawah, sesi meninggalkan daftar. Transkrip-nya tetap di mesin Anda melalui claude --resume, dan penghapusan bertahan supervisor restart.

Apa yang terjadi pada worktree Claude buat untuk sesi:

• Agent view menghapusnya, termasuk perubahan yang tidak di-commit, jadi commit apa yang ingin Anda simpan terlebih dahulu.

• claude rm menyimpannya, bersama dengan baris sesi, ketika memiliki perubahan yang tidak di-commit.

• Baik agent view maupun claude rm tidak menghapus worktree yang sesi lain yang berjalan gunakan atau kunci, dan menghapus lagi tidak mengubah itu. Claude Code menyimpan worktree dan sesi, dan memberi nama direktori yang disimpan dan alasannya; di agent view, baris sesi menunjukkan not deleted. Tutup sesi lain, kemudian hapus lagi.

• Ketika Anda menghapus sesi yang worktree-nya memiliki commits yang Claude Code tidak dapat konfirmasi disimpan di tempat lain, Claude Code menyimpan worktree dan sesi, dan pesan menyebutkan cabang worktree dan berapa banyak commits yang tidak didorong. Pesan juga menawarkan dua cara maju: dorong commits, atau hapus lagi untuk membuangnya.

  Commits pada remote tidak memblokir penghapusan. Begitu juga commits pada salinan lokal cabang default remote origin Anda, asalkan cabang itu diperiksa di checkout utama Anda, direktori repositori itu sendiri daripada worktree.

  Setelah penolakan itu, Anda memilih:

  • Untuk menyimpan commits, dorong mereka, atau gabungkan mereka ke dalam cabang default itu, kemudian hapus sesi lagi.
  • Untuk membuangnya, hapus sesi lagi tanpa mendorong: tekan Ctrl+X dua kali pada barisnya di agent view, atau jalankan perintah claude rm <id> --discard-unpushed yang ditolak cetak. Ini menghapus sesi dan worktree bersama dengan cabangnya, membuang commits yang tidak didorong dan perubahan apa pun yang tidak di-commit.

  Ketika Anda menghapus lagi, Claude Code membuang hanya apa yang ditolak tunjukkan: jika worktree telah mendapatkan commit sejak itu, Claude Code menyimpannya lagi dan menunjukkan status yang diperbarui.

  Ketika catatan sesi selesai lainnya juga menyebutkan worktree, itu tetap ketika Anda menghapus lagi; dorong commits, kemudian hapus lagi.

• Worktree yang git tidak lagi kenali, misalnya setelah git worktree prune, tidak memblokir penghapusan. Claude Code menghapus sesi dan meninggalkan direktori di disk.

• Ketika git atau WorktreeRemove hook Anda gagal menghapus worktree, Claude Code menyimpan worktree dan sesi, dan pesan menyebutkan penyebabnya. Untuk hook, pesan mengatakan bagaimana itu berakhir, seperti exited 1, dan mengutip awal stderr-nya. Pesan juga memberitahu Anda mana dari ini yang harus dilakukan selanjutnya:

  • Hapus sesi lagi untuk menghapus direktori bagaimanapun, dengan menekan Ctrl+X dua kali pada barisnya di agent view atau menjalankan perintah claude rm <id> --force-remove-worktree <worktree-id> yang ditolak cetak. Claude Code menawarkan ini hanya ketika dapat mengonfirmasi direktori adalah salah satu worktrees tertaut repositori di bawah .claude/worktrees/ tanpa perubahan yang tidak di-commit ke file yang dilacak, tidak ada repositori bersarang di dalamnya, dan tidak ada catatan sesi lain yang menyebutkannya. Cabang worktree tetap dalam repositori.
  • Perbaiki apa yang menghalangi, seperti committing atau stashing perubahan yang tidak di-commit, menutup apa pun yang menggunakan direktori, atau memperbaiki hook, kemudian hapus sesi lagi.
  • Hapus direktori sendiri, kemudian hapus sesi lagi.

Worktree yang Anda buat sendiri dan mulai sesi di dalamnya ditinggalkan di tempat bagaimanapun.

Sesi yang direktori worktree-nya tidak termasuk dalam repositori git apa pun, karena repositori dihapus atau WorktreeCreate hook membuat direktori di tempat lain, masih dapat dihapus. Sementara file tetap dalam direktori:

• Agent view meminta Ctrl+X double-press yang sama sebelum membuangnya. Untuk direktori yang dibuat hook, ia menjalankan WorktreeRemove hook Anda sebagai gantinya, dan tanpa satu itu menolak penghapusan dan menyimpan sesi.
• claude rm menyimpan sesi dan worktree, dan menyebutkan alasannya.

Jalur mana pun menyimpan direktori yang catatan sesi selesai lainnya sebutkan.

Set the model

Nama model yang ditampilkan di header agent view adalah default pengiriman. Sesi baru yang Anda mulai dari input menggunakan model ini, yang berasal dari pengaturan model dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih /model, atau edit pengaturan secara langsung.

Untuk mengganti default pengiriman untuk seluruh sesi agent view, berikan --model ketika membuka agent view. Lihat Permission mode, model, and effort.

Untuk mengubah default pengiriman dari dalam agent view, ketik /model diikuti dengan nama model dalam input pengiriman dan tekan Enter. Header diperbarui untuk menunjukkan model itu dengan penanda (session), dan sesi yang Anda kirim setelahnya menggunakannya. Ketik /model default untuk menghapus penggantian dan kembali ke default pengiriman. Penggantian ini berlangsung untuk sisa jalankan claude agents saat ini dan tidak menulis ke file pengaturan Anda. Contoh berikut mengirim satu sesi pada Opus dan yang berikutnya pada Sonnet:

/model opus
refactor auth
/model sonnet
run the test suite

Setiap sesi latar belakang dapat berjalan pada model yang berbeda. Untuk mengganti untuk satu sesi:

• Dari shell, berikan --model dengan claude --bg.
• Lampirkan ke sesi yang berjalan dan jalankan /model untuk beralih: pilihan dari pemilih, atau /model <name> yang diketik, disimpan sebagai default Anda untuk sesi baru kecuali Anda menekan s dalam pemilih untuk switch hanya-sesi. Switch hanya-sesi bertahan jika sesi dimulai ulang.
• Kirim subagent yang frontmatter-nya menetapkan bidang model.

Permission mode, model, and effort

Sesi latar belakang mengambil pengaturan, penyedia, mode izin, model, dan upaya dari tempat dan cara Anda mengirimnya. Subbagian di bawah mencakup setiap sumber, dan apa yang bertahan ketika supervisor memulai ulang sesi.

Settings and provider

Sesi latar belakang membaca pengaturan dari direktori tempat ia berjalan, sama seperti jika Anda telah memulai claude di sana. Ini termasuk nilai env dalam pengaturan proyek, jadi ANTHROPIC_MODEL atau variabel penyedia yang ditetapkan di sana berlaku untuk setiap sesi latar belakang di direktori itu.

Sesi latar belakang juga berjalan dengan PATH dari shell tempat Anda mengirimnya, jadi perintah yang dijalankannya menemukan alat yang sama yang ditemukan terminal Anda. Ia menyimpan pilihan penyedia cloud shell itu juga, seperti CLAUDE_CODE_USE_BEDROCK atau CLAUDE_CODE_USE_VERTEX, bersama dengan alias ANTHROPIC_DEFAULT_*_MODEL dan penggantian CLAUDE_CODE_EXTRA_BODY apa pun yang Anda ekspor di sana.

LLM gateway

Jika Anda merutekan Claude Code melalui LLM gateway, letakkan variabel gateway dalam blok env file pengaturan daripada mengekspornya di shell Anda, dan sesi latar belakang membacanya dengan sisa pengaturan mereka. Set in a settings file menunjukkan blok dan file pengaturan mana yang digunakan untuk kredensial.

Jika Anda mengekspor gateway ANTHROPIC_BASE_URL hanya di shell Anda sebagai gantinya, itu mencapai sesi latar belakang, bersama dengan ANTHROPIC_CUSTOM_HEADERS dan kredensial yang Anda ekspor dengannya, hanya ketika supervisor itu sendiri dimulai dari shell yang mengekspor gateway yang sama, dan hanya dalam kasus ini:

• Anda backgrounding sesi Anda sendiri dengan ← atau /background
• Anda mengirim sesi ke direktori yang Anda masuki
• Anda membangunkan sesi yang dihentikan di direktori yang Anda masuki dengan melampirkan atau membalasnya

Claude Code meneruskan gateway di depan penyedia cloud. Jika shell tempat Anda mengirim memilih penyedia dan mengekspor titik akhir gateway-nya dengan bendera bypass auth-nya, Claude Code meneruskan pasangan endpoint-dan-bendera ke sesi di bawah kondisi yang berlaku untuk ANTHROPIC_BASE_URL, bersama dengan ANTHROPIC_CUSTOM_HEADERS. Misalnya, ekspor CLAUDE_CODE_USE_VERTEX=1 dengan ANTHROPIC_VERTEX_BASE_URL dan CLAUDE_CODE_SKIP_VERTEX_AUTH=1, dan Claude Code meneruskan titik akhir dan bendera itu.

Claude Code menerapkan gateway yang diteruskan ke proses sesi yang berjalan saja dan tidak pernah menulisnya ke disk.

Permission mode

Mode izin tergantung pada cara Anda memulai sesi:

• Backgrounded dengan /bg atau ←: Claude Code menyimpan mode izin sesi yang ada, jadi yang Anda alihkan ke acceptEdits atau auto tetap di sana setelah melepas
• Dikirim dari agent view yang Anda buka dengan ←: konfigurasi target sendiri datang terlebih dahulu, dan mode izin sesi yang Anda datang dari berlaku ketika tidak ada yang menetapkan satu
• Dikirim dari claude agents dimulai dalam shell, atau dengan claude --bg: sesi baru dimulai dengan cara sesi claude baru di direktori itu akan, kecuali Anda mengirimnya dari agent view yang Anda buka dengan dispatch defaults. Which permission mode a session starts in mencantumkan urutan

Untuk sesi yang Anda kirim dari agent view yang dibuka dengan ←, Claude Code mengambil mode izin dari yang pertama dari ini yang berlaku:

1. permissions.defaultMode direktori target. Dua aturan sumber berlaku:
   • auto dan bypassPermissions hanya berlaku dari pengaturan yang dikelola, file --settings, atau ~/.claude/settings.json.
   • Claude Code menolak defaultMode dari .claude/settings.json atau .claude/settings.local.json proyek yang memilih mode lebih permisif daripada sesi yang Anda datang dari.
2. Mode izin sesi yang Anda datang dari

Ketika Claude Code menolak mode sumber sebagai terlalu permisif, sumber berikutnya dalam daftar memutuskan. Misalnya, jika Anda mengirim dari sesi mode rencana ke direktori yang pengaturan yang diperiksa minta acceptEdits, sesi baru dimulai dalam mode rencana. Jika Anda memindahkan defaultMode itu ke ~/.claude/settings.json, itu berlaku terlepas dari mode izin sesi yang Anda datang dari.

Permissiveness berjalan rencana, kemudian Manual dan dontAsk, kemudian acceptEdits dan auto, yang masing-masing menghitung sebagai lebih permisif daripada yang lain, kemudian bypassPermissions.

Dispatch defaults

Untuk menetapkan default untuk setiap sesi yang Anda kirim dari agent view, berikan salah satu dari --permission-mode, --model, --effort, atau --agent ketika membukanya:

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

--effort di sini menerima nilai yang sama seperti bendera --effort tingkat atas, termasuk ultracode.

--agent menetapkan subagent yang digunakan ketika prompt pengiriman tidak menyebutkan satu, baik dengan @name atau sebagai kata pertama. Ini default ke pengaturan agent jika satu diatur, jika tidak agen claude catch-all bawaan. Menyebutkan subagent dalam input pengiriman mengganti 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.

Berikan --restricted untuk memulai setiap sesi yang Anda kirim dari tampilan dalam mode terbatas, seolah-olah masing-masing diluncurkan dengan bendera --restricted tingkat atas. Memerlukan Claude Code v2.1.248 atau lebih baru.

Default aktif muncul di footer di bawah input pengiriman.

Claude Code menolak claude --bg --permission-mode bypassPermissions sampai Anda telah menerima penafian bypass dengan menjalankan claude --dangerously-skip-permissions sekali secara interaktif, karena mode itu memungkinkan sesi yang tidak Anda tonton bertindak tanpa persetujuan. Melewatkan --dangerously-skip-permissions atau --permission-mode bypassPermissions ke claude agents menunjukkan penafian yang sama ketika Anda belum menerimanya sebelumnya, dan menerima menerapkan bypassPermissions ke sesi yang Anda luncurkan dari tampilan. Melewatkan --allow-dangerously-skip-permissions menunjukkan penafian yang sama juga, dan menerima membuat bypassPermissions tersedia dalam siklus Shift+Tab sesi itu tanpa memulai mereka di dalamnya.

What persists across restarts

Mode izin, model, dan upaya yang Anda pilih untuk sesi latar belakang, bersama dengan bendera konfigurasi yang dibawanya, semuanya bertahan ketika supervisor nanti berhenti dan memulai ulang prosesnya. Sesi yang Anda luncurkan dengan claude --bg --dangerously-skip-permissions atau claude --bg --permission-mode bypassPermissions tetap dalam bypassPermissions setelah restart itu. Model atau upaya yang Anda ubah pertengahan sesi dengan /model atau /effort juga disimpan.

Jika sesi mengambil upayanya dari pengaturan Anda daripada dari --effort atau /effort, Claude Code membaca pengaturan Anda lagi setiap kali memulai proses untuk sesi. Setelah Anda mengedit upaya yang disimpan dalam settings.json, perubahan mencapai sesi yang Anda background dengan ← atau /bg, dan restart mereka nanti. Upaya yang disimpan adalah kunci effortLevel atau entri modelSettings.

Claude Code juga menyimpan nama yang Anda atur dengan /rename atau Ctrl+R di seluruh restart itu, jadi Anda masih dapat menjalankan claude --resume <name> untuk mencapai sesi.

Prompt yang Anda simpan dengan Ctrl+S saat dilampirkan disimpan dengan sesi juga. Buka kembali sesi setelah prosesnya dihentikan atau dimulai ulang, dan Ctrl+S memulihkan teks yang disimpan. Konten yang ditempel dalam simpanan tidak bertahan restart.

Settings, plugins, and MCP servers

Agent view menerima bendera konfigurasi yang sama seperti claude untuk memuat pengaturan, plugin, server MCP, dan direktori tambahan. Agent view menerapkan --settings dan --plugin-dir ke dirinya sendiri dan melewatkan setiap bendera konfigurasi ke sesi yang Anda kirim darinya, jadi plugin atau server MCP yang Anda muat dengan cara ini tersedia dalam sesi itu.

Ulangi --add-dir, --plugin-dir, atau --mcp-config sekali per nilai. claude agents tidak mendukung bentuk yang dipisahkan spasi, seperti --add-dir a b c.

Anda dapat menempatkan --settings dan --plugin-dir sebelum atau sesudah agents. Simpan --add-dir dan --mcp-config setelah agents: jika Anda menempatkan salah satu sebelum agents, claude agents --json gagal dengan kesalahan unknown option.

Contoh berikut membuka agent view dengan penggantian pengaturan dan satu direktori tambahan:

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

--settings menerima jalur file atau string JSON inline. Jalur file harus menunjuk ke file yang ada; Claude Code keluar dengan kesalahan Settings file not found jika tidak.

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.

Daftar sesi sebagai JSON

claude agents --json mencetak 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, dan --cwd <path> untuk membatasi daftar ke sesi yang dimulai di bawah direktori tersebut.

Setiap entri menjelaskan satu sesi:

Baca status sesi dari skrip

claude agents --json adalah cara yang didukung untuk membaca status sesi dari luar Claude Code, misalnya dari bilah status, penjadwal, atau sesi Claude lain yang mengawasi pekerjaan latar belakang. Poll claude agents --json --all, yang terus mencantumkan sesi yang prosesnya telah keluar, dan baca state, status, dan waitingFor setiap entri.

Sesi yang menyelesaikan gilirannya dan menunggu instruksi berikutnya Anda membaca done, bukan blocked. blocked selalu berarti sesi membutuhkan sesuatu dari Anda sebelum dapat melanjutkan.

File di bawah ~/.claude/jobs/<id>/ bukan antarmuka yang stabil. Nilai yang ditulis sesi atau program lain ke state, detail, tempo, atau needs diganti pada pembaruan berikutnya.

Jika Anda ingin sesi melaporkan kemajuan dengan kata-katanya sendiri, buat sesi menulis file miliknya sendiri, misalnya di bawah $CLAUDE_JOB_DIR/tmp, alih-alih mengedit state.json.

Bagaimana sesi latar belakang dihosting

Claude Code memperlakukan setiap sesi yang tercantum dalam tampilan agen 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.

Untuk memeriksa jenis sesi apa yang Anda gunakan, jalankan /status. Baris Session kind menampilkan background job · attached atau background job · unattended dalam sesi latar belakang, tergantung pada apakah terminal terhubung, dan interactive dalam sesi lainnya.

Proses supervisor

Supervisor adalah layanan latar belakang yang menjalankan sesi latar belakang Anda sehingga terus bekerja setelah Anda menutup tampilan agen atau terminal Anda. Claude Code memulainya pertama kali Anda mengirim sesi ke latar belakang atau membuka tampilan agen, dan Anda tidak perlu mengelolanya sendiri.

Setiap sesi adalah proses Claude Code-nya sendiri di bawah supervisor, dan apa yang terjadi pada proses itu tergantung pada status sesi:

• Bekerja, dijeda pada permintaan izin atau dialog lainnya, atau terhubung: proses terus berjalan. Subagen yang berjalan, alur kerja, atau monitor dihitung sebagai bekerja.
• Selesai atau menunggu pesan Anda berikutnya, dan tidak terhubung selama sekitar satu jam: supervisor menghentikan proses untuk membebaskan sumber daya. Sesi yang mengakhiri giliran dengan mengajukan pertanyaan kepada Anda dihitung sebagai menunggu pesan Anda berikutnya. Percakapan tetap di disk, dan lain kali Anda melampirkan atau membalas, sesi dilanjutkan dari tempat ia berhenti. Pin sesi dengan Ctrl+T untuk membuat prosesnya tetap berjalan.
• Keluar secara tidak terduga sementara supervisor berjalan: supervisor memulai ulang proses. Mengakhiri sesi yang Anda kirim ke latar belakang sendiri dengan ← atau /background, misalnya dengan kill, menandainya sebagai berhenti alih-alih memulai ulangnya. Untuk sesi yang berakhir dengan shutdown, lihat Sesi menampilkan sebagai gagal atau berhenti setelah shutdown.
• Setelah auto-update: supervisor memulai ulang dirinya sendiri ke versi baru dan memindahkan sesi idle ke latar belakang. Sesi yang bekerja, menunggu Anda, atau terhubung tidak terganggu.

Ketika proses sesi berhenti atau dimulai ulang, perintah shell latar belakang, alur kerja dinamis, dan subagen latar belakang yang Claude mulai di dalamnya dibawa ke proses berikutnya; monitor yang berjalan dan perintah shell yang subagen mulai berhenti dengan proses. Menghapus sesi menghentikan semua yang dibawanya. Untuk menghentikan semuanya dengan proses alih-alih membawanya, atur CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF ke 1.

Supervisor dan sesinya mengautentikasi dengan kredensial yang disimpan sama seperti sesi interaktif Anda. Untuk pengaturan dan variabel shell mana yang mencapai sesi, termasuk PATH, lihat Pengaturan dan penyedia. Untuk titik akhir gateway, lihat Gateway LLM.

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.

Setiap sesi latar belakang memiliki variabel lingkungan CLAUDE_JOB_DIR yang diatur ke direktori ~/.claude/jobs/<id> 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.

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.

Sesi bertahan melalui ketidaksesuaian versi itu utuh: versi Claude Code yang lebih lama yang memperbarui state.json sesi menyimpan bidang yang tidak dikenalinya dan membuat sesi tetap terdaftar. Daftar sesi dalam roster.json mengikuti aturan yang sama, jadi sesi yang dimulai oleh versi yang lebih baru tetap dapat dijangkau dan terus menerima masukan setelah supervisor dimulai ulang.

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. 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

Sebelum Anda mengirim sesi pertama Anda, tampilan agen menampilkan bagian header kosong dengan deskripsi di bawah masing-masing, ditambah penjelasan satu baris di atas input, sebagai pengganti daftar sesi. Ketik prompt dalam input di bagian bawah dan tekan Enter untuk mengirim sesi pertama Anda.

Melepaskan menunjukkan dialog `Background this session?`

Jika Anda menekan ← untuk melepaskan sesi saat ini dan Claude Code menampilkan dialog Background this session?, sesi memiliki pekerjaan yang sedang berlangsung yang melepaskan akan menghentikan, memulai ulang, atau biarkan berjalan tanpa pengawasan, dan Claude Code bertanya sebelum melakukan salah satu dari hal tersebut:

• Pekerjaan yang tidak dapat dipindahkan: sesi memiliki pekerjaan yang tidak dapat dipindahkan ke sesi latar belakang, seperti monitor yang sedang berjalan. Dialog menyebutkan pekerjaan yang akan dihentikan Claude Code dan, secara terpisah, menghitung tugas yang dibawa.
• Alur kerja dengan subagen yang sedang berjalan: alur kerja dinamis masih memiliki subagen yang sedang berjalan. Alur kerja itu sendiri dibawa, tetapi subagen yang sedang berjalannya dimulai ulang dari awal, dan dialog mengatakan berapa banyak.
• Balasan artefak otomatis: Claude membalas komentar pada artefak dengan sendirinya. Balasan tersebut berlanjut dalam sesi latar belakang, dan dialog mengatakan demikian.

Jalankan /tasks untuk melihat semua yang sedang berjalan, kemudian konfirmasi untuk melepaskan atau pilih Stay untuk membiarkan pekerjaan selesai terlebih dahulu. Lihat Apa yang dibawa saat Anda melepaskan untuk jenis pekerjaan mana yang dibawa dan mana yang dihentikan Claude Code.

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 atau dihentikan setelah shutdown

Mematikan atau memulai ulang mesin Anda menghentikan sesi latar belakang yang sedang berjalan. Sesi yang menunggu input Anda tetap di bawah Needs input saat Anda kembali. Untuk sesi yang sedang berjalan lainnya, apa yang ditampilkan tampilan agen tergantung pada berapa lama yang lalu sesi terakhir membuat kemajuan:

• Dalam 48 jam, sesi menampilkan sebagai gagal. Lampirkan atau balas dan sesi itu dimulai ulang dari tempat ia berhenti.
• Melewati 48 jam, seperti setelah mesin mati selama berhari-hari, sesi menampilkan sebagai dihentikan dengan ended while the background service was off. Tekan Enter pada baris dan footer menampilkan Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Tekan Enter pada baris yang sama lagi untuk melanjutkan percakapan yang disimpannya. Balasan, atau claude attach <id>, melanjutkannya tanpa prompt footer itu.

Ketika pembersihan transkrip telah menghapus percakapan yang disimpan dari sesi yang dihentikan, Claude Code menolak untuk membuka baris: pesan mengatakan tidak ada yang dapat dilanjutkan. claude rm <id> menghapus baris, kecuali dalam kasus yang disimpan yang dijelaskan di atas, dan claude respawn <id> menjalankan prompt aslinya lagi. Lihat Percakapan yang disimpan sesi ini tidak lagi ada di disk.

Sleep saja tidak menghentikan sesi. Sesi dipertahankan di seluruh sleep dan supervisor terhubung kembali ke sesi tersebut saat bangun.

Membuka sesi mengatakan percakapan sudah terbuka

Dua proses tidak dapat menulis ke transkrip yang sama. Ketika percakapan yang disimpan dari sesi yang dihentikan sudah terbuka di proses Claude Code yang sedang berjalan lainnya, Claude Code menolak untuk memulai proses sesi itu sendiri. Apa yang Anda lihat tergantung pada apa yang memegang percakapan:

• Terminal tempat Anda melanjutkan percakapan, misalnya dengan claude --resume atau /resume: baris menampilkan Open in a terminal dengan petunjuk untuk melanjutkannya di sana, dan membuka baris menampilkan Can't open — this session is running in another terminal. Lanjutkan di terminal itu, atau keluar darinya dan buka baris lagi.
• Proses Claude Code non-interaktif lainnya, misalnya proses sesi latar belakang untuk percakapan yang sama yang belum keluar: membuka baris menampilkan This conversation is already open in another running Claude session. Gunakan proses itu, atau tunggu sampai keluar dan buka baris lagi.

Claude Code menyimpan balasan yang Anda ketik dengan upaya yang ditolak dan mengirimnya saat sesi berikutnya dimulai.

Membuka sesi mengatakan tidak memiliki transkrip yang disimpan

Sesi yang dihentikan yang dilepaskan dari percakapan lain dan dihentikan sebelum respons pertamanya selesai tidak memiliki apa pun untuk dilanjutkan: sampai respons pertama itu selesai, percakapan masih hidup hanya dalam sesi yang dilepaskan darinya. claude attach menolak untuk membukanya dengan This session has no saved transcript.

Dalam tampilan agen, membuka baris itu menampilkan Press enter again to restart this session fresh di bawah daftar. Tekan Enter pada baris yang sama lagi untuk memulai ulang sesi dengan percakapan kosong, atau jalankan claude respawn <id> dari shell.

Percakapan asli tetap utuh; lanjutkan dengan claude --resume atau terus bekerja di dalamnya. Lihat referensi kesalahan untuk detail.

Host terminal mati atau sesi berhenti merespons

Supervisor menjalankan terminal setiap sesi latar belakang dalam proses host-nya sendiri. Ketika proses itu mati atau berhenti merespons, Claude Code menampilkan alasannya dan menawarkan restart; dalam kedua kasus percakapan disimpan dan restart melanjutkannya. Referensi kesalahan mengutip pesan lengkapnya.

Claude Code tidak pernah memulai ulang baris yang menjalankan perintah shell, dari Enter atau dari claude attach, karena itu akan menjalankan perintah lagi; pesan baris dan claude attach keduanya mengatakan perintah tidak dijalankan lagi.

Host terminal mati

Di Linux dan WSL, supervisor memeriksa setiap proses host setiap beberapa detik, apakah Anda membuka sesi atau tidak, dan menandai sesi gagal ketika proses telah keluar tetapi koneksinya ke supervisor tidak pernah ditutup.

• Dalam tampilan agen, baris menampilkan terminal host process died — press Enter to restart. Tekan Enter padanya dan Claude Code memulai ulang sesi pada proses host yang segar.
• Dari shell, claude attach <id> memulai ulang sesi yang sudah ditandai gagal. Jika tidak, itu melaporkan penyebabnya dan keluar, memberi tahu Anda untuk menjalankan claude attach <id> lagi.

Sesi tidak merespons

Ketika supervisor menerima pembukaan tetapi tidak ada output yang tiba selama sekitar sepuluh detik, Claude Code mengakhiri upaya dan menawarkan restart. Sesi yang hanya macet, misalnya di seluruh sleep mesin, tidak mencapai penawaran ini: supervisor memulai ulangnya saat dibuka itu sendiri.

• Dalam tampilan agen, footer menampilkan Press enter again to restart this session — it isn't responding (its conversation is saved and resumes). Tekan Enter pada baris yang sama lagi dan Claude Code menghentikan proses yang tidak merespons dan memulai ulang sesi; itu tidak menghentikan apa pun tanpa tekan kedua itu.
• Dari shell, claude attach <id> melaporkan penyebabnya dan keluar, memberi tahu Anda untuk menjalankan claude stop <id>, kemudian claude attach <id>.

Sesi gagal sebelum dimulai dengan catatan `possibly low memory`

Ketika proses sesi latar belakang keluar sebelum selesai dimulai dan host kekurangan memori, status baris menyebutkan keluar dan menambahkan possibly low memory — free some up and retry.

Catatan ini adalah hipotesis, bukan penyebab yang dikonfirmasi. Claude Code menambahkannya hanya ketika proses keluar diam-diam, tanpa menulis kesalahan dan tanpa dihentikan oleh sinyal, dan host melaporkan memori rendah pada saat itu. Ketika proses menulis kesalahan sebelum keluar, baris menampilkan kesalahan itu sebagai gantinya.

Bebaskan memori di mesin, kemudian lampirkan atau balas ke baris dan supervisor memulai proses segar untuk sesi. Ketika memori tetap rendah, supervisor juga menghentikan sesi idle untuk membebaskan sumber daya dengan sendirinya, dan menghentikan sesi idle yang disematkan juga jika menghentikan yang lain tidak membebaskan apa pun.

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:

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.

Supervisor yang dimulai tetapi tidak dapat menerima koneksi keluar dan melepaskan kuncinya sendiri, jadi claude agents berikutnya memulai yang baru tanpa penghentian manual ini. Langkah-langkah di atas berlaku ketika supervisor yang sedang berjalan macet.

Jika perintah malah keluar mengatakan proses yang tercatat tidak dapat diverifikasi sebagai supervisor, periksa ID proses yang dilaporkan: jika itu adalah supervisor yang Anda miliki, hentikan sendiri, kemudian hapus ~/.claude/daemon.lock sehingga claude agents berikutnya dimulai segar.

Di Windows, jika supervisor tidak merespons permintaan stop, perintah mencetak ID prosesnya. Akhiri proses itu dengan taskkill /PID <pid> untuk menyelesaikan pemulihan. Sesi latar belakang masih dipertahankan saat Anda memberikan --keep-workers.

Pengiriman gagal dengan `Could not resolve authentication method`

Jika pengiriman latar belakang gagal dengan Could not resolve authentication method sementara sesi interaktif mengautentikasi secara normal, worker yang menerima pengiriman tidak mengambil kredensial. Sesi latar belakang mendapatkan kredensial mereka dari supervisor, 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:

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 untuk daftar lengkap penyebab dan perbaikan.

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 latar belakang tidak dapat menjangkau host jaringan lokal di macOS

Di macOS 15 dan yang lebih baru, sistem memblokir proses dari menjangkau perangkat di jaringan lokal Anda sampai Anda memberikan izin Local Network, jadi perintah yang menargetkan alamat LAN dapat gagal dengan connect: no route to host dalam sesi latar belakang meskipun berfungsi di terminal foreground. Perintah pertama dalam sesi latar belakang yang terhubung ke alamat jaringan lokal memicu prompt izin Local Network macOS untuk Claude Code. Berikan sekali dan perintah tersebut menjangkau host LAN dengan cara yang sama seperti di terminal foreground.

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 dan beralih ke sesi segera sementara proses dimulai ulang. Sesi yang bekerja, menunggu Anda, atau disematkan tidak dihentikan dengan cara ini, jadi semat sesi dengan Ctrl+T untuk menjaganya tetap responsif.

Saat proses dimulai, Claude Code menampilkan ekor transkrip sesi yang diformat dengan cara sesi langsung merender, dengan markdown, blok kode yang disorot, dan panggilan alat sebagai baris yang redup, di atas area prompt yang redup dengan catatan Session is starting. Sesi langsung menggantikannya segera setelah siap.

`.claude/worktrees/` penuh

Menghapus sesi dalam tampilan agen menghapus worktree yang dibuat Claude untuk sesi tersebut, tetapi beberapa penghapusan menyimpan worktree atau meninggalkan direktorinya di disk, jadi direktori sisa dapat terakumulasi. Direktori yang tidak lagi dikenali git tidak muncul dalam git worktree list, jadi hapus yang tersebut dengan tangan.

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. Sesi ini dipertahankan di seluruh tidur tetapi berhenti jika mesin dimatikan.
• Worktrees yang dibuat Claude dihapus dengan sesi di tampilan agen: gabungkan perubahan sebelum menghapus sesi yang mengedit file di worktree-nya sendiri. Beberapa penghapusan menyimpan worktree sebagai gantinya.

Sumber daya terkait

Untuk cara lain menjalankan Claude secara paralel, dan untuk meneruskan temuan antar sesi yang Anda jalankan, lihat:

• Jalankan agen secara paralel: bandingkan tampilan agen dengan subagents, tim agen, dan worktrees
• Pesan lintas sesi: biarkan sesi Anda meneruskan temuan satu sama lain
• Tim agen: koordinasikan beberapa sesi yang saling berpesan
• Gunakan Claude Code di cloud: jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal
• Projects: biarkan Claude mengoordinasikan sesi cloud paralel dari satu percakapan dan beritahu Anda mana yang Anda butuhkan

Riwayat versi

Tampilan agen telah berkembang dengan cepat selama pratinjau penelitian. Jika Anda berada di versi Claude Code yang lebih lama, beberapa perilaku di halaman ini mungkin berbeda; khususnya, claude agents menolak bendera yang belum didukungnya dengan kesalahan unknown option. Tabel di bawah mencantumkan kapan setiap bendera dan perilaku ditambahkan.