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.

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

Gunakan tampilan agen ketika Anda memiliki beberapa tugas independen yang dapat dikerjakan Claude tanpa Anda menonton setiap langkah. Kirim perbaikan bug, tinjauan permintaan tarik, dan investigasi tes yang tidak stabil sebagai tiga baris, terus bekerja di jendela lain, dan periksa kembali ketika baris menunjukkan bahwa itu membutuhkan Anda atau memiliki hasil.

Ketika Anda ingin bekerja lebih langsung di sesi agen mana pun, lampirkan ke baris untuk memasuki percakapan lengkap.

Untuk membandingkan tampilan agen dengan subagen, tim agen, dan worktrees, lihat Jalankan agen secara paralel.

Mulai cepat

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

Buka tampilan agen

Dari shell Anda, jalankan:

claude agents

Jika Anda belum menerima dialog kepercayaan ruang kerja untuk direktori tersebut, Claude Code menampilkannya sebelum tampilan agen terbuka, dialog yang sama yang ditampilkan claude. Terima untuk menyimpan kepercayaan untuk ruang kerja dan lanjutkan. Jika Anda menolak, Claude Code keluar tanpa membuka tampilan agen.

Tampilan agen terbuka dengan input di bagian bawah dan tabel yang terisi saat sesi dimulai. Tekan Esc untuk kembali ke shell Anda; jika Anda membuka tampilan agen dengan mengirim sesi ke latar belakang dengan ←, Esc kembali ke percakapan tersebut. Sesi Anda terus berjalan saat Anda pergi dan muncul kembali saat Anda membuka tampilan agen berikutnya.

Kirim sesi

Ketik prompt yang menjelaskan tugas dan tekan Enter. Sesi latar belakang baru dimulai pada tugas tersebut dan muncul sebagai baris yang menunjukkan apakah sedang bekerja, menunggu Anda, atau selesai. Sesi baru menggunakan model yang ditampilkan di header tampilan agen. Mode izin yang dimulainya tergantung pada cara Anda membuka tampilan agen.

Setiap prompt yang Anda masukkan di sini memulai sesi baru sendiri. Mengetik prompt lain dan menekan Enter meluncurkan sesi kedua bersama yang pertama daripada mengirim tindak lanjut ke sesi tersebut. Anda dapat menjalankan beberapa secara paralel dengan cara ini.

Setiap sesi menggunakan kuota langganan Anda secara independen, jadi lihat Batasan sebelum mengirim banyak sekaligus.

Intip dan balas

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

Lampirkan dan lepaskan

Tekan Enter atau → pada baris untuk melampirkan ketika Anda menginginkan percakapan lengkap. Sesi mengambil alih terminal sebagai sesi Claude Code interaktif penuh. Tekan ← pada prompt kosong untuk melepaskan dan kembali ke tabel.

Bawa sesi yang ada ke dalam

Langkah ini memerlukan sesi yang sedang berjalan. Jika Anda mengikuti langkah-langkah sebelumnya, Anda tidak memiliki sesi yang terbuka di terminal ini, jadi buka sesi claude biasa di terminal lain dan kirim pesan terlebih dahulu.

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. Dalam sesi baru tanpa pesan apa pun, /bg meminta Anda untuk mengirim pesan terlebih dahulu, sementara ← berfungsi langsung. 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.

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:

Status	Ikon ditampilkan sebagai	Artinya
Bekerja	Animasi	Claude secara aktif menjalankan alat atau menghasilkan respons
Membutuhkan masukan	Kuning	Claude menunggu sesuatu yang hanya Anda yang dapat berikan: jawaban atas pertanyaan, keputusan izin, atau prompt lain yang hanya Anda yang dapat menjawab, seperti prompt sandbox untuk mengizinkan host jaringan atau permintaan masukan server MCP. Perintah yang memerlukan terminal terpasang, seperti `/install-github-app` atau daftar pengaturan `/mcp`, juga menahan sesi yang tidak diawasi di sini
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	Anda menghentikan sesi dengan `Ctrl+X` atau `claude stop`, prosesnya diakhiri dari luar Claude Code, atau berakhir saat layanan latar belakang mati

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 baris, dan ketika Anda membalas atau melampirkan, Claude memulai ulang dari tempat ia berhenti
`✢`	Sesi `/loop` yang tidur di antara iterasi. Baris menunjukkan jumlah jalannya dan hitungan mundur

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.

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:

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

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:

Filter	Menampilkan
`a:<name>`	Sesi yang menjalankan agen bernama
`s:<state>`	Sesi dalam status tertentu, seperti `s:working`. Juga menerima `s:blocked` untuk semua yang menunggu Anda
`#<number>` atau URL PR atau MR	Sesi yang bekerja pada permintaan tarik atau permintaan penggabungan 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`	Sisipkan baris baru dalam input pengiriman, seperti dalam prompt utama
`Ctrl+Enter`	Kirim dan lampirkan segera, di terminal tempat overlay `?` mencantumkan `ctrl+enter to start and open`
`→`	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+J`	Sisipkan baris baru dalam input pengiriman
`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. Ketika Anda membuka tampilan agen dengan mengirim sesi Anda ke latar belakang dengan `←`, `Esc` terakhir kembali ke percakapan itu alih-alih keluar. Dengan mode editor vim aktif, menekan `Esc` dalam input beralih dari mode INSERT ke mode NORMAL dan menyimpan teks Anda, seperti dalam prompt utama
`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.

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 berkembang kembali ke dalam input.

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

Input	Efek
`<agent-name> <prompt>`	Jika kata pertama cocok dengan nama subagent kustom, subagent itu berjalan sebagai agen utama sesi dengan konfigurasi dari frontmatter-nya
`@<agent-name>`	Sebutkan subagent kustom di mana saja dalam prompt untuk menjalankannya sebagai agen utama
`@<repo>`	Sebutkan repositori untuk menjalankan sesi di sana. Lihat Kirim ke direktori tertentu untuk repositori mana yang terdaftar
`/<command>`	Sarankan skills dan commands untuk dikirim sebagai prompt
`! <command>`	Jalankan perintah shell sebagai pekerjaan latar belakang alih-alih memulai sesi Claude. Pekerjaan muncul sebagai baris yang dapat Anda lampirkan, tonton, dan lepaskan
`#<number>` atau URL permintaan tarik atau gabung	Jika sesi sudah bekerja pada permintaan tarik atau gabung itu, Claude Code memilih barisnya alih-alih mengirim sesi baru

Serangkaian kecil perintah berjalan dalam tampilan agen itu sendiri alih-alih mengirim:

/exit dan /quit menutup tampilan agen
/logout menandatangani Anda keluar
/model menetapkan model pengiriman
/login membuka dialog masuk sehingga Anda dapat masuk lagi tanpa melampirkan ke sesi
Bare /resume, atau aliasnya /continue, 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 pertamanya. Perintah built-in lainnya menampilkan petunjuk attach to a session to run it sebagai gantinya. Semua yang Anda ketik tetap berada dalam input di sebelah petunjuk sehingga Anda dapat mengeditnya.

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

Ketika @name yang sama cocok dengan subagent dan repositori saudara, subagent memiliki prioritas. Kecocokan kata pertama tanpa @ juga berlaku, jadi prompt yang dimulai dengan salah satu nama subagent Anda mengirim subagent itu daripada memperlakukan kata sebagai teks biasa. Gunakan bentuk @ ketika Anda ingin eksplisit, atau mulai prompt dengan kata berbeda untuk menghindari kecocokan.

Kirim ke direktori tertentu

Sesi baru berjalan di direktori tempat Anda membuka tampilan agen. Untuk menargetkan direktori berbeda, 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 dari yang berada di dalam pohon direktorinya, seperti yang Claude buat 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 direktori dan jalankan claude --bg "<prompt>".

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

Dari dalam sesi

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.

Kirim sesi ke latar belakang

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.

Keluar dari sesi yang masih memiliki pekerjaan latar belakang yang berjalan, seperti subagent, perintah shell latar belakang, alur kerja, atau monitor, menampilkan dialog Background work is running alih-alih berhenti segera. Pilih Move to background and exit untuk melepaskan sesi dengan cara yang sama seperti /background dan kembali ke shell Anda. Opsi tidak ditampilkan ketika tampilan agen dimatikan.

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

Salin sesi dengan /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. Salinan 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 dalam tampilan agen.

Setelah fork, dua percakapan independen: tidak ada yang dilakukan salinan memasuki percakapan asli dengan sendirinya, meskipun dalam sesi di mana pengiriman lintas sesi diaktifkan, Claude sesi 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 subagent yang di-fork sebagai gantinya, yang sekarang /subtask. Ketika tampilan agen 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 dalam claude agents dan tekan Space untuk mengirim satu, atau jalankan claude attach <id>. Baris yang dipilih menampilkan space to send it a prompt sementara menunggu.

Konfirmasi /fork adalah satu baris yang menunjukkan status salinan, seperti session running, nama baris tampilan agen-nya, dan ID sesinya untuk claude attach. Klik nama untuk beralih ke salinan: sesi ini pindah ke latar belakang, sama seperti menekan ←, dan tampilan agen 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 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 pada tempat sesi saat ini berjalan:

Seperti sesi yang dikirim apa pun, salinan pindah 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 dalam 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 dalam 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 dalam pohon kerja utama itu, dengan aturan worktree-milik-sendiri yang sama tetapi tanpa 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 diwarisi 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 tampilan agen di-fork secara normal: salinan diluncurkan dengan definisi agen dan instruksi yang ditambahkan yang sama seperti sesi yang berasal darinya.

Apa yang dibawa ketika Anda melepaskan ke latar belakang

Melepaskan ke latar belakang memulai proses segar yang dilanjutkan dari percakapan yang disimpan, dan pekerjaan yang sedang berlangsung berpindah ke sana: menjalankan perintah shell latar belakang, subagent yang dilepaskan ke latar belakang, alur kerja dinamis, tugas terjadwal yang Anda buat dengan /loop, dan balasan otomatis Claude ke komentar artefak semuanya dibawa dan terus berjalan di sana. Subagent bergerak bersama dengan semua yang dimulainya, jadi hanya dibawa ketika semua pekerjaan itu dapat berpindah 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 melepaskan.

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

Claude Code menghentikan pekerjaan yang tidak dapat dibawa, seperti monitor yang sedang berjalan, dan menghentikan subagent yang dilepaskan ke latar belakang yang memiliki monitor bersama dengannya. Ketika ada pekerjaan seperti itu yang sedang berjalan, Claude Code menampilkan dialog Background this session? sehingga Anda dapat mengonfirmasi sebelum dihentikan.

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 juga dibawa. Membawa --allow-dangerously-skip-permissions 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 dijelaskan dalam Mode izin, model, dan upaya.

Dari shell Anda

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 tertentu yang 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 subagent Anda, peluncuran gagal: Claude Code mencetak peringatan no agent named dan masih melaporkan sesi sebagai dilepaskan ke latar belakang, tetapi sesi keluar segera dengan kesalahan --agent '<name>' not found.

Ketika sesi yang dilepaskan ke latar belakang nanti dilanjutkan atau dimulai ulang, Claude Code memulihkan prompt sistem agen dan pembatasan alat. Sesi mencari direktorinya sendiri untuk agen terlebih dahulu, asalkan Anda telah mempercayai ruang kerja itu, jadi agen yang dibatasi proyek masih dimuat ketika sesi dilanjutkan dari direktori lain. Jika agen tidak lagi ada, sesi berlanjut dengan alat default dan prompt sistem dan transkrip-nya terbuka dengan peringatan yang menyebutkan agen.

Berikan --name untuk menetapkan nama tampilan sesi dalam tampilan agen alih-alih yang dibuat secara otomatis:

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

Jalankan perintah shell

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 tampilan agen, kirim pekerjaan jenis yang sama dengan mengetik ! sebagai karakter pertama dari input pengiriman: ! ditampilkan sebagai awalan, semua yang setelahnya adalah perintah, dan Enter memulai pekerjaan.

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 <id> 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 yang terisolasi di bawah .claude/worktrees/, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri. Setelah sesi berada dalam worktree-nya, Claude Code memberlakukan isolasi worktree untuk sesi dan untuk subagent apa pun yang dihasilkannya.

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
File yang Claude edit berada di dalam linked git worktree, 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 tempat git worktree 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 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 dan Claude mengisolasi pengeditan dengan cara yang sama seperti yang dilakukannya 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 sesi latar belakang hasilkan mewarisi direktori kerja sesi, jadi pengeditan filenya mendarat di worktree sesi daripada salinan kerja Anda. Untuk memberikan subagent worktree terpisah sendiri, atur isolation: worktree dalam frontmatter-nya atau berikan isolation: "worktree" saat menghasilkannya.

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

Komit dan dorong: Claude melakukan komit tanpa bertanya, dan mendorong cabang ketika repositori memiliki remote.
Draft pull request: Claude membuka satu ketika tugas memanggilnya, dan label #N muncul di baris.
Tidak pernah: mendorong ke main atau master, force-push, dan merge.
Instruksi git Anda memiliki prioritas: jika tugas, CLAUDE.md, atau memori mengatakan Anda menangani komit atau push sendiri, Claude membiarkan git kepada Anda.

Sesi yang mengedit checkout yang tidak mengisolasi dirinya sendiri masih bertanya sebelum melakukan komit atau beralih cabang. 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, pull request, atau jawabannya sendiri.

Apa yang dihapus menghapus sesi

Hapus sesi dengan Ctrl+X dua kali dalam tampilan agen 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 restart supervisor.

Apa yang terjadi pada worktree Claude buat untuk sesi:

Tampilan agen menghapusnya, termasuk perubahan yang belum dikomit, jadi komit apa yang ingin Anda simpan terlebih dahulu.
claude rm menyimpannya, bersama dengan baris sesi, ketika memiliki perubahan yang belum dikomit.
Tidak ada tampilan agen atau claude rm yang menghapus worktree dengan komit Claude Code tidak dapat mengonfirmasi disimpan di tempat lain, atau yang digunakan atau dikunci sesi yang sedang berjalan lainnya. Claude Code menyimpan worktree dan sesi, dan memberi nama direktori yang disimpan dan alasannya.

Komit pada remote tidak memblokir penghapusan. Juga tidak komit pada salinan lokal cabang default remote origin Anda, asalkan cabang itu diperiksa dalam checkout utama Anda, direktori repositori itu sendiri daripada worktree.

Dalam tampilan agen, penghapusan yang ditolak menampilkan not deleted dengan alasan di baris sesi. Dorong komit, gabungkan ke dalam cabang default itu, atau tutup sesi lain, kemudian hapus lagi.
Worktree yang git tidak lagi mengenali, misalnya setelah git worktree prune, tidak memblokir penghapusan. Claude Code menghapus sesi dan meninggalkan direktori di disk.

Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat baik cara apa pun.

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 berada dalam direktori:

Tampilan agen meminta Ctrl+X double-press yang sama sebelum membuang mereka. Untuk direktori yang dibuat hook, jalankan WorktreeRemove hook Anda sebagai gantinya, dan tanpa satu menolak penghapusan dan menyimpan sesi.
claude rm menyimpan sesi dan worktree, dan memberi nama alasannya.

Jalur mana pun menyimpan direktori yang catatan sesi yang selesai lainnya beri nama.

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 dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih /model, atau edit pengaturan secara langsung.

Untuk menimpanya untuk seluruh sesi tampilan agen, berikan --model saat membuka tampilan agen. Lihat Mode izin, model, dan upaya.

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 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 berbeda. Untuk menimpanya 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 beralih hanya sesi. Beralih hanya sesi bertahan jika sesi direspawn.
Kirim subagent yang frontmatter-nya menetapkan bidang model.

Mode izin, model, dan upaya

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.

Pengaturan dan penyedia

Sesi latar belakang membaca pengaturan dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai claude di sana. Ini mencakup 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 yang Anda kirim darinya, sehingga perintah yang dijalankannya menemukan alat yang sama seperti terminal Anda. Sesi juga menyimpan pemilihan penyedia cloud shell itu, seperti CLAUDE_CODE_USE_BEDROCK atau CLAUDE_CODE_USE_VERTEX, bersama dengan alias ANTHROPIC_DEFAULT_*_MODEL dan penimpaan CLAUDE_CODE_EXTRA_BODY apa pun yang Anda ekspor di sana.

Gateway LLM

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

Jika Anda mengekspor gateway ANTHROPIC_BASE_URL hanya dalam 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 melepaskan sesi Anda sendiri dengan ← atau /background
Anda mengirim sesi ke direktori yang Anda masuki
Anda membangunkan sesi yang dihentikan dalam direktori yang Anda masuki dengan melampirkan atau membalasnya

Claude Code meneruskan gateway di depan penyedia cloud. Jika shell yang Anda kirim dari memilih penyedia dan mengekspor titik akhir gateway-nya dengan bendera bypass auth-nya, Claude Code meneruskan pasangan titik akhir-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 hanya dan tidak pernah menulisnya ke disk.

Mode izin

Mode izin tergantung pada cara Anda memulai sesi:

Dilepaskan dengan /bg atau ←: Claude Code mempertahankan mode izin sesi yang ada, jadi sesi yang Anda alihkan ke acceptEdits atau auto tetap di sana setelah detach
Dikirim dari tampilan agen yang Anda buka dengan ←: sesi baru dimulai dalam mode izin sesi yang Anda datang dari
Dikirim dari claude agents yang dimulai dalam shell, atau dengan claude --bg: sesi baru dimulai dengan cara sesi claude baru di direktori itu akan, kecuali Anda mengirimnya dari tampilan agen yang Anda buka dengan default pengiriman. Mode izin mana sesi dimulai mencantumkan urutan

Default pengiriman

Untuk menetapkan default untuk setiap sesi yang Anda kirim dari tampilan agen, berikan salah satu dari --permission-mode, --model, --effort, atau --agent saat 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 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.

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 pengecualian 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 menampilkan pengecualian yang sama ketika Anda belum menerimanya sebelumnya, dan menerima menerapkan bypassPermissions ke sesi yang Anda luncurkan dari tampilan. Melewatkan --allow-dangerously-skip-permissions menampilkan pengecualian yang sama juga, dan menerima membuat bypassPermissions tersedia dalam siklus Shift+Tab sesi tersebut tanpa memulai di dalamnya.

Apa yang bertahan di seluruh restart

Mode izin, model, dan upaya yang Anda pilih untuk sesi latar belakang, bersama dengan bendera konfigurasi yang dibawanya, semuanya bertahan ketika supervisor kemudian menghentikan 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 di tengah sesi dengan /model atau /effort juga disimpan.

Jika sesi mengambil upaya dari pengaturan Anda daripada dari --effort atau /effort, Claude Code membaca pengaturan Anda lagi setiap kali memulai proses untuk sesi. Jadi ketika Anda mengedit upaya yang disimpan dalam settings.json, perubahan mencapai sesi yang Anda lepaskan ke latar belakang dengan ← atau /bg, dan restart mereka yang lebih baru. 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.

Pengaturan, plugins, dan server MCP

Tampilan agen menerima bendera konfigurasi yang sama seperti claude untuk memuat pengaturan, plugins, server MCP, dan direktori tambahan. Tampilan agen menerapkan --settings dan --plugin-dir ke dirinya sendiri dan meneruskan setiap bendera konfigurasi ke sesi yang Anda kirim darinya, jadi plugin atau server MCP yang Anda muat dengan cara ini tersedia di sesi tersebut.

Bendera	Efek
`--settings <file-or-json>`	Menimpa pengaturan untuk tampilan agen dan sesi yang dikirim
`--add-dir <path>`	Memberikan akses file ke direktori tambahan
`--plugin-dir <path>`	Memuat plugin dari direktori lokal
`--mcp-config <file-or-json>`	Memuat server MCP dari file konfigurasi atau string JSON
`--strict-mcp-config`	Gunakan hanya server MCP dari `--mcp-config`, abaikan konfigurasi MCP lainnya. Lihat Kontrol eksklusif dengan managed-mcp.json untuk apa yang dilakukan bendera di bawah file MCP yang dikelola

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 tampilan agen dengan penimpaan 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.

Perintah	Tujuan
`claude agents`	Buka tampilan agen
`claude agents --cwd <path>`	Buka tampilan agen yang dibatasi pada sesi yang dimulai di bawah `<path>`
`claude agents --json`	Cetak sesi sebagai array JSON dan keluar. Lihat Daftar sesi sebagai JSON
`claude attach <id>`	Lampirkan ke sesi di terminal ini
`claude logs <id>`	Cetak output terbaru sesi
`claude stop <id>`	Hentikan sesi. Juga menerima `claude kill`
`claude respawn <id>`	Mulai ulang sesi, baik yang sedang berjalan maupun yang dihentikan, misalnya untuk mengambil biner Claude Code yang telah diperbarui. Sesi yang dimulai ulang melanjutkan percakapan yang disimpannya; ketika tidak ada di disk, sesi tersebut menjalankan prompt aslinya lagi sebagai percakapan baru
`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 <id>`	Hapus sesi dari daftar, bersama dengan worktree yang dibuat Claude untuk sesi tersebut ketika aman untuk dihapus; lihat Apa yang menghapus sesi menghapus. Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui `claude --resume`
`claude daemon status`	Cetak status supervisor, 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

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:

Bidang	Hadir	Deskripsi
`cwd`, `kind`, `startedAt`	Selalu	Direktori kerja, `interactive` atau `background`, dan waktu mulai dalam milidetik Unix
`id`	Sesi latar belakang	ID pendek, dapat digunakan dengan `claude attach`, `claude logs`, dan `claude stop`
`state`	Sesi latar belakang	Salah satu dari `working`, `blocked`, `done`, `failed`, atau `stopped`
`pid`, `status`	Saat proses masih hidup	ID proses dan status saat ini
`waitingFor`	Ketika `status` adalah `waiting`	Apa sesi diblokir: `permission prompt` untuk persetujuan, `input needed` untuk pertanyaan dari Claude atau permintaan input server MCP, `sandbox request`, `worker request`, atau `dialog open`
`sessionId`, `name`	Ketika diatur	`sessionId` adalah UUID sesi lengkap, dapat digunakan dengan `claude --resume`. Nama sesi interaktif adalah nama tampilan defaultnya sampai Anda memberi nama sesi atau menerima rencana di dalamnya

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, menunggu Anda, atau terhubung: proses terus berjalan. Subagen yang berjalan, alur kerja, atau monitor dihitung sebagai bekerja.
Selesai dan tidak terhubung selama sekitar satu jam: supervisor menghentikan proses untuk membebaskan sumber daya. 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 saat idle.
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.

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

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
Claude Code di web: jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal

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.

Versi	Perubahan
v2.1.251	Dalam sesi latar belakang yang belum pindah ke worktree, Claude dan subagen yang dipawnnya dapat mengedit file di dalam worktree git yang ditautkan.
v2.1.251	Claude Code meneruskan gateway penyedia cloud yang diekspor dalam shell tempat Anda mengirim, seperti `ANTHROPIC_VERTEX_BASE_URL` atau `ANTHROPIC_BEDROCK_BASE_URL` dengan bendera bypass autnya, ke worker sesi di bawah kondisi yang sama dengan `ANTHROPIC_BASE_URL`. Sebelum rilis ini, jika Anda melepaskan atau mengirim dari shell yang hanya diautentikasi melalui gateway seperti itu, setiap permintaan yang dibuat sesi gagal, karena titik akhir dan bendera dijatuhkan dari lingkungannya.
v2.1.251	Ketika sesi latar belakang dimulai sementara proses Claude Code lain sedang menyegarkan marketplace plugin, seperti sesi saudara yang menjalankan pembaruan otomatis marketplace, Claude Code menjaga plugin marketplace tersebut tetap tersedia. Sebelum rilis ini, sesi seperti itu bisa dimulai tanpa skill, agen, hook, dan server MCP marketplace apa pun dan tetap seperti itu selama seluruh jalannya.
v2.1.248	`Shift+Enter` dalam input pengiriman menyisipkan baris baru, sesuai dengan prompt utama, dan `Ctrl+Enter` mengirim dan melampirkan segera di terminal tempat overlay `?` mencantumkan `ctrl+enter to start and open`. Sebelum rilis ini, `Shift+Enter` mengirim dan melampirkan.
v2.1.248	Menghapus sesi berhasil ketika commit worktree sudah ada di salinan lokal cabang default remote `origin` Anda dan checkout utama Anda memiliki cabang itu yang diperiksa; sebelum rilis ini, penghapusan ditolak dengan `has commits that are not pushed anywhere`.
v2.1.248	Sesi yang dilepaskan dengan `←` atau `/background` memegang `git worktree lock` pada worktree-nya saat berjalan; sebelum rilis ini, melepaskan melepaskan kunci, dan pembersihan atau `git worktree remove` bisa menghapus worktree di bawah sesi yang sedang berjalan.
v2.1.248	Sesi latar belakang yang tidak menunggu input Anda dan ditemukan mati lebih dari 48 jam setelah aktivitas terakhirnya, seperti setelah mesin mati selama berhari-hari, menampilkan sebagai berhenti dengan `ended while the background service was off`, dan `Enter` padanya bertanya sebelum melanjutkan percakapan yang disimpannya. Sebelum rilis ini, sesi seperti itu muncul kembali sebagai kegagalan segar yang diurutkan ke atas daftar, dan satu `Enter` menarik percakapan berusia berminggu-minggu ke latar depan.
v2.1.248	Membuka baris yang dihentikan yang percakapannya Anda lanjutkan di terminal lain ditolak dengan `Can't open — this session is running in another terminal`, dan baris menampilkan `Open in a terminal` alih-alih menampilkan di bawah `Working`. Sebelum rilis ini, membuka baris memulai proses kedua yang menulis ke percakapan yang sama.
v2.1.248	Sesi latar belakang yang menunggu keputusan izin sementara hook `PermissionRequest` atau `PreToolUse` mencetak jawaban yang tidak valid menyebutkan acara hook dan kesalahan skema pada barisnya. Sebelum rilis ini, baris hanya menampilkan permintaan yang tertunda.
v2.1.248	Di Windows, `claude agents` merespons keyboard ketika diluncurkan di tab terminal yang program sebelumnya tinggalkan dalam mode win32-input. Sebelum rilis ini, Claude Code tidak mendekode catatan kunci yang dikirim tab seperti itu.
v2.1.247	Di Linux dan WSL, sesi yang proses host terminalnya mati gagal dalam hitungan detik dengan alasannya. Pembukaan yang tidak menghasilkan output berakhir setelah sekitar sepuluh detik dengan penawaran restart, dan `Enter` pada baris memulai ulang sesi dengan percakapannya; `claude attach <id>` melaporkan penyebabnya dan keluar. Sebelum rilis ini, membuka sesi seperti itu menampilkan `opening… · esc to cancel` tanpa batas dan `claude attach <id>` menunggu tanpa melaporkan kesalahan.
v2.1.246	Pada instalasi npm, ketika layanan latar belakang gagal dimulai sementara `npm install -g @anthropic-ai/claude-code` mengganti biner, Claude Code menunggu hingga sepuluh detik agar instalasi selesai dan mencoba lagi sebelum melaporkan `EACCES: permission denied`.
v2.1.246	Ketika proses layanan latar belakang mati setelah mencetak kesalahan, Claude Code melaporkan kegagalan dan mengutip baris kesalahan pertama layanan.
v2.1.246	Jika mesin Anda tidur sementara layanan latar belakang sedang dimulai, Claude Code mencoba lagi sekali alih-alih gagal.
v2.1.246	Claude Code menunggu sekitar dua menit alih-alih 45 detik untuk layanan latar belakang yang baru dimulai yang hidup tetapi lambat menerima koneksi.
v2.1.246	Layanan latar belakang dimulai dari direktori rumah Anda, jadi di macOS dan Linux direktori awal yang dihapus atau dipindahkan tidak lagi memblokir awal.
v2.1.246	`/fork` menyalin percakapan lengkap dari sesi yang sendiri dimulai sebagai salinan dan belum merekam prompt baru sejak: salinan `/fork` yang Anda lampirkan, sesi yang dilampirkan kembali setelah `←` atau `/background` memindahkannya ke latar belakang, atau sesi yang dimulai dengan `claude --resume <id> --fork-session`. Sebelum rilis ini, jika Anda menjalankan `/fork` dalam sesi seperti itu sebelum mengirimnya prompt baru, Claude Code mencetak konfirmasi normal tetapi memulai salinan dengan percakapan kosong. Memindahkan sesi seperti itu ke latar belakang dengan `←` atau `/background` kehilangan percakapan dengan cara yang sama.
v2.1.246	Ketika Anda membuka sesi yang baru saja Anda kirim sementara proses worker-nya masih dimulai, seperti dengan menekan `Enter` pada barisnya, Claude Code menunggu proses dan kemudian melampirkan. Sebelum rilis ini, jika Anda menekan `Enter` sementara proses masih dimulai, Claude Code bisa menghentikan sesi dengan `Session <id> was stopped while the respawn was in flight`.
v2.1.246	Ketika Anda melepaskan sesi bernama, Claude Code mencantumkannya sekali, dan ketika Anda melepaskan percakapan yang sama lagi, itu menomori nama baris baru, seperti `my-session (2)`, dengan baris yang ada menyimpan namanya. Sebelum rilis ini, terminal tempat Anda menekan `←` bisa muncul dalam `claude agents --json` sebagai sesi kedua dengan nama yang sama, dan jika Anda melepaskan percakapan yang sama lagi, Claude Code menambahkan baris lain di bawah nama yang identik.
v2.1.239	Dengan mode editor vim aktif, menekan `Esc` dalam input tampilan agen beralih dari mode INSERT ke NORMAL dan menyimpan teks Anda, sesuai dengan prompt utama; dalam mode NORMAL dengan teks masih dalam input, menekan `Esc` menghapusnya, dan menekan `Esc` pada input kosong keluar, seperti yang dijelaskan pintasan `Esc`. Sebelum rilis ini, `Esc` menghapus input.
v2.1.233	Untuk sesi yang ditautkan ke permintaan tarik GitLab, Claude Code menulis label baris dalam sintaks referensi `!1234` GitLab. Anda juga dapat menempel URL permintaan tarik ke dalam input pengiriman untuk memilih sesi itu. Sebelum rilis ini, label dirender sebagai `#1234`, dan URL permintaan tarik yang ditempel cocok dengan sesi hanya ketika prompt pertamanya berisi URL.
v2.1.227	Menghapus sesi menyimpan sesi dan worktree-nya sementara sesi Claude Code langsung lain sedang berjalan di dalam direktori worktree itu. Tampilan agen menampilkan `not deleted` pada baris dan alasannya di footer, dan `claude rm` mencetak `kept <id>` dengan alasan, yang menyebutkan ID proses sesi lain. Sebelum rilis ini, menghapus sesi menghapus worktree sementara sesi lain masih bekerja di dalamnya.
v2.1.225	`claude agents` dalam direktori yang belum Anda percayai menampilkan dialog kepercayaan workspace yang sama yang ditampilkan `claude` saat startup, sebelum tampilan agen terbuka. Menerima menyimpan kepercayaan untuk workspace itu; menolak keluar tanpa membuka tampilan agen. Sebelum rilis ini, `claude agents` terbuka tanpa bertanya, jadi sesi yang Anda kirim darinya berjalan dalam direktori yang tidak pernah Anda diminta untuk percayai. Dengan daftar yang dikelompokkan berdasarkan direktori, mengarahkan mouse ke baris menyorotinya tanpa mengubah target pengiriman; memilih baris dengan tombol panah atau klik masih mengubah target. Sebelum rilis ini, menggerakkan mouse ke sesi di proyek lain diam-diam mengubah direktori tempat sesi yang dikirim berikutnya dimulai.
v2.1.221	`/status` menampilkan baris `Session kind`: `background job · attached` atau `background job · unattended` dalam sesi latar belakang, tergantung apakah terminal dilampirkan, dan `interactive` dalam sesi lain apa pun. Sebelum rilis ini, `/status` tidak melaporkan jenis sesi. `/fork`: Claude Code menginstruksikan salinan untuk mengisolasi pekerjaannya dari sesi asli: salinan membuat worktree-nya sendiri sebelum membuat perubahan kode, tetap keluar dari worktree sesi asli, dan mendasarkan cabang baru pada cabang asli ketika tugasnya dibangun di atas pekerjaan itu. Lihat bagian tertaut untuk kondisi pastinya. Sebelum rilis ini, salinan tidak menerima instruksi isolasi dan bisa berakhir mengedit worktree atau checkout yang masih dikerjakan sesi asli. Dengan mode editor vim aktif, menekan `←` tepat setelah membatalkan prompt kembali ke kosong dengan `u` bertanya untuk konfirmasi yang sama seperti menghapus teks atau bergerak melalui riwayat prompt, dan beralih hanya pada tekan kedua; sebelum rilis ini tekan beralih segera.
v2.1.219	Dengan mode editor vim aktif, menekan `←` pada prompt kosong membuka tampilan agen dari mode NORMAL serta INSERT, dan petunjuk `←` footer menampilkan dalam mode NORMAL; sebelum rilis ini gestur dan petunjuk adalah INSERT-only, dan dalam mode NORMAL `←` pada prompt kosong tidak melakukan apa pun. Mengetik ke dalam input sementara Claude Code menunggu untuk melepaskan sesi membatalkan switch dengan `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` jadi draft yang diketik tidak hilang.
v2.1.218	Menekan `←` dalam dua detik penghapusan yang mengosongkan prompt, atau bergerak melalui riwayat prompt, menampilkan `Press ← again to open agents`, atau `Press ← again to go back to agents` dalam sesi yang dilampirkan, dan beralih hanya pada tekan kedua setidaknya satu detik kemudian; sebelum rilis ini tekan beralih segera. `←` yang tiba di dalam input yang ditempel atau skrip tidak lagi memicu switch. Melepaskan sesi latar depan dengan `←` menampilkan `Your conversation moved to the background` di atas daftar, dan `Esc` di akar tampilan agen kembali ke percakapan itu alih-alih keluar ke shell, dengan `Ctrl+C` ganda tetap menjadi keluar; jika percakapan tidak dapat dibuka kembali, Claude Code keluar dan mencetak perintah `claude --resume` untuknya. Di Windows, `←` yang ditekan dalam sekitar setengah detik melampirkan menampilkan `Ambiguous ←, press again to detach` dan melepaskan pada tekan kedua.
v2.1.217	Lencana permintaan tarik pada baris sesi dirender sebagai hyperlink bahkan ketika Claude Code tidak dapat mendeteksi dukungan hyperlink terminal, misalnya melalui SSH atau tmux; atur `FORCE_HYPERLINK=0` untuk merendernya sebagai teks biasa. Sebelum rilis ini, lencana dirender sebagai teks biasa ketika dukungan tidak terdeteksi.
v2.1.216	`/fork`: konfirmasi adalah satu baris, menampilkan status salinan, nama baris tampilan agen-nya, dan ID sesi-nya untuk `claude attach`, berakhir dengan `runs in the origin tree` atau `edits this checkout` hanya ketika salinan berjalan di pohon kerja utama atau mengedit checkout yang Anda buka. Mengklik nama melepaskan sesi ini dan membuka tampilan agen dalam sesi salinan. Konfirmasi tidak lagi menyatakan kembali mode izin yang diwarisi salinan; versi sebelumnya mencetak konfirmasi multi-baris tanpa nama yang dapat diklik. Memerlukan input: `/install-github-app` dan daftar pengaturan `/mcp`, jalankan sementara tidak ada yang dilampirkan, menampilkan sesi di bawah `Needs input` dengan baris yang menyebutkan perintah, dan melampirkan dan menjalankan kembali perintah melanjutkan; dari v2.1.208 hingga v2.1.215 mereka ditolak sepenuhnya dalam keadaan itu. Pemulihan `--agent`: melanjutkan atau memulai ulang sesi `--agent` yang dilepaskan memulihkan prompt sistem agen dan pembatasan alat, mencari direktori sesi sendiri untuk agen terlebih dahulu, ketika workspace-nya dipercayai; sesi yang agennya tidak lagi ada melanjutkan dengan alat default dan prompt sistem dan terbuka dengan peringatan yang terlihat, alih-alih diam-diam kembali ke agen default. `Ctrl+X`: menekannya dua kali menghapus sesi bahkan ketika upaya berhenti gagal, alih-alih berhenti yang gagal membatalkan penghapusan yang tertunda, dan sesi yang dihapus yang proses worker-nya telah mati tidak lagi muncul kembali pada refresh berikutnya. Penghapusan worktree: sesi yang direktori worktree-nya tidak termasuk dalam repositori git apa pun dapat dihapus; sebelum rilis ini setiap upaya menghapus sesi seperti itu ditolak. Direktori yang sudah hilang dihapus segera. Tekan ganda tampilan agen menghapus direktori yang masih memiliki file, menjalankan hook `WorktreeRemove` Anda untuk direktori yang dibuat hook, kecuali sesi lain juga menyebutnya. `claude rm` menyimpan direktori seperti itu kapan pun file tetap ada.
v2.1.214	Sesi yang dilepaskan dengan `←` atau `/background` dan dibiarkan idle tanpa apa pun yang berjalan memiliki prosesnya dihentikan seperti sesi idle lainnya, alih-alih menyimpan prosesnya dan layanan latar belakang berjalan tanpa batas. Sesi yang selesai dapat dihapus dengan `claude rm` atau dari tampilan agen setelah layanan latar belakang telah idle, dan sesi yang memasuki worktree setelah dikirim dari direktori yang bukan repositori git, seperti folder workspace multi-repo, dapat dihapus dari tampilan agen ketika worktree itu sendiri termasuk dalam repositori git, karena pembersihan diselesaikan dari worktree alih-alih direktori tempat sesi dikirim; kedua penghapusan ditolak pada setiap upaya sebelumnya. Membuka kembali sesi yang dihentikan memulihkan percakapan yang disimpannya bahkan ketika folder dalam penyimpanan transkrip tidak dapat dibaca.
v2.1.213	`/install-github-app`, daftar pengaturan `/mcp`, dan tindakan autentikasi MCP bekerja dalam sesi latar belakang sementara terminal dilampirkan, dan ditolak hanya ketika tidak ada yang dilampirkan, dengan pesan yang memberi tahu Anda untuk melampirkan dan menjalankan perintah lagi; dari v2.1.208 hingga v2.1.212 mereka ditolak bahkan dengan terminal yang dilampirkan.
v2.1.212	`/fork` dalam sesi interaktif menyalin percakapan ke sesi latar belakang baru yang muncul sebagai barisnya sendiri, dinamai setelah sesi yang berasal darinya atau, untuk fork yang diminta dari sesi tanpa nama, setelah prompt fork, sementara asli terus berjalan; perilaku subagen yang di-fork sebelumnya dari `/fork` pindah ke `/subtask`. Dengan tampilan agen dimatikan, `/fork` menyimpan perilaku subagen yang di-fork. Baris yang difokuskan yang menunggu prompt pertamanya menampilkan `space to send it a prompt`. `Ctrl+J` menyisipkan baris baru dalam input pengiriman di terminal dengan pelaporan kunci diperluas, di mana penekanan tombol sebelumnya diabaikan, dan overlay `?` mencantumkan pintasan. Petunjuk footer `←` dalam sesi interaktif secara singkat menampilkan `N done` ketika sesi latar belakang selesai sementara tidak ada yang memerlukan input Anda. Mengetik `/resume` telanjang dalam tampilan agen membuka pemilih sesi masa lalu dari repositori tempat Anda membuka tampilan agen, termasuk sesi yang dihapus dari daftar, dan memilih satu melanjutkannya sebagai sesi latar belakang; sebelum rilis ini `/resume` tidak tersedia dalam tampilan agen dan sesi yang dihapus hanya dapat dijangkau dengan `claude --resume` atau `/resume` dari sesi interaktif. Bentuk yang ditargetkan, dibatasi, dan dibatasi menyimpan petunjuk `attach to a session to run it` yang ditampilkan versi sebelumnya untuk setiap bentuk. Sesi yang menunggu prompt jaringan sandbox network-host, permintaan input MCP, atau prompt pengaturan terkelola menampilkan sebagai `Needs input` alih-alih `Working`, dalam tampilan agen dan dalam `claude agents --json`, dan pertanyaan dari Claude melaporkan `waitingFor: input needed` alih-alih `permission prompt`. Melampirkan ke sesi yang prosesnya telah berhenti menampilkan transkripsnya diformat cara sesi langsung merendernya, alih-alih sebagai teks mentah. Sesi yang dihentikan yang transkripsnya berada di tempat yang tidak terduga melanjutkan darinya melalui pemindaian upaya terakhir dari transkrip yang disimpan Anda, dan membuka baris yang tidak memiliki transkrip yang disimpan menampilkan `Press enter again to restart this session fresh`, memulai ulang segar pada tekan kedua; v2.1.211 menampilkan penolakan tanpa cara untuk memulai ulang dari tampilan agen.
v2.1.211	Membangunkan sesi yang dihentikan dengan melampirkan atau membalas dari direktori tempat ia berjalan meneruskan gateway `ANTHROPIC_BASE_URL` shell Anda lagi, di bawah kondisi yang sama dengan pengiriman segar, jadi sesi yang diautentikasi melalui gateway `ANTHROPIC_AUTH_TOKEN` melanjutkan di gateway alih-alih melaporkan `Not logged in`. Melampirkan ke sesi yang dihentikan yang dilepaskan dari percakapan lain sebelum respons pertamanya selesai ditolak dengan `This session has no saved transcript` alih-alih diam-diam memulai percakapan kosong di bawah ID sesi yang sama; membuka baris yang sama dari tampilan agen menampilkan penolakan di footer. Mengakhiri proses sesi `←` atau `/background` dari luar Claude Code menandainya berhenti alih-alih supervisor memulai ulangnya, berhenti yang sudah dicatat di disk dihormati kecuali balasan yang Anda kirim masih menunggu untuk dikirimkan, sesi yang dimulai ulang setelah crash diberitahu itu dimulai ulang, dan sesi `←` atau `/background` yang dimulai ulang tidak melanjutkan respons yang terputus lebih lama dari sekitar satu jam. Balasan penamaan sesi yang menjawab atau menolak prompt alih-alih memberi label padanya, seperti untuk prompt yang sebagian besar tautan, dibuang dan baris menyimpan nama yang diambil dari teks prompt. Menghapus sesi yang worktree git-nya tidak lagi dikenali berhasil, meninggalkan direktori worktree di disk dan menyebutkan jalurnya, alih-alih setiap upaya ditolak. Penolakan penghapusan menampilkan alasan pada baris sesi, termasuk kesalahan git yang mendasar ketika worktree tidak dapat dihapus, alih-alih baris diam-diam muncul kembali.
v2.1.210	`claude attach` menunggu sementara layanan latar belakang sedang dimulai atau terhubung kembali alih-alih gagal dengan kesalahan `job not found` atau `still starting`, melaporkan sesi yang selesai selama lampiran sebagai keluar, dan menerapkan perubahan ukuran terminal yang dibuat selama lampiran lambat ketika lampiran selesai. Hitungan kebutuhan input `←` footer prompt muncul di setiap penyedia, termasuk penyedia pihak ketiga yang sebelumnya menampilkan bentuk `← for agents` biasa. Melepaskan sesi dengan `←` membawa daftar tugas Claude ke sesi latar belakang alih-alih menjatuhkannya. Baris yang Anda tekan `←` darinya menyimpan nama yang berani dan tidak redup setelah pilihan bergerak. `claude agents --effort` menerima `ultracode` alih-alih diam-diam menjatuhkannya.
v2.1.208	Melampirkan ke sesi yang prosesnya telah berhenti menampilkan layar terakhir transkripsnya sementara proses dimulai, alih-alih hanya catatan `Session is starting`. Balasan yang tidak dapat dikirimkan karena layanan latar belakang tidak dapat dijangkau atau pengiriman gagal disimpan dan dikirim sebagai prompt berikutnya dari sesi ketika prosesnya dimulai lagi; sebelum rilis ini, balasan yang hilang saat layanan latar belakang tidak dapat dijangkau dibuang. Proses yang binernya sendiri diganti oleh pembaruan masih dapat memulai supervisor, dari peluncur `claude` yang terinstal atau versi terbaru di disk, alih-alih gagal sampai Claude Code dimulai ulang. Supervisor yang menjalankan versi yang lebih lama tidak pernah memulai ulang sesi idle yang dimulai oleh versi yang lebih baru ke binernya sendiri yang lebih lama. Menghapus sesi menghapus worktree-nya bahkan setelah sesi memindahkan worktree ke cabang yang berbeda, dan menjaga worktree tetap bersama dengan baris sesi ketika worktree memiliki commit yang tidak didorong ke mana pun atau sesi lain mengklaimnya, alih-alih menghancurkan commit atau meninggalkan worktree. `/install-github-app` dan daftar pengaturan `/mcp` serta tindakan autentikasinya ditolak dalam sesi latar belakang dengan pesan yang menyebutkan alternatifnya; hanya dalam v2.1.208, pemilih `/model` ditolak dengan cara yang sama dan `/model <name>` yang diketik beralih hanya sesi itu alih-alih juga menyimpan model default Anda.
v2.1.207	Panel intip terbuka dengan kalimat yang dipotong baris, seperti pertanyaan pastinya untuk sesi yang menunggu Anda, dan menampilkan berapa lama sesi yang diblokir telah menunggu sebagai baris `waiting 3m` tunggal alih-alih menambahkan awalan stempel waktu yang sama ke kalimat status dan pertanyaan. Menempel teks yang sama lagi dalam input pengiriman memperluas placeholder `[Pasted text #N]` yang runtuh alih-alih menambahkan yang kedua. Sesi latar belakang yang dinamai dengan menerima rencana menampilkan nama itu pada barisnya. Sesi latar belakang yang pindah ke worktree menyimpan percakapannya ketika prosesnya dimulai ulang dari tampilan agen.
v2.1.206	Ringkasan baris mengisi lebar sisa baris dan dipotong hanya di tepi kanan terminal alih-alih pada 64 kolom. Setelah supervisor dimulai ulang ke versi Claude Code baru, ia memulai ulang sesi latar belakang idle yang tersisa ke versi itu di latar belakang alih-alih beberapa per menit. Menghapus sesi dengan `Ctrl+X` atau `claude rm` juga menghapusnya dari daftar sesi supervisor, sehingga baris tidak lagi muncul kembali setelah restart supervisor. Penimpaan badan permintaan `CLAUDE_CODE_EXTRA_BODY` yang diekspor dalam shell pengiriman mencapai sesi latar belakang alih-alih diabaikan.
v2.1.205	Petunjuk `←` footer prompt menghitung agen latar belakang yang menunggu Anda, seperti `← 2 agents`. Ringkasan baris menampilkan laporan satu baris sesi itu sendiri, dipotong pada 64 kolom, alih-alih invokasi alat mentah atau hitungan `done/total`; baris yang dikelompokkan direktori terbuka dengan kata status berwarna. Panel intip terbuka dengan kalimat status lengkap dan, untuk sesi yang menunggu Anda, pertanyaan pastinya di atas input balasan. Sesi yang mengedit, mengomentari, menutup, atau menandai permintaan tarik siap dengan `gh` ditautkan ke sana, bukan hanya yang membuat atau checkout permintaan tarik, push menautkan permintaan tarik bahkan ketika nama cabang lokal tidak cocok, dan permintaan tarik yang output perintah pembuatannya melebihi batas inline juga ditautkan. Giliran tanpa teks yang dapat dibaca menyimpan status sesi sebelumnya alih-alih membaliknya kembali ke `Working`. `claude attach` menunggu hingga sekitar 60 detik untuk sesi yang sedang dimulai ulang, dengan baris status yang menyebutkan alasannya, alih-alih gagal.
v2.1.203	Gateway `ANTHROPIC_BASE_URL` yang diekspor dalam shell pengiriman mencapai sesi yang dikirim darinya ke direktori yang sama ketika supervisor membagikan gateway environment tersebut, alih-alih dijatuhkan sementara kunci API yang diekspor bersama dengannya tetap disimpan. `PATH` shell pengiriman diterapkan ke setiap worker sesi. Menekan `←` saat subagen sedang berjalan menunggu mereka alih-alih memulai ulang mereka setelah sepuluh detik. Daftar kosong selalu menampilkan header bagian dengan deskripsi di bawah masing-masing. Mengetik `@` dalam input pengiriman juga mencantumkan git worktrees terdaftar dari repositori peluncuran yang berada di dalam pohon direktorinya. Upaya yang diwarisi dari pengaturan `effortLevel` mengikuti pengeditan kemudian ke pengaturan tersebut alih-alih diperbaiki pada pengiriman. Membuka sesi yang dihentikan yang percakapannya sudah terbuka di sesi yang sedang berjalan lainnya ditolak dengan pesan alih-alih gagal pada baris. Perintah yang tidak tersedia dalam tampilan agen meninggalkan teks yang diketik dalam input. Hook `WorktreeCreate` yang gagal di luar repositori git tidak lagi memblokir sesi dari pengeditan file.
v2.1.202	Nama yang ditetapkan dengan `/rename` atau `Ctrl+R` pada sesi latar belakang tetap ada ketika supervisor menghentikan dan memulai ulang prosesnya, alih-alih kembali ke nama yang dikirim sesi dengan.
v2.1.200	Versi Claude Code yang lebih lama yang menulis ulang daftar sesi dalam `roster.json` mempertahankan bidang yang ditulis oleh versi yang lebih baru, sesuai dengan jaminan `state.json` yang ada, sehingga sesi yang dimulai oleh versi yang lebih baru terus menerima input setelah supervisor dimulai ulang. Ketika Anda membuka sesi yang telah berhenti merespons, supervisor memulai ulang prosesnya dan sesi melanjutkan respons yang terputus dari tempat ia berhenti. Tampilan agen menerapkan bendera `--plugin-dir` yang ditempatkan setelah `agents` ke subagen tampilan agen-nya sendiri dan autocomplete skill dalam input pengiriman serta sesi yang dikirim.
v2.1.199	Sesi latar belakang yang prosesnya keluar sebelum selesai dimulai pada host dengan memori rendah menampilkan `possibly low memory — free some up and retry` dalam status barisnya alih-alih hanya alasan keluar yang polos. Melepaskan sesi dengan `←` atau `/background` membawa `/color` ke baris baru.
v2.1.198	Tampilan agen mengirim notifikasi melalui `preferredNotifChannel` ketika sesi latar belakang memerlukan input, selesai, atau gagal, dan memicu hook `Notification` dengan tipe `agent_needs_input` atau `agent_completed`. `←` dan `/exit` di dalam `claude attach <id>` kembali ke tampilan agen alih-alih keluar ke shell; `Ctrl+Z` kembali ke shell. Sesi latar belakang yang mengisolasi pekerjaannya dalam worktree melakukan commit, mendorong cabang terisolasinya sendiri, tidak pernah `main` atau `master`, dan membuka permintaan tarik draft ketika selesai alih-alih bertanya terlebih dahulu. `/login` berjalan dalam tampilan agen dan membuka dialog masuk. Dialog keluar `Background work is running` menawarkan `Move to background and exit`. Handoff keluar juga mencakup subagen latar belakang, yang melanjutkan dari transkrip mereka pada waktu bangun berikutnya alih-alih dilaporkan sebagai gagal. `claude --bg` dikombinasikan dengan `-p` atau `--print` ditolak dengan kesalahan. Host sesi latar belakang meminta izin Jaringan Lokal macOS pada akses LAN pertama alih-alih gagal dengan `connect: no route to host`.
v2.1.196	Tekan `←` tunggal melepaskan sesi latar depan ke latar belakang; versi sebelumnya memerlukan dua tekan, dengan petunjuk footer dan konfirmasi. `--dangerously-skip-permissions` yang diteruskan ke `claude agents` menampilkan pengecualian bypass alih-alih dijatuhkan diam-diam. Sesi interaktif yang tidak pernah Anda beri nama membawa nama default seperti `my-app-3f` dalam daftar sesi dan `claude agents --json`. Perintah shell latar belakang dan alur kerja dinamis bertahan ketika proses sesi dihentikan, dimulai ulang, atau diperbarui, termasuk di Windows; atur `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` untuk mematikan handoff. Transkrip yang salah dibaca sebagai kosong saat restart diganti nama dengan akhiran `.orphaned-` alih-alih dihapus.
v2.1.195	Pekerjaan yang sedang berlangsung dibawa ketika Anda melepaskan sesi di Windows juga; atur `CLAUDE_DISABLE_ADOPT=1` untuk menghentikannya sebagai gantinya. Grup `Completed` mengisi ruang vertikal yang tersisa dan header dikompakkan di terminal pendek. Versi Claude Code yang lebih lama tidak lagi menjatuhkan bidang `state.json` sesi yang lebih baru atau menyembunyikan sesi tersebut dari `claude agents`. Melampirkan ke sesi yang dihentikan beralih segera alih-alih menampilkan layar kosong selama lima detik. Supervisor yang tidak dapat menerima koneksi keluar dan melepaskan kuncinya sendiri.
v2.1.191	`claude --bg` dengan nama `--agent` yang tidak cocok dengan subagen apa pun Anda gagal meluncurkan: sesi keluar segera dengan kesalahan `--agent '<name>' not found` alih-alih berjalan dengan agen default.
v2.1.174	Sesi latar belakang tidak lagi mewarisi variabel titik akhir gateway seperti `ANTHROPIC_BASE_URL` dari shell peluncuran supervisor; supervisor menyediakan snapshot kredensial segar ke worker yang sudah dipanaskan sebelumnya, memperbaiki kesalahan `Could not resolve authentication method` yang palsu.
v2.1.172	`/model` dalam input pengiriman menetapkan penimpaan model pengiriman yang dibatasi sesi.
v2.1.161	Ringkasan baris menampilkan hitungan `done/total` untuk item kerja paralel; panel intip menyebutkan item kerja paralel yang paling lama berjalan.
v2.1.157	`claude agents` menerima `--agent`; sesi yang dikirim menghormati pengaturan `agent`.
v2.1.145	Dikte suara didukung dalam input balasan panel intip dan input pengiriman.
v2.1.143	Pengaturan `worktree.bgIsolation` ditambahkan; `claude agents` menerima `--allow-dangerously-skip-permissions`.
v2.1.142	`claude agents` menerima `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config`, dan `--strict-mcp-config`.
v2.1.141	`claude agents` menerima `--cwd` untuk membatasi daftar ke satu proyek.
v2.1.139	Tampilan agen diperkenalkan sebagai pratinjau penelitian.

agent-view.md +380 −172

19Untuk membandingkan tampilan agen dengan subagen, tim agen, dan worktrees, lihat [Jalankan agen secara paralel](/docs/id/agents).19Untuk membandingkan tampilan agen dengan subagen, tim agen, dan worktrees, lihat [Jalankan agen secara paralel](/docs/id/agents).

20 20

21<Note>21<Note>

22 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.22 Tampilan agen adalah pratinjau penelitian. Antarmuka dan pintasan keyboard mungkin berubah seiring dengan evolusi fitur.

23</Note>23</Note>

24 24

~~25Halaman ini mencakup:~~

~~27* [Mulai cepat](#quick-start): berikan Claude tugas untuk dikerjakan di latar belakang, periksa, dan campur tangan ketika diperlukan~~

~~28* [Pantau sesi dengan tampilan agen](#monitor-sessions-with-agent-view), termasuk ikon status, mengintip dan membalas, melampirkan, mengorganisir, dan pintasan keyboard~~

~~29* [Kirim agen baru](#dispatch-new-agents) dari tampilan agen, dari dalam sesi, atau dari shell Anda~~

~~30* [Kelola sesi dari shell](#manage-sessions-from-the-shell) dengan `claude agents`, `claude attach`, dan perintah terkait~~

~~31* [Bagaimana sesi latar belakang dihosting](#how-background-sessions-are-hosted) oleh proses supervisor~~

33<h2 id="quick-start">25<h2 id="quick-start">

34 Mulai cepat26 Mulai cepat

35</h2>27</h2>

44 claude agents36 claude agents

45 ```37 ```

46 38

47 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.39 Jika Anda belum menerima [dialog kepercayaan ruang kerja](/docs/id/permissions#project-allow-rules-and-workspace-trust) untuk direktori tersebut, Claude Code menampilkannya sebelum tampilan agen terbuka, dialog yang sama yang ditampilkan `claude`. Terima untuk menyimpan kepercayaan untuk ruang kerja dan lanjutkan. Jika Anda menolak, Claude Code keluar tanpa membuka tampilan agen.

41 Tampilan agen terbuka dengan input di bagian bawah dan tabel yang terisi saat sesi dimulai. Tekan `Esc` untuk kembali ke shell Anda; jika Anda membuka tampilan agen dengan mengirim sesi ke latar belakang dengan `←`, `Esc` kembali ke percakapan tersebut. Sesi Anda terus berjalan saat Anda pergi dan muncul kembali saat Anda membuka tampilan agen berikutnya.

48 </Step>42 </Step>

49 43

50 <Step title="Kirim sesi">44 <Step title="Kirim sesi">

51 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.45 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. [Mode izin yang dimulainya](#permission-mode-model-and-effort) tergantung pada cara Anda membuka tampilan agen.

52 46

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

54 48

64 </Step>58 </Step>

65 59

66 <Step title="Bawa sesi yang ada ke dalam">60 <Step title="Bawa sesi yang ada ke dalam">

67 Langkah ini memerlukan sesi yang sedang berjalan. Jika Anda mengikuti langkah-langkah sebelumnya, Anda tidak memiliki sesi yang terbuka di terminal ini, jadi buka sesi `claude` biasa di terminal lain dan kirim pesan terlebih dahulu. 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.61 Langkah ini memerlukan sesi yang sedang berjalan. Jika Anda mengikuti langkah-langkah sebelumnya, Anda tidak memiliki sesi yang terbuka di terminal ini, jadi buka sesi `claude` biasa di terminal lain dan kirim pesan terlebih dahulu.

63 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. Dalam sesi baru tanpa pesan apa pun, `/bg` meminta Anda untuk mengirim pesan terlebih dahulu, sementara `←` berfungsi langsung. Sesi terus berjalan dan muncul sebagai baris bersama yang Anda kirim.

68 </Step>64 </Step>

69</Steps>65</Steps>

70 66

71Anda 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.67Anda 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.

72 68

73Di 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, kecuali pengaturan [`prefersReducedMotion`](/docs/id/settings#available-settings) aktif, dan tersembunyi dalam [mode pembaca layar](/docs/id/accessibility). Di [Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry](/docs/id/third-party-integrations), petunjuk tetap dalam bentuk `← for agents` biasa tanpa hitungan. Memerlukan Claude Code v2.1.205 atau lebih baru.69Di 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`](/docs/id/settings-reference#prefersreducedmotion) aktif, dan petunjuk tersembunyi dalam [mode pembaca layar](/docs/id/accessibility).

74 70

75<h2 id="monitor-sessions-with-agent-view">71<h2 id="monitor-sessions-with-agent-view">

76 Pantau sesi dengan tampilan agen72 Pantau sesi dengan tampilan agen

78 74

79Jalankan `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.75Jalankan `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.

80 76

81Nama tersebut berwarna dengan warna yang ditetapkan oleh [`/color`](/docs/id/commands) dalam sesi itu. Mulai dari v2.1.199, warna terbawa ketika Anda [mengirim sesi ke latar belakang](#from-inside-a-session) dengan `←` atau `/background`.77Nama tersebut berwarna dengan warna yang ditetapkan oleh [`/color`](/docs/id/commands) dalam sesi itu, termasuk ketika Anda [mengirim sesi ke latar belakang](#from-inside-a-session) dengan `←` atau `/background`.

82 78

83Secara 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`:79Secara 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`:

84 80

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

87```83```

88 84

89Ini 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`.85Ini 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.

90 86

91Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda [mengirimnya ke latar belakang](#from-inside-a-session). [Subagents](/docs/id/sub-agents) dan [teammates](/docs/id/agent-teams) yang sesi hasilkan tidak tercantum sebagai baris terpisah.87Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda [mengirimnya ke latar belakang](#from-inside-a-session). [Subagents](/docs/id/sub-agents) dan [teammates](/docs/id/agent-teams) yang sesi hasilkan tidak tercantum sebagai baris terpisah.

92 88

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

118 114

120| :------------------ | :----------------------- | :-------------------------------------------------------------------------------- |116| :------------------ | :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

122| Membutuhkan masukan | Kuning | Claude menunggu pertanyaan spesifik atau keputusan izin dari Anda |118| Membutuhkan masukan | Kuning | Claude menunggu sesuatu yang hanya Anda yang dapat berikan: jawaban atas pertanyaan, keputusan izin, atau prompt lain yang hanya Anda yang dapat menjawab, seperti prompt [sandbox](/docs/id/sandboxing) untuk mengizinkan host jaringan atau [permintaan masukan](/docs/id/mcp#respond-to-mcp-elicitation-requests) server MCP. Perintah yang memerlukan terminal terpasang, seperti `/install-github-app` atau daftar pengaturan `/mcp`, [juga menahan sesi yang tidak diawasi di sini](#attach-to-a-session) |

127 123

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

129 125

130| Bentuk | Artinya |126| Bentuk | Artinya |

131| :------------------- | :---------------------------------------------------------------------------------------------------------------------------- |127| :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |

133| `∙` | Proses telah keluar. Anda masih dapat mengintip, membalas, atau melampirkan, dan Claude memulai ulang dari tempat ia berhenti |129| `∙` | Proses telah keluar. Anda masih dapat mengintip baris, dan ketika Anda membalas atau melampirkan, Claude memulai ulang dari tempat ia berhenti |

134| `✢` | Sesi [`/loop`](/docs/id/scheduled-tasks) yang tidur di antara iterasi. Baris menunjukkan jumlah jalannya dan hitungan mundur |130| `✢` | Sesi [`/loop`](/docs/id/scheduled-tasks) yang tidur di antara iterasi. Baris menunjukkan jumlah jalannya dan hitungan mundur |

135 131

136Label `#N` yang dapat muncul di tepi kanan baris adalah [permintaan tarik yang dibuka sesi](#pull-request-status), bukan bagian dari ikon status.132Label `#N` atau `!N` yang dapat muncul di tepi kanan baris adalah tautan ke [permintaan tarik atau permintaan penggabungan](#pull-request-status) sesi, bukan bagian dari ikon status.

137 133

138Judul 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.134Judul 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.

139 135

140Mulai dari v2.1.198, saat tampilan agen terbuka, Claude Code juga mengirim notifikasi melalui [saluran notifikasi terminal](/docs/id/terminal-config#get-a-terminal-bell-or-notification) yang dikonfigurasi ketika sesi latar belakang lokal mulai membutuhkan masukan Anda, selesai, atau gagal. Sesi yang berjalan sesuai jadwal, seperti sesi [`/loop`](/docs/id/scheduled-tasks), hanya memberitahu ketika mereka membutuhkan masukan Anda. Notifikasi menggunakan pengaturan [`preferredNotifChannel`](/docs/id/settings#available-settings) yang sama dengan sisa Claude Code dan menjalankan hook [`Notification`](/docs/id/hooks#notification) dengan tipe `agent_needs_input` atau `agent_completed`.136Saat tampilan agen terbuka, Claude Code juga mengirim notifikasi melalui [saluran notifikasi terminal](/docs/id/terminal-config#get-a-terminal-bell-or-notification) yang dikonfigurasi ketika sesi latar belakang lokal mulai membutuhkan masukan Anda, selesai, atau gagal. Sesi yang berjalan sesuai jadwal, seperti sesi [`/loop`](/docs/id/scheduled-tasks), hanya memberitahu ketika mereka membutuhkan masukan Anda. Notifikasi menggunakan pengaturan [`preferredNotifChannel`](/docs/id/settings-reference#preferrednotifchannel) yang sama dengan sisa Claude Code dan menjalankan hook [`Notification`](/docs/id/hooks#notification) dengan tipe `agent_needs_input` atau `agent_completed`.

141 137

142Sesi 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.138Sesi 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.

143 139

144Status 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.140Status 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](#sessions-show-as-failed-after-shutdown) untuk cara memulihkannya.

145 141

146Ketika Anda membuka sesi yang telah berhenti merespons, supervisor memulai ulang prosesnya dan sesi melanjutkan respons yang terputus dari tempat ia berhenti. Sesi dapat berakhir dalam status itu ketika mesin tidur saat sedang merespons. Memerlukan Claude Code v2.1.200 atau lebih baru.142Sesi 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.

147 143

148<h3 id="row-summaries">144<h3 id="row-summaries">

149 Ringkasan baris145 Ringkasan baris

150</h3>146</h3>

151 147

152Ringkasan satu baris di setiap baris dihasilkan oleh [model kelas Haiku](/docs/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 dari output terbaru sesi itu sendiri tanpa mengirim permintaan model, dan model menulis ringkasan segar ketika setiap giliran berakhir.148Ringkasan satu baris di setiap baris dihasilkan oleh [model kelas Haiku](/docs/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, 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.

153 149

154Baris 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 sekitar sekali semenit, menunggu dua kali lebih lama setelah setiap penulisan ulang hingga empat menit, sehingga baris yang sibuk tidak terus menampilkan ringkasan yang sudah ketinggalan zaman. Teks ringkasan mengisi lebar sisa baris dan hanya terpotong di tepi kanan terminal; buka [panel intip](#peek-and-reply) untuk membaca kalimat yang dipotong tepi. Sebelum v2.1.206, teks dipotong pada 64 kolom terlepas dari lebar terminal.150Baris 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](#peek-and-reply) untuk membaca kalimat yang dipotong tepi terminal.

155 151

156Ketika daftar [dikelompokkan berdasarkan direktori](#organize-the-list), 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. Sebelum v2.1.205, baris yang dikelompokkan direktori tidak membawa kata status.152Ketika daftar [dikelompokkan berdasarkan direktori](#organize-the-list), 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.

157 153

158Giliran yang seluruh outputnya tidak mengandung huruf atau angka, seperti sesi [`/loop`](/docs/id/scheduled-tasks) yang mencetak simbol tunggal pada iterasi yang tenang, menyimpan ringkasan dan status baris sebelumnya. Sebelum v2.1.205, giliran itu diklasifikasikan ulang dan dapat membalik sesi yang menunggu masukan Anda kembali ke `Bekerja`.154Ringkasan 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](/docs/id/data-usage) 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`](/docs/id/model-config#environment-variables) untuk memilih satu.

~~159~~

160Ringkasan 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](/docs/id/data-usage) 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 seperti Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan gateway khusus, permintaan kembali ke model utama sesi ketika tidak ada model Haiku yang dikonfigurasi. Atur [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/id/model-config#environment-variables) untuk memilih model untuk ringkasan ini pada penyedia tersebut.

161 155

162<h3 id="pull-request-status">156<h3 id="pull-request-status">

163 Status permintaan tarik157 Status permintaan tarik

164</h3>158</h3>

165 159

166Ketika sesi membuka permintaan tarik, label `#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. Sesi latar belakang yang mengisolasi perubahan mereka dalam worktree membuka permintaan tarik ini sendiri; [Bagaimana file edit diisolasi](#how-file-edits-are-isolated) mencakup kapan itu terjadi dan apa yang tidak pernah dilakukan sesi tanpa bertanya.160Ketika sesi [membuka permintaan tarik](#how-file-edits-are-isolated), Claude Code menambahkan label di tepi kanan baris, tertaut ke permintaan tarik:

161

162* Claude Code menulis label sebagai `#1234` untuk permintaan tarik dan sebagai `!1234` untuk permintaan penggabungan GitLab.

163* Claude Code memancarkan tautan bahkan ketika tidak dapat mendeteksi dukungan hyperlink, misalnya melalui SSH atau tmux. Atur [`FORCE_HYPERLINK=0`](/docs/id/env-vars) untuk merender label sebagai teks biasa.

164* Setelah Anda mengirim tindak lanjut ke sesi, Claude Code menyimpan label sementara baris kembali ke kemajuan langsung.

167 165

168Sesi yang bekerja pada permintaan tarik yang ada tertaut ke sana dengan cara yang sama. Mengedit, mengomentari, menutup, atau menandai permintaan tarik siap dengan `gh` menautkan permintaan tarik yang dinamai output perintah itu sendiri, jadi 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. Memeriksa permintaan tarik dengan `gh pr checkout`, atau mendorong ke cabang yang memiliki permintaan tarik terbuka, menautkannya dengan mencari cabang itu dengan `gh pr view` sebagai gantinya. Sebelum v2.1.205, hanya permintaan tarik yang dibuat atau diperiksa sesi yang tertaut, dan dorong menautkan satu hanya ketika nama cabang lokal cocok.166Sesi 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:

169 167

170Claude Code membaca permintaan tarik dari output perintah lengkap, termasuk bagian yang disimpan ke file ketika output perintah melebihi batas inline. Sebelum v2.1.205, permintaan tarik yang dibuat dalam panggilan Bash yang outputnya melebihi sekitar 30.000 karakter tidak tertaut.168* 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.

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

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

171 171

172Ketika 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](#peek-and-reply) untuk melihat semuanya.172Ketika 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](#peek-and-reply) untuk melihat semuanya.

173 173

180| Ungu | Digabungkan |180| Ungu | Digabungkan |

181| Abu-abu | Draf atau ditutup |181| Abu-abu | Draf atau ditutup |

182 182

183Untuk sebagian besar tugas, kolom ini adalah tempat Anda mengambil hasilnya: tinjau dan gabungkan permintaan tarik ketika nomornya berubah menjadi hijau.183Untuk tugas yang berakhir dalam permintaan tarik, periksa label ini untuk hasilnya: tinjau dan gabungkan permintaan tarik ketika nomornya berubah menjadi hijau.

184 184

185<h3 id="peek-and-reply">185<h3 id="peek-and-reply">

186 Intip dan balas186 Intip dan balas

196 196

197Sebagian besar waktu panel intip cukup dan Anda tidak perlu membuka transkrip lengkap.197Sebagian besar waktu panel intip cukup dan Anda tidak perlu membuka transkrip lengkap.

198 198

199Sebelum v2.1.207, setiap intip dibuka dengan kalimat status dan stempel waktu telanjang, dan sesi yang diblokir pertanyaannya muncul di bawahnya dengan awalan stempel waktu yang sama untuk kedua kalinya.199Ketik 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.

200 200

201Ketik 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.201Ketika hook [`PermissionRequest`](/docs/id/hooks#permissionrequest) atau [`PreToolUse`](/docs/id/hooks#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.

202 202

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

204 204

214 214

215Saat dilampirkan, sesi berperilaku seperti sesi Claude Code lainnya: [perintah](/docs/id/commands), pintasan keyboard, dan fitur semuanya berfungsi, dengan pengecualian di bawah.215Saat dilampirkan, sesi berperilaku seperti sesi Claude Code lainnya: [perintah](/docs/id/commands), pintasan keyboard, dan fitur semuanya berfungsi, dengan pengecualian di bawah.

216 216

217Sesi latar belakang menolak `/install-github-app` dan daftar pengaturan [`/mcp`](/docs/id/mcp), termasuk tindakan autentikasinya, apakah Anda dilampirkan atau membalas dari panel intip. Pesan mengarahkan Anda ke sesi `claude` biasa, dan `/mcp reconnect <server>`, `/mcp enable`, dan `/mcp disable` masih berfungsi.217Saat Anda melampirkan, `/install-github-app` dan daftar pengaturan [`/mcp`](/docs/id/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.

218 218

219Sesi yang dilampirkan selalu dirender dalam [mode layar penuh](/docs/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.219Sesi yang dilampirkan selalu dirender dalam [mode layar penuh](/docs/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.

220 220

221Tekan `←` pada prompt kosong, atau jalankan `/exit`, untuk melepaskan dan kembali ke tampilan agen. Mulai dari v2.1.198, ini berfungsi dengan cara yang sama apakah Anda membuka sesi dari tampilan agen atau dengan `claude attach <id>` dari shell Anda.221Tekan `←` 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.

222

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

222 224

223`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 `←`.225`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 `←`.

224 226

226 228

227Melepaskan 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`.229Melepaskan 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`.

228 230

231<h4 id="switch-sessions-without-leaving-the-terminal">

232 Alihkan sesi tanpa meninggalkan terminal

233</h4>

234

229Dalam 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.235Dalam 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.

230 236

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

238

239Ketika `←` 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:

240

241* Tekan `Enter` untuk membuka kembali percakapan.

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

243* Tekan `Ctrl+C` dua kali untuk keluar ke shell Anda.

244

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

246

247[Daftar tugas Claude](/docs/id/interactive-mode#task-list) bergerak ke sesi latar belakang dengan percakapan, jadi daftar periksa tetap utuh ketika Anda kembali ke baris itu.

248

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

250

231Jika 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`](#from-inside-a-session).251Jika 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`](#from-inside-a-session).

232 252

233Batas sepuluh detik tidak berlaku saat [subagents](/docs/id/sub-agents) sedang 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 dari awal. Sebelum v2.1.203, tunggu berakhir setelah sepuluh detik dan subagents yang sedang berjalan dimulai ulang dari awal tanpa peringatan.253Batas sepuluh detik tidak berlaku saat [subagents latar depan](/docs/id/sub-agents#run-subagents-in-foreground-or-background) 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](/docs/id/workflows) jalankan. Ketika alur kerja memiliki subagents yang berjalan, Claude Code menunjukkan dialog `Background this session?` sebagai gantinya.

254

255Claude 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.`

234 256

235Baris dibuat bahkan dari sesi segar tanpa riwayat percakapan, jadi `→` kembali ke sana. Sebelum v2.1.203, tampilan agen menampilkan petunjuk onboarding di bawah baris itu ketika itu adalah satu-satunya.257Menekan `←` membuat baris sesi bahkan ketika percakapan belum memiliki pesan, jadi `→` masih kembali ke sana.

236 258

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

238 260

240 Atur daftar262 Atur daftar

241</h3>263</h3>

242 264

243Tampilan 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.265Tampilan 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](#read-session-state) di atas: sesi bergerak ke `Ready for review` ketika memiliki permintaan tarik terbuka, dan `Completed` mengumpulkan sesi yang selesai, gagal, dan dihentikan bersama-sama.

244 266

245Tekan `Ctrl+S` untuk mengelompokkan berdasarkan direktori sebagai gantinya. Pilihan Anda bertahan di seluruh jalankan.267Tekan `Ctrl+S` untuk mengelompokkan berdasarkan direktori sebagai gantinya. Pilihan Anda bertahan di seluruh jalankan.

246 268

253 275

254Untuk 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.276Untuk 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.

255 277

256Menghapus 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`.278Tekan kedua menghapus sesi bahkan ketika upaya penghentian gagal, misalnya karena [layanan latar belakang tidak merespons](#agent-view-says-the-background-service-did-not-respond): konfirmasi tetap aktif selama dua detik lagi, dan penghapusan mengakhiri proses sesi itu sendiri. Tekan `Esc` untuk membatalkan konfirmasi tanpa menghapus.

257 279

258Menghapus tidak pernah menghapus worktree dengan komit yang tidak didorong ke mana pun, atau yang sesi lain yang sedang berjalan klaim atau kunci. Claude Code menyimpan worktree dan sesi, dan footer menamai jalur yang disimpan dan alasannya. Dorong komit, atau tutup sesi lain, lalu hapus lagi.280Kecuali dalam kasus yang dipertahankan yang tercakup dalam [Apa yang menghapus sesi menghapus](#what-deleting-a-session-removes), 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`.

259 281

260Menghapus juga menghapus sesi dari [daftar sesi supervisor](#the-supervisor-process), apakah Anda menghapus dengan `Ctrl+X` atau dengan [`claude rm`](#manage-sessions-from-the-shell) dari shell, sehingga penghapusan bertahan di seluruh restart supervisor. Sebelum v2.1.206, menghapus sesi saat supervisor memulai ulang atau tidak dapat dijangkau meninggalkannya dalam daftar itu, dan supervisor berikutnya memulai ulang prosesnya dan menampilkan baris lagi.282Untuk 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.

283

284Pemilih 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:

285

286* `/resume` menamai id atau istilah pencarian

287* tampilan dibatasi dengan `--cwd`

288* tampilan dimulai dengan [`--safe-mode`](/docs/id/cli-reference#cli-flags)

289* tampilan dibuka dengan bendera seperti `--permission-mode` atau `--settings`

261 290

262Sesi 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.291Sesi 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.

263 292

268Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:297Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:

269 298

270| Filter | Menampilkan |299| Filter | Menampilkan |

271| :---------------------- | :-------------------------------------------------------------------------------------------------------- |300| :------------------------------ | :-------------------------------------------------------------------------------------------------------- |

273| `s:<state>` | Sesi dalam status tertentu, seperti `s:working`. Juga menerima `s:blocked` untuk semua yang menunggu Anda |302| `s:<state>` | Sesi dalam status tertentu, seperti `s:working`. Juga menerima `s:blocked` untuk semua yang menunggu Anda |

275| URL lainnya | Sesi yang prompt pertamanya berisi URL itu |304| URL lainnya | Sesi yang prompt pertamanya berisi URL itu |

276 305

277<h3 id="keyboard-shortcuts">306<h3 id="keyboard-shortcuts">

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

282 311

283| Pintasan | Tindakan |312| Pintasan | Tindakan |

284| :-------------------- | :----------------------------------------------------------------------------------- |313| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

285| `↑` / `↓` | Pindah antar baris |314| `↑` / `↓` | Pindah antar baris |

318| `Ctrl+Enter` | Kirim dan lampirkan segera, di terminal tempat overlay `?` mencantumkan `ctrl+enter to start and open` |

289| `→` | Lampirkan ke sesi yang dipilih |319| `→` | Lampirkan ke sesi yang dipilih |

291| `Tab` | Pada input kosong, telusuri semua subagents. Jika tidak, terapkan saran yang disorot |321| `Tab` | Pada input kosong, telusuri semua subagents. Jika tidak, terapkan saran yang disorot |

326| `Ctrl+J` | Sisipkan baris baru dalam input pengiriman |

298| `Esc` | Tutup panel intip, hapus input, atau keluar |329| `Esc` | Tutup panel intip, hapus input, atau keluar. Ketika Anda membuka tampilan agen dengan mengirim sesi Anda ke latar belakang dengan `←`, `Esc` terakhir kembali ke percakapan itu alih-alih keluar. Dengan [mode editor vim](/docs/id/interactive-mode#vim-editor-mode) aktif, menekan `Esc` dalam input beralih dari mode INSERT ke mode NORMAL dan menyimpan teks Anda, seperti dalam prompt utama |

300| `?` | Tampilkan semua pintasan |331| `?` | Tampilkan semua pintasan |

301 332

311 342

312Ketik 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`.343Ketik 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`.

313 344

314Nama yang diterima sesi nanti juga muncul di barisnya, termasuk nama yang Claude turunkan ketika Anda [menerima rencana](/docs/id/permission-modes#review-and-approve-a-plan) dalam sesi itu. Sebelum v2.1.207, sesi latar belakang yang diberi nama dengan menerima rencana menampilkan nama itu dalam `/status` tetapi bukan di baris tampilan agen-nya sampai Anda mengganti namanya sendiri.345Nama otomatis adalah label pendek yang ditulis oleh [model kelas Haiku](/docs/id/model-config). Nama yang diterima sesi nanti juga muncul di barisnya, termasuk [judul yang dihasilkan](/docs/id/sessions#name-your-sessions) yang diterima sesi ketika Anda [menerima rencana](/docs/id/permission-modes#review-and-approve-a-plan) dalam sesi itu.

315 346

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

317 348

318Teks yang ditempel lebih panjang dari 800 karakter atau lebih dari dua 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 berkembang kembali ke dalam input. Pengingat `paste again to expand` muncul di bawah input selama beberapa detik setelah tempel pada terminal setidaknya 90 kolom lebar. Sebelum v2.1.207, menempel teks yang sama lagi menambahkan placeholder kedua alih-alih memperluas yang pertama.349Teks 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 berkembang kembali ke dalam input.

319 350

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

321 352

322| Input | Efek |353| Input | Efek |

323| :------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |354| :------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

324| `<agent-name> <prompt>` | Jika kata pertama cocok dengan nama [subagent](/docs/id/sub-agents) kustom, subagent itu berjalan sebagai agen utama sesi dengan konfigurasi dari frontmatter-nya |355| `<agent-name> <prompt>` | Jika kata pertama cocok dengan nama [subagent](/docs/id/sub-agents) kustom, subagent itu berjalan sebagai agen utama sesi dengan konfigurasi dari frontmatter-nya |

326| `@<repo>` | Sebutkan repositori untuk menjalankan sesi di sana. Lihat [Kirim ke direktori tertentu](#dispatch-to-a-specific-directory) untuk repositori mana yang terdaftar |357| `@<repo>` | Sebutkan repositori untuk menjalankan sesi di sana. Lihat [Kirim ke direktori tertentu](#dispatch-to-a-specific-directory) untuk repositori mana yang terdaftar |

328| `! <command>` | Jalankan perintah shell sebagai pekerjaan latar belakang alih-alih memulai sesi Claude. Pekerjaan muncul sebagai baris yang dapat Anda lampirkan, tonton, dan lepaskan |359| `! <command>` | Jalankan perintah shell sebagai pekerjaan latar belakang alih-alih memulai sesi Claude. Pekerjaan muncul sebagai baris yang dapat Anda lampirkan, tonton, dan lepaskan |

329| `#<number>` atau URL permintaan tarik | Jika sesi sudah bekerja pada PR itu, pilih saja alih-alih mengirim |360| `#<number>` atau URL permintaan tarik atau gabung | Jika sesi sudah bekerja pada permintaan tarik atau gabung itu, Claude Code memilih barisnya alih-alih mengirim sesi baru |

330| `Shift+Enter` | Kirim dan lampirkan segera ke sesi baru |

331 361

332Serangkaian kecil perintah berjalan dalam tampilan agen itu sendiri alih-alih mengirim:362Serangkaian kecil perintah berjalan dalam tampilan agen itu sendiri alih-alih mengirim:

333 363

334* `/exit` dan `/quit` menutup tampilan agen364* `/exit` dan `/quit` menutup tampilan agen

335* `/logout` menandatangani Anda keluar365* `/logout` menandatangani Anda keluar

336* `/model` menetapkan [model pengiriman](#set-the-model)366* `/model` menetapkan [model pengiriman](#set-the-model)

337* Mulai dari v2.1.198, `/login` membuka dialog masuk sehingga Anda dapat masuk lagi tanpa melampirkan ke sesi367* `/login` membuka dialog masuk sehingga Anda dapat masuk lagi tanpa melampirkan ke sesi

368* Bare `/resume`, atau aliasnya `/continue`, membuka pemilih sesi masa lalu repositori untuk [membawa satu kembali](#organize-the-list) sebagai sesi latar belakang. Memerlukan Claude Code v2.1.212 atau lebih baru

338 369

339Skills, 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. Sebelum v2.1.203, petunjuk menghapus input dan teks yang diketik hilang.370Skills, 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. Semua yang Anda ketik tetap berada dalam input di sebelah petunjuk sehingga Anda dapat mengeditnya.

340 371

341Mengemas tugas berulang sebagai [skill](/docs/id/skills) memungkinkan Anda memulai alur kerja yang sama dari tampilan agen berulang kali tanpa mengetik ulang prompt.372Mengemas tugas berulang sebagai [skill](/docs/id/skills) memungkinkan Anda memulai alur kerja yang sama dari tampilan agen berulang kali tanpa mengetik ulang prompt.

342 373

355 * [Git worktrees](/docs/id/worktrees) terdaftar dari repositori yang Anda luncurkan dari yang berada di dalam pohon direktorinya, seperti yang Claude buat di bawah `.claude/worktrees/`, diberi label dengan cabang yang diperiksa. Worktrees yang ditambahkan di luar repositori, seperti dengan `git worktree add ../feature`, tidak terdaftar386 * [Git worktrees](/docs/id/worktrees) terdaftar dari repositori yang Anda luncurkan dari yang berada di dalam pohon direktorinya, seperti yang Claude buat di bawah `.claude/worktrees/`, diberi label dengan cabang yang diperiksa. Worktrees yang ditambahkan di luar repositori, seperti dengan `git worktree add ../feature`, tidak terdaftar

356 * Direktori apa pun yang sudah memiliki sesi dalam daftar387 * Direktori apa pun yang sudah memiliki sesi dalam daftar

357 388

358 Direktori yang namanya berisi spasi tidak terdaftar. Sebelum v2.1.203, worktrees terdaftar tidak terdaftar, jadi pengiriman ke dalamnya berarti menjalankan `claude --bg` dari direktori worktree itu.389 Direktori yang namanya berisi spasi tidak terdaftar.

359* Dari shell, `cd` ke direktori dan jalankan `claude --bg "<prompt>"`.390* Dari shell, `cd` ke direktori dan jalankan `claude --bg "<prompt>"`.

360 391

361Ketika 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.392Ketika tampilan agen dikelompokkan berdasarkan direktori, pengiriman mengirim prompt ke direktori baris yang dipilih, sehingga Anda dapat memilih grup dan mengirim ke dalamnya tanpa mengetik ulang jalur.

362 393

363<h3 id="from-inside-a-session">394<h3 id="from-inside-a-session">

364 Dari dalam sesi395 Dari dalam sesi

365</h3>396</h3>

366 397

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

399

400<h4 id="send-the-session-to-the-background">

401 Kirim sesi ke latar belakang

402</h4>

403

367Jalankan `/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.404Jalankan `/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.

368 405

369Keluar dari sesi interaktif yang masih memiliki pekerjaan latar belakang yang berjalan, seperti subagent, perintah shell latar belakang, alur kerja, atau [monitor](/docs/id/tools-reference#monitor-tool), menampilkan dialog `Background work is running` alih-alih berhenti segera. Mulai dari v2.1.198 dialog menawarkan `Move to background and exit` bersama `Exit anyway` dan `Stay`. Memilihnya memindahkan sesi ke latar belakang dengan cara yang sama seperti `/background`, kemudian mengembalikan Anda ke shell Anda, sehingga pekerjaan yang dapat dibawa terus berjalan dan sesi muncul dalam tampilan agen. Opsi tidak ditampilkan ketika tampilan agen [dimatikan](#turn-off-agent-view).406Keluar dari sesi yang masih memiliki pekerjaan latar belakang yang berjalan, seperti subagent, perintah shell latar belakang, alur kerja, atau [monitor](/docs/id/tools-reference#monitor-tool), menampilkan dialog `Background work is running` alih-alih berhenti segera. Pilih `Move to background and exit` untuk melepaskan sesi dengan cara yang sama seperti `/background` dan kembali ke shell Anda. Opsi tidak ditampilkan ketika tampilan agen [dimatikan](#turn-off-agent-view).

407

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

409

410<h4 id="copy-the-session-with-/fork">

411 Salin sesi dengan /fork

412</h4>

413

414Jalankan `/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. Salinan 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 dalam tampilan agen.

415

416Setelah fork, dua percakapan independen: tidak ada yang dilakukan salinan memasuki percakapan asli dengan sendirinya, meskipun dalam sesi di mana [pengiriman lintas sesi](/docs/id/cross-session-messaging) diaktifkan, Claude sesi mana pun dapat secara eksplisit mengirim pesan ke yang lain.

417

418Menyalin sesi memerlukan Claude Code v2.1.212 atau lebih baru; pada v2.1.161 melalui v2.1.211, `/fork` memulai [subagent yang di-fork](/docs/id/sub-agents#fork-the-current-conversation) sebagai gantinya, yang sekarang `/subtask`. Ketika [tampilan agen dimatikan](#turn-off-agent-view), `/fork` mempertahankan perilaku subagent yang di-fork dan `/subtask` tidak tersedia.

419

420Berikan 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 dalam `claude agents` dan tekan `Space` untuk mengirim satu, atau jalankan `claude attach <id>`. Baris yang dipilih menampilkan `space to send it a prompt` sementara menunggu.

370 421

371Melepaskan dari sesi interaktif memulai proses segar yang dilanjutkan dari percakapan yang disimpan, dan pekerjaan yang sedang berlangsung berpindah ke sesi itu: menjalankan perintah shell latar belakang, subagent yang dilepaskan ke latar belakang, alur kerja dinamis, dan tugas terjadwal yang Anda buat dengan [`/loop`](/docs/id/scheduled-tasks) dibawa ke sesi latar belakang dan terus berjalan di sana. Subagent bergerak bersama dengan semua yang dimulainya, jadi hanya dibawa ketika semua pekerjaan itu dapat berpindah juga, termasuk di Windows. Untuk menghentikan pekerjaan yang sedang berlangsung alih-alih membawanya, atur variabel lingkungan [`CLAUDE_DISABLE_ADOPT=1`](/docs/id/env-vars#variables); Claude Code kemudian meminta Anda untuk mengonfirmasi sebelum melepaskan.422Konfirmasi `/fork` adalah satu baris yang menunjukkan status salinan, seperti `session running`, nama baris tampilan agen-nya, dan ID sesinya untuk `claude attach`. Klik nama untuk beralih ke salinan: sesi ini pindah ke latar belakang, sama seperti menekan `←`, dan tampilan agen membuka sesi salinan.

372 423

373Pekerjaan yang tidak dapat dibawa, seperti [monitor](/docs/id/tools-reference#monitor-tool) yang sedang berjalan, dihentikan. Subagent yang dilepaskan ke latar belakang yang memiliki monitor dihentikan bersama dengannya. Ketika ada pekerjaan seperti itu yang sedang berjalan, Claude Code menampilkan dialog `Background this session?` sehingga Anda dapat mengonfirmasi sebelum dihentikan.424Kecuali ketika salinan [mengedit di tempat](#how-file-edits-are-isolated), 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 mendapat instruksi; tanpa [`WorktreeCreate` hook](/docs/id/hooks#worktreecreate), 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.

425

426Tempat salinan dimulai tergantung pada tempat sesi saat ini berjalan:

427

428* Seperti sesi yang dikirim apa pun, salinan [pindah ke worktree miliknya sendiri sebelum mengedit file](#how-file-edits-are-isolated). Dalam hal ini konfirmasi tidak menyebutkan tempat salinan berjalan.

429* Ketika sesi Anda pindah ke [worktree](/docs/id/worktrees) tertaut setelah dimulai, salinan dimulai kembali di mana sesi berada sebelum pindah dan, kecuali [mengedit di tempat](#how-file-edits-are-isolated), membuat perubahan kodenya dalam 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 dalam worktree Anda. Konfirmasi berakhir dengan `runs in the origin tree`.

430* Ketika Anda meluncurkan sesi di dalam worktree tertaut dari repositori yang memiliki pohon kerja utama, salinan dimulai dalam pohon kerja utama itu, dengan aturan worktree-milik-sendiri yang sama tetapi tanpa instruksi cabang. Konfirmasi berakhir dengan `runs in the origin tree` di sini juga.

431* 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](#how-file-edits-are-isolated) dalam sesi yang tidak berada di dalam worktree tertaut, karena salinan kemudian mengedit file yang Anda buka.

432

433Sesi yang dimulai dengan bendera peluncuran yang tidak akan diwarisi 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 tampilan agen di-fork secara normal: salinan diluncurkan dengan [definisi agen](/docs/id/sub-agents) dan instruksi yang ditambahkan yang sama seperti sesi yang berasal darinya.

434

435<h4 id="what-carries-over-when-you-background">

436 Apa yang dibawa ketika Anda melepaskan ke latar belakang

437</h4>

438

439Melepaskan ke latar belakang memulai proses segar yang dilanjutkan dari percakapan yang disimpan, dan pekerjaan yang sedang berlangsung berpindah ke sana: menjalankan perintah shell latar belakang, subagent yang dilepaskan ke latar belakang, alur kerja dinamis, tugas terjadwal yang Anda buat dengan [`/loop`](/docs/id/scheduled-tasks), dan [balasan otomatis Claude ke komentar artefak](/docs/id/artifacts#let-claude-reply-to-comments-on-its-own) semuanya dibawa dan terus berjalan di sana. Subagent bergerak bersama dengan semua yang dimulainya, jadi hanya dibawa ketika semua pekerjaan itu dapat berpindah juga. Untuk menghentikan pekerjaan yang sedang berlangsung alih-alih membawanya, atur variabel lingkungan [`CLAUDE_DISABLE_ADOPT=1`](/docs/id/env-vars#variables); Claude Code kemudian meminta Anda untuk mengonfirmasi sebelum melepaskan.

440

441Ketika [alur kerja dinamis](/docs/id/workflows) masih memiliki subagent yang berjalan, Claude Code bertanya sebelum melepaskan dengan dialog `Background this session?`, yang mengatakan berapa banyak subagent yang akan dimulai ulang. Pilih `Stay` untuk membiarkan mereka selesai terlebih dahulu. Jika Anda mengonfirmasi, Claude Code memutar ulang jalankan dalam sesi latar belakang: subagent yang masih berjalan dimulai dari awal, jadi token yang mereka gunakan sejauh ini dihabiskan lagi. Lihat [Lanjutkan setelah jeda](/docs/id/workflows#resume-after-a-pause) untuk subagent mana yang menyelesaikan mengembalikan hasil yang disimpan dan mana yang berjalan lagi.

442

443Claude Code menghentikan pekerjaan yang tidak dapat dibawa, seperti [monitor](/docs/id/tools-reference#monitor-tool) yang sedang berjalan, dan menghentikan subagent yang dilepaskan ke latar belakang yang memiliki monitor bersama dengannya. Ketika ada pekerjaan seperti itu yang sedang berjalan, Claude Code menampilkan dialog `Background this session?` sehingga Anda dapat mengonfirmasi sebelum dihentikan.

374 444

375Setelah 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.445Setelah 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.

376 446

383* `--fallback-model`453* `--fallback-model`

384* `--allow-dangerously-skip-permissions`454* `--allow-dangerously-skip-permissions`

385 455

386Direktori yang Anda tambahkan selama sesi dengan [`/add-dir`](/docs/id/permissions#additional-directories-grant-file-access-not-configuration) juga dibawa ke sesi.456Direktori yang Anda tambahkan selama sesi dengan [`/add-dir`](/docs/id/permissions#additional-directories-grant-file-access-not-configuration) juga dibawa. Membawa `--allow-dangerously-skip-permissions` 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 dijelaskan dalam [Mode izin, model, dan upaya](#permission-mode-model-and-effort).

~~387~~

388Membawa `--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.

389 457

390<h3 id="from-your-shell">458<h3 id="from-your-shell">

391 Dari shell Anda459 Dari shell Anda

397claude --bg "investigate the flaky SettingsChangeDetector test"465claude --bg "investigate the flaky SettingsChangeDetector test"

398```466```

399 467

400Prompt adalah argumen posisional, bukan nilai `-p`. Mulai dari v2.1.198, menggabungkan `--bg` dengan `-p` atau `--print` ditolak dengan kesalahan sebelum sesi apa pun dibuat, karena `--print` tidak pernah memulai sesi interaktif yang `claude agents` lampirkan.468Prompt 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.

401 469

402Untuk menjalankan subagent tertentu sebagai agen utama sesi, gabungkan `--bg` dengan `--agent`:470Untuk menjalankan [subagent](/docs/id/sub-agents) tertentu yang Anda tentukan, seperti `code-reviewer`, sebagai agen utama sesi, gabungkan `--bg` dengan `--agent`:

403 471

404```bash theme={null}472```bash theme={null}

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

406```474```

407 475

476Jika nama tidak cocok dengan subagent Anda, peluncuran gagal: Claude Code mencetak peringatan `no agent named` dan masih melaporkan sesi sebagai dilepaskan ke latar belakang, tetapi sesi keluar segera dengan kesalahan `--agent '<name>' not found`.

477

478Ketika sesi yang dilepaskan ke latar belakang nanti dilanjutkan atau dimulai ulang, Claude Code memulihkan prompt sistem agen dan pembatasan alat. Sesi mencari direktorinya sendiri untuk agen terlebih dahulu, asalkan Anda telah [mempercayai ruang kerja itu](/docs/id/permissions#project-allow-rules-and-workspace-trust), jadi agen yang dibatasi proyek masih dimuat ketika sesi dilanjutkan dari direktori lain. Jika agen tidak lagi ada, sesi berlanjut dengan alat default dan prompt sistem dan transkrip-nya terbuka dengan [peringatan yang menyebutkan agen](/docs/id/errors#session-agent-no-longer-available).

479

408Berikan `--name` untuk menetapkan nama tampilan sesi dalam tampilan agen alih-alih yang dibuat secara otomatis:480Berikan `--name` untuk menetapkan nama tampilan sesi dalam tampilan agen alih-alih yang dibuat secara otomatis:

409 481

410```bash theme={null}482```bash theme={null}

425 Jalankan perintah shell497 Jalankan perintah shell

426</h4>498</h4>

427 499

428Untuk 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:500Untuk menjalankan perintah shell sebagai pekerjaan latar belakang alih-alih sesi Claude, berikan `--exec`. Contoh berikut menjalankan `pytest -x` sebagai pekerjaan latar belakang:

~~429~~

430```text theme={null}

431! pytest -x

432```

~~433~~

434Tekan `Enter` untuk memulai pekerjaan. Pekerjaan yang sama juga dapat diluncurkan langsung dari shell Anda dengan `--exec`:

435 501

436```bash theme={null}502```bash theme={null}

437claude --bg --exec 'pytest -x'503claude --bg --exec 'pytest -x'

438```504```

439 505

506Dari tampilan agen, kirim pekerjaan jenis yang sama dengan mengetik `!` sebagai karakter pertama dari input pengiriman: `!` ditampilkan sebagai awalan, semua yang setelahnya adalah perintah, dan `Enter` memulai pekerjaan.

507

440Perintah 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.508Perintah 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.

441 509

442Untuk melihat output, lampirkan ke baris, tekan `Space` untuk mengintip tanpa melampirkan, atau jalankan `claude logs <id>` 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.510Untuk melihat output, lampirkan ke baris, tekan `Space` untuk mengintip tanpa melampirkan, atau jalankan `claude logs <id>` 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.

445 Bagaimana pengeditan file diisolasi513 Bagaimana pengeditan file diisolasi

446</h3>514</h3>

447 515

448Setiap 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](/docs/id/worktrees) yang terisolasi di bawah `.claude/worktrees/`, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri.516Setiap 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](/docs/id/worktrees) yang terisolasi di bawah `.claude/worktrees/`, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri. Setelah sesi berada dalam worktree-nya, Claude Code [memberlakukan isolasi worktree](/docs/id/worktrees#how-claude-code-enforces-isolation) untuk sesi dan untuk subagent apa pun yang dihasilkannya.

449 517

450Claude melewati worktree ketika:518Claude melewati worktree ketika:

451 519

452* Sesi sudah berada di dalam linked git worktree, baik Claude membuatnya di bawah `.claude/worktrees/` atau Anda membuatnya dengan `git worktree add` di tempat lain520* 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

521* File yang Claude edit berada di dalam linked git worktree, seperti yang dibuat sesi atau subagent-nya dengan `git worktree add`

453* Direktori kerja bukan repositori git dan tidak ada [`WorktreeCreate` hook](/docs/id/hooks#worktreecreate) yang dikonfigurasi522* Direktori kerja bukan repositori git dan tidak ada [`WorktreeCreate` hook](/docs/id/hooks#worktreecreate) yang dikonfigurasi

454* Penulisan berada di luar direktori kerja523* Penulisan berada di luar direktori kerja

455 524

456Untuk mematikan isolasi worktree untuk repositori tempat git worktree tidak praktis, atur [`worktree.bgIsolation`](/docs/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:525Untuk mematikan isolasi worktree untuk repositori tempat git worktree tidak praktis, atur [`worktree.bgIsolation`](/docs/id/settings-reference#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:

457 526

458```json theme={null}527```json theme={null}

459{528{

465 534

466Di 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](/docs/id/worktrees#non-git-version-control) dan Claude mengisolasi pengeditan dengan cara yang sama seperti yang dilakukannya untuk git.535Di 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](/docs/id/worktrees#non-git-version-control) dan Claude mengisolasi pengeditan dengan cara yang sama seperti yang dilakukannya untuk git.

467 536

468Ketika hook gagal di direktori yang bukan repositori git, sesi melewati isolasi untuk direktori itu dan mengedit direktori kerja di tempat. Di dalam repositori git, penulisan tetap diblokir sampai sesi mengisolasi. Sebelum v2.1.203, sesi latar belakang dalam keadaan itu tidak dapat mengedit file apa pun: setiap penulisan ditolak sampai mengisolasi, dan hook tidak pernah dapat mengisolasi direktori itu.537Ketika 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.

469 538

470Menghapus sesi menghapus atau menyimpan worktree yang Claude buat untuk sesi itu, tergantung pada cara Anda menghapusnya dan apa yang dipegang worktree:539Untuk menemukan jalur worktree sesi, intip sesi atau lampirkan dan periksa direktori kerjanya.

471 540

472* Menghapus dalam tampilan agen dengan `Ctrl+X` dua kali menghapus worktree, termasuk perubahan yang belum dikomit, jadi komit perubahan yang ingin Anda simpan terlebih dahulu.541[Subagent](/docs/id/sub-agents) yang sesi latar belakang hasilkan mewarisi direktori kerja sesi, jadi pengeditan filenya mendarat di worktree sesi daripada salinan kerja Anda. Untuk memberikan subagent worktree terpisah sendiri, atur [`isolation: worktree`](/docs/id/sub-agents#supported-frontmatter-fields) dalam frontmatter-nya atau berikan `isolation: "worktree"` saat menghasilkannya.

473* Menghapus dari shell dengan [`claude rm`](#manage-sessions-from-the-shell) menyimpan worktree yang memiliki perubahan yang belum dikomit, bersama dengan baris sesinya.

474* Tidak ada jalur yang menghapus worktree dengan komit yang tidak didorong ke mana pun: worktree [disimpan bersama dengan sesinya](#organize-the-list) dan output menyebutkan jalur yang disimpan dan alasannya.

475* Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat baik cara apa pun.

476 542

477Untuk menemukan jalur worktree sesi, intip sesi atau lampirkan dan periksa direktori kerjanya.543Ketika sesi latar belakang telah membuat perubahan kode dalam worktree Claude masuki, Claude Code menginstruksikan Claude untuk menyimpan pekerjaan sebelum selesai, sehingga bertahan jika Anda menghapus sesi dan worktree-nya:

478 544

479Sebuah [subagent](/docs/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`](/docs/id/sub-agents#supported-frontmatter-fields) dalam frontmatter-nya atau berikan `isolation: "worktree"` saat spawn-nya.545* **Komit dan dorong**: Claude melakukan komit tanpa bertanya, dan mendorong cabang ketika repositori memiliki remote.

546* **Draft pull request**: Claude membuka satu ketika tugas memanggilnya, dan label [`#N`](#pull-request-status) muncul di baris.

547* **Tidak pernah**: mendorong ke `main` atau `master`, force-push, dan merge.

548* **Instruksi git Anda memiliki prioritas**: jika tugas, `CLAUDE.md`, atau [memori](/docs/id/memory) mengatakan Anda menangani komit atau push sendiri, Claude membiarkan git kepada Anda.

480 549

481Mulai dari v2.1.198, sesi latar belakang yang mengisolasi perubahan kodenya dalam worktree juga melakukan commit, mendorong cabangnya sendiri, dan membuka draft pull request tanpa berhenti untuk bertanya. Label [`#N`](#pull-request-status) muncul pada barisnya ketika pull request dibuka. Tidak pernah mendorong ke `main` atau `master`, tidak pernah force-push atau merge, dan melewati pull request ketika Anda mengatakan kepadanya untuk tidak membuka satu atau repositori tidak memiliki remote.550Sesi yang mengedit checkout yang tidak mengisolasi dirinya sendiri masih bertanya sebelum melakukan komit atau beralih cabang. Ini berlaku ketika isolasi diatur ke `"none"`, ketika pergerakan worktree gagal, atau ketika sesi dimulai di dalam worktree yang sudah ada.

482 551

483Sesi yang mengedit checkout yang tidak mengisolasi dirinya sendiri masih bertanya sebelum melakukan commit atau beralih cabang. Ini berlaku ketika isolasi diatur ke `"none"`, ketika pergerakan worktree gagal, atau ketika sesi dimulai di dalam worktree yang sudah ada.552Apa pun tugasnya, Claude mengakhiri pekerjaan dengan laporan yang mengatakan apa yang dilakukannya dan di mana pekerjaan itu: jalur, cabang, pull request, atau jawabannya sendiri.

553

554<h4 id="what-deleting-a-session-removes">

555 Apa yang dihapus menghapus sesi

556</h4>

557

558Hapus sesi dengan `Ctrl+X` dua kali dalam [tampilan agen](#organize-the-list) atau dengan [`claude rm`](#manage-sessions-from-the-shell). Kecuali dalam kasus yang disimpan di bawah, sesi meninggalkan daftar. Transkrip-nya tetap di mesin Anda melalui `claude --resume`, dan penghapusan bertahan restart supervisor.

559

560Apa yang terjadi pada worktree Claude buat untuk sesi:

561

562* Tampilan agen menghapusnya, termasuk perubahan yang belum dikomit, jadi komit apa yang ingin Anda simpan terlebih dahulu.

563* `claude rm` menyimpannya, bersama dengan baris sesi, ketika memiliki perubahan yang belum dikomit.

564* Tidak ada tampilan agen atau `claude rm` yang menghapus worktree dengan komit Claude Code tidak dapat mengonfirmasi disimpan di tempat lain, atau yang digunakan atau dikunci sesi yang sedang berjalan lainnya. Claude Code menyimpan worktree dan sesi, dan memberi nama direktori yang disimpan dan alasannya.

565

566 Komit pada remote tidak memblokir penghapusan. Juga tidak komit pada salinan lokal cabang default remote `origin` Anda, asalkan cabang itu diperiksa dalam checkout utama Anda, direktori repositori itu sendiri daripada worktree.

567

568 Dalam tampilan agen, penghapusan yang ditolak menampilkan `not deleted` dengan alasan di baris sesi. Dorong komit, gabungkan ke dalam cabang default itu, atau tutup sesi lain, kemudian hapus lagi.

569* Worktree yang git tidak lagi mengenali, misalnya setelah `git worktree prune`, tidak memblokir penghapusan. Claude Code menghapus sesi dan meninggalkan direktori di disk.

570

571Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat baik cara apa pun.

572

573Sesi yang direktori worktree-nya tidak termasuk dalam repositori git apa pun, karena repositori dihapus atau [`WorktreeCreate` hook](/docs/id/hooks#worktreecreate) membuat direktori di tempat lain, masih dapat dihapus. Sementara file tetap berada dalam direktori:

574

575* Tampilan agen meminta `Ctrl+X` double-press yang sama sebelum membuang mereka. Untuk direktori yang dibuat hook, jalankan [`WorktreeRemove` hook](/docs/id/hooks#worktreeremove) Anda sebagai gantinya, dan tanpa satu menolak penghapusan dan menyimpan sesi.

576* `claude rm` menyimpan sesi dan worktree, dan memberi nama alasannya.

577

578Jalur mana pun menyimpan direktori yang catatan sesi yang selesai lainnya beri nama.

484 579

485<h3 id="set-the-model">580<h3 id="set-the-model">

486 Atur model581 Atur model

487</h3>582</h3>

488 583

489Nama 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`](/docs/id/settings#available-settings) dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih [`/model`](/docs/id/model-config), atau edit pengaturan secara langsung.584Nama 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`](/docs/id/settings-reference#model) dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih [`/model`](/docs/id/model-config), atau edit pengaturan secara langsung.

490 585

491Untuk menimpanya untuk seluruh sesi tampilan agen, berikan `--model` saat membuka tampilan agen. Lihat [Mode izin, model, dan upaya](#permission-mode-model-and-effort).586Untuk menimpanya untuk seluruh sesi tampilan agen, berikan `--model` saat membuka tampilan agen. Lihat [Mode izin, model, dan upaya](#permission-mode-model-and-effort).

492 587

509 Mode izin, model, dan upaya604 Mode izin, model, dan upaya

510</h3>605</h3>

511 606

512Sesi latar belakang membaca [pengaturan](/docs/id/settings) dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai `claude` di sana. Ini mencakup nilai [`env`](/docs/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.607Sesi 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.

608

609<h4 id="settings-and-provider">

610 Pengaturan dan penyedia

611</h4>

513 612

514Pemilihan penyedia cloud, seperti `CLAUDE_CODE_USE_BEDROCK` atau `CLAUDE_CODE_USE_VERTEX`, dan alias `ANTHROPIC_DEFAULT_*_MODEL` mengikuti shell yang mengirim sesi. Jika Anda mengekspor penimpaan badan permintaan [`CLAUDE_CODE_EXTRA_BODY`](/docs/id/env-vars) dalam shell itu, itu mencapai sesi dengan cara yang sama. Sebelum v2.1.206, pekerja latar belakang mengabaikan `CLAUDE_CODE_EXTRA_BODY` yang diekspor shell.613Sesi latar belakang membaca [pengaturan](/docs/id/settings) dari direktori tempat sesi berjalan, sama seperti jika Anda telah memulai `claude` di sana. Ini mencakup nilai [`env`](/docs/id/settings-reference#env) dalam pengaturan proyek, jadi `ANTHROPIC_MODEL` atau variabel penyedia yang ditetapkan di sana berlaku untuk setiap sesi latar belakang di direktori itu.

515 614

516Jika Anda mengekspor gateway `ANTHROPIC_BASE_URL` dalam shell pengiriman, itu mencapai sesi juga, bersama dengan `ANTHROPIC_CUSTOM_HEADERS`, ketika supervisor berjalan dengan lingkungan gateway yang sama dan sesi berjalan di direktori tempat Anda mengirim atau adalah sesi Anda sendiri yang dilepaskan ke latar belakang dengan `←` atau `/background`. Itu adalah kasus normal ketika shell pertama yang membuka tampilan agen atau mengirim sesi latar belakang adalah shell gateway. Pengiriman ke direktori berbeda dengan `@repo` atau `--cwd` tidak membawa gateway shell; pengaturan [settings](/docs/id/settings) proyek itu menyediakan endpoint. Lihat [proses supervisor](#the-supervisor-process) untuk cara sesi latar belakang bersumber pengaturan penyedia dan kredensial.615Sesi latar belakang juga berjalan dengan `PATH` dari shell yang Anda kirim darinya, sehingga perintah yang dijalankannya menemukan alat yang sama seperti terminal Anda. Sesi juga menyimpan pemilihan penyedia cloud shell itu, seperti `CLAUDE_CODE_USE_BEDROCK` atau `CLAUDE_CODE_USE_VERTEX`, bersama dengan alias `ANTHROPIC_DEFAULT_*_MODEL` dan penimpaan [`CLAUDE_CODE_EXTRA_BODY`](/docs/id/env-vars) apa pun yang Anda ekspor di sana.

517 616

518[Mode izin](/docs/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](/docs/id/sub-agents#supported-frontmatter-fields) yang dikirim.617<h4 id="llm-gateway">

618 Gateway LLM

619</h4>

519 620

520Mode 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.621Jika Anda merutekan Claude Code melalui [gateway LLM](/docs/id/llm-gateway), letakkan variabel gateway dalam blok `env` file pengaturan daripada mengekspornya dalam shell Anda, dan sesi latar belakang membacanya dengan sisa pengaturan mereka. [Atur dalam file pengaturan](/docs/id/llm-gateway-connect#set-in-a-settings-file) menunjukkan blok dan file pengaturan mana yang digunakan untuk kredensial.

521 622

522Upaya yang sesi ambil dari pengaturan [`effortLevel`](/docs/id/settings#available-settings) daripada dari `--effort` atau `/effort` tidak diperbaiki saat pengiriman: setiap proses yang dimulai untuk sesi membaca pengaturan lagi, jadi mengedit `effortLevel` dalam `settings.json` mencapai sesi yang Anda lepaskan ke latar belakang dengan `←` atau `/bg` dan restart mereka yang lebih baru. Sebelum v2.1.203, melepaskan sesi mencatat upaya yang berasal dari pengaturan seolah-olah Anda telah melewatkan `--effort`, jadi pengeditan `effortLevel` yang lebih baru tidak pernah mencapainya.623Jika Anda mengekspor gateway `ANTHROPIC_BASE_URL` hanya dalam shell Anda sebagai gantinya, itu mencapai sesi latar belakang, bersama dengan `ANTHROPIC_CUSTOM_HEADERS` dan kredensial yang Anda ekspor dengannya, hanya ketika [supervisor](#the-supervisor-process) itu sendiri dimulai dari shell yang mengekspor gateway yang sama, dan hanya dalam kasus ini:

523 624

524Nama yang Anda atur dengan [`/rename`](/docs/id/commands) atau `Ctrl+R` juga bertahan di seluruh restart itu, jadi [`claude --resume <name>`](/docs/id/sessions#name-your-sessions) masih menyelesaikan sesi. Sebelum v2.1.202, restart mengembalikan sesi ke nama yang dikirim dengannya dan nama baru berhenti menyelesaikan.625* Anda melepaskan sesi Anda sendiri dengan `←` atau `/background`

626* Anda mengirim sesi ke direktori yang Anda masuki

627* Anda membangunkan sesi yang dihentikan dalam direktori yang Anda masuki dengan melampirkan atau membalasnya

628

629Claude Code meneruskan gateway di depan penyedia cloud. Jika shell yang Anda kirim dari memilih penyedia dan mengekspor titik akhir gateway-nya dengan bendera bypass auth-nya, Claude Code meneruskan pasangan titik akhir-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.

630

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

632

633<h4 id="permission-mode">

634 Mode izin

635</h4>

636

637[Mode izin](/docs/id/permissions) tergantung pada cara Anda memulai sesi:

638

639* **Dilepaskan dengan `/bg` atau `←`**: Claude Code mempertahankan mode izin sesi yang ada, jadi sesi yang Anda alihkan ke `acceptEdits` atau `auto` tetap di sana setelah detach

640* **Dikirim dari tampilan agen yang Anda buka dengan `←`**: sesi baru dimulai dalam mode izin sesi yang Anda datang dari

641* **Dikirim dari `claude agents` yang dimulai dalam shell, atau dengan `claude --bg`**: sesi baru dimulai dengan cara sesi `claude` baru di direktori itu akan, kecuali Anda mengirimnya dari tampilan agen yang Anda buka dengan [default pengiriman](#dispatch-defaults). [Mode izin mana sesi dimulai](/docs/id/permission-modes#which-mode-a-session-starts-in) mencantumkan urutan

642

643<h4 id="dispatch-defaults">

644 Default pengiriman

645</h4>

525 646

526Untuk menetapkan default untuk setiap sesi yang Anda kirim dari tampilan agen, berikan salah satu dari `--permission-mode`, `--model`, `--effort`, atau `--agent` saat membukanya:647Untuk menetapkan default untuk setiap sesi yang Anda kirim dari tampilan agen, berikan salah satu dari `--permission-mode`, `--model`, `--effort`, atau `--agent` saat membukanya:

527 648

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

530```651```

531 652

532`--agent` menetapkan [subagent](/docs/id/sub-agents) yang digunakan ketika prompt pengiriman tidak menyebutkan satu, baik dengan `@name` atau sebagai kata pertama. Ini default ke pengaturan [`agent`](/docs/id/settings#available-settings) jika satu diatur, jika tidak agen catch-all bawaan `claude`. Menyebutkan subagent dalam input pengiriman menimpa keduanya.653`--effort` di sini menerima nilai yang sama seperti [bendera `--effort` tingkat atas](/docs/id/cli-reference#cli-flags), termasuk `ultracode`.

654

655`--agent` menetapkan [subagent](/docs/id/sub-agents) yang digunakan ketika prompt pengiriman tidak menyebutkan satu, baik dengan `@name` atau sebagai kata pertama. Ini default ke pengaturan [`agent`](/docs/id/settings-reference#agent) jika satu diatur, jika tidak agen catch-all bawaan `claude`. Menyebutkan subagent dalam input pengiriman menimpa keduanya.

533 656

534`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](/docs/id/cli-reference).657`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](/docs/id/cli-reference).

535 658

659Berikan `--restricted` untuk memulai setiap sesi yang Anda kirim dari tampilan dalam [mode terbatas](/docs/id/cli-reference#cli-flags), seolah-olah masing-masing diluncurkan dengan bendera `--restricted` tingkat atas. Memerlukan Claude Code v2.1.248 atau lebih baru.

660

536Default aktif muncul di footer di bawah input pengiriman.661Default aktif muncul di footer di bawah input pengiriman.

537 662

538Tanpa bendera ini, sesi menggunakan `defaultMode` dari pengaturan direktori itu atau `permissionMode` dari [frontmatter subagent](/docs/id/sub-agents#supported-frontmatter-fields) yang dikirim, dan model yang ditampilkan di header tampilan agen.663Claude Code menolak `claude --bg --permission-mode bypassPermissions` sampai Anda telah menerima pengecualian 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` menampilkan pengecualian yang sama ketika Anda belum menerimanya sebelumnya, dan menerima menerapkan `bypassPermissions` ke sesi yang Anda luncurkan dari tampilan. Melewatkan `--allow-dangerously-skip-permissions` menampilkan pengecualian yang sama juga, dan menerima membuat `bypassPermissions` tersedia dalam siklus `Shift+Tab` sesi tersebut tanpa memulai di dalamnya.

664

665<h4 id="what-persists-across-restarts">

666 Apa yang bertahan di seluruh restart

667</h4>

668

669Mode izin, model, dan upaya yang Anda pilih untuk sesi latar belakang, bersama dengan [bendera konfigurasi yang dibawanya](#what-carries-over-when-you-background), 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. Model atau upaya yang Anda ubah di tengah sesi dengan `/model` atau `/effort` juga disimpan.

539 670

540Menggunakan `bypassPermissions` dengan `claude --bg --permission-mode` ditolak sampai Anda telah menerima pengecualian 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` menampilkan pengecualian yang sama ketika Anda belum menerimanya sebelumnya, dan menerima menerapkan `bypassPermissions` ke sesi yang Anda luncurkan dari tampilan. Melewatkan `--allow-dangerously-skip-permissions` menampilkan pengecualian yang sama juga, dan menerima membuat `bypassPermissions` tersedia dalam siklus `Shift+Tab` sesi tersebut tanpa memulai di dalamnya.671Jika sesi mengambil upaya dari pengaturan Anda daripada dari `--effort` atau `/effort`, Claude Code membaca pengaturan Anda lagi setiap kali memulai proses untuk sesi. Jadi ketika Anda mengedit upaya yang disimpan dalam `settings.json`, perubahan mencapai sesi yang Anda lepaskan ke latar belakang dengan `←` atau `/bg`, dan restart mereka yang lebih baru. Upaya yang disimpan adalah kunci [`effortLevel`](/docs/id/settings-reference#effortlevel) atau entri [`modelSettings`](/docs/id/settings-reference#modelsettings).

672

673Claude Code juga menyimpan nama yang Anda atur dengan [`/rename`](/docs/id/commands) atau `Ctrl+R` di seluruh restart itu, jadi Anda masih dapat menjalankan [`claude --resume <name>`](/docs/id/sessions#name-your-sessions) untuk mencapai sesi.

541 674

542<h3 id="settings-plugins-and-mcp-servers">675<h3 id="settings-plugins-and-mcp-servers">

543 Pengaturan, plugins, dan server MCP676 Pengaturan, plugins, dan server MCP

544</h3>677</h3>

545 678

546Tampilan agen menerima bendera konfigurasi yang sama dengan `claude` untuk memuat pengaturan, plugins, server MCP, dan direktori tambahan. 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.679Tampilan agen menerima bendera konfigurasi yang sama seperti `claude` untuk memuat pengaturan, plugins, server MCP, dan direktori tambahan. Tampilan agen menerapkan `--settings` dan `--plugin-dir` ke dirinya sendiri dan meneruskan setiap bendera konfigurasi ke sesi yang Anda kirim darinya, jadi plugin atau server MCP yang Anda muat dengan cara ini tersedia di sesi tersebut.

547 680

548| Bendera | Efek |681| Bendera | Efek |

549| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- |682| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

551| [`--add-dir <path>`](/docs/id/permissions#additional-directories-grant-file-access-not-configuration) | Memberikan akses file ke direktori tambahan |684| [`--add-dir <path>`](/docs/id/permissions#additional-directories-grant-file-access-not-configuration) | Memberikan akses file ke direktori tambahan |

554| `--strict-mcp-config` | Gunakan hanya server MCP dari `--mcp-config`, abaikan konfigurasi MCP lainnya |687| `--strict-mcp-config` | Gunakan hanya server MCP dari `--mcp-config`, abaikan konfigurasi MCP lainnya. Lihat [Kontrol eksklusif dengan managed-mcp.json](/docs/id/managed-mcp#exclusive-control-with-managed-mcp-json) untuk apa yang dilakukan bendera di bawah file MCP yang dikelola |

688

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

555 690

556Ulangi `--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`.691Anda 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`](#manage-sessions-from-the-shell) gagal dengan kesalahan `unknown option`.

557 692

558Contoh berikut membuka tampilan agen dengan penimpaan pengaturan dan satu direktori tambahan:693Contoh berikut membuka tampilan agen dengan penimpaan pengaturan dan satu direktori tambahan:

559 694

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

562```697```

563 698

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

700

564<h2 id="manage-sessions-from-the-shell">701<h2 id="manage-sessions-from-the-shell">

565 Kelola sesi dari shell702 Kelola sesi dari shell

566</h2>703</h2>

568Setiap 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.705Setiap 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.

569 706

570| Perintah | Tujuan |707| Perintah | Tujuan |

571| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |708| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

574| `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. Entri interaktif yang tidak pernah Anda beri nama membawa nama default yang dibangun dari nama direktori kerja ditambah akhiran dua karakter, seperti `my-app-3f`. Gabungkan dengan `--cwd <path>` untuk memfilter |711| `claude agents --json` | Cetak sesi sebagai array JSON dan keluar. Lihat [Daftar sesi sebagai JSON](#list-sessions-as-json) |

578| `claude respawn <id>` | Mulai ulang sesi, baik yang sedang berjalan maupun yang dihentikan, dengan percakapannya tetap utuh, misalnya untuk mengambil biner Claude Code yang telah diperbarui |715| `claude respawn <id>` | Mulai ulang sesi, baik yang sedang berjalan maupun yang dihentikan, misalnya untuk mengambil biner Claude Code yang telah diperbarui. Sesi yang dimulai ulang melanjutkan percakapan yang disimpannya; ketika tidak ada di disk, sesi tersebut menjalankan prompt aslinya lagi sebagai percakapan baru |

579| `claude respawn --all` | Mulai ulang setiap sesi yang sedang berjalan, misalnya untuk memindahkan semua sesi ke biner Claude Code yang telah diperbarui sekaligus |716| `claude respawn --all` | Mulai ulang setiap sesi yang sedang berjalan, misalnya untuk memindahkan semua sesi ke biner Claude Code yang telah diperbarui sekaligus |

580| `claude rm <id>` | Hapus sesi dari daftar. Menghapus worktree yang dibuat Claude untuk sesi jika tidak ada perubahan yang belum di-commit dan tidak ada commit yang tidak didorong ke mana pun; jika tidak, sesi tetap disimpan, dan perintah mencetak jalur worktree dan alasannya sehingga Anda dapat menyelesaikannya dan menjalankan `claude rm` lagi. Membiarkan worktree yang Anda buat sendiri tetap ada. Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui `claude --resume` |717| `claude rm <id>` | Hapus sesi dari daftar, bersama dengan worktree yang dibuat Claude untuk sesi tersebut ketika aman untuk dihapus; lihat [Apa yang menghapus sesi menghapus](#what-deleting-a-session-removes). Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui `claude --resume` |

581| `claude daemon status` | Cetak status [supervisor](#the-supervisor-process), versi, direktori soket, dan jumlah pekerja |718| `claude daemon status` | Cetak status [supervisor](#the-supervisor-process), versi, direktori soket, dan jumlah pekerja |

582| `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 |719| `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 |

583 720

584<h2 id="how-background-sessions-are-hosted">721<h3 id="list-sessions-as-json">

585 Bagaimana sesi latar belakang dihosting722 Daftar sesi sebagai JSON

586</h2>

~~587~~

588Setiap 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).

~~589~~

590<h3 id="the-supervisor-process">

591 Proses supervisor

592</h3>723</h3>

593 724

594Sesi 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.725`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.

~~595~~

596Ketika pembaruan telah mengganti atau menghapus biner dari mana proses Claude Code yang sedang berjalan diluncurkan, proses itu memulai supervisor dari salinan terinstal lainnya, seperti peluncur `claude` yang terinstal atau versi terbaru di disk.

~~597~~

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

~~599~~

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

~~601~~

602PATH shell pengiriman diterapkan ke worker dengan cara yang sama, jadi perintah shell yang dijalankan sesi menemukan alat yang sama dengan yang ada di terminal Anda. Sebelum v2.1.203, sesi latar belakang menyimpan `PATH` dari shell yang pertama kali memulai supervisor, jadi alat yang ditambahkan ke `PATH` Anda sejak saat itu bisa hilang, paling sering di Windows.

~~603~~

604Sesi latar belakang tidak mewarisi variabel titik akhir gateway seperti `ANTHROPIC_BASE_URL` atau variabel URL dasar yang setara untuk Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry dari shell yang memulai supervisor. Tanpa gateway yang diekspor di shell tempat Anda mengirim, sesi menggunakan kredensial yang disimpan Anda dan nilai `env` apa pun dalam [pengaturan](/docs/id/settings) direktori proyek. Untuk mengarahkan setiap sesi dalam proyek ke [gateway LLM](/docs/id/llm-gateway), atur `ANTHROPIC_BASE_URL` dalam blok `env` `settings.json` `.claude/` proyek itu.

~~605~~

606Gateway `ANTHROPIC_BASE_URL` yang diekspor di shell tempat Anda mengirim mencapai worker sesi itu, bersama dengan `ANTHROPIC_CUSTOM_HEADERS` dan kredensial yang diekspor bersama dengannya, ketika supervisor dimulai dari lingkungan dengan gateway yang sama. Supervisor menangkap lingkungannya dari shell pertama yang membuka tampilan agen atau mengirim sesi latar belakang, jadi memulai dari shell gateway memberikannya lingkungan itu. Penerusan juga hanya berlaku untuk sesi yang dikirim ke direktori tempat Anda mengirim, atau dikirim ke latar belakang dari sesi Anda sendiri dengan `←` atau `/background`: mengirim ke direktori berbeda dengan `@repo` atau `--cwd` tidak membawa gateway shell, dan blok `env` `settings.json` proyek itu menyediakan titik akhir sebagai gantinya. Ketika lingkungan supervisor membawa gateway berbeda atau tidak ada, worker menyimpan kredensial yang disimpan Anda terhadap titik akhir default alih-alih mencampur kredensial satu lingkungan dengan titik akhir lingkungan lain. Sebelum v2.1.203, `ANTHROPIC_BASE_URL` shell pengiriman dijatuhkan sementara `ANTHROPIC_API_KEY` yang diekspor bersama dengannya disimpan, jadi kunci gateway dikirim ke titik akhir default dan setiap permintaan gagal dengan 401.

~~607~~

608Titik akhir yang diteruskan hanya berlaku untuk proses aktif itu dan tidak pernah ditulis ke disk. Ketika supervisor menghentikan sesi idle dan kemudian memulainya kembali, proses yang dimulai ulang membaca titik akhirnya dari pengaturan Anda lagi: dengan `ANTHROPIC_AUTH_TOKEN` gateway itu kembali ke kredensial yang disimpan Anda, dan dengan `ANTHROPIC_API_KEY` yang dikeluarkan gateway itu dapat gagal untuk mengautentikasi sampai gateway diatur dalam pengaturan.

~~609~~

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

~~611~~

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

~~613~~

614Pekerjaan latar belakang yang sesi itu sendiri mulai di tingkat atas diserahkan ketika prosesnya dihentikan, dimulai ulang, atau diperbarui, termasuk di Windows. Proses berikutnya yang dimulai untuk sesi itu mengambilnya kembali:

~~615~~

616* Perintah shell latar belakang yang selesai sementara itu dilaporkan sebagai selesai dengan outputnya

617* Alur kerja dinamis dilanjutkan dari tempat ia berhenti

618* [Subagen latar belakang](/docs/id/sub-agents#run-subagents-in-foreground-or-background) dilanjutkan dari transkrip mereka sendiri

619 726

620Mulai dari v2.1.198 penyerahan mencakup ketiga-tiganya. Sebelum v2.1.198 itu hanya mencakup perintah shell dan alur kerja, jadi subagen latar belakang berhenti dengan proses dan dilaporkan sebagai gagal pada bangun berikutnya.727Setiap entri menjelaskan satu sesi:

621 728

622Pekerjaan yang statusnya hanya hidup di dalam proses itu sendiri berhenti dengannya alih-alih diserahkan. Itu adalah perintah shell yang dimulai subagen, yang dapat dimulai lagi oleh subagen yang dilanjutkan, dan [monitor](/docs/id/tools-reference#monitor-tool) yang sedang berjalan, yang aliran acaranya tidak dapat dipindahkan ke proses lain.729| Bidang | Hadir | Deskripsi |

730| :------------------------- | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

731| `cwd`, `kind`, `startedAt` | Selalu | Direktori kerja, `interactive` atau `background`, dan waktu mulai dalam milidetik Unix |

732| `id` | Sesi latar belakang | ID pendek, dapat digunakan dengan `claude attach`, `claude logs`, dan `claude stop` |

733| `state` | Sesi latar belakang | Salah satu dari `working`, `blocked`, `done`, `failed`, atau `stopped` |

734| `pid`, `status` | Saat proses masih hidup | ID proses dan status saat ini |

735| `waitingFor` | Ketika `status` adalah `waiting` | Apa sesi diblokir: `permission prompt` untuk persetujuan, `input needed` untuk pertanyaan dari Claude atau permintaan input server MCP, `sandbox request`, `worker request`, atau `dialog open` |

736| `sessionId`, `name` | Ketika diatur | `sessionId` adalah UUID sesi lengkap, dapat digunakan dengan [`claude --resume`](/docs/id/sessions). Nama sesi interaktif adalah [nama tampilan defaultnya](/docs/id/sessions#name-your-sessions) sampai Anda memberi nama sesi atau menerima rencana di dalamnya |

623 737

624Menghapus sesi menghentikan semua yang diserahkannya. Untuk menghentikan semua pekerjaan latar belakang sesi dengan proses alih-alih menyerahkannya, atur variabel lingkungan [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/id/env-vars#variables) ke `1`.738<h2 id="how-background-sessions-are-hosted">

739 Bagaimana sesi latar belakang dihosting

740</h2>

625 741

626Proses yang dimulai ulang menemukan percakapan sesi yang [pindah ke worktree](#how-file-edits-are-isolated) di tengah tugas: ketika transkrip tidak berada di tempat sesi dimulai, Claude Code juga mencari di bawah worktree terdaftar repositori. Sebelum v2.1.207, membuka kembali sesi itu dari tampilan agen setelah prosesnya berhenti dapat menampilkan percakapan kosong dengan hanya prompt aslinya, dengan transkrip masih utuh di disk; membuka sesi lagi pada v2.1.207 atau lebih baru memulihkannya.742Claude 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](#from-inside-a-session).

627 743

628Jika sesi yang dimulai ulang kembali menampilkan hanya prompt aslinya karena Claude Code salah membaca transkrip sebagai kosong, transkrip percakapan diganti nama dengan akhiran `.orphaned-` alih-alih dihapus, jadi tetap berada di mesin Anda.744Untuk memeriksa jenis sesi apa yang Anda gunakan, jalankan [`/status`](/docs/id/commands). 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.

629 745

630Baris 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.746<h3 id="the-supervisor-process">

747 Proses supervisor

748</h3>

631 749

632Ketika host kekurangan memori, supervisor menghentikan sesi idle non-pin terlebih dahulu dan menghentikan sesi pin idle hanya jika itu tidak membebaskan apa pun.750Supervisor 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.

633 751

634Supervisor memantau biner Claude Code yang diinstal di disk dan memulai ulang ke versi baru setelah [auto-updater](/docs/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.752Setiap sesi adalah proses Claude Code-nya sendiri di bawah supervisor, dan apa yang terjadi pada proses itu tergantung pada status sesi:

635 753

636Setelah supervisor baru mengambil alih, itu juga memulai ulang sesi idle yang tersisa ke versi baru, beberapa sekaligus di latar belakang, setelah penundaan singkat yang memungkinkan terminal yang terpasang di seluruh restart untuk terhubung kembali terlebih dahulu. Sesi yang bekerja, menunggu masukan Anda, atau memiliki terminal yang terpasang tidak terganggu; itu berpindah ke versi baru lain kali prosesnya dimulai ulang. Sebelum v2.1.206, supervisor memindahkan hanya beberapa sesi idle per menit ke versi baru, jadi sesi dapat terus menjalankan yang lama selama beberapa waktu setelah pembaruan.754* **Bekerja, menunggu Anda, atau terhubung**: proses terus berjalan. Subagen yang berjalan, alur kerja, atau monitor dihitung sebagai bekerja.

755* **Selesai dan tidak terhubung selama sekitar satu jam**: supervisor menghentikan proses untuk membebaskan sumber daya. 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 saat idle.

756* **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](#sessions-show-as-failed-after-shutdown).

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

637 758

638Restart ini hanya pernah memindahkan sesi ke versi yang lebih baru. Supervisor yang menjalankan versi Claude Code yang lebih lama daripada yang dimulai proses sesi dengan meninggalkan proses itu sendiri; sesi terus menjalankan versi yang lebih baru sampai supervisor yang lebih baru mengambil alih.759Ketika 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`](/docs/id/env-vars#variables) ke `1`.

639 760

640Menjalankan `claude attach` sementara supervisor memulai ulang sesi, baik untuk pembaruan, kemacetan, atau migrasi, menunggu proses pengganti alih-alih gagal. Baris status seperti `Agent is updating to the new Claude Code…` menamai apa yang ditunggu dan menghitung detik yang telah berlalu, dan perintah terhubung segera setelah sesi siap. Setelah sekitar 60 detik itu berhenti menunggu dan melaporkan kesalahan. Sebelum v2.1.205, `claude attach` berhenti mencoba ulang setelah beberapa detik dan mencetak kesalahan sementara sesi masih dimulai ulang.761Supervisor 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](#settings-and-provider). Untuk titik akhir gateway, lihat [Gateway LLM](#llm-gateway).

641 762

642<h3 id="where-state-is-stored">763<h3 id="where-state-is-stored">

643 Tempat status disimpan764 Tempat status disimpan

658 779

659Perintah 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.780Perintah 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.

660 781

661Sesi 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: versi yang lebih lama yang menulis ulangnya menyimpan bidang yang ditulis versi yang lebih baru, jadi sesi yang dimulai oleh versi yang lebih baru tetap dapat dijangkau dan terus menerima masukan setelah supervisor dimulai ulang. Sebelum v2.1.200, versi yang lebih lama dapat menghapus bidang tersebut saat menulis ulang.782Sesi 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.

~~662~~

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

664 783

665<h3 id="turn-off-agent-view">784<h3 id="turn-off-agent-view">

666 Matikan tampilan agen785 Matikan tampilan agen

667</h3>786</h3>

668 787

669Untuk mematikan agen latar belakang dan tampilan agen sepenuhnya, atur pengaturan `disableAgentView` [setting](/docs/id/settings) ke `true` atau atur variabel lingkungan `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Administrator dapat memberlakukan ini melalui [pengaturan terkelola](/docs/id/permissions#managed-settings).788Untuk mematikan agen latar belakang dan tampilan agen sepenuhnya, atur pengaturan `disableAgentView` [setting](/docs/id/settings) ke `true` atau atur variabel lingkungan `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Administrator dapat memberlakukan ini melalui [pengaturan terkelola](/docs/id/managed-settings).

670 789

671<h2 id="troubleshooting">790<h2 id="troubleshooting">

672 Troubleshooting791 Troubleshooting

690 Melepaskan menunjukkan dialog `Background this session?`809 Melepaskan menunjukkan dialog `Background this session?`

691</h3>810</h3>

692 811

693Jika menekan `←` untuk melepaskan sesi saat ini menunjukkan dialog `Background this session?`, sesi memiliki pekerjaan yang sedang berlangsung yang tidak dapat berpindah ke sesi latar belakang, seperti [monitor](/docs/id/tools-reference#monitor-tool) yang sedang berjalan, dan Claude Code tidak akan diam-diam menghentikannya. Dialog menyebutkan pekerjaan yang akan dihentikan dan, secara terpisah, menghitung tugas yang dibawa. Jalankan `/tasks` untuk melihat semua yang sedang berjalan, kemudian konfirmasi untuk melepaskan atau pilih `Stay` untuk membiarkan pekerjaan selesai terlebih dahulu. Lihat [Dari dalam sesi](#from-inside-a-session) untuk jenis tugas mana yang dibawa dan mana yang dihentikan.812Jika 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:

813

814* **Pekerjaan yang tidak dapat dipindahkan**: sesi memiliki pekerjaan yang tidak dapat dipindahkan ke sesi latar belakang, seperti [monitor](/docs/id/tools-reference#monitor-tool) yang sedang berjalan. Dialog menyebutkan pekerjaan yang akan dihentikan Claude Code dan, secara terpisah, menghitung tugas yang dibawa.

815* **Alur kerja dengan subagen yang sedang berjalan**: [alur kerja dinamis](/docs/id/workflows) 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.

816* **Balasan artefak otomatis**: Claude [membalas komentar pada artefak dengan sendirinya](/docs/id/artifacts#let-claude-reply-to-comments-on-its-own). Balasan tersebut berlanjut dalam sesi latar belakang, dan dialog mengatakan demikian.

817

818Jalankan `/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](#what-carries-over-when-you-background) untuk jenis pekerjaan mana yang dibawa dan mana yang dihentikan Claude Code.

694 819

695<h3 id="prompt-rejected-as-too-short">820<h3 id="prompt-rejected-as-too-short">

696 Prompt ditolak karena terlalu pendek821 Prompt ditolak karena terlalu pendek

699Input 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`.824Input 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`.

700 825

701<h3 id="sessions-show-as-failed-after-shutdown">826<h3 id="sessions-show-as-failed-after-shutdown">

702 Sesi menampilkan sebagai gagal setelah shutdown827 Sesi menampilkan sebagai gagal atau dihentikan setelah shutdown

703</h3>828</h3>

704 829

705Mematikan 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.830Mematikan 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:

831

832* Dalam 48 jam, sesi menampilkan sebagai gagal. Lampirkan atau balas dan sesi itu dimulai ulang dari tempat ia berhenti.

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

706 834

707Sleep saja tidak menyebabkan hal ini. Sesi dipertahankan di seluruh sleep dan supervisor terhubung kembali ke sesi tersebut saat bangun.835Ketika [pembersihan transkrip](/docs/id/settings-reference#cleanupperioddays) 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](#what-deleting-a-session-removes) yang dijelaskan di atas, dan `claude respawn <id>` menjalankan prompt aslinya lagi. Lihat [Percakapan yang disimpan sesi ini tidak lagi ada di disk](/docs/id/errors#this-sessions-saved-conversation-is-no-longer-on-disk).

836

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

708 838

709<h3 id="opening-a-session-says-the-conversation-is-already-open">839<h3 id="opening-a-session-says-the-conversation-is-already-open">

710 Membuka sesi mengatakan percakapan sudah terbuka840 Membuka sesi mengatakan percakapan sudah terbuka

711</h3>841</h3>

712 842

713Membuka baris yang dihentikan yang percakapannya juga dipegang terbuka oleh proses Claude Code non-interaktif yang sedang berjalan lainnya, misalnya pekerja latar belakang untuk percakapan yang sama yang masih sedang berhenti, menampilkan `This conversation is already open in another running Claude session` alih-alih memulai proses baris, karena dua proses tidak dapat menulis ke transkrip yang sama. Balas dalam sesi yang sudah memiliki percakapan terbuka, atau keluar darinya dan buka baris lagi. Balasan yang Anda ketik dengan upaya yang ditolak tidak hilang; itu dikirim saat sesi berikutnya dimulai.843Dua 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:

844

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

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

847

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

849

850<h3 id="opening-a-session-says-it-has-no-saved-transcript">

851 Membuka sesi mengatakan tidak memiliki transkrip yang disimpan

852</h3>

853

854Sesi yang dihentikan yang [dilepaskan dari percakapan lain](#from-inside-a-session) 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`.

714 855

715Sebelum v2.1.203, keadaan ini memulai proses kedua. Proses itu keluar dengan kesalahan `currently running as a background agent` dan baris menampilkan sebagai gagal.856Dalam 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.

857

858Percakapan asli tetap utuh; lanjutkan dengan `claude --resume` atau terus bekerja di dalamnya. Lihat [referensi kesalahan](/docs/id/errors#this-session-has-no-saved-transcript) untuk detail.

859

860<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

861 Host terminal mati atau sesi berhenti merespons

862</h3>

863

864[Supervisor](#the-supervisor-process) 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](/docs/id/errors#terminal-host-process-died) mengutip pesan lengkapnya.

865

866Claude Code tidak pernah memulai ulang baris yang menjalankan [perintah shell](#run-a-shell-command), dari `Enter` atau dari `claude attach`, karena itu akan menjalankan perintah lagi; pesan baris dan `claude attach` keduanya mengatakan perintah tidak dijalankan lagi.

867

868<h4 id="terminal-host-died">

869 Host terminal mati

870</h4>

871

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

873

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

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

876

877<h4 id="session-isn’t-responding">

878 Sesi tidak merespons

879</h4>

880

881Ketika 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](#read-session-state) itu sendiri.

882

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

884* Dari shell, `claude attach <id>` melaporkan penyebabnya dan keluar, memberi tahu Anda untuk menjalankan `claude stop <id>`, kemudian `claude attach <id>`.

716 885

717<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">886<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

718 Sesi gagal sebelum dimulai dengan catatan `possibly low memory`887 Sesi gagal sebelum dimulai dengan catatan `possibly low memory`

719</h3>888</h3>

720 889

721Mulai dari v2.1.199, 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`. Versi sebelumnya hanya menampilkan alasan keluar yang telanjang untuk kegagalan ini.890Ketika 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`.

722 891

723Catatan 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.892Catatan 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.

724 893

725Bebaskan memori di mesin, kemudian lampirkan, intip, atau balas ke baris dan supervisor memulai proses segar untuk sesi. Ketika memori tetap rendah, supervisor juga [menghentikan sesi idle](#the-supervisor-process) untuk membebaskan sumber daya dengan sendirinya.894Bebaskan 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](#the-supervisor-process) untuk membebaskan sumber daya dengan sendirinya, dan menghentikan sesi idle yang disematkan juga jika menghentikan yang lain tidak membebaskan apa pun.

726 895

727<h3 id="agent-view-says-the-background-service-did-not-respond">896<h3 id="agent-view-says-the-background-service-did-not-respond">

728 Tampilan agen mengatakan layanan latar belakang tidak merespons897 Tampilan agen mengatakan layanan latar belakang tidak merespons

738 907

739Supervisor 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.908Supervisor 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.

740 909

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

911

741Di 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`.912Di 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`.

742 913

743<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">914<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

744 Pengiriman gagal dengan `Could not resolve authentication method`915 Pengiriman gagal dengan `Could not resolve authentication method`

745</h3>916</h3>

746 917

747Jika pengiriman latar belakang gagal dengan `Could not resolve authentication method` sementara sesi interaktif mengautentikasi secara normal, worker yang menerima pengiriman tidak mengambil kredensial. 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:918Jika 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](#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:

748 919

749```bash theme={null}920```bash theme={null}

750claude daemon stop --any --keep-workers921claude daemon stop --any --keep-workers

766 Sesi latar belakang tidak dapat menjangkau host jaringan lokal di macOS937 Sesi latar belakang tidak dapat menjangkau host jaringan lokal di macOS

767</h3>938</h3>

768 939

769Di macOS 15 dan yang lebih baru, sistem memblokir proses dari menjangkau perangkat di jaringan lokal Anda sampai Anda memberikan izin Local Network. Sebelum v2.1.198 host sesi latar belakang tidak pernah meminta izin itu, jadi perintah yang menargetkan alamat LAN gagal dengan `connect: no route to host` meskipun perintah yang sama berfungsi di terminal foreground. Mulai dari v2.1.198, 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.940Di 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.

770 941

771<h3 id="a-session-is-slow-to-respond-after-attaching">942<h3 id="a-session-is-slow-to-respond-after-attaching">

772 Sesi lambat merespons setelah melampirkan943 Sesi lambat merespons setelah melampirkan

774 945

775Setelah 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](#organize-the-list) tidak dihentikan dengan cara ini, jadi semat sesi dengan `Ctrl+T` untuk menjaganya tetap responsif.946Setelah 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](#organize-the-list) tidak dihentikan dengan cara ini, jadi semat sesi dengan `Ctrl+T` untuk menjaganya tetap responsif.

776 947

777Saat proses dimulai, layar terakhir dari transkrip sesi ditampilkan dengan catatan `Session is starting` di bawahnya, dan sesi langsung menggantikannya segera setelah siap.948Saat 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.

778 949

779<h3 id="claude/worktrees/-is-filling-up">950<h3 id="claude/worktrees/-is-filling-up">

780 `.claude/worktrees/` penuh951 `.claude/worktrees/` penuh

781</h3>952</h3>

782 953

783Menghapus sesi dalam tampilan agen menghapus worktree yang dibuat Claude untuk sesi tersebut, dan worktree yang tidak dapat dihapus dengan aman [menyimpan baris sesinya](#organize-the-list) sehingga tidak menjadi yatim piatu. `claude rm` menyimpan worktree yang memiliki perubahan yang belum dikomit, dan baris sesinya, dan mencetak jalur yang disimpan. Daftar entri sisa dengan `git worktree list` di direktori proyek dan hapus masing-masing dengan `git worktree remove <path>`. Lihat [Bersihkan worktrees](/docs/id/worktrees#clean-up-worktrees).954Menghapus sesi dalam tampilan agen menghapus worktree yang dibuat Claude untuk sesi tersebut, tetapi [beberapa penghapusan menyimpan worktree atau meninggalkan direktorinya di disk](#what-deleting-a-session-removes), jadi direktori sisa dapat terakumulasi. Direktori yang tidak lagi dikenali git tidak muncul dalam `git worktree list`, jadi hapus yang tersebut dengan tangan.

955

956Daftar entri sisa dengan `git worktree list` di direktori proyek dan hapus masing-masing dengan `git worktree remove <path>`. Lihat [Bersihkan worktrees](/docs/id/worktrees#clean-up-worktrees).

784 957

785<h2 id="limitations">958<h2 id="limitations">

786 Keterbatasan959 Keterbatasan

790 963

791* **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.964* **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.

792* **Sesi bersifat lokal**: sesi latar belakang berjalan di mesin Anda. Sesi ini dipertahankan di seluruh tidur tetapi berhenti jika mesin dimatikan.965* **Sesi bersifat lokal**: sesi latar belakang berjalan di mesin Anda. Sesi ini dipertahankan di seluruh tidur tetapi berhenti jika mesin dimatikan.

793* **Worktrees yang dibuat Claude dihapus dengan sesi di tampilan agen**: gabungkan perubahan sebelum menghapus sesi yang mengedit file di worktree-nya sendiri. Worktree dengan commit yang tidak didorong ke mana pun disimpan bersama sesi. `claude rm` juga menyimpan worktree yang memiliki perubahan yang belum dilakukan bersama sesinya, dan worktree yang Anda buat sendiri dibiarkan di tempat.966* **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](#what-deleting-a-session-removes).

794 967

795<h2 id="related-resources">968<h2 id="related-resources">

796 Sumber daya terkait969 Sumber daya terkait

797</h2>970</h2>

798 971

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

800 973

801* [Jalankan agen secara paralel](/docs/id/agents): bandingkan tampilan agen dengan subagents, tim agen, dan worktrees974* [Jalankan agen secara paralel](/docs/id/agents): bandingkan tampilan agen dengan subagents, tim agen, dan worktrees

975* [Pesan lintas sesi](/docs/id/cross-session-messaging): biarkan sesi Anda meneruskan temuan satu sama lain

802* [Tim agen](/docs/id/agent-teams): koordinasikan beberapa sesi yang saling berpesan976* [Tim agen](/docs/id/agent-teams): koordinasikan beberapa sesi yang saling berpesan

803* [Claude Code di web](/docs/id/claude-code-on-the-web): jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal977* [Claude Code di web](/docs/id/claude-code-on-the-web): jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal

804 978

809Tampilan 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.983Tampilan 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.

810 984

812| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |986| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

987| v2.1.251 | Dalam sesi latar belakang yang belum [pindah ke worktree](#how-file-edits-are-isolated), Claude dan subagen yang dipawnnya dapat mengedit file di dalam worktree git yang ditautkan. |

988| v2.1.251 | Claude Code meneruskan gateway penyedia cloud yang diekspor dalam shell tempat Anda mengirim, seperti `ANTHROPIC_VERTEX_BASE_URL` atau `ANTHROPIC_BEDROCK_BASE_URL` dengan bendera bypass autnya, ke [worker sesi](#llm-gateway) di bawah kondisi yang sama dengan `ANTHROPIC_BASE_URL`. Sebelum rilis ini, jika Anda melepaskan atau mengirim dari shell yang hanya diautentikasi melalui gateway seperti itu, setiap permintaan yang dibuat sesi gagal, karena titik akhir dan bendera dijatuhkan dari lingkungannya. |

989| v2.1.251 | Ketika sesi latar belakang dimulai sementara proses Claude Code lain sedang menyegarkan [marketplace plugin](/docs/id/plugin-marketplaces), seperti sesi saudara yang menjalankan [pembaruan otomatis marketplace](/docs/id/discover-plugins#configure-auto-updates), Claude Code menjaga plugin marketplace tersebut tetap tersedia. Sebelum rilis ini, sesi seperti itu bisa dimulai tanpa skill, agen, hook, dan server MCP marketplace apa pun dan tetap seperti itu selama seluruh jalannya. |

990| v2.1.248 | `Shift+Enter` dalam [input pengiriman](#keyboard-shortcuts) menyisipkan baris baru, sesuai dengan prompt utama, dan `Ctrl+Enter` mengirim dan melampirkan segera di terminal tempat overlay `?` mencantumkan `ctrl+enter to start and open`. Sebelum rilis ini, `Shift+Enter` mengirim dan melampirkan. |

991| v2.1.248 | [Menghapus sesi](#what-deleting-a-session-removes) berhasil ketika commit worktree sudah ada di salinan lokal cabang default remote `origin` Anda dan checkout utama Anda memiliki cabang itu yang diperiksa; sebelum rilis ini, penghapusan ditolak dengan `has commits that are not pushed anywhere`. |

992| v2.1.248 | Sesi yang dilepaskan dengan `←` atau `/background` memegang [`git worktree lock`](/docs/id/worktrees#clean-up-subagent-and-background-session-worktrees) pada worktree-nya saat berjalan; sebelum rilis ini, melepaskan melepaskan kunci, dan pembersihan atau `git worktree remove` bisa menghapus worktree di bawah sesi yang sedang berjalan. |

993| v2.1.248 | Sesi latar belakang yang tidak menunggu input Anda dan ditemukan mati lebih dari 48 jam setelah aktivitas terakhirnya, seperti setelah mesin mati selama berhari-hari, [menampilkan sebagai berhenti](#sessions-show-as-failed-after-shutdown) dengan `ended while the background service was off`, dan `Enter` padanya bertanya sebelum melanjutkan percakapan yang disimpannya. Sebelum rilis ini, sesi seperti itu muncul kembali sebagai kegagalan segar yang diurutkan ke atas daftar, dan satu `Enter` menarik percakapan berusia berminggu-minggu ke latar depan. |

994| v2.1.248 | Membuka baris yang dihentikan yang percakapannya [Anda lanjutkan di terminal lain](#opening-a-session-says-the-conversation-is-already-open) ditolak dengan `Can't open — this session is running in another terminal`, dan baris menampilkan `Open in a terminal` alih-alih menampilkan di bawah `Working`. Sebelum rilis ini, membuka baris memulai proses kedua yang menulis ke percakapan yang sama. |

995| v2.1.248 | Sesi latar belakang yang menunggu keputusan izin sementara hook `PermissionRequest` atau `PreToolUse` mencetak jawaban yang tidak valid [menyebutkan acara hook dan kesalahan skema pada barisnya](#peek-and-reply). Sebelum rilis ini, baris hanya menampilkan permintaan yang tertunda. |

996| v2.1.248 | Di Windows, `claude agents` merespons keyboard ketika diluncurkan di tab terminal yang program sebelumnya tinggalkan dalam mode win32-input. Sebelum rilis ini, Claude Code tidak mendekode catatan kunci yang dikirim tab seperti itu. |

997| v2.1.247 | Di Linux dan WSL, sesi [yang proses host terminalnya mati](#the-terminal-host-died-or-the-session-stopped-responding) gagal dalam hitungan detik dengan alasannya. Pembukaan yang tidak menghasilkan output berakhir setelah sekitar sepuluh detik dengan penawaran restart, dan `Enter` pada baris memulai ulang sesi dengan percakapannya; `claude attach <id>` melaporkan penyebabnya dan keluar. Sebelum rilis ini, membuka sesi seperti itu menampilkan `opening… · esc to cancel` tanpa batas dan `claude attach <id>` menunggu tanpa melaporkan kesalahan. |

998| v2.1.246 | Pada instalasi npm, ketika [layanan latar belakang](#the-supervisor-process) gagal dimulai sementara `npm install -g @anthropic-ai/claude-code` mengganti biner, Claude Code menunggu hingga sepuluh detik agar instalasi selesai dan mencoba lagi sebelum melaporkan [`EACCES: permission denied`](/docs/id/errors#eacces-when-starting-a-background-session). |

999| v2.1.246 | Ketika proses [layanan latar belakang](#the-supervisor-process) mati setelah mencetak kesalahan, Claude Code melaporkan kegagalan dan [mengutip baris kesalahan pertama layanan](/docs/id/errors#background-service-exited-before-it-became-reachable). |

1000| v2.1.246 | Jika mesin Anda tidur sementara [layanan latar belakang](#the-supervisor-process) sedang dimulai, Claude Code mencoba lagi sekali alih-alih gagal. |

1001| v2.1.246 | Claude Code menunggu sekitar dua menit alih-alih 45 detik untuk [layanan latar belakang](#the-supervisor-process) yang baru dimulai yang hidup tetapi lambat menerima koneksi. |

1002| v2.1.246 | [Layanan latar belakang](#the-supervisor-process) dimulai dari direktori rumah Anda, jadi di macOS dan Linux direktori awal yang dihapus atau dipindahkan tidak lagi memblokir awal. |

1003| v2.1.246 | `/fork` [menyalin percakapan lengkap](#copy-the-session-with-%2Ffork) dari sesi yang sendiri dimulai sebagai salinan dan belum merekam prompt baru sejak: salinan `/fork` yang Anda lampirkan, sesi yang dilampirkan kembali setelah `←` atau `/background` memindahkannya ke latar belakang, atau sesi yang dimulai dengan `claude --resume <id> --fork-session`. Sebelum rilis ini, jika Anda menjalankan `/fork` dalam sesi seperti itu sebelum mengirimnya prompt baru, Claude Code mencetak konfirmasi normal tetapi memulai salinan dengan percakapan kosong. Memindahkan sesi seperti itu ke latar belakang dengan `←` atau `/background` kehilangan percakapan dengan cara yang sama. |

1004| v2.1.246 | Ketika Anda membuka sesi yang baru saja Anda kirim sementara proses worker-nya masih dimulai, seperti dengan menekan `Enter` pada barisnya, Claude Code menunggu proses dan kemudian melampirkan. Sebelum rilis ini, jika Anda menekan `Enter` sementara proses masih dimulai, Claude Code bisa menghentikan sesi dengan [`Session <id> was stopped while the respawn was in flight`](/docs/id/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1005| v2.1.246 | Ketika Anda [melepaskan](#from-inside-a-session) sesi bernama, Claude Code mencantumkannya sekali, dan ketika Anda melepaskan percakapan yang sama lagi, itu menomori nama baris baru, seperti `my-session (2)`, dengan baris yang ada menyimpan namanya. Sebelum rilis ini, terminal tempat Anda menekan `←` bisa muncul dalam `claude agents --json` sebagai sesi kedua dengan nama yang sama, dan jika Anda melepaskan percakapan yang sama lagi, Claude Code menambahkan baris lain di bawah nama yang identik. |

1006| v2.1.239 | Dengan [mode editor vim](/docs/id/interactive-mode#vim-editor-mode) aktif, menekan `Esc` dalam input tampilan agen beralih dari mode INSERT ke NORMAL dan menyimpan teks Anda, sesuai dengan prompt utama; dalam mode NORMAL dengan teks masih dalam input, menekan `Esc` menghapusnya, dan menekan `Esc` pada input kosong keluar, seperti yang dijelaskan pintasan [`Esc`](#keyboard-shortcuts). Sebelum rilis ini, `Esc` menghapus input. |

1007| v2.1.233 | Untuk sesi yang ditautkan ke permintaan tarik GitLab, Claude Code menulis label baris dalam sintaks referensi `!1234` GitLab. Anda juga dapat menempel URL permintaan tarik ke dalam [input pengiriman](#filter-sessions) untuk memilih sesi itu. Sebelum rilis ini, label dirender sebagai `#1234`, dan URL permintaan tarik yang ditempel cocok dengan sesi hanya ketika prompt pertamanya berisi URL. |

1008| v2.1.227 | [Menghapus sesi](#what-deleting-a-session-removes) menyimpan sesi dan worktree-nya sementara sesi Claude Code langsung lain sedang berjalan di dalam direktori worktree itu. Tampilan agen menampilkan `not deleted` pada baris dan alasannya di footer, dan `claude rm` mencetak `kept <id>` dengan alasan, yang menyebutkan ID proses sesi lain. Sebelum rilis ini, menghapus sesi menghapus worktree sementara sesi lain masih bekerja di dalamnya. |

1009| v2.1.225 | `claude agents` dalam direktori yang belum Anda percayai menampilkan [dialog kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust) yang sama yang ditampilkan `claude` saat startup, sebelum tampilan agen terbuka. Menerima menyimpan kepercayaan untuk workspace itu; menolak keluar tanpa membuka tampilan agen. Sebelum rilis ini, `claude agents` terbuka tanpa bertanya, jadi sesi yang Anda kirim darinya berjalan dalam direktori yang tidak pernah Anda diminta untuk percayai.<br /><br />Dengan daftar yang dikelompokkan berdasarkan direktori, mengarahkan mouse ke baris menyorotinya tanpa mengubah [target pengiriman](#dispatch-to-a-specific-directory); memilih baris dengan tombol panah atau klik masih mengubah target. Sebelum rilis ini, menggerakkan mouse ke sesi di proyek lain diam-diam mengubah direktori tempat sesi yang dikirim berikutnya dimulai. |

1010| v2.1.221 | `/status` menampilkan baris `Session kind`: `background job · attached` atau `background job · unattended` dalam sesi latar belakang, tergantung apakah terminal dilampirkan, dan `interactive` dalam sesi lain apa pun. Sebelum rilis ini, `/status` tidak melaporkan jenis sesi.<br /><br />`/fork`: Claude Code menginstruksikan [salinan](#from-inside-a-session) untuk mengisolasi pekerjaannya dari sesi asli: salinan membuat worktree-nya sendiri sebelum membuat perubahan kode, tetap keluar dari worktree sesi asli, dan mendasarkan cabang baru pada cabang asli ketika tugasnya dibangun di atas pekerjaan itu. Lihat bagian tertaut untuk kondisi pastinya. Sebelum rilis ini, salinan tidak menerima instruksi isolasi dan bisa berakhir mengedit worktree atau checkout yang masih dikerjakan sesi asli.<br /><br />Dengan [mode editor vim](/docs/id/interactive-mode#vim-editor-mode) aktif, menekan `←` tepat setelah membatalkan prompt kembali ke kosong dengan `u` bertanya untuk konfirmasi yang sama seperti menghapus teks atau bergerak melalui riwayat prompt, dan beralih hanya pada tekan kedua; sebelum rilis ini tekan beralih segera. |

1011| v2.1.219 | Dengan [mode editor vim](/docs/id/interactive-mode#vim-editor-mode) aktif, menekan `←` pada prompt kosong membuka tampilan agen dari mode NORMAL serta INSERT, dan petunjuk `←` footer menampilkan dalam mode NORMAL; sebelum rilis ini gestur dan petunjuk adalah INSERT-only, dan dalam mode NORMAL `←` pada prompt kosong tidak melakukan apa pun. Mengetik ke dalam input sementara Claude Code menunggu untuk melepaskan sesi membatalkan switch dengan `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` jadi draft yang diketik tidak hilang. |

1012| v2.1.218 | Menekan `←` dalam dua detik penghapusan yang mengosongkan prompt, atau bergerak melalui riwayat prompt, menampilkan `Press ← again to open agents`, atau `Press ← again to go back to agents` dalam sesi yang dilampirkan, dan beralih hanya pada tekan kedua setidaknya satu detik kemudian; sebelum rilis ini tekan beralih segera. `←` yang tiba di dalam input yang ditempel atau skrip tidak lagi memicu switch. Melepaskan sesi latar depan dengan `←` menampilkan `Your conversation moved to the background` di atas daftar, dan `Esc` di akar tampilan agen kembali ke percakapan itu alih-alih keluar ke shell, dengan `Ctrl+C` ganda tetap menjadi keluar; jika percakapan tidak dapat dibuka kembali, Claude Code keluar dan mencetak perintah `claude --resume` untuknya. Di Windows, `←` yang ditekan dalam sekitar setengah detik melampirkan menampilkan `Ambiguous ←, press again to detach` dan melepaskan pada tekan kedua. |

1013| v2.1.217 | Lencana permintaan tarik pada baris sesi dirender sebagai hyperlink bahkan ketika Claude Code tidak dapat mendeteksi dukungan hyperlink terminal, misalnya melalui SSH atau tmux; atur [`FORCE_HYPERLINK=0`](/docs/id/env-vars) untuk merendernya sebagai teks biasa. Sebelum rilis ini, lencana dirender sebagai teks biasa ketika dukungan tidak terdeteksi. |

1014| v2.1.216 | `/fork`: [konfirmasi](#from-inside-a-session) adalah satu baris, menampilkan status salinan, nama baris tampilan agen-nya, dan ID sesi-nya untuk `claude attach`, berakhir dengan `runs in the origin tree` atau `edits this checkout` hanya ketika salinan berjalan di pohon kerja utama atau mengedit checkout yang Anda buka. Mengklik nama melepaskan sesi ini dan membuka tampilan agen dalam sesi salinan. Konfirmasi tidak lagi menyatakan kembali mode izin yang diwarisi salinan; versi sebelumnya mencetak konfirmasi multi-baris tanpa nama yang dapat diklik.<br /><br />Memerlukan input: `/install-github-app` dan daftar pengaturan `/mcp`, jalankan sementara tidak ada yang dilampirkan, menampilkan sesi di bawah `Needs input` dengan baris yang menyebutkan perintah, dan melampirkan dan menjalankan kembali perintah melanjutkan; dari v2.1.208 hingga v2.1.215 mereka ditolak sepenuhnya dalam keadaan itu.<br /><br />Pemulihan `--agent`: melanjutkan atau memulai ulang sesi `--agent` yang [dilepaskan](#from-your-shell) memulihkan prompt sistem agen dan pembatasan alat, mencari direktori sesi sendiri untuk agen terlebih dahulu, ketika workspace-nya dipercayai; sesi yang agennya tidak lagi ada melanjutkan dengan alat default dan prompt sistem dan terbuka dengan peringatan yang terlihat, alih-alih diam-diam kembali ke agen default.<br /><br />`Ctrl+X`: menekannya dua kali menghapus sesi bahkan ketika upaya berhenti gagal, alih-alih berhenti yang gagal membatalkan penghapusan yang tertunda, dan sesi yang dihapus yang proses worker-nya telah mati tidak lagi muncul kembali pada refresh berikutnya.<br /><br />Penghapusan worktree: sesi yang direktori worktree-nya tidak termasuk dalam repositori git apa pun dapat dihapus; sebelum rilis ini setiap upaya menghapus sesi seperti itu ditolak. Direktori yang sudah hilang dihapus segera. Tekan ganda tampilan agen menghapus direktori yang masih memiliki file, menjalankan hook `WorktreeRemove` Anda untuk direktori yang dibuat hook, kecuali sesi lain juga menyebutnya. `claude rm` menyimpan direktori seperti itu kapan pun file tetap ada. |

1015| v2.1.214 | Sesi yang dilepaskan dengan `←` atau `/background` dan dibiarkan idle tanpa apa pun yang berjalan memiliki prosesnya dihentikan seperti sesi idle lainnya, alih-alih menyimpan prosesnya dan layanan latar belakang berjalan tanpa batas. Sesi yang selesai dapat dihapus dengan `claude rm` atau dari tampilan agen setelah layanan latar belakang telah idle, dan sesi yang memasuki worktree setelah dikirim dari direktori yang bukan repositori git, seperti folder workspace multi-repo, dapat dihapus dari tampilan agen ketika worktree itu sendiri termasuk dalam repositori git, karena pembersihan diselesaikan dari worktree alih-alih direktori tempat sesi dikirim; kedua penghapusan ditolak pada setiap upaya sebelumnya. Membuka kembali sesi yang dihentikan memulihkan percakapan yang disimpannya bahkan ketika folder dalam penyimpanan transkrip tidak dapat dibaca. |

1016| v2.1.213 | `/install-github-app`, [daftar pengaturan `/mcp`](/docs/id/mcp), dan tindakan autentikasi MCP bekerja dalam sesi latar belakang sementara terminal dilampirkan, dan ditolak hanya ketika tidak ada yang dilampirkan, dengan pesan yang memberi tahu Anda untuk melampirkan dan menjalankan perintah lagi; dari v2.1.208 hingga v2.1.212 mereka ditolak bahkan dengan terminal yang dilampirkan. |

1017| v2.1.212 | [`/fork` dalam sesi interaktif](#from-inside-a-session) menyalin percakapan ke sesi latar belakang baru yang muncul sebagai barisnya sendiri, dinamai setelah sesi yang berasal darinya atau, untuk fork yang diminta dari sesi tanpa nama, setelah prompt fork, sementara asli terus berjalan; perilaku subagen yang di-fork sebelumnya dari `/fork` pindah ke `/subtask`. Dengan [tampilan agen dimatikan](#turn-off-agent-view), `/fork` menyimpan perilaku subagen yang di-fork. Baris yang difokuskan yang menunggu prompt pertamanya menampilkan `space to send it a prompt`. `Ctrl+J` menyisipkan baris baru dalam input pengiriman di terminal dengan pelaporan kunci diperluas, di mana penekanan tombol sebelumnya diabaikan, dan overlay `?` mencantumkan pintasan. Petunjuk footer `←` dalam sesi interaktif secara singkat menampilkan `N done` ketika sesi latar belakang selesai sementara tidak ada yang memerlukan input Anda. Mengetik `/resume` telanjang dalam tampilan agen membuka pemilih sesi masa lalu dari repositori tempat Anda membuka tampilan agen, termasuk sesi yang dihapus dari daftar, dan memilih satu melanjutkannya sebagai sesi latar belakang; sebelum rilis ini `/resume` tidak tersedia dalam tampilan agen dan sesi yang dihapus hanya dapat dijangkau dengan `claude --resume` atau `/resume` dari sesi interaktif. Bentuk yang ditargetkan, dibatasi, dan dibatasi menyimpan petunjuk `attach to a session to run it` yang ditampilkan versi sebelumnya untuk setiap bentuk. Sesi yang menunggu prompt jaringan sandbox network-host, permintaan input MCP, atau prompt pengaturan terkelola menampilkan sebagai `Needs input` alih-alih `Working`, dalam tampilan agen dan dalam `claude agents --json`, dan pertanyaan dari Claude melaporkan `waitingFor: input needed` alih-alih `permission prompt`. Melampirkan ke sesi yang prosesnya telah berhenti menampilkan transkripsnya diformat cara sesi langsung merendernya, alih-alih sebagai teks mentah. Sesi yang dihentikan yang transkripsnya berada di tempat yang tidak terduga melanjutkan darinya melalui pemindaian upaya terakhir dari transkrip yang disimpan Anda, dan membuka baris yang tidak memiliki transkrip yang disimpan menampilkan `Press enter again to restart this session fresh`, memulai ulang segar pada tekan kedua; v2.1.211 menampilkan penolakan tanpa cara untuk memulai ulang dari tampilan agen. |

1018| v2.1.211 | Membangunkan sesi yang dihentikan dengan melampirkan atau membalas dari direktori tempat ia berjalan meneruskan gateway `ANTHROPIC_BASE_URL` shell Anda lagi, di bawah kondisi yang sama dengan pengiriman segar, jadi sesi yang diautentikasi melalui gateway `ANTHROPIC_AUTH_TOKEN` melanjutkan di gateway alih-alih melaporkan `Not logged in`. Melampirkan ke sesi yang dihentikan yang dilepaskan dari percakapan lain sebelum respons pertamanya selesai ditolak dengan `This session has no saved transcript` alih-alih diam-diam memulai percakapan kosong di bawah ID sesi yang sama; membuka baris yang sama dari tampilan agen menampilkan penolakan di footer. Mengakhiri proses sesi `←` atau `/background` dari luar Claude Code menandainya berhenti alih-alih supervisor memulai ulangnya, berhenti yang sudah dicatat di disk dihormati kecuali balasan yang Anda kirim masih menunggu untuk dikirimkan, sesi yang dimulai ulang setelah crash diberitahu itu dimulai ulang, dan sesi `←` atau `/background` yang dimulai ulang tidak melanjutkan respons yang terputus lebih lama dari sekitar satu jam. Balasan penamaan sesi yang menjawab atau menolak prompt alih-alih memberi label padanya, seperti untuk prompt yang sebagian besar tautan, dibuang dan baris menyimpan nama yang diambil dari teks prompt. Menghapus sesi yang worktree git-nya tidak lagi dikenali berhasil, meninggalkan direktori worktree di disk dan menyebutkan jalurnya, alih-alih setiap upaya ditolak. Penolakan penghapusan menampilkan alasan pada baris sesi, termasuk kesalahan git yang mendasar ketika worktree tidak dapat dihapus, alih-alih baris diam-diam muncul kembali. |

1019| v2.1.210 | `claude attach` menunggu sementara layanan latar belakang sedang dimulai atau terhubung kembali alih-alih gagal dengan kesalahan `job not found` atau `still starting`, melaporkan sesi yang selesai selama lampiran sebagai keluar, dan menerapkan perubahan ukuran terminal yang dibuat selama lampiran lambat ketika lampiran selesai. Hitungan kebutuhan input `←` footer prompt muncul di setiap penyedia, termasuk penyedia pihak ketiga yang sebelumnya menampilkan bentuk `← for agents` biasa. Melepaskan sesi dengan `←` membawa daftar tugas Claude ke sesi latar belakang alih-alih menjatuhkannya. Baris yang Anda tekan `←` darinya menyimpan nama yang berani dan tidak redup setelah pilihan bergerak. `claude agents --effort` menerima `ultracode` alih-alih diam-diam menjatuhkannya. |

813| v2.1.208 | Melampirkan ke sesi yang prosesnya telah berhenti menampilkan layar terakhir transkripsnya sementara proses dimulai, alih-alih hanya catatan `Session is starting`. Balasan yang tidak dapat dikirimkan karena layanan latar belakang tidak dapat dijangkau atau pengiriman gagal disimpan dan dikirim sebagai prompt berikutnya dari sesi ketika prosesnya dimulai lagi; sebelum rilis ini, balasan yang hilang saat layanan latar belakang tidak dapat dijangkau dibuang. Proses yang binernya sendiri diganti oleh pembaruan masih dapat memulai supervisor, dari peluncur `claude` yang terinstal atau versi terbaru di disk, alih-alih gagal sampai Claude Code dimulai ulang. Supervisor yang menjalankan versi yang lebih lama tidak pernah memulai ulang sesi idle yang dimulai oleh versi yang lebih baru ke binernya sendiri yang lebih lama. Menghapus sesi menghapus worktree-nya bahkan setelah sesi memindahkan worktree ke cabang yang berbeda, dan menjaga worktree tetap bersama dengan baris sesi ketika worktree memiliki commit yang tidak didorong ke mana pun atau sesi lain mengklaimnya, alih-alih menghancurkan commit atau meninggalkan worktree. `/install-github-app` dan daftar pengaturan `/mcp` serta tindakan autentikasinya ditolak dalam sesi latar belakang dengan pesan yang menyebutkan alternatifnya; hanya dalam v2.1.208, pemilih `/model` ditolak dengan cara yang sama dan `/model <name>` yang diketik beralih hanya sesi itu alih-alih juga menyimpan model default Anda. |1020| v2.1.208 | Melampirkan ke sesi yang prosesnya telah berhenti menampilkan layar terakhir transkripsnya sementara proses dimulai, alih-alih hanya catatan `Session is starting`. Balasan yang tidak dapat dikirimkan karena layanan latar belakang tidak dapat dijangkau atau pengiriman gagal disimpan dan dikirim sebagai prompt berikutnya dari sesi ketika prosesnya dimulai lagi; sebelum rilis ini, balasan yang hilang saat layanan latar belakang tidak dapat dijangkau dibuang. Proses yang binernya sendiri diganti oleh pembaruan masih dapat memulai supervisor, dari peluncur `claude` yang terinstal atau versi terbaru di disk, alih-alih gagal sampai Claude Code dimulai ulang. Supervisor yang menjalankan versi yang lebih lama tidak pernah memulai ulang sesi idle yang dimulai oleh versi yang lebih baru ke binernya sendiri yang lebih lama. Menghapus sesi menghapus worktree-nya bahkan setelah sesi memindahkan worktree ke cabang yang berbeda, dan menjaga worktree tetap bersama dengan baris sesi ketika worktree memiliki commit yang tidak didorong ke mana pun atau sesi lain mengklaimnya, alih-alih menghancurkan commit atau meninggalkan worktree. `/install-github-app` dan daftar pengaturan `/mcp` serta tindakan autentikasinya ditolak dalam sesi latar belakang dengan pesan yang menyebutkan alternatifnya; hanya dalam v2.1.208, pemilih `/model` ditolak dengan cara yang sama dan `/model <name>` yang diketik beralih hanya sesi itu alih-alih juga menyimpan model default Anda. |

814| v2.1.207 | Panel intip terbuka dengan kalimat yang dipotong baris, seperti pertanyaan pastinya untuk sesi yang menunggu Anda, dan menampilkan berapa lama sesi yang diblokir telah menunggu sebagai baris `waiting 3m` tunggal alih-alih menambahkan awalan stempel waktu yang sama ke kalimat status dan pertanyaan. Menempel teks yang sama lagi dalam input pengiriman memperluas placeholder `[Pasted text #N]` yang runtuh alih-alih menambahkan yang kedua. Sesi latar belakang yang dinamai dengan menerima rencana menampilkan nama itu pada barisnya. Sesi latar belakang yang pindah ke worktree menyimpan percakapannya ketika prosesnya dimulai ulang dari tampilan agen. |1021| v2.1.207 | Panel intip terbuka dengan kalimat yang dipotong baris, seperti pertanyaan pastinya untuk sesi yang menunggu Anda, dan menampilkan berapa lama sesi yang diblokir telah menunggu sebagai baris `waiting 3m` tunggal alih-alih menambahkan awalan stempel waktu yang sama ke kalimat status dan pertanyaan. Menempel teks yang sama lagi dalam input pengiriman memperluas placeholder `[Pasted text #N]` yang runtuh alih-alih menambahkan yang kedua. Sesi latar belakang yang dinamai dengan menerima rencana menampilkan nama itu pada barisnya. Sesi latar belakang yang pindah ke worktree menyimpan percakapannya ketika prosesnya dimulai ulang dari tampilan agen. |

815| v2.1.206 | Ringkasan baris mengisi lebar sisa baris dan dipotong hanya di tepi kanan terminal alih-alih pada 64 kolom. Setelah supervisor dimulai ulang ke versi Claude Code baru, ia memulai ulang sesi latar belakang idle yang tersisa ke versi itu di latar belakang alih-alih beberapa per menit. Menghapus sesi dengan `Ctrl+X` atau `claude rm` juga menghapusnya dari daftar sesi supervisor, sehingga baris tidak lagi muncul kembali setelah restart supervisor. |1022| v2.1.206 | Ringkasan baris mengisi lebar sisa baris dan dipotong hanya di tepi kanan terminal alih-alih pada 64 kolom. Setelah supervisor dimulai ulang ke versi Claude Code baru, ia memulai ulang sesi latar belakang idle yang tersisa ke versi itu di latar belakang alih-alih beberapa per menit. Menghapus sesi dengan `Ctrl+X` atau `claude rm` juga menghapusnya dari daftar sesi supervisor, sehingga baris tidak lagi muncul kembali setelah restart supervisor. Penimpaan badan permintaan `CLAUDE_CODE_EXTRA_BODY` yang diekspor dalam shell pengiriman mencapai sesi latar belakang alih-alih diabaikan. |

816| v2.1.205 | Ringkasan baris menampilkan laporan satu baris sesi itu sendiri, dipotong pada 64 kolom, alih-alih invokasi alat mentah atau hitungan `done/total`; baris yang dikelompokkan direktori terbuka dengan kata status berwarna. Panel intip terbuka dengan kalimat status lengkap dan, untuk sesi yang menunggu Anda, pertanyaan pastinya di atas input balasan. Sesi yang mengedit, mengomentari, menutup, atau menandai permintaan tarik siap dengan `gh` ditautkan ke sana, bukan hanya yang membuat atau checkout permintaan tarik, push menautkan permintaan tarik bahkan ketika nama cabang lokal tidak cocok, dan permintaan tarik yang output perintah pembuatannya melebihi batas inline juga ditautkan. Giliran tanpa teks yang dapat dibaca menyimpan status sesi sebelumnya alih-alih membaliknya kembali ke `Working`. `claude attach` menunggu hingga sekitar 60 detik untuk sesi yang sedang dimulai ulang, dengan baris status yang menyebutkan alasannya, alih-alih gagal. |1023| v2.1.205 | Petunjuk `←` footer prompt menghitung agen latar belakang yang menunggu Anda, seperti `← 2 agents`. Ringkasan baris menampilkan laporan satu baris sesi itu sendiri, dipotong pada 64 kolom, alih-alih invokasi alat mentah atau hitungan `done/total`; baris yang dikelompokkan direktori terbuka dengan kata status berwarna. Panel intip terbuka dengan kalimat status lengkap dan, untuk sesi yang menunggu Anda, pertanyaan pastinya di atas input balasan. Sesi yang mengedit, mengomentari, menutup, atau menandai permintaan tarik siap dengan `gh` ditautkan ke sana, bukan hanya yang membuat atau checkout permintaan tarik, push menautkan permintaan tarik bahkan ketika nama cabang lokal tidak cocok, dan permintaan tarik yang output perintah pembuatannya melebihi batas inline juga ditautkan. Giliran tanpa teks yang dapat dibaca menyimpan status sesi sebelumnya alih-alih membaliknya kembali ke `Working`. `claude attach` menunggu hingga sekitar 60 detik untuk sesi yang sedang dimulai ulang, dengan baris status yang menyebutkan alasannya, alih-alih gagal. |

817| v2.1.203 | Gateway `ANTHROPIC_BASE_URL` yang diekspor dalam shell pengiriman mencapai sesi yang dikirim darinya ke direktori yang sama ketika supervisor membagikan gateway environment tersebut, alih-alih dijatuhkan sementara kunci API yang diekspor bersama dengannya tetap disimpan. `PATH` shell pengiriman diterapkan ke setiap worker sesi. Menekan `←` saat subagen sedang berjalan menunggu mereka alih-alih memulai ulang mereka setelah sepuluh detik. Daftar kosong selalu menampilkan header bagian dengan deskripsi di bawah masing-masing. Mengetik `@` dalam input pengiriman juga mencantumkan git worktrees terdaftar dari repositori peluncuran yang berada di dalam pohon direktorinya. Upaya yang diwarisi dari pengaturan `effortLevel` mengikuti pengeditan kemudian ke pengaturan tersebut alih-alih diperbaiki pada pengiriman. Membuka sesi yang dihentikan yang percakapannya sudah terbuka di sesi yang sedang berjalan lainnya ditolak dengan pesan alih-alih gagal pada baris. Perintah yang tidak tersedia dalam tampilan agen meninggalkan teks yang diketik dalam input. Hook `WorktreeCreate` yang gagal di luar repositori git tidak lagi memblokir sesi dari pengeditan file. |1024| v2.1.203 | Gateway `ANTHROPIC_BASE_URL` yang diekspor dalam shell pengiriman mencapai sesi yang dikirim darinya ke direktori yang sama ketika supervisor membagikan gateway environment tersebut, alih-alih dijatuhkan sementara kunci API yang diekspor bersama dengannya tetap disimpan. `PATH` shell pengiriman diterapkan ke setiap worker sesi. Menekan `←` saat subagen sedang berjalan menunggu mereka alih-alih memulai ulang mereka setelah sepuluh detik. Daftar kosong selalu menampilkan header bagian dengan deskripsi di bawah masing-masing. Mengetik `@` dalam input pengiriman juga mencantumkan git worktrees terdaftar dari repositori peluncuran yang berada di dalam pohon direktorinya. Upaya yang diwarisi dari pengaturan `effortLevel` mengikuti pengeditan kemudian ke pengaturan tersebut alih-alih diperbaiki pada pengiriman. Membuka sesi yang dihentikan yang percakapannya sudah terbuka di sesi yang sedang berjalan lainnya ditolak dengan pesan alih-alih gagal pada baris. Perintah yang tidak tersedia dalam tampilan agen meninggalkan teks yang diketik dalam input. Hook `WorktreeCreate` yang gagal di luar repositori git tidak lagi memblokir sesi dari pengeditan file. |

818| v2.1.202 | Nama yang ditetapkan dengan `/rename` atau `Ctrl+R` pada sesi latar belakang tetap ada ketika supervisor menghentikan dan memulai ulang prosesnya, alih-alih kembali ke nama yang dikirim sesi dengan. |1025| v2.1.202 | Nama yang ditetapkan dengan `/rename` atau `Ctrl+R` pada sesi latar belakang tetap ada ketika supervisor menghentikan dan memulai ulang prosesnya, alih-alih kembali ke nama yang dikirim sesi dengan. |

819| v2.1.200 | Versi Claude Code yang lebih lama yang menulis ulang daftar sesi dalam `roster.json` mempertahankan bidang yang ditulis oleh versi yang lebih baru, sesuai dengan jaminan `state.json` yang ada, sehingga sesi yang dimulai oleh versi yang lebih baru terus menerima input setelah supervisor dimulai ulang. Ketika Anda membuka sesi yang telah berhenti merespons, supervisor memulai ulang prosesnya dan sesi melanjutkan respons yang terputus dari tempat ia berhenti. |1026| v2.1.200 | Versi Claude Code yang lebih lama yang menulis ulang daftar sesi dalam `roster.json` mempertahankan bidang yang ditulis oleh versi yang lebih baru, sesuai dengan jaminan `state.json` yang ada, sehingga sesi yang dimulai oleh versi yang lebih baru terus menerima input setelah supervisor dimulai ulang. Ketika Anda membuka sesi yang telah berhenti merespons, supervisor memulai ulang prosesnya dan sesi melanjutkan respons yang terputus dari tempat ia berhenti. Tampilan agen menerapkan bendera `--plugin-dir` yang ditempatkan setelah `agents` ke subagen tampilan agen-nya sendiri dan autocomplete skill dalam input pengiriman serta sesi yang dikirim. |

820| v2.1.199 | Sesi latar belakang yang prosesnya keluar sebelum selesai dimulai pada host dengan memori rendah menampilkan `possibly low memory — free some up and retry` dalam status barisnya alih-alih hanya alasan keluar yang polos. Melepaskan sesi dengan `←` atau `/background` membawa `/color` ke baris baru. |1027| v2.1.199 | Sesi latar belakang yang prosesnya keluar sebelum selesai dimulai pada host dengan memori rendah menampilkan `possibly low memory — free some up and retry` dalam status barisnya alih-alih hanya alasan keluar yang polos. Melepaskan sesi dengan `←` atau `/background` membawa `/color` ke baris baru. |

821| v2.1.198 | Tampilan agen mengirim notifikasi melalui `preferredNotifChannel` ketika sesi latar belakang memerlukan input, selesai, atau gagal, dan memicu hook `Notification` dengan tipe `agent_needs_input` atau `agent_completed`. `←` dan `/exit` di dalam `claude attach <id>` kembali ke tampilan agen alih-alih keluar ke shell; `Ctrl+Z` kembali ke shell. Sesi latar belakang yang mengisolasi pekerjaannya dalam worktree melakukan commit, mendorong cabang terisolasinya sendiri, tidak pernah `main` atau `master`, dan membuka permintaan tarik draft ketika selesai alih-alih bertanya terlebih dahulu. `/login` berjalan dalam tampilan agen dan membuka dialog masuk. Dialog keluar `Background work is running` menawarkan `Move to background and exit`. Handoff keluar juga mencakup subagen latar belakang, yang melanjutkan dari transkrip mereka pada waktu bangun berikutnya alih-alih dilaporkan sebagai gagal. `claude --bg` dikombinasikan dengan `-p` atau `--print` ditolak dengan kesalahan. |1028| v2.1.198 | Tampilan agen mengirim notifikasi melalui `preferredNotifChannel` ketika sesi latar belakang memerlukan input, selesai, atau gagal, dan memicu hook `Notification` dengan tipe `agent_needs_input` atau `agent_completed`. `←` dan `/exit` di dalam `claude attach <id>` kembali ke tampilan agen alih-alih keluar ke shell; `Ctrl+Z` kembali ke shell. Sesi latar belakang yang mengisolasi pekerjaannya dalam worktree melakukan commit, mendorong cabang terisolasinya sendiri, tidak pernah `main` atau `master`, dan membuka permintaan tarik draft ketika selesai alih-alih bertanya terlebih dahulu. `/login` berjalan dalam tampilan agen dan membuka dialog masuk. Dialog keluar `Background work is running` menawarkan `Move to background and exit`. Handoff keluar juga mencakup subagen latar belakang, yang melanjutkan dari transkrip mereka pada waktu bangun berikutnya alih-alih dilaporkan sebagai gagal. `claude --bg` dikombinasikan dengan `-p` atau `--print` ditolak dengan kesalahan. Host sesi latar belakang meminta izin Jaringan Lokal macOS pada akses LAN pertama alih-alih gagal dengan `connect: no route to host`. |

822| v2.1.196 | Tekan `←` tunggal mengirim sesi latar depan ke latar belakang; versi sebelumnya memerlukan dua tekan, dengan petunjuk footer dan konfirmasi. `--dangerously-skip-permissions` yang diteruskan ke `claude agents` menampilkan pengecualian bypass alih-alih dijatuhkan diam-diam. Sesi interaktif yang tidak pernah Anda beri nama membawa nama default seperti `my-app-3f` dalam daftar sesi dan `claude agents --json`. Perintah shell latar belakang dan alur kerja dinamis bertahan ketika proses sesi dihentikan, dimulai ulang, atau diperbarui, termasuk di Windows; atur `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` untuk mematikan handoff. Transkrip yang salah dibaca sebagai kosong saat restart diganti nama dengan akhiran `.orphaned-` alih-alih dihapus. |1029| v2.1.196 | Tekan `←` tunggal melepaskan sesi latar depan ke latar belakang; versi sebelumnya memerlukan dua tekan, dengan petunjuk footer dan konfirmasi. `--dangerously-skip-permissions` yang diteruskan ke `claude agents` menampilkan pengecualian bypass alih-alih dijatuhkan diam-diam. Sesi interaktif yang tidak pernah Anda beri nama membawa nama default seperti `my-app-3f` dalam daftar sesi dan `claude agents --json`. Perintah shell latar belakang dan alur kerja dinamis bertahan ketika proses sesi dihentikan, dimulai ulang, atau diperbarui, termasuk di Windows; atur `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` untuk mematikan handoff. Transkrip yang salah dibaca sebagai kosong saat restart diganti nama dengan akhiran `.orphaned-` alih-alih dihapus. |

823| v2.1.195 | Pekerjaan yang sedang berlangsung dibawa ketika Anda melepaskan sesi di Windows juga; atur `CLAUDE_DISABLE_ADOPT=1` untuk menghentikannya sebagai gantinya. Grup `Completed` mengisi ruang vertikal yang tersisa dan header dikompakkan di terminal pendek. Versi Claude Code yang lebih lama tidak lagi menjatuhkan bidang `state.json` sesi yang lebih baru atau menyembunyikan sesi tersebut dari `claude agents`. Melampirkan ke sesi yang dihentikan beralih segera alih-alih menampilkan layar kosong selama lima detik. Supervisor yang tidak dapat menerima koneksi keluar dan melepaskan kuncinya sendiri. |1030| v2.1.195 | Pekerjaan yang sedang berlangsung dibawa ketika Anda melepaskan sesi di Windows juga; atur `CLAUDE_DISABLE_ADOPT=1` untuk menghentikannya sebagai gantinya. Grup `Completed` mengisi ruang vertikal yang tersisa dan header dikompakkan di terminal pendek. Versi Claude Code yang lebih lama tidak lagi menjatuhkan bidang `state.json` sesi yang lebih baru atau menyembunyikan sesi tersebut dari `claude agents`. Melampirkan ke sesi yang dihentikan beralih segera alih-alih menampilkan layar kosong selama lima detik. Supervisor yang tidak dapat menerima koneksi keluar dan melepaskan kuncinya sendiri. |

1031| v2.1.191 | `claude --bg` dengan nama `--agent` yang tidak cocok dengan subagen apa pun Anda gagal meluncurkan: sesi keluar segera dengan kesalahan `--agent '<name>' not found` alih-alih berjalan dengan agen default. |

824| v2.1.174 | Sesi latar belakang tidak lagi mewarisi variabel titik akhir gateway seperti `ANTHROPIC_BASE_URL` dari shell peluncuran supervisor; supervisor menyediakan snapshot kredensial segar ke worker yang sudah dipanaskan sebelumnya, memperbaiki kesalahan `Could not resolve authentication method` yang palsu. |1032| v2.1.174 | Sesi latar belakang tidak lagi mewarisi variabel titik akhir gateway seperti `ANTHROPIC_BASE_URL` dari shell peluncuran supervisor; supervisor menyediakan snapshot kredensial segar ke worker yang sudah dipanaskan sebelumnya, memperbaiki kesalahan `Could not resolve authentication method` yang palsu. |

825| v2.1.172 | `/model` dalam input pengiriman menetapkan penimpaan model pengiriman yang dibatasi sesi. |1033| v2.1.172 | `/model` dalam input pengiriman menetapkan penimpaan model pengiriman yang dibatasi sesi. |

826| v2.1.161 | Ringkasan baris menampilkan hitungan `done/total` untuk item kerja paralel; panel intip menyebutkan item kerja paralel yang paling lama berjalan. |1034| v2.1.161 | Ringkasan baris menampilkan hitungan `done/total` untuk item kerja paralel; panel intip menyebutkan item kerja paralel yang paling lama berjalan. |

agent-view.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

Kelola banyak agen dengan tampilan agen

Mulai cepat

Buka tampilan agen

Kirim sesi

Intip dan balas

Lampirkan dan lepaskan

Bawa sesi yang ada ke dalam

Pantau sesi dengan tampilan agen

Baca status sesi

Ringkasan baris

Status permintaan tarik

Intip dan balas

Lampirkan ke sesi

Alihkan sesi tanpa meninggalkan terminal

Atur daftar

Filter sesi

Pintasan keyboard

Kirim agen baru

Dari tampilan agen

Kirim ke direktori tertentu

Dari dalam sesi

Kirim sesi ke latar belakang

Salin sesi dengan /fork

Apa yang dibawa ketika Anda melepaskan ke latar belakang

Dari shell Anda

Jalankan perintah shell

Bagaimana pengeditan file diisolasi

Apa yang dihapus menghapus sesi

Atur model

Mode izin, model, dan upaya

Pengaturan dan penyedia

Gateway LLM

Mode izin

Default pengiriman

Apa yang bertahan di seluruh restart

Pengaturan, plugins, dan server MCP

Kelola sesi dari shell

Daftar sesi sebagai JSON

Bagaimana sesi latar belakang dihosting

Proses supervisor

Tempat status disimpan

Matikan tampilan agen

Troubleshooting

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

Tampilan agen terbuka tanpa sesi

Melepaskan menunjukkan dialog `Background this session?`

Prompt ditolak karena terlalu pendek

Sesi menampilkan sebagai gagal atau dihentikan setelah shutdown

Membuka sesi mengatakan percakapan sudah terbuka

Membuka sesi mengatakan tidak memiliki transkrip yang disimpan

Host terminal mati atau sesi berhenti merespons

Host terminal mati

Sesi tidak merespons

Sesi gagal sebelum dimulai dengan catatan `possibly low memory`

Tampilan agen mengatakan layanan latar belakang tidak merespons

Pengiriman gagal dengan `Could not resolve authentication method`

Sesi latar belakang tidak dapat membaca Desktop, Documents, atau Downloads di macOS

Sesi latar belakang tidak dapat menjangkau host jaringan lokal di macOS

Sesi lambat merespons setelah melampirkan

`.claude/worktrees/` penuh

Keterbatasan

Sumber daya terkait

Riwayat versi