SpyBara
Go Premium

agent-view.md 2026-10-05 23:58 UTC to 2026-10-06 03:01 UTC

This page contains 300 additions and 297 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sun 4 23:58 Tue 6 03:57

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. Baris di bagian atas menghitung sesi yang menunggu masukan, bekerja, dan selesai. Empat sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai. Setiap baris menunjukkan nama sesi, status atau pertanyaan terakhirnya, dan waktu. Di bagian bawah adalah input untuk mendeskripsikan tugas baru dan baris petunjuk keyboard. Tampilan agen di terminal. Baris di bagian atas menghitung sesi yang menunggu masukan, bekerja, dan selesai. Empat sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai. Setiap baris menunjukkan nama sesi, status atau pertanyaan terakhirnya, dan waktu. Di bagian bawah adalah input untuk mendeskripsikan tugas baru dan baris petunjuk keyboard.

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

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

Untuk membandingkan tampilan agen dengan subagen, tim agen, dan worktrees, lihat Jalankan agen secara paralel. Tampilan agen menjalankan sesi di mesin Anda dan Anda mengirim masing-masing; untuk membuat Claude memulai dan melacak sesi paralel di cloud dari satu percakapan, lihat Projects.

Mulai cepat

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

1

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.

2

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.

3

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.

4

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.

5

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.

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.

Buka tampilan agen secara default

Untuk membuat claude tanpa argumen membuka tampilan agen alih-alih percakapan baru, aktifkan pengaturan /config.

1

Aktifkan pengaturan

Dalam sesi claude biasa, jalankan /config dan aktifkan Open agents view by default. Untuk melewati menu, atur kunci defaultToAgentsView secara langsung:

/config defaultToAgentsView=true
2

Mulai Claude Code

Keluar dari sesi, kemudian jalankan claude tanpa argumen:

claude

Tampilan agen terbuka sebagai pengganti percakapan baru.

Untuk memulai sesi biasa saat pengaturan aktif, berikan prompt: claude "fix the login test". Untuk mematikan pengaturan, jalankan /config defaultToAgentsView=false dalam sesi biasa atau dalam sesi yang Anda lampirkan dari tampilan agen.

Pantau sesi dengan tampilan agent

Jalankan claude agents untuk membuka tampilan agent. 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 proyek Anda. Sesi yang bekerja di satu repositori dan sesi lain di worktree berbeda keduanya muncul di sini, terlepas dari direktori mana Anda membuka tampilan agent. Untuk membatasi daftar ke satu proyek, berikan --cwd:

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

Ini menampilkan hanya sesi yang dimulai di bawah direktori itu. Daftar tetap mencantumkan sesi yang telah berpindah ke worktree di bawah ~/projects/my-app/.claude/worktrees/.

Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda mengirimnya ke latar belakang. Subagent dan teammate yang dihasilkan sesi tidak tercantum sebagai baris terpisah.

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           double jump or wall climb?                    1m

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          all checkpoints cleared ×12                in 4m

Completed
  ✻ title screen              menu, options, and credits done               9m
  ∙ sound effects             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 tool 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 dari 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 memiliki artinya sendiri:

Bentuk Artinya
✻ atau animasi ✽ Proses sesi sedang berjalan, atau sesi membutuhkan masukan Anda
∙ 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 pull request atau merge request sesi, bukan bagian dari ikon status.

Judul tab terminal menunjukkan jumlah menunggu-masukan saat tampilan agent terbuka: 2 awaiting input · claude agents ketika sesi membutuhkan masukan, atau claude agents ketika tidak ada.

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

Saat tampilan agent 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 memberi tahu ketika mereka membutuhkan masukan Anda. Notifikasi menggunakan pengaturan preferredNotifChannel yang sama dengan bagian lain 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 agent, 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 mesin tetap 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 kelas Haiku yang dikonfigurasi, permintaan menggunakan model utama sesi sebagai gantinya; atur ANTHROPIC_DEFAULT_HAIKU_MODEL untuk memilih satu.

Status pull request

Ketika sesi membuka pull request, Claude Code menambahkan label di tepi kanan baris, tertaut ke pull request:

  • Claude Code menulis label sebagai #1234 untuk pull request dan sebagai !1234 untuk merge request 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 pull request yang ada tertaut ke sana dengan cara yang sama. Claude Code menemukan pull request secara berbeda tergantung pada perintah yang dijalankan Claude:

  • Ketika Claude mengedit, mengomentari, menutup, atau menandai pull request siap dengan gh, Claude Code menautkan pull request yang dinamai oleh output perintah itu sendiri. Perintah gh yang output tertangkapnya tidak menamai pull request tidak membuat tautan; gh pr merge adalah kasus umum, karena mencetak hasilnya hanya ke terminal interaktif.
  • Ketika Claude melakukan checkout pull request dengan gh pr checkout atau melakukan push ke branch, Claude Code mencari branch dengan gh pr view dan menautkan pull request-nya yang terbuka.
  • Pull request tidak perlu sudah ada ketika Claude melakukan push: Claude Code mencoba ulang pencarian branch setelah hingga lima perintah git, gh, glab, atau curl berikutnya berjalan di direktori yang sama, jadi pull request yang dibuat setelah push, termasuk yang dibuat Claude melalui REST API GitHub, tertaut ketika retry menemukannya.

Ketika sesi tertaut ke lebih dari satu pull request, label menunjukkan hitungan sebagai gantinya, seperti 3 PRs, berwarna sesuai pull request terbuka yang paling membutuhkan perhatian. Buka panel intip untuk melihat semuanya.

Nomor pull request berwarna berdasarkan statusnya:

Warna Status pull request
Kuning Menunggu pemeriksaan atau tinjauan, atau pemeriksaan gagal
Hijau Pemeriksaan lulus dan tidak ada tinjauan yang memblokir
Ungu Di-merge
Abu-abu Draf atau ditutup

Untuk tugas yang berakhir dengan pull request, periksa label ini untuk hasilnya: tinjau dan merge pull request ketika nomornya berubah menjadi hijau.

Intip dan balas

Tekan Space pada baris yang dipilih untuk membuka panel intip. Panel terbuka dengan kalimat yang dipotong baris 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

Pull request 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. Awali balasan dengan ! untuk mengirim perintah Bash sebagai gantinya. Apa yang terjadi pada balasan tergantung pada sesi dan apa yang Anda kirim:

  • Sesi yang sedang bekerja: balasan masuk ke antrean pesan sesi alih-alih menginterupsi respons, dan berlaku saat input dalam antrean berlaku. Perintah menunggu hingga giliran berakhir, bahkan perintah yang langsung berjalan saat Anda mengetiknya di prompt sesi itu sendiri
  • Balasan yang persis /stop: menghentikan sesi seketika alih-alih dikirimkan kepadanya, baik sesi sedang bekerja maupun menunggu Anda
  • Shell job: balasan, termasuk /stop, dikirim ke terminal perintah sebagai input yang diketik

Ketika sesi menunggu Anda, cara Anda menjawab dari panel intip tergantung pada apa yang ditunggunya:

  • Pertanyaan dengan pilihan yang telah ditentukan: panel mencantumkan pilihan berdasarkan nomor. Dengan input balasan kosong, tekan nomor pilihan untuk mengisinya, lalu Enter untuk mengirimnya, atau ketik jawaban Anda sendiri sebagai gantinya
  • Pertanyaan tanpa pilihan yang telah ditentukan: ketik jawaban Anda. Ketika input kosong menampilkan balasan yang disarankan, tekan Tab untuk mengisinya dan mengeditnya sebelum mengirim
  • Permintaan izin atau dialog lain, seperti prompt sandbox atau permintaan masukan dari server MCP: membalas tidak menjawabnya. Balasan Anda menunggu dalam antrean. Untuk menjawab dialog, lampirkan dengan →

Ketika hook PermissionRequest atau PreToolUse mengembalikan output yang tidak dapat divalidasi Claude Code untuk panggilan yang diminta sesi, baris menunjukkan event 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 alih-alih dijalankan sebagai perintah Bash.

Dengan dikte suara diaktifkan dalam mode tahan, tahan 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 agent.

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 agent 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 agent 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 dalam kedua kondisi.

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 agent, baik Anda membuka sesi dari tampilan agent maupun dengan claude attach <id> dari shell Anda.

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

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

Ctrl+Z juga melepaskan tetapi kembali ke tempat Anda memulai: tampilan agent 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 ! alih-alih 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, yaitu sesi yang Anda mulai di terminal alih-alih dilampirkan dari tampilan agent, menekan ← pada prompt kosong mengirimnya ke latar belakang dan membuka tampilan agent dengan baris itu dipilih, sehingga Anda dapat beralih sesi tanpa meninggalkan terminal. Satu tekanan yang sama melepaskan sesi yang dilampirkan.

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

Ketika ← mengirim sesi latar depan ke latar belakang, tampilan agent 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 peralihan dan kembali ke percakapan. Jika Esc menunjukkan Still starting — try again in a moment, sesi latar belakang belum siap, jadi tekan Esc lagi sebentar kemudian.
  • Tekan Ctrl+C dua kali untuk keluar ke shell Anda.

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

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

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

Jika tool sedang berjalan saat Anda menekan ←, Claude Code menunggu hingga sekitar sepuluh detik agar tool selesai sebelum mengirim ke latar belakang, dan Claude melanjutkan respons 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, Claude Code menampilkan dialog Background this session? terlebih dahulu, sama seperti dengan /background.

Batas sepuluh detik tidak berlaku saat subagent 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 subagent itu dari awal. Claude Code tidak menunggu subagent yang dijalankan oleh workflow dinamis. Ketika workflow memiliki subagent 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, ia membatalkan peralihan 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 → tetap kembali ke sana.

Anda dapat mematikan pintasan ini untuk sesi latar depan dengan pengaturan leftArrowOpensAgents di /config.

Atur daftar

Tampilan agent 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 berpindah ke Ready for review ketika memiliki pull request terbuka yang membutuhkan tinjauan atau memiliki pemeriksaan yang gagal, 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 eksekusi.

Dalam grup:

  • Tekan Ctrl+T untuk menyematkan sesi ke atas dan menjaga prosesnya tetap berjalan saat menganggur
  • Tekan Shift+↑ atau Shift+↓ untuk mengatur ulang urutan sesi
  • Tekan Ctrl+R untuk mengganti nama sesi
  • Tekan Enter pada header grup untuk menciutkannya, kecuali saat filter aktif, ketika setiap grup tetap terbuka

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.

Tekanan 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 dihapus saat menghapus sesi, penghapusan menghapus sesi dari daftar, dan worktree yang dibuat Claude untuknya dihapus, dipertahankan, atau dibiarkan di tempat tergantung pada cara Anda menghapus dan apa isi 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 tempat Anda membuka tampilan agent, 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 kembali masuk ke daftar sebagai baris, dan Esc menutup pemilih.

Pemilih terbuka hanya untuk /resume tanpa argumen. Resume yang ditargetkan, dibatasi cakupannya, atau dibatasi tidak dapat dilayani oleh pemilih, jadi tampilan agent menunjukkan petunjuk attach to a session to run it sebagai gantinya ketika:

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

Sesi yang selesai yang tidak muat di layar dilipat menjadi baris … N more. Grup Completed mengisi ruang vertikal yang tersisa setelah grup aktif, dan di terminal pendek header dipadatkan menjadi satu baris ringkasan sehingga sesi yang bekerja atau membutuhkan masukan tetap terlihat.

Filter sesi

Awali input pengiriman dengan salah satu filter berikut untuk mempersempit daftar saat Anda mengetik:

Filter Menampilkan
a:<name> Sesi yang menjalankan agent bernama tersebut
s:<state> Sesi dalam status tertentu, seperti s:working, atau di bawah header grup tertentu, seperti s:ready untuk Ready for review. s:blocked mencantumkan semua yang menunggu Anda
n:<text> Sesi yang nama atau prompt pertamanya berisi teks tersebut, seperti n:login. Memerlukan Claude Code v2.1.287 atau lebih baru
o:<text> Sesi yang hasilnya berisi teks tersebut, seperti o:merged. o: tanpa teks mencantumkan setiap sesi yang telah melaporkan hasil
Nomor pull request atau merge request, seperti #1234, atau URL-nya Sesi yang bekerja pada pull request atau merge request tersebut
URL lainnya Sesi yang prompt pertamanya berisi URL itu

Untuk menggabungkan filter, mulai dengan a:, s:, n:, atau o: lalu tambahkan filter lain, dipisahkan dengan spasi. Daftar menampilkan sesi yang cocok dengan semuanya. Misalnya, s:blocked a:reviewer mencantumkan sesi reviewer yang sedang menunggu Anda.

Saat filter aktif, grup yang Anda ciutkan terbuka untuk menampilkan kecocokannya dan sebuah kecocokan dipilih, sehingga menekan Enter akan membukanya. Kosongkan input untuk menghapus filter, dan grup-grup tersebut diciutkan kembali.

Pintasan keyboard

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

Pintasan Tindakan
↑ / ↓ Pindah antar baris
PgUp / PgDn Pindah ke atas atau ke bawah sebanyak satu layar baris
Home / End Lompat ke baris pertama atau terakhir
Enter Lampirkan ke sesi yang dipilih, atau kirim teks di input jika bukan filter
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 subagent. Jika tidak, terapkan saran yang disorot
Ctrl+S Alihkan pengelompokan antara status dan direktori
Ctrl+T Sematkan atau lepas sematkan sesi yang dipilih
Ctrl+F Cari sesi berdasarkan nama, dengan filter n:
Alt+↑ / Alt+↓ Lompat ke header grup sebelumnya atau berikutnya
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 urutan sesi yang dipilih
Esc Tutup panel intip, hapus input, atau keluar. Ketika Anda membuka tampilan agent 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 pintasan

Pintasan yang memiliki tindakan dalam konteks Agents mengikuti keybindings.json Anda. Demikian pula Ctrl+G, melalui binding chat:externalEditor dalam konteks Chat.

Dispatch new agents

Anda dapat mengirim sesi latar belakang baru dari agent view, mengirim atau menyalin sesi interaktif yang ada ke latar belakang, atau memulai satu langsung dari shell.

From agent view

Ketik prompt dalam input di bagian bawah agent view dan tekan Enter untuk memulai sesi latar belakang baru. Sesi diberi nama secara otomatis dari prompt; ubah nama 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 diciutkan menjadi placeholder [Pasted text #N] sehingga input tetap pada satu baris; teks lengkap dikirim ketika Anda mengirim. Untuk meninjau atau mengedit teks yang diciutkan sebelum mengirim, tempel teks yang sama lagi dan placeholder akan diperluas kembali ke dalam input.

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

Input Efek
<agent-name> <prompt> Jika kata pertama cocok dengan nama subagent kustom, subagent itu berjalan sebagai agent utama sesi dengan konfigurasi dari frontmatter-nya
@<agent-name> Sebutkan subagent kustom di mana saja dalam prompt untuk menjalankannya sebagai agent utama
@<repo> Sebutkan repositori untuk menjalankan sesi di sana. Lihat Dispatch to a specific directory untuk repositori mana yang terdaftar
/<command> Sarankan skills dan perintah 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, pantau, dan lepaskan
#<number> atau URL pull request atau merge request Jika sesi sudah bekerja pada pull request atau merge request itu, Claude Code memilih barisnya alih-alih mengirim sesi baru

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

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

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

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

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

Dispatch to a specific directory

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

  • Buka claude agents di direktori itu.

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

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

    Direktori yang namanya berisi spasi tidak terdaftar.

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

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

From inside a session

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

Send the session to the background

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, workflow, atau monitor, menampilkan dialog Background work is running alih-alih langsung keluar. Pilih Move to background and exit untuk memindahkan sesi ke latar belakang dengan cara yang sama seperti /background dan kembali ke shell Anda. Opsi ini tidak ditampilkan ketika agent view dimatikan.

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

Copy the session with /fork

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

Setelah fork, kedua percakapan independen: tidak ada yang dilakukan salinan yang masuk ke percakapan asli dengan sendirinya, meskipun dalam sesi di mana cross-session messaging diaktifkan, Claude di 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 hingga v2.1.211, /fork memulai forked subagent sebagai gantinya, yang sekarang adalah /subtask. Ketika agent view dimatikan, /fork mempertahankan perilaku subagent yang di-fork dan /subtask tidak tersedia.

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

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

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

Tempat salinan dimulai tergantung di mana sesi saat ini berjalan:

  • Seperti sesi yang dikirim lainnya, salinan pindah ke worktree miliknya sendiri sebelum mengedit file. Dalam hal ini konfirmasi tidak menyebutkan tempat salinan berjalan.
  • Ketika sesi Anda pindah ke worktree tertautnya setelah dimulai, salinan dimulai kembali di tempat sesi berada sebelum pindah dan, kecuali mengedit di tempat, membuat perubahan kodenya di worktree miliknya sendiri di sana. Ketika worktree Anda di-checkout pada sebuah branch, instruksi itu juga memberi tahu salinan yang tugasnya dibangun di atas pekerjaan Anda untuk mendasarkan branch barunya pada branch Anda, karena branch Anda tetap di-checkout di worktree Anda. Konfirmasi berakhir dengan runs in the origin tree.
  • Ketika Anda meluncurkan sesi di dalam worktree tertaut dari repositori yang memiliki main working tree, salinan dimulai di main working tree itu, dengan aturan worktree-miliknya-sendiri yang sama tetapi tanpa instruksi branch. Konfirmasi juga berakhir dengan runs in the origin tree di sini.
  • Sesi yang diluncurkan di dalam worktree dari tata letak bare repository tidak memiliki main working tree untuk kembali, jadi salinan tetap di tempatnya, 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 flag peluncuran yang tidak akan diwarisi salinan, seperti system prompt yang diganti atau allowlist --tools, tidak dapat di-fork; Claude Code memberitahukan hal itu alih-alih membuat salinan sebagian. Sesi yang dikirim dari agent view dapat di-fork secara normal: salinan diluncurkan dengan definisi agent dan instruksi tambahan yang sama seperti sesi asalnya.

What carries over when you background

Memindahkan ke latar belakang memulai proses baru yang melanjutkan dari percakapan yang disimpan, dan pekerjaan yang sedang berlangsung pindah ke sana: perintah shell latar belakang yang sedang berjalan, subagent yang di-background, workflow dinamis, tugas terjadwal yang Anda buat dengan /loop, dan balasan otomatis Claude terhadap komentar artifact semuanya terbawa dan terus berjalan di sana. Subagent berpindah bersama dengan semua yang dimulainya, jadi subagent hanya terbawa ketika semua pekerjaan itu juga dapat berpindah. Untuk menghentikan pekerjaan yang sedang berlangsung alih-alih membawanya, atur environment variable CLAUDE_DISABLE_ADOPT=1; Claude Code kemudian meminta Anda untuk mengonfirmasi sebelum memindahkan ke latar belakang.

Ketika workflow dinamis masih memiliki subagent yang berjalan, Claude Code bertanya sebelum memindahkan ke latar belakang dengan dialog Background this session?, yang menyebutkan berapa banyak subagent yang akan dimulai ulang. Pilih Stay untuk membiarkan mereka selesai terlebih dahulu. Jika Anda mengonfirmasi, Claude Code memutar ulang run tersebut dalam sesi latar belakang: subagent yang masih berjalan dimulai dari awal, jadi token yang telah mereka gunakan sejauh ini dihabiskan lagi. Lihat Resume after a pause untuk subagent selesai mana yang mengembalikan hasil tersimpannya dan mana yang berjalan lagi.

Claude Code menghentikan pekerjaan yang tidak dapat terbawa, seperti monitor yang sedang berjalan, dan menghentikan subagent yang di-background yang memiliki monitor bersamanya. Ketika ada pekerjaan seperti itu yang berjalan, Claude Code menampilkan dialog Background this session? sehingga Anda dapat mengonfirmasi sebelum pekerjaan itu dihentikan.

Setelah berada di latar belakang, sesi dapat memulai subagent, monitor, dan perintah latar belakang baru, dan semuanya terus berjalan melewati detach dan reattach berikutnya.

Flag konfigurasi dari peluncuran asli terbawa ke sesi yang di-background, jadi server MCP, pengaturan, dan model fallback-nya tetap berlaku:

  • --mcp-config dan --strict-mcp-config
  • --settings
  • --setting-sources
  • --add-dir
  • --plugin-dir
  • --fallback-model
  • --allow-dangerously-skip-permissions

Direktori yang Anda tambahkan selama sesi dengan /add-dir juga terbawa. Membawa --allow-dangerously-skip-permissions membuat bypassPermissions tetap dapat dijangkau dalam sesi yang di-background, tetapi tidak memberikan apa pun yang baru: mode tersebut tetap memerlukan penerimaan interaktif satu kali yang dijelaskan dalam Permission mode, model, and effort.

From your shell

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

claude --bg "investigate the flaky SettingsChangeDetector test"

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

Jika Anda menjalankan claude --bg dari terminal di direktori yang belum Anda percayai, dialog kepercayaan workspace muncul terlebih dahulu dan sesi dimulai setelah Anda menerima. Jika Anda menolak, Claude Code keluar tanpa memulai sesi. Di mana tidak ada dialog yang dapat muncul, seperti dalam skrip, perintah keluar dengan kesalahan Workspace not trusted sebagai gantinya.

Untuk menjalankan subagent tertentu yang telah Anda definisikan, seperti code-reviewer, sebagai agent utama sesi, gabungkan --bg dengan --agent:

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

Jika nama tidak cocok dengan subagent Anda mana pun, peluncuran gagal: Claude Code mencetak peringatan no agent named dan tetap melaporkan sesi sebagai backgrounded, tetapi sesi langsung keluar dengan kesalahan --agent '<name>' not found.

Ketika sesi yang di-background nanti dilanjutkan atau dimulai ulang, Claude Code memulihkan agent dan pembatasan tool-nya; untuk system prompt-nya, lihat System prompt flags in resumed conversations. Claude Code mencari agent di direktori sesi itu sendiri terlebih dahulu, asalkan Anda telah mempercayai workspace itu, jadi agent dengan cakupan proyek tetap dimuat ketika sesi dilanjutkan dari direktori lain. Jika agent tidak lagi ada, sesi berlanjut dengan tool default dan transkripnya terbuka dengan peringatan yang menyebutkan agent tersebut.

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

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

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

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

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

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

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

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

Run a shell command

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

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

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

Perintah berjalan sebagai pekerjaan berbasis PTY dan muncul sebagai baris di agent view, dengan baris output terbaru sebagai statusnya. Pekerjaan shell menjalankan perintah sebagai pengganti Claude, jadi tidak ada model yang dipanggil dan output tidak dikirim ke sesi mana 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 di memori dan tidak ditulis ke disk. Baris dan output-nya dibersihkan secara otomatis sekitar lima menit setelah perintah keluar, jadi bacalah sebelum itu jika Anda memerlukan hasilnya.

How file edits are isolated

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

Claude melewati worktree ketika:

  • Anda memindahkan sesi yang sudah Anda buka ke latar belakang dengan ← atau /background. Sesi itu tetap mengedit file di tempat ia sudah bekerja
  • Sesi sudah berada di dalam git worktree tertaut, baik Claude membuatnya di bawah .claude/worktrees/ atau Anda membuatnya dengan git worktree add di tempat lain
  • File yang sedang diedit Claude berada di dalam git worktree tertaut, seperti yang dibuat sesi atau subagent-nya dengan git worktree add
  • Direktori kerja bukan repositori git dan tidak ada WorktreeCreate hook yang dikonfigurasi
  • Penulisan berada di luar direktori kerja

Untuk mematikan isolasi worktree untuk repositori di mana git 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 terisolasi 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 edit dengan cara yang sama seperti untuk git.

Ketika hook gagal di direktori yang bukan repositori git, Claude melewati isolasi untuk direktori itu dan mengedit direktori kerja di tempat. Di dalam repositori git, sesi yang dipindahkan Claude ke worktree sebelum mengedit tidak dapat mengedit file di checkout bersama sampai perpindahan itu terjadi.

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

Subagent yang dibuat sesi latar belakang mewarisi direktori kerja sesi. Setelah sesi berada di worktree, edit file subagent masuk ke worktree itu, bukan ke salinan kerja Anda. Untuk memberikan subagent worktree terpisah miliknya sendiri, atur isolation: worktree dalam frontmatter-nya atau berikan isolation: "worktree" ketika membuatnya.

Ketika sesi latar belakang telah membuat perubahan kode di worktree yang dimasuki Claude, Claude Code menginstruksikan Claude untuk mengamankan pekerjaan sebelum selesai, sehingga pekerjaan tetap ada jika Anda menghapus sesi dan worktree-nya:

  • Commit dan push: Claude melakukan commit tanpa bertanya, dan melakukan push branch ketika repositori memiliki remote.
  • Draft pull request: Claude membuka satu ketika tugas memerlukannya, dan label #N muncul di baris.
  • Tidak pernah: push ke main atau master, force-push, dan merge.
  • Instruksi git Anda diutamakan: jika tugas, CLAUDE.md, atau memori menyatakan bahwa Anda sendiri yang menangani commit atau push, Claude menyerahkan git kepada Anda.

Sesi yang mengedit checkout yang tidak diisolasinya sendiri tetap bertanya sebelum melakukan commit atau berpindah branch. Ini berlaku ketika isolasi diatur ke "none", ketika perpindahan worktree gagal, atau ketika sesi dimulai di dalam worktree yang sudah ada.

Apa pun tugasnya, Claude mengakhiri pekerjaan dengan laporan yang menyatakan apa yang dilakukannya dan di mana pekerjaan itu berada: jalur, branch, pull request, atau jawabannya sendiri.

What deleting a session removes

Hapus sesi dengan Ctrl+X dua kali di agent view atau dengan claude rm. Kecuali dalam kasus dipertahankan di bawah, sesi keluar dari daftar. Transkripnya tetap ada di mesin Anda melalui claude --resume, dan penghapusan bertahan melewati restart supervisor.

Apa yang terjadi pada worktree yang dibuat Claude untuk sesi:

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

  • claude rm mempertahankannya, bersama dengan baris sesi, ketika worktree memiliki perubahan yang belum di-commit.

  • Baik agent view maupun claude rm tidak menghapus worktree yang sedang digunakan atau dikunci oleh sesi lain yang berjalan, dan menghapus lagi tidak mengubah hal itu. Claude Code mempertahankan worktree dan sesi, serta menyebutkan direktori yang dipertahankan dan alasannya; di agent view, baris sesi menampilkan not deleted. Tutup sesi lain tersebut, lalu hapus lagi.

  • Ketika Anda menghapus sesi yang worktree-nya memiliki commit yang tidak dapat dikonfirmasi Claude Code telah tersimpan di tempat lain, Claude Code mempertahankan worktree dan sesi, dan pesan menyebutkan branch worktree dan berapa banyak commit yang belum di-push. Pesan juga menawarkan dua jalan keluar: push commit tersebut, atau hapus lagi untuk membuangnya.

    Commit yang ada di remote tidak memblokir penghapusan. Begitu juga commit pada salinan lokal branch default remote origin Anda, asalkan branch itu di-checkout di checkout utama Anda, yaitu direktori repositori itu sendiri, bukan worktree.

    Setelah penolakan itu, Anda memilih:

    • Untuk mempertahankan commit, push commit tersebut, atau merge ke branch default itu, lalu hapus sesi lagi.
    • Untuk membuangnya, hapus sesi lagi tanpa push: tekan Ctrl+X dua kali pada barisnya di agent view, atau jalankan perintah claude rm <id> --discard-unpushed yang dicetak oleh penolakan. Ini menghapus sesi dan worktree beserta branch-nya, membuang commit yang belum di-push dan perubahan apa pun yang belum di-commit.

    Ketika Anda menghapus lagi, Claude Code hanya membuang apa yang ditampilkan oleh penolakan: jika worktree mendapatkan commit baru sejak itu, Claude Code mempertahankannya lagi dan menampilkan status yang diperbarui.

    Ketika catatan sesi lain yang telah selesai juga menyebutkan worktree tersebut, worktree tetap ada ketika Anda menghapus lagi; push commit tersebut, lalu hapus lagi.

  • Worktree yang tidak lagi dikenali git, misalnya setelah git worktree prune, tidak memblokir penghapusan. Claude Code menghapus sesi dan membiarkan direktori tetap ada di disk.

  • Ketika git atau WorktreeRemove hook Anda gagal menghapus worktree, Claude Code mempertahankan worktree dan sesi, dan pesan menyebutkan penyebabnya. Untuk hook, pesan menyatakan bagaimana hook berakhir, seperti exited 1, dan mengutip awal stderr-nya. Pesan juga memberi tahu Anda mana dari berikut ini yang perlu dilakukan selanjutnya:

    • Hapus sesi lagi untuk tetap menghapus direktori, dengan menekan Ctrl+X dua kali pada barisnya di agent view atau menjalankan perintah claude rm <id> --force-remove-worktree <worktree-id> yang dicetak oleh penolakan claude rm. Branch worktree tetap ada di repositori.

      Claude Code menawarkan ini hanya ketika dapat mengonfirmasi semua hal berikut:

      • Direktori adalah salah satu worktree tertaut repositori di bawah .claude/worktrees/
      • Baik worktree maupun submodule yang di-checkout tidak memiliki perubahan yang belum di-commit pada file yang dilacak
      • Tidak ada catatan sesi lain yang menyebutkannya

      Ketika Claude Code tidak dapat memverifikasi status checkout submodule, seperti yang digantikan oleh repositori git terpisah, Claude Code juga tidak menawarkan ini.

    • Perbaiki apa yang menghalangi, seperti melakukan commit atau stash perubahan yang belum di-commit, memindahkan repositori git terpisah keluar dari worktree, menutup apa pun yang menggunakan direktori, atau memperbaiki hook, lalu hapus sesi lagi.

    • Hapus direktori sendiri, lalu hapus sesi lagi.

Worktree yang Anda buat sendiri dan tempat Anda memulai sesi dibiarkan di tempatnya dalam kedua cara.

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

  • Agent view meminta tekan Ctrl+X dua kali yang sama sebelum membuangnya. Untuk direktori yang dibuat hook, agent view menjalankan WorktreeRemove hook Anda sebagai gantinya, dan tanpa hook tersebut, agent view menolak penghapusan dan mempertahankan sesi.
  • claude rm mempertahankan sesi dan worktree, dan menyebutkan alasannya.

Kedua jalur mempertahankan direktori yang disebutkan dalam catatan sesi lain yang telah selesai.

Set the model

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

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

Untuk mengubah default pengiriman dari dalam agent view, ketik /model diikuti nama model di 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 override dan kembali ke default pengiriman. Override ini berlaku untuk sisa run claude agents saat ini dan tidak menulis ke file pengaturan Anda. Contoh berikut mengirim satu sesi pada Opus dan sesi berikutnya pada Sonnet:

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

Setiap sesi latar belakang dapat berjalan pada model yang 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 di pemilih untuk peralihan khusus sesi. Peralihan khusus sesi tetap berlaku jika sesi dimulai ulang.
  • Kirim subagent yang frontmatter-nya menetapkan field model.

Permission mode, model, and effort

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

Settings and provider

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

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

LLM gateway

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

Jika Anda justru mengekspor ANTHROPIC_BASE_URL gateway hanya di shell Anda, nilai itu mencapai sesi latar belakang, bersama dengan ANTHROPIC_CUSTOM_HEADERS dan kredensial yang Anda ekspor bersamanya, hanya ketika supervisor itu sendiri dimulai dari shell yang mengekspor gateway yang sama, dan hanya dalam kasus berikut:

  • Anda memindahkan sesi Anda sendiri ke latar belakang dengan ← atau /background
  • Anda mengirim sesi ke direktori tempat Anda berada
  • Anda membangunkan sesi yang dihentikan di direktori tempat Anda berada dengan melampirkan atau membalasnya

Claude Code meneruskan gateway yang berada di depan penyedia cloud. Jika shell tempat Anda mengirim memilih penyedia dan mengekspor endpoint gateway-nya dengan flag bypass auth-nya, Claude Code meneruskan pasangan endpoint-dan-flag tersebut 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 endpoint dan flag tersebut.

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

Permission mode

Mode izin tergantung pada cara Anda memulai sesi:

  • Dipindahkan ke latar belakang dengan /bg atau ←: Claude Code mempertahankan mode izin yang digunakan sesi, jadi sesi yang Anda alihkan ke acceptEdits atau auto tetap dalam mode itu setelah dilepas
  • Dikirim dari agent view yang Anda buka dengan ←: konfigurasi target sendiri didahulukan, dan mode izin sesi asal Anda berlaku ketika tidak ada hal lain yang menetapkannya
  • Dikirim dari claude agents yang dimulai di shell, atau dengan claude --bg: sesi baru dimulai seperti sesi claude baru di direktori itu, kecuali Anda mengirimnya dari agent view yang Anda buka dengan dispatch defaults. Which permission mode a session starts in mencantumkan urutannya

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

  1. permissions.defaultMode direktori target. Dua aturan sumber berlaku:
  2. Mode izin sesi asal Anda

Ketika Claude Code menolak mode suatu sumber karena terlalu permisif, sumber berikutnya dalam daftar yang menentukan. Misalnya, jika Anda mengirim dari sesi plan mode ke direktori yang pengaturan check-in-nya meminta acceptEdits, sesi baru dimulai dalam plan mode. Jika Anda memindahkan defaultMode itu ke ~/.claude/settings.json, pengaturan tersebut berlaku terlepas dari mode izin sesi asal Anda.

Urutan tingkat permisif adalah plan, lalu Manual dan dontAsk, lalu acceptEdits dan auto, yang masing-masing dihitung lebih permisif daripada yang lain, lalu bypassPermissions.

Dispatch defaults

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

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

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

--agent menetapkan subagent yang digunakan ketika prompt pengiriman tidak menyebutkannya, baik dengan @name maupun sebagai kata pertama. Defaultnya adalah pengaturan agent jika diatur, jika tidak, agent claude catch-all bawaan. Menyebutkan subagent di 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 sesuai dengan flag CLI tingkat atas.

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

Default yang aktif muncul di footer di bawah input pengiriman.

Claude Code menolak claude --bg --permission-mode bypassPermissions sampai Anda menerima penafian bypass dengan menjalankan claude --dangerously-skip-permissions sekali secara interaktif, karena mode itu memungkinkan sesi yang tidak Anda pantau bertindak tanpa persetujuan. Memberikan --dangerously-skip-permissions atau --permission-mode bypassPermissions ke claude agents menampilkan penafian yang sama ketika Anda belum menerimanya sebelumnya, dan menerimanya menerapkan bypassPermissions ke sesi yang Anda luncurkan dari tampilan ini. Memberikan --allow-dangerously-skip-permissions juga menampilkan penafian yang sama, dan menerimanya membuat bypassPermissions tersedia dalam siklus Shift+Tab sesi tersebut tanpa memulainya dalam mode itu.

What persists across restarts

Mode izin, model, dan effort yang Anda pilih untuk sesi latar belakang, bersama dengan flag konfigurasi yang dibawanya, semuanya bertahan ketika supervisor nanti 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 effort yang Anda ubah di tengah sesi dengan /model atau /effort juga dipertahankan.

Jika sesi mengambil effort-nya dari pengaturan Anda, bukan dari --effort atau /effort, Claude Code membaca pengaturan Anda lagi setiap kali memulai proses untuk sesi tersebut. Setelah Anda mengedit effort yang disimpan di settings.json, perubahan mencapai sesi yang Anda pindahkan ke latar belakang dengan ← atau /bg, serta restart berikutnya. Effort yang disimpan adalah kunci effortLevel atau entri modelSettings.

Claude Code juga mempertahankan nama yang Anda atur dengan /rename atau Ctrl+R melewati restart itu, sehingga Anda tetap dapat menjalankan claude --resume <name> untuk mencapai sesi.

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

Settings, plugins, and MCP servers

Agent view menerima flag konfigurasi yang sama seperti claude untuk memuat pengaturan, plugin, server MCP, dan direktori tambahan. Agent view menerapkan --settings, --setting-sources, dan --plugin-dir ke dirinya sendiri dan meneruskan setiap flag konfigurasi ke sesi yang Anda kirim darinya, sehingga plugin atau server MCP yang Anda muat dengan cara ini tersedia dalam sesi tersebut.

Flag Efek
--settings <file-or-json> Menimpa pengaturan untuk agent view dan sesi yang dikirim
--setting-sources <sources> Muat hanya sumber pengaturan yang disebutkan, di agent view dan sesi yang dikirim
--add-dir <path> Berikan akses file ke direktori tambahan
--plugin-dir <path> Muat plugin dari direktori lokal
--mcp-config <file-or-json> Muat server MCP dari file konfigurasi atau string JSON
--strict-mcp-config Gunakan hanya server MCP dari --mcp-config, abaikan konfigurasi MCP lainnya. Lihat Exclusive control with managed-mcp.json untuk apa yang dilakukan flag ini di bawah file MCP terkelola

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, --setting-sources, dan --plugin-dir sebelum atau sesudah agents. Tempatkan --add-dir dan --mcp-config setelah agents: jika Anda menempatkan salah satunya sebelum agents, claude agents --json gagal dengan kesalahan unknown option.

Contoh berikut membuka agent view dengan override 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 agent.

Perintah Tujuan
claude agents Buka tampilan agent
claude agents --cwd <path> Buka tampilan agent 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|name> Lampirkan ke sesi di terminal ini
claude logs <id|name> 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 dihapus saat menghapus sesi. Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui claude --resume
claude rm <id> --discard-unpushed <commit>@<worktree-id> Hapus sesi yang penghapusannya ditolak karena commit yang belum di-push, membuang worktree beserta branch dan commitnya. Lewatkan nilai yang tepat yang ditampilkan penolakan; lihat Apa yang dihapus saat menghapus sesi. Memerlukan v2.1.260 atau lebih baru
claude rm <id> --force-remove-worktree <worktree-id> Hapus sesi yang penghapusannya ditolak karena git atau hook WorktreeRemove tidak dapat menghapus worktreenya, menghapus direktori worktree bagaimanapun dan meninggalkan branch-nya di repositori. Lewatkan nilai yang tepat yang ditampilkan penolakan; lihat Apa yang dihapus saat menghapus sesi. Memerlukan v2.1.268 atau lebih baru
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

claude attach dan claude logs dapat menerima sebagian nama sesi yang sedang berjalan sebagai pengganti ID, seperti dalam claude logs "auth refactor". Meneruskan nama memerlukan Claude Code v2.1.290 atau lebih 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. Lihat Baca status sesi dari skrip untuk mengetahui apa arti setiap nilai
pid, status Saat proses masih hidup ID proses dan salah satu dari busy, waiting, atau idle
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

Baca status sesi dari skrip

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

state Apa artinya
working Giliran sedang berjalan, atau sesi berada di antara langkah-langkah pekerjaan yang dijalankannya sendiri, seperti iterasi /loop atau menunggu CI. status memberi tahu Anda apakah prosesnya busy sekarang
blocked Sesi menunggu Anda: pertanyaan yang diajukannya, keputusan izin atau sandbox, kesalahan yang hanya dapat Anda hapus seperti login yang kedaluwarsa, atau prompt pertamanya jika Anda memulainya tanpa prompt. Ketika penundaan adalah prompt terbuka dalam proses langsung, waitingFor menamakannya
done Giliran terakhir menyelesaikan apa yang Anda minta dan sesi siap untuk prompt berikutnya Anda, terlepas dari apakah prosesnya masih hidup atau tidak
failed, stopped Tugas berakhir dengan kesalahan, atau sesi dihentikan

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

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

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

Bagaimana sesi latar belakang dihosting

Claude Code memperlakukan setiap sesi yang tercantum dalam tampilan agent 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 agent atau terminal Anda. Claude Code memulainya pertama kali Anda mengirim sesi ke latar belakang atau membuka tampilan agent, dan Anda tidak perlu mengelolanya sendiri.

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

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

Ketika proses sesi berhenti atau dimulai ulang, perintah shell latar belakang, alur kerja dinamis, dan subagent latar belakang yang Claude mulai di dalamnya dibawa ke proses berikutnya; monitor yang berjalan dan perintah shell yang subagent 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 endpoint 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 agent. Bacanya melalui claude agents --json alih-alih mengurai file
~/.claude/jobs/<id>/tmp/ Direktori awal per-sesi. Panggilan Write dan Edit Claude di sini tidak meminta izin. Dihapus ketika sesi dihapus

Setiap sesi latar belakang memiliki environment variable 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 agent

Untuk mematikan agent latar belakang dan tampilan agent sepenuhnya, atur pengaturan disableAgentView ke true atau atur environment variable CLAUDE_CODE_DISABLE_AGENT_VIEW. Administrator dapat memberlakukan ini melalui pengaturan terkelola.

Pemecahan masalah

`claude agents` menampilkan subagent alih-alih membuka tampilan agent

Jika claude agents mencetak hitungan diikuti oleh subagent yang dikonfigurasi dan kemudian keluar, tampilan agent tidak tersedia di lingkungan Anda. Jalankan claude update untuk menginstal versi terbaru.

Jika tampilan agent masih tidak terbuka setelah memperbarui, periksa apakah telah dimatikan oleh pengaturan atau environment variable.

Tampilan agent terbuka tanpa sesi

Sebelum Anda mengirim sesi pertama Anda, tampilan agent 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 akan dihentikan, dimulai ulang, atau dibiarkan berjalan tanpa pengawasan jika dilepaskan, 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 subagent yang sedang berjalan: alur kerja dinamis masih memiliki subagent yang sedang berjalan. Alur kerja itu sendiri dibawa, tetapi subagent yang sedang berjalannya dimulai ulang dari awal, dan dialog mengatakan berapa banyak.
  • Balasan artifact otomatis: Claude membalas komentar pada artifact dengan sendirinya. Balasan tersebut berlanjut dalam sesi latar belakang, dan dialog mengatakan demikian.

Jalankan /tasks untuk melihat semua yang sedang berjalan, kemudian konfirmasi untuk tetap 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 agent 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 agent, 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.

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 agent 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. Flag --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 environment variable 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 permintaan 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 atau menunggu pesan berikutnya Anda tetap tidak terlampir 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, dijeda pada permintaan izin atau dialog lainnya, atau disematkan tidak dihentikan dengan cara ini, jadi sematkan 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 tool 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 agent 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 worktree.

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
  • Gunakan Claude Code di cloud: jalankan sesi di lingkungan cloud yang dikelola alih-alih secara lokal
  • Projects: biarkan Claude mengoordinasikan sesi cloud paralel dari satu percakapan dan beritahu Anda mana yang Anda butuhkan

Riwayat versi

Agent view telah berkembang pesat selama research preview. Jika Anda menggunakan versi Claude Code yang lebih lama, beberapa perilaku di halaman ini mungkin berbeda; khususnya, claude agents menolak flag yang belum didukungnya dengan kesalahan unknown option. Tabel di bawah mencantumkan kapan setiap flag dan perilaku ditambahkan.

Versi Perubahan
v2.1.290 claude attach dan claude logs dapat menerima sebagian nama sesi yang sedang berjalan sebagai pengganti ID.
v2.1.288 Ctrl+F menemukan sesi berdasarkan nama, dan Alt+↑ / Alt+↓ melompat antar header grup. Keduanya, serta Ctrl+R, dapat diatur ulang pintasannya.
v2.1.287 Filter n:<text> menemukan sesi berdasarkan nama atau prompt pertama. Selama filter apa pun aktif, grup yang Anda ciutkan diperluas untuk menampilkan kecocokannya dan kecocokan pertama dipilih, sehingga Enter membukanya.
v2.1.287 Perintah yang dikirim sebagai balasan intip dijalankan ketika giliran sesi saat ini berakhir, termasuk perintah yang langsung dijalankan begitu Anda mengetiknya di prompt sesi itu sendiri. Balasan yang persis /stop menghentikan sesi seketika.
v2.1.281 Pembatasan --setting-sources terbawa ke sesi yang Anda pindahkan ke latar belakang dengan ← atau /bg dan ke sesi yang Anda dispatch dari agent view. Sebelum rilis ini, sesi yang dihasilkan memuat setiap sumber pengaturan.
v2.1.281 claude --bg, dan perintah yang memulai ulang sesi, memeriksa kepercayaan workspace untuk direktori sesi terlebih dahulu. Dari terminal di direktori itu, dialog kepercayaan muncul jika Anda belum menerimanya; di mana tidak ada dialog yang dapat muncul, seperti dalam skrip, perintah keluar dengan kesalahan Workspace not trusted.
v2.1.274 Setelah pembaruan otomatis, agent view yang Anda tinggalkan selama sekitar satu jam dapat meluncurkan ulang dirinya ke build baru. Ketika melakukannya, ia menyimpan default dispatch yang Anda buka dengannya: --model, --effort, --permission-mode, --allow-dangerously-skip-permissions, dan --agent. Sebelum rilis ini, tampilan yang diluncurkan ulang hanya menyimpan --cwd dan flag konfigurasi seperti --settings dan --mcp-config, jadi sesi yang Anda dispatch setelahnya dimulai tanpa default tersebut.
v2.1.274 Ketika penghapusan ditolak karena git atau hook WorktreeRemove Anda tidak dapat menghapus worktree, submodul yang di-checkout yang diverifikasi Claude Code tidak memiliki perubahan yang belum di-commit pada file yang dilacak tidak memblokir tawaran untuk menghapus lagi dan tetap menghapus direktori. Pekerjaan yang belum di-commit di dalam submodul yang di-checkout dihitung sebagai perubahan yang belum di-commit, dan pesan menyebutkan submodul tersebut. Sebelum rilis ini, checkout submodul apa pun di worktree memblokir tawaran, dengan pesan yang mengatakan worktree berisi repositori bersarang.
v2.1.268 Ketika penghapusan ditolak karena git atau hook WorktreeRemove Anda tidak dapat menghapus worktree, pesan menyebutkan penyebabnya, termasuk bagaimana hook berakhir dan awal stderr-nya. Untuk worktree tertaut di bawah .claude/worktrees/ repositori tanpa perubahan yang belum di-commit pada file yang dilacak, tanpa repositori bersarang di dalamnya, dan tanpa catatan sesi lain yang menyebutkannya, menghapus sesi lagi tetap menghapus direktori, dari agent view atau dengan claude rm <id> --force-remove-worktree <worktree-id>. Sebelum rilis ini, baris hanya menampilkan worktree could not be removed (WorktreeRemove hook failed) atau kesalahan git, stderr hook hanya masuk ke log debug, dan menghapus lagi ditolak dengan cara yang sama.
v2.1.268 Setelah ← pertama menampilkan Press ← again to open agents, atau Press ← again to go back to agents dalam sesi yang terpasang, tekan pertama yang datang setidaknya satu detik kemudian beralih, bahkan ketika tekan yang lebih cepat di antaranya diabaikan. Sebelum rilis ini, setiap tekan yang diabaikan memulai ulang penantian, jadi menekan ← lagi dengan kecepatan yang stabil tidak beralih sampai Anda berhenti selama lebih dari satu detik.
v2.1.260 Ketika Anda memindahkan sesi ke latar belakang, daftar agent sesi lain Anda menampilkan percakapan sekali, sebagai sesi latar belakangnya, dan pesan mereka kepadanya tidak lagi mencapai terminal yang Anda pindahkan. Sebelum rilis ini, terminal itu bisa tetap terdaftar sebagai sesi interaktif kedua di bawah nama percakapan, dan sesi yang telah mengirim pesan ke percakapan sebelum perpindahan terus mengirimkan ke terminal itu.
v2.1.260 Ketika penghapusan ditolak karena commit yang belum di-push, pesan menyebutkan branch worktree dan berapa banyak commit yang belum di-push, dan menghapus sesi lagi membuang worktree beserta commit-nya. Sebelum rilis ini, penolakan hanya mengatakan worktree has commits that are not pushed anywhere, menghapus lagi ditolak dengan cara yang sama, dan menghapus sesi memerlukan mem-push commit atau menghapus worktree secara manual.
v2.1.257 ← melepaskan dari sesi yang terpasang sementara overlay /btw terbuka, bahkan di tengah jawaban, dan overlay dibuka kembali ketika Anda melampirkan berikutnya. Sebelum rilis ini, ← tidak melepaskan sementara overlay terbuka.
v2.1.257 Ketika Anda menjalankan claude --resume <session-id> --bg, Claude Code melanjutkan sesi itu di bawah ID-nya sendiri, atau memulai salinan di bawah ID baru dan mencetak baris note: yang menjelaskan mengapa. --continue, --resume yang kosong, dan --resume dengan nama atau path memulai salinan dengan catatan yang sama. Sebelum rilis ini, --resume dengan --bg selalu memulai salinan di bawah ID baru dan tidak mengatakan apa-apa.
v2.1.257 Ketika Anda dispatch sesi dari agent view yang Anda buka dengan ←, Claude Code memulainya dalam mode izin yang dikonfigurasi direktori target melalui permissions.defaultMode. Ketika direktori tidak menetapkan satu, mode izin sesi yang Anda datangi berlaku. Sebelum rilis ini, sesi yang didispatch selalu dimulai dalam mode izin sesi yang Anda datangi, menimpanya.
v2.1.257 Ctrl+S, Ctrl+T, dan Ctrl+G dalam agent view mengikuti keybindings.json Anda: Ctrl+S dan Ctrl+T melalui tindakan agents:switchView dan agents:togglePin konteks Agents, dan Ctrl+G melalui pengikatan chat:externalEditor konteks Chat. Sebelum rilis ini, agent view mengabaikan keybindings.json dan tombol-tombol ini tetap.
v2.1.257 Memulai layanan latar belakang pulih dari dua penyebab kegagalan. Pada instalasi npm macOS, start selama pembaruan diri menunggu instalasi alih-alih menjalankan placeholder yang diletakkan npm saat mengganti biner. Di Windows, daemon.lock usang yang ditulis sebelum mesin terakhir kali boot, atau yang ID proses tercatatnya sekarang milik proses berbeda, diganti. Sebelum rilis ini, start macOS gagal dengan Error: claude native binary not installed. selama jendela instalasi, dan lock Windows membuat setiap start gagal dengan exited before it became reachable sampai Anda menghapus ~/.claude/daemon.lock.
v2.1.257 Ketika Anda membuka atau dispatch sesi latar belakang sementara proses Claude Code lain mengunduh pembaruan npm, Claude Code terus menunggu hingga dua menit sementara instalasi berjalan, kemudian gagal dengan mengatakan Claude Code is being updated by npm on this machine. Sebelum rilis ini, penantian berhenti pada sepuluh detik, jadi pembukaan gagal dengan Couldn't start the background service sementara unduhan masih berjalan.
v2.1.257 Sesi latar belakang yang menahan pesan lintas sesi untuk persetujuan Anda menampilkan approve message from pada baris Needs input-nya, dengan alamat pengirim dan nama yang diklaim pengirim. Sebelum rilis ini, baris pindah ke Needs input tetapi menyimpan teks sebelumnya, jadi tidak ada dalam claude agents yang menyebutkan pesan yang menunggu atau pengirimnya.
v2.1.257 Prompt yang disimpan dengan Ctrl+S di dalam sesi latar belakang yang dibuka disimpan bersama sesi, jadi Ctrl+S memulihkannya setelah proses sesi dihentikan dan dimulai lagi. Sebelum rilis ini, simpanan hanya hidup dalam proses yang berjalan dan hilang ketika sesi menjadi idle cukup lama hingga prosesnya berhenti, atau ketika dihentikan lalu dibuka kembali.
v2.1.251 Dalam sesi latar belakang yang belum pindah ke worktree, Claude dan subagent yang dihasilkannya dapat mengedit file di dalam worktree git yang ditautkan.
v2.1.251 Claude Code meneruskan gateway penyedia cloud yang diekspor dalam shell tempat Anda dispatch, seperti ANTHROPIC_VERTEX_BASE_URL atau ANTHROPIC_BEDROCK_BASE_URL dengan flag bypass autentikasinya, ke worker sesi di bawah kondisi yang sama dengan ANTHROPIC_BASE_URL. Sebelum rilis ini, jika Anda memindahkan ke latar belakang atau dispatch dari shell yang diautentikasi hanya melalui gateway seperti itu, setiap permintaan yang dibuat sesi gagal, karena endpoint dan flag dijatuhkan dari lingkungannya.
v2.1.251 Ketika sesi latar belakang dimulai sementara proses Claude Code lain menyegarkan marketplace plugin, seperti sesi saudara yang menjalankan pembaruan otomatis marketplace, Claude Code menjaga plugin marketplace itu tetap tersedia. Sebelum rilis ini, sesi seperti itu bisa dimulai tanpa skill, agent, hook, dan server MCP marketplace itu dan tetap seperti itu sepanjang jalannya.
v2.1.248 Shift+Enter dalam input dispatch menyisipkan baris baru, cocok dengan prompt utama, dan Ctrl+Enter dispatch dan melampirkan segera di terminal tempat overlay ? mencantumkan ctrl+enter to start and open. Sebelum rilis ini, Shift+Enter dispatch dan melampirkan.
v2.1.248 Menghapus sesi berhasil ketika commit worktree sudah ada di salinan lokal branch default remote origin Anda dan checkout utama Anda sedang men-checkout branch itu; sebelum rilis ini, penghapusan ditolak dengan has commits that are not pushed anywhere.
v2.1.248 Sesi yang dipindahkan ke latar belakang dengan ← atau /background menahan git worktree lock pada worktree-nya selama berjalan; sebelum rilis ini, memindahkan ke latar belakang melepaskan lock, 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, ditampilkan sebagai dihentikan dengan ended while the background service was off, dan Enter padanya menanyakan sebelum melanjutkan percakapan yang disimpannya. Sebelum rilis ini, sesi seperti itu muncul kembali sebagai kegagalan baru yang diurutkan ke atas daftar, dan satu Enter menarik percakapan berminggu-minggu lalu 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 ditampilkan 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 event 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 ditinggalkan program sebelumnya dalam win32-input-mode. Sebelum rilis ini, Claude Code tidak mendekode catatan tombol 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 tawaran restart, dan Enter pada baris memulai ulang sesi dengan percakapannya; claude attach <id> melaporkan penyebab 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 ulang 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 ulang start 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 home Anda, jadi di macOS dan Linux direktori awal yang dihapus atau dipindahkan tidak lagi memblokir start.
v2.1.246 /fork menyalin percakapan lengkap dari sesi yang sendiri dimulai sebagai salinan dan belum mencatat prompt baru sejak itu: 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 dispatch sementara proses worker-nya masih dimulai, seperti dengan menekan Enter pada barisnya, Claude Code menunggu proses lalu 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 memindahkan sesi bernama ke latar belakang, Claude Code mencantumkannya sekali, dan ketika Anda memindahkan percakapan yang sama ke latar belakang lagi, ia menomori nama baris baru, seperti my-session (2), dengan baris yang ada tetap menyimpan namanya. Sebelum rilis ini, terminal tempat Anda menekan ← bisa muncul dalam claude agents --json sebagai sesi kedua di bawah nama yang sama, dan jika Anda memindahkan percakapan yang sama ke latar belakang lagi, Claude Code menambahkan baris lain di bawah nama yang identik.
v2.1.239 Dengan mode editor vim aktif, menekan Esc dalam input agent view beralih dari mode INSERT ke NORMAL dan menyimpan teks Anda, cocok 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 merge request GitLab, Claude Code menulis label baris dalam sintaks referensi !1234 GitLab. Anda juga dapat menempelkan URL merge request ke dalam input dispatch untuk memilih sesi itu. Sebelum rilis ini, label dirender sebagai #1234, dan URL merge request yang ditempel cocok dengan sesi hanya ketika prompt pertamanya berisi URL tersebut.
v2.1.227 Menghapus sesi mempertahankan sesi dan worktree-nya sementara sesi Claude Code aktif lain berjalan di dalam direktori worktree itu. Agent view menampilkan not deleted pada baris dan alasannya di footer, dan claude rm mencetak kept <id> dengan alasannya, 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 agent view terbuka. Menerima menyimpan kepercayaan untuk workspace itu; menolak keluar tanpa membuka agent view. Sebelum rilis ini, claude agents terbuka tanpa bertanya, jadi sesi yang Anda dispatch darinya berjalan dalam direktori yang belum pernah diminta untuk Anda percayai.

Dengan daftar dikelompokkan berdasarkan direktori, mengarahkan mouse ke baris menyorotinya tanpa mengubah target dispatch; memilih baris dengan tombol panah atau klik tetap mengubah target. Sebelum rilis ini, menggerakkan mouse ke sesi dalam proyek lain secara diam-diam mengubah direktori tempat sesi yang didispatch 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 sendiri sebelum membuat perubahan kode, menjauhi worktree sesi asli, dan mendasarkan branch baru pada branch asli ketika tugasnya dibangun di atas pekerjaan itu. Lihat bagian tertaut untuk kondisi yang tepat. 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 meminta 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 agent view dari mode NORMAL serta INSERT, dan hint footer ← ditampilkan dalam mode NORMAL; sebelum rilis ini gesture dan hint hanya untuk INSERT, dan dalam mode NORMAL ← pada prompt kosong tidak melakukan apa-apa. Mengetik ke dalam input sementara Claude Code menunggu untuk memindahkan sesi ke latar belakang membatalkan peralihan dengan Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. sehingga draf yang diketik tidak hilang.
v2.1.218 Menekan ← dalam dua detik setelah penghapusan yang mengosongkan prompt, atau setelah bergerak melalui riwayat prompt, menampilkan Press ← again to open agents, atau Press ← again to go back to agents dalam sesi yang terpasang, 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 peralihan. Memindahkan sesi latar depan ke latar belakang dengan ← menampilkan Your conversation moved to the background di atas daftar, dan Esc di akar agent view kembali ke percakapan itu alih-alih keluar ke shell, dengan Ctrl+C ganda tetap menjadi cara keluar; jika percakapan tidak dapat dibuka kembali, Claude Code keluar dan mencetak perintah claude --resume untuknya. Di Windows, ← yang ditekan dalam sekitar setengah detik setelah melampirkan menampilkan Ambiguous ←, press again to detach dan melepaskan pada tekan kedua.
v2.1.217 Lencana pull request 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 berupa satu baris, menampilkan status salinan, nama baris agent view-nya, dan ID sesinya untuk claude attach, berakhir dengan runs in the origin tree atau edits this checkout hanya ketika salinan berjalan di working tree utama atau mengedit checkout yang Anda buka. Mengklik nama memindahkan sesi ini ke latar belakang dan membuka agent view dalam sesi salinan. Konfirmasi tidak lagi menyatakan kembali mode izin yang diwarisi salinan; versi sebelumnya mencetak konfirmasi multi-baris tanpa nama yang dapat diklik.

Needs input: /install-github-app dan daftar pengaturan /mcp, yang dijalankan sementara tidak ada yang dilampirkan, menampilkan sesi di bawah Needs input dengan baris yang menyebutkan perintah, dan melampirkan lalu menjalankan kembali perintah akan melanjutkan; dari v2.1.208 hingga v2.1.215 perintah-perintah tersebut ditolak sepenuhnya dalam keadaan itu.

Pemulihan --agent: melanjutkan atau memulai ulang sesi --agent yang dipindahkan ke latar belakang memulihkan system prompt dan pembatasan tool agent, dengan mencari agent di direktori sesi itu sendiri terlebih dahulu, ketika workspace-nya dipercaya; sesi yang agent-nya tidak lagi ada melanjutkan dengan tool default dan system prompt default serta terbuka dengan peringatan yang terlihat, alih-alih diam-diam kembali ke agent default.

Ctrl+X: menekannya dua kali menghapus sesi bahkan ketika upaya penghentian gagal, alih-alih penghentian 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 bukan milik repositori git mana pun dapat dihapus; sebelum rilis ini setiap upaya menghapus sesi seperti itu ditolak. Direktori yang sudah hilang langsung dibersihkan. Tekan ganda di agent view menghapus direktori yang masih memiliki file, dengan menjalankan hook WorktreeRemove Anda untuk direktori yang dibuat hook, kecuali catatan sesi lain juga menyebutkannya. claude rm mempertahankan direktori seperti itu selama masih ada file.
v2.1.214 Sesi yang dipindahkan ke latar belakang dengan ← atau /background dan dibiarkan idle tanpa apa pun yang berjalan dihentikan prosesnya seperti sesi idle lainnya, alih-alih mempertahankan prosesnya dan layanan latar belakang berjalan tanpa batas. Sesi yang selesai dapat dihapus dengan claude rm atau dari agent view setelah layanan latar belakang menjadi idle, dan sesi yang memasuki worktree setelah didispatch dari direktori yang bukan repositori git, seperti folder workspace multi-repo, dapat dihapus dari agent view ketika worktree itu sendiri milik repositori git, karena pembersihan ditentukan dari worktree alih-alih direktori tempat sesi didispatch; kedua penghapusan tersebut 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 berfungsi 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 perintah-perintah tersebut ditolak bahkan dengan terminal dilampirkan.
v2.1.212 /fork dalam sesi interaktif menyalin percakapan ke dalam sesi latar belakang baru yang muncul sebagai barisnya sendiri, dinamai menurut sesi asalnya atau, untuk fork dengan prompt dari sesi tanpa nama, menurut prompt fork, sementara sesi asli terus berjalan; perilaku subagent hasil fork sebelumnya dari /fork pindah ke /subtask. Dengan agent view dimatikan, /fork mempertahankan perilaku subagent hasil fork. Baris yang difokuskan yang menunggu prompt pertamanya menampilkan space to send it a prompt. Ctrl+J menyisipkan baris baru dalam input dispatch pada terminal dengan pelaporan tombol yang diperluas, di mana penekanan tombol tersebut sebelumnya diabaikan, dan overlay ? mencantumkan pintasan tersebut. Hint footer ← dalam sesi interaktif secara singkat menampilkan N done ketika sesi latar belakang selesai sementara tidak ada yang memerlukan input Anda. Mengetik /resume saja dalam agent view membuka pemilih sesi masa lalu dari repositori tempat Anda membuka agent view, termasuk sesi yang dihapus dari daftar, dan memilih salah satu melanjutkannya sebagai sesi latar belakang; sebelum rilis ini /resume tidak tersedia dalam agent view dan sesi yang dihapus hanya dapat dijangkau dengan claude --resume atau /resume dari sesi interaktif. Bentuk yang ditargetkan, dicakup, dan dibatasi tetap menampilkan hint attach to a session to run it yang ditampilkan versi sebelumnya untuk setiap bentuk. Sesi yang menunggu prompt host jaringan sandbox, permintaan input MCP, atau prompt pengaturan terkelola ditampilkan sebagai Needs input alih-alih Working, dalam agent view 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 transkripnya dalam format seperti yang dirender sesi aktif, alih-alih sebagai teks mentah. Sesi yang dihentikan yang transkripnya berada di tempat yang tidak terduga dilanjutkan darinya melalui pemindaian upaya terakhir atas transkrip yang Anda simpan, dan membuka baris yang tidak memiliki transkrip tersimpan menampilkan Press enter again to restart this session fresh, memulai ulangnya dari awal pada tekan kedua; v2.1.211 menampilkan penolakan tanpa cara untuk memulai ulang dari agent view.
v2.1.211 Membangunkan sesi yang dihentikan dengan melampirkan atau membalas dari direktori tempat ia berjalan kembali meneruskan gateway ANTHROPIC_BASE_URL shell Anda, di bawah kondisi yang sama dengan dispatch baru, sehingga sesi yang diautentikasi melalui gateway ANTHROPIC_AUTH_TOKEN dilanjutkan pada gateway alih-alih melaporkan Not logged in. Melampirkan ke sesi yang dihentikan yang dipindahkan ke latar belakang 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 agent view menampilkan penolakan di footer. Mengakhiri proses sesi ← atau /background dari luar Claude Code menandainya dihentikan alih-alih supervisor memulai ulangnya, penghentian yang sudah tercatat di disk dihormati kecuali balasan yang Anda kirim masih menunggu untuk dikirimkan, sesi yang dimulai ulang setelah crash diberi tahu bahwa ia dimulai ulang, dan sesi ← atau /background yang dimulai ulang tidak melanjutkan respons terputus yang lebih lama dari sekitar satu jam. Balasan penamaan sesi yang menjawab atau menolak prompt alih-alih memberinya label, seperti untuk prompt yang sebagian besar berupa tautan, dibuang dan baris mempertahankan nama yang diambil dari teks prompt. Menghapus sesi yang worktree-nya tidak lagi dikenali git berhasil, meninggalkan direktori worktree di disk dan menyebutkan path-nya, alih-alih setiap upaya ditolak. Penghapusan yang ditolak menampilkan alasannya pada baris sesi, termasuk kesalahan git yang mendasarinya 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 menghubungkan kembali alih-alih gagal dengan kesalahan job not found atau still starting, melaporkan sesi yang selesai selama proses melampirkan sebagai keluar, dan menerapkan perubahan ukuran terminal yang dibuat selama melampirkan yang lambat ketika proses melampirkan selesai. Hitungan needs-input ← pada footer prompt muncul di setiap penyedia, termasuk penyedia pihak ketiga yang sebelumnya menampilkan bentuk ← for agents biasa. Memindahkan sesi ke latar belakang dengan ← membawa daftar tugas Claude ke sesi latar belakang alih-alih menjatuhkannya. Baris tempat Anda menekan ← mempertahankan nama yang tebal dan tidak redup setelah pilihan berpindah. claude agents --effort menerima ultracode alih-alih diam-diam menjatuhkannya.
v2.1.208 Melampirkan ke sesi yang prosesnya telah berhenti menampilkan layar terakhir transkripnya 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 untuk sesi ketika prosesnya dimulai lagi; sebelum rilis ini, balasan yang hilang sementara layanan latar belakang tidak dapat dijangkau dibuang. Proses yang binernya sendiri diganti oleh pembaruan tetap 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 lebih lama tidak pernah memulai ulang sesi idle yang dimulai oleh versi lebih baru ke biner lamanya sendiri. Menghapus sesi menghapus worktree-nya bahkan setelah sesi memindahkan worktree ke branch berbeda, dan mempertahankan worktree bersama baris sesi ketika worktree memiliki commit yang belum di-push ke mana pun atau sesi lain mengklaimnya, alih-alih menghancurkan commit atau meninggalkan worktree tanpa pemilik. /install-github-app serta daftar pengaturan /mcp dan 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 hanya mengganti model sesi itu alih-alih juga menyimpan model default Anda.
v2.1.207 Panel intip terbuka dengan kalimat yang dipotong pada baris, seperti pertanyaan persis untuk sesi yang menunggu Anda, dan menampilkan berapa lama sesi yang terblokir telah menunggu sebagai satu baris waiting 3m alih-alih menambahkan stempel waktu yang sama di depan kalimat status dan pertanyaan. Menempelkan teks yang sama lagi dalam input dispatch memperluas placeholder [Pasted text #N] yang diciutkan 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 mempertahankan percakapannya ketika prosesnya dimulai ulang dari agent view.
v2.1.206 Ringkasan baris mengisi sisa lebar baris dan hanya dipotong 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 supervisor dimulai ulang. Override isi permintaan CLAUDE_CODE_EXTRA_BODY yang diekspor dalam shell tempat dispatch mencapai sesi latar belakang alih-alih diabaikan.
v2.1.205 Hint ← pada footer prompt dalam sesi claude biasa menghitung agent latar belakang yang menunggu Anda, seperti ← 2 agents. Ringkasan baris menampilkan laporan satu baris milik sesi itu sendiri, dipotong pada 64 kolom, alih-alih pemanggilan tool mentah atau hitungan done/total; baris yang dikelompokkan per direktori dibuka dengan kata status berwarna. Panel intip terbuka dengan kalimat status lengkap dan, untuk sesi yang menunggu Anda, pertanyaan persisnya di atas input balasan. Sesi yang mengedit, mengomentari, menutup, atau menandai pull request siap dengan gh ditautkan ke pull request tersebut, bukan hanya sesi yang membuat atau men-checkout pull request, push menautkan pull request bahkan ketika nama branch lokal tidak cocok, dan pull request yang output perintah pembuatannya melebihi batas inline juga ditautkan. Giliran tanpa teks yang dapat dibaca mempertahankan 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 tempat dispatch mencapai sesi yang didispatch darinya ke direktori yang sama ketika supervisor berbagi lingkungan gateway itu, alih-alih dijatuhkan sementara kunci API yang diekspor bersamanya dipertahankan. PATH shell tempat dispatch diterapkan ke worker setiap sesi. Menekan ← sementara subagent 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 dispatch juga mencantumkan worktree git terdaftar dari repositori peluncuran yang berada di dalam pohon direktorinya. Effort yang diwarisi dari pengaturan effortLevel mengikuti pengeditan berikutnya pada pengaturan itu alih-alih ditetapkan saat dispatch. Membuka sesi yang dihentikan yang percakapannya sudah terbuka dalam sesi lain yang sedang berjalan ditolak dengan pesan alih-alih menggagalkan baris. Perintah yang tidak tersedia dalam agent view membiarkan teks yang diketik tetap di input. Hook WorktreeCreate yang gagal di luar repositori git tidak lagi memblokir sesi dari mengedit file.
v2.1.202 Nama yang ditetapkan dengan /rename atau Ctrl+R pada sesi latar belakang bertahan ketika supervisor menghentikan dan memulai ulang prosesnya, alih-alih kembali ke nama saat sesi didispatch.
v2.1.200 Versi Claude Code yang lebih lama yang menulis ulang daftar sesi dalam roster.json mempertahankan field yang ditulis oleh versi yang lebih baru, sesuai dengan jaminan state.json yang ada, sehingga sesi yang dimulai oleh versi yang lebih baru tetap 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. Agent view menerapkan flag --plugin-dir yang ditempatkan setelah agents ke autocomplete subagent dan skill miliknya sendiri dalam input dispatch serta ke sesi yang didispatch.
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 mentah. Memindahkan sesi ke latar belakang dengan ← atau /background membawa /color-nya ke baris baru.
v2.1.198 Agent view 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 agent view alih-alih keluar ke shell; Ctrl+Z kembali ke shell. Sesi latar belakang yang mengisolasi pekerjaannya dalam worktree melakukan commit, mem-push branch terisolasinya sendiri, tidak pernah main atau master, dan membuka pull request draf ketika selesai alih-alih bertanya terlebih dahulu. /login berjalan dalam agent view dan membuka dialog masuk. Dialog keluar Background work is running menawarkan Move to background and exit. Handoff saat keluar juga mencakup subagent latar belakang, yang dilanjutkan dari transkrip mereka pada saat dibangunkan berikutnya alih-alih dilaporkan gagal. claude --bg yang dikombinasikan dengan -p atau --print ditolak dengan kesalahan. Host sesi latar belakang meminta izin Local Network macOS pada akses LAN pertama alih-alih gagal dengan connect: no route to host.
v2.1.196 Satu tekan ← memindahkan sesi latar depan ke latar belakang; versi sebelumnya memerlukan dua tekan, dengan hint footer dan konfirmasi. --dangerously-skip-permissions yang diteruskan ke claude agents menampilkan penafian bypass alih-alih diam-diam dijatuhkan. 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 terbaca sebagai kosong saat restart diberi nama baru dengan akhiran .orphaned- alih-alih dihapus.
v2.1.195 Pekerjaan yang sedang berlangsung juga terbawa ketika Anda memindahkan sesi ke latar belakang di Windows; atur CLAUDE_DISABLE_ADOPT=1 untuk menghentikannya. Grup Completed mengisi ruang vertikal yang tersisa dan header dipadatkan pada terminal yang pendek. Versi Claude Code yang lebih lama tidak lagi menjatuhkan field 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 hingga lima detik. Supervisor yang tidak dapat menerima koneksi keluar dan melepaskan lock-nya sendiri.
v2.1.191 claude --bg dengan nama --agent yang tidak cocok dengan subagent Anda mana pun menggagalkan peluncuran: sesi langsung keluar dengan kesalahan --agent '<name>' not found alih-alih berjalan dengan agent default.
v2.1.174 Sesi latar belakang tidak lagi mewarisi variabel endpoint gateway seperti ANTHROPIC_BASE_URL dari shell peluncuran supervisor; supervisor menyediakan snapshot kredensial baru ke worker yang sudah dihangatkan, memperbaiki kesalahan Could not resolve authentication method yang keliru.
v2.1.172 /model dalam input dispatch menetapkan override model dispatch yang dicakup 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 didispatch menghormati pengaturan agent.
v2.1.145 Dikte suara didukung dalam input balasan panel intip dan input dispatch.
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 Agent view diperkenalkan sebagai research preview.