Kelola banyak agen dengan tampilan agen

Kirim dan kelola banyak sesi Claude Code dari satu layar. Tampilan agen menunjukkan apa yang dilakukan setiap sesi dan mana yang membutuhkan masukan Anda.

Tampilan agen, dibuka dengan claude agents, adalah satu layar untuk semua sesi latar belakang Anda: apa yang sedang berjalan, apa yang membutuhkan masukan Anda, dan apa yang sudah selesai. Kirim sesi baru, pantau keadaan mereka sekilas alih-alih menggulir transkrip, dan campur tangan hanya ketika ada yang membutuhkan Anda. Setiap sesi latar belakang adalah percakapan Claude Code lengkap yang terus berjalan tanpa terminal yang terpasang, sehingga Anda dapat membukanya, membalas, dan pergi kapan saja.

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

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

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

Halaman ini mencakup:

• Mulai cepat: berikan Claude tugas untuk dikerjakan di latar belakang, periksa, dan campur tangan ketika diperlukan
• Pantau sesi dengan tampilan agen, termasuk ikon status, mengintip dan membalas, melampirkan, mengorganisir, dan pintasan keyboard
• Kirim agen baru dari tampilan agen, dari dalam sesi, atau dari shell Anda
• Kelola sesi dari shell
• Bagaimana sesi latar belakang dihosting oleh proses supervisor

Mulai cepat

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

claude agents

Anda dapat menggunakan claude agents sebagai titik masuk utama Anda alih-alih claude: kirim setiap tugas dari tampilan agen, lampirkan ketika Anda menginginkan percakapan lengkap, dan tekan ← untuk kembali ke tabel.

Pantau sesi dengan tampilan agen

Jalankan claude agents untuk membuka tampilan agen. Ini mengambil alih terminal penuh dan mencantumkan setiap sesi yang dikelompokkan berdasarkan status, dengan sesi yang disematkan dan yang membutuhkan Anda di bagian atas. Setiap baris menunjukkan nama sesi, aktivitas saat ini, dan berapa lama yang lalu sesi terakhir berubah.

Secara default, daftar menampilkan setiap sesi latar belakang yang telah Anda mulai, di seluruh semua proyek Anda. Sesi yang bekerja di satu repositori dan sesi lain di worktree berbeda keduanya muncul di sini, terlepas dari direktori mana yang Anda buka tampilan agen dari. Untuk membatasi daftar ke satu proyek, berikan --cwd (memerlukan Claude Code v2.1.141 atau lebih baru):

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

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

Sesi interaktif yang Anda buka di terminal lain tidak muncul sampai Anda mengirimnya ke latar belakang. Subagents dan teammates yang sesi hasilkan tidak tercantum sebagai baris terpisah.

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

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

Membutuhkan masukan
  ✻ power-up design           needs input: double jump or wall climb?       1m

Bekerja
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Selesai
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

Baca status sesi

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

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

Label PR #N yang dapat muncul di tepi kanan baris adalah status permintaan tarik yang dibuka sesi, bukan bagian dari ikon status. Ketika sesi telah membuka lebih dari satu permintaan tarik, label menunjukkan hitungan sebagai gantinya, seperti 3 PRs.

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

Sesi latar belakang tidak memerlukan terminal apa pun yang terbuka untuk terus bekerja. Proses supervisor terpisah menjalankannya, jadi Anda dapat menutup tampilan agen, menutup shell, atau memulai sesi interaktif baru dan pekerjaan yang dikirim terus berlanjut.

Status sesi bertahan di disk melalui pembaruan otomatis dan restart supervisor. Sesi juga dipertahankan ketika mesin Anda tidur. Proses mereka dilanjutkan saat bangun dan supervisor terhubung kembali ke mereka alih-alih memperlakukan celah waktu sebagai menganggur. Mematikan masih menghentikan sesi yang berjalan; lihat Sesi menampilkan gagal setelah shutdown untuk cara memulihkannya.

Ringkasan baris

Ringkasan satu baris di setiap baris dihasilkan oleh model kelas Haiku sehingga baris dapat memberi tahu Anda apa yang dilakukan sesi, apa yang dibutuhkannya, atau apa yang dihasilkannya tanpa membuka transkrip. Saat sesi secara aktif bekerja, ringkasan menyegarkan paling banyak sekali setiap 15 detik, ditambah sekali ketika setiap giliran berakhir.

Dari v2.1.161, ketika sesi menjalankan dua atau lebih item kerja paralel, seperti subagents, perintah shell latar belakang, atau monitor, hitungan done/total seperti 2/5 muncul sebelum teks ringkasan.

Setiap penyegaran adalah satu permintaan kelas Haiku pendek melalui penyedia normal Anda, ditagih dan ditangani di bawah persyaratan penggunaan data yang sama dengan sesi itu sendiri. Pada penyedia pihak ketiga seperti Bedrock, Vertex AI, Microsoft Foundry, dan gateway khusus, permintaan kembali ke model utama sesi ketika tidak ada model Haiku yang dikonfigurasi. Atur ANTHROPIC_DEFAULT_HAIKU_MODEL untuk memilih model untuk ringkasan ini pada penyedia tersebut.

Status permintaan tarik

Ketika sesi membuka permintaan tarik, label PR #1234 muncul di tepi kanan baris, tertaut ke permintaan tarik di terminal yang mendukung hyperlink. Label bertahan ketika Anda mengirim tindak lanjut ke sesi, sehingga permintaan tarik tetap terlihat sementara baris kembali ke kemajuan langsung.

Ketika sesi telah membuka lebih dari satu permintaan tarik, label menunjukkan hitungan sebagai gantinya, seperti 3 PRs, berwarna oleh permintaan tarik terbuka yang paling membutuhkan perhatian. Buka panel intip untuk melihat semuanya.

Nomor permintaan tarik berwarna berdasarkan statusnya:

Untuk sebagian besar tugas, kolom ini adalah tempat Anda mengambil hasilnya: tinjau dan gabungkan permintaan tarik ketika nomornya berubah menjadi hijau.

Intip dan balas

Tekan Space pada baris yang dipilih untuk membuka panel intip. Ini menunjukkan apa yang dibutuhkan sesi dari Anda, output terakhirnya, dan permintaan tarik apa pun yang dibukanya. Sebagian besar waktu ini cukup, dan Anda tidak perlu membuka transkrip lengkap.

Dari v2.1.161, ketika sesi menjalankan item kerja paralel, panel juga menyebutkan yang paling lama berjalan dan berapa lama sudah berjalan, sehingga Anda dapat melihat apa yang ditunggu sesi tanpa melampirkan.

Ketik balasan di panel intip dan tekan Enter untuk mengirimnya ke sesi itu. Ketika sesi mengajukan pertanyaan pilihan ganda, panel intip menunjukkan opsi dan Anda dapat menekan tombol angka untuk memilih satu. Untuk sesi terhalang lainnya, tekan Tab untuk mengisi input dengan balasan yang disarankan yang dapat Anda edit sebelum mengirim. Awali balasan dengan ! untuk mengirim perintah Bash sebagai gantinya.

Dari v2.1.145, dengan dikte suara diaktifkan, tahan atau ketuk tombol push-to-talk Anda saat input balasan difokuskan untuk mendikte balasan alih-alih mengetiknya. Hal yang sama berlaku dalam input pengiriman di bagian bawah tampilan agen.

Gunakan ↑ dan ↓ untuk mengintip sesi yang berdekatan tanpa menutup panel, atau → untuk melampirkan.

Lampirkan ke sesi

Tekan Enter atau → pada baris yang dipilih untuk melampirkan. Tampilan agen diganti oleh sesi interaktif lengkap. Ketika Anda melampirkan, Claude memposting ringkasan singkat tentang apa yang terjadi saat Anda pergi.

Saat dilampirkan, sesi berperilaku seperti sesi Claude Code lainnya: setiap perintah, pintasan keyboard, dan fitur berfungsi.

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 untuk melepaskan dan kembali ke tampilan agen. Jika dialog memiliki fokus dan tidak merespons ←, tekan Ctrl+Z untuk melepaskan segera.

Ctrl+C mempertahankan perilaku interupsi standarnya saat dilampirkan: ini membatalkan respons yang sedang berjalan atau perintah shell ! daripada melepaskan. Menekan Ctrl+C dua kali pada prompt kosong melepaskan, sama seperti di sesi apa pun.

Melepaskan tidak pernah menghentikan sesi latar belakang: ←, Ctrl+Z, /exit, dan Ctrl+C ganda atau Ctrl+D ganda semuanya membiarkannya berjalan. Untuk mengakhiri sesi dari dalamnya, jalankan /stop.

Menekan ← pada prompt kosong berfungsi dari sesi Claude Code apa pun, bukan hanya yang Anda lampirkan dari tampilan agen. Ini mengirim sesi saat ini ke latar belakang dan membuka tampilan agen dengan sesi itu yang dipilih, sehingga Anda dapat beralih sesi tanpa meninggalkan terminal. Baris dibuat bahkan dari sesi segar tanpa riwayat percakapan, jadi → kembali ke sana. Ketika baris itu adalah satu-satunya, tampilan agen menampilkan petunjuk onboarding di bawahnya. Anda dapat mematikan pintasan ini di /config (pengaturan leftArrowOpensAgents).

Atur daftar

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

Dalam grup:

• Tekan Ctrl+T untuk menyematkan sesi ke atas dan menjaga proses tetap berjalan saat menganggur
• Tekan Shift+↑ atau Shift+↓ untuk mengatur ulang sesi
• Tekan Ctrl+R untuk mengganti nama sesi
• Tekan Enter pada header grup untuk menutupnya

Untuk menghapus sesi dari daftar, tekan Ctrl+X untuk menghentikannya dan Ctrl+X lagi dalam dua detik untuk menghapusnya. Menekan Ctrl+X pada header grup menghapus setiap sesi dalam grup itu setelah konfirmasi.

Menghapus menghapus sesi dari tampilan agen. Jika Claude membuat worktree untuk sesi, menghapus menghapus worktree itu juga, termasuk perubahan yang tidak dikomitkan di dalamnya, jadi dorong atau komitkan pekerjaan yang ingin Anda simpan terlebih dahulu. Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat. Transkrip percakapan tetap berada di mesin lokal Anda dan tetap tersedia melalui claude --resume.

Sesi yang selesai lebih lama dilipat menjadi baris … N more untuk menjaga daftar tetap pendek. Kegagalan dan sesi dengan permintaan tarik terbuka selalu tetap terlihat.

Filter sesi

Ketik dalam input pengiriman untuk memfilter alih-alih mengirim:

Pintasan keyboard

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

Kirim agen baru

Anda dapat mengirim sesi latar belakang baru dari tampilan agen, mengirim sesi interaktif yang ada ke latar belakang, atau memulai satu langsung dari shell.

Dari tampilan agen

Ketik prompt dalam input di bagian bawah tampilan agen dan tekan Enter untuk memulai sesi latar belakang baru. Sesi diberi nama secara otomatis dari prompt; ubah namanya nanti dengan Ctrl+R.

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

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

Serangkaian kecil perintah berjalan dalam tampilan agen itu sendiri alih-alih mengirim: /exit dan /quit menutup tampilan agen, /logout menandatangani Anda keluar, dan /model menetapkan model pengiriman. Skills, perintah Anda sendiri, dan built-in yang memperluas prompt seperti /init dikirim ke sesi latar belakang baru sebagai prompt pertamanya. Perintah built-in lainnya menampilkan petunjuk attach to a session to run it sebagai gantinya.

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

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

Kirim ke direktori tertentu

Sesi baru berjalan di direktori tempat Anda membuka tampilan agen. Untuk menargetkan direktori berbeda:

• Buka claude agents di direktori itu.
• Buka claude agents di direktori induk yang menyimpan beberapa repositori dan sebutkan satu dengan @<repo> dalam prompt untuk menjalankan sesi di sana.
• Dari shell, cd ke direktori dan jalankan claude --bg "<prompt>".

Ketika tampilan agen dikelompokkan berdasarkan direktori, direktori baris yang disorot menjadi target pengiriman, sehingga Anda dapat menggulir ke grup dan mengirim ke dalamnya tanpa mengetik ulang jalur.

Dari dalam sesi

Jalankan /background atau aliasnya /bg untuk memindahkan percakapan saat ini ke sesi latar belakang. Berikan prompt seperti /bg run the test suite and fix any failures untuk memberikan satu instruksi lagi terlebih dahulu. Jika Claude sedang merespons ketika Anda menjalankan /bg, respons berlanjut dalam sesi latar belakang.

Melepaskan dari sesi interaktif memulai proses segar yang dilanjutkan dari percakapan yang disimpan, jadi menjalankan subagent, monitor, dan perintah latar belakang tidak ditransfer ke sesi itu. Claude meminta Anda untuk mengonfirmasi sebelum melepaskan ketika ada yang berjalan. Setelah berada di latar belakang, sesi dapat memulai subagent, monitor, dan perintah latar belakang baru, dan yang tersebut terus berjalan di seluruh detach dan reattach berikutnya.

Bendera konfigurasi dari peluncuran asli dibawa ke sesi yang dilepaskan ke latar belakang, sehingga server MCP, pengaturan, dan model fallback-nya tetap berlaku:

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

Direktori yang Anda tambahkan selama sesi dengan /add-dir juga dibawa ke sesi.

Membawa --allow-dangerously-skip-permissions melalui membuat bypassPermissions dapat dijangkau dalam sesi yang dilepaskan ke latar belakang, tetapi tidak memberikan apa pun yang baru. Mode masih memerlukan penerimaan interaktif satu kali yang sama seperti yang dijelaskan dalam Mode izin, model, dan upaya sebelum sesi apa pun dapat menggunakannya.

Dari shell Anda

Berikan --bg untuk memulai sesi yang langsung masuk ke latar belakang:

claude --bg "investigate the flaky SettingsChangeDetector test"

Untuk menjalankan subagent tertentu sebagai agen utama sesi, gabungkan --bg dengan --agent:

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

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

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

Setelah melepaskan ke latar belakang, Claude mencetak ID pendek sesi dan perintah untuk mengelolanya. Ketika Anda memberikan --name, nama muncul setelah ID pendek:

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

Jalankan perintah shell

Untuk menjalankan perintah shell sebagai pekerjaan latar belakang alih-alih sesi Claude, ketik ! sebagai karakter pertama dari input pengiriman tampilan agen. ! ditampilkan sebagai awalan dan semua yang Anda ketik setelahnya adalah perintah. Contoh berikut mengirim pytest -x dari kotak input tampilan agen:

! pytest -x

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

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

Perintah berjalan sebagai pekerjaan yang didukung PTY dan muncul sebagai baris dalam tampilan agen, dengan baris output terbaru sebagai statusnya. Pekerjaan shell menjalankan perintah sebagai pengganti Claude, jadi tidak ada model yang dipanggil dan output tidak dikirim ke sesi apa pun.

Untuk melihat output, lampirkan ke baris, tekan Space untuk mengintip tanpa melampirkan, atau jalankan claude logs <id> dari shell Anda. Output yang ditangkap tetap berada dalam memori dan tidak ditulis ke disk. Baris dan outputnya dibersihkan secara otomatis sekitar lima menit setelah perintah keluar, jadi bacalah sebelum itu jika Anda memerlukan hasilnya.

Bagaimana pengeditan file diisolasi

Setiap sesi latar belakang, baik dimulai dari tampilan agen, /bg, atau claude --bg, dimulai di direktori kerja Anda. Sebelum mengedit file, Claude memindahkan sesi ke git worktree yang terisolasi di bawah .claude/worktrees/, sehingga sesi paralel dapat membaca checkout yang sama tetapi masing-masing menulis ke miliknya sendiri.

Claude melewati worktree ketika:

• Sesi sudah berada di dalam linked git worktree, baik Claude membuatnya di bawah .claude/worktrees/ atau Anda membuatnya dengan git worktree add di tempat lain
• Direktori kerja bukan repositori git dan tidak ada WorktreeCreate hook yang dikonfigurasi
• Penulisan berada di luar direktori kerja

Untuk mematikan isolasi worktree untuk repositori tempat git worktree tidak praktis, atur worktree.bgIsolation ke "none". Sesi latar belakang kemudian mengedit salinan kerja Anda secara langsung tanpa pindah ke worktree terlebih dahulu. Tambahkan pengaturan ke .claude/settings.json proyek:

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

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

Menghapus sesi dalam tampilan agen (Ctrl+X dua kali) menghapus worktree yang Claude buat untuk sesi itu, termasuk perubahan yang belum dikomit, jadi gabungkan atau dorong perubahan yang ingin Anda simpan terlebih dahulu. Menghapus dari shell dengan claude rm menyimpan worktree yang memiliki perubahan yang belum dikomit dan mencetak jalurnya sehingga Anda dapat membersihkannya sendiri. Worktree yang Anda buat sendiri dan mulai sesi di dalamnya dibiarkan di tempat baik cara apa pun.

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

Sebuah subagent yang sesi latar belakang spawn mewarisi direktori kerja sesi, jadi pengeditan filenya mendarat di worktree sesi daripada salinan kerja Anda. Untuk memberikan subagent worktree terpisah sendiri, atur isolation: worktree dalam frontmatter-nya atau berikan isolation: "worktree" saat spawn-nya.

Atur model

Nama model yang ditampilkan di header tampilan agen adalah default pengiriman. Sesi baru yang Anda mulai dari input menggunakan model ini, yang berasal dari pengaturan model dalam pengaturan pengguna Anda. Atur dengan memilih model dalam pemilih /model, atau edit pengaturan secara langsung. Untuk menimpanya untuk seluruh sesi tampilan agen, berikan --model saat membuka tampilan agen. Lihat Mode izin, model, dan upaya.

Untuk mengubah default pengiriman dari dalam tampilan agen, ketik /model diikuti dengan nama model dalam input pengiriman dan tekan Enter. Header diperbarui untuk menampilkan model itu dengan penanda (session), dan sesi yang Anda kirim setelahnya menggunakannya. Ketik /model default untuk menghapus penimpaan dan kembali ke default pengiriman. Penimpaan ini berlangsung untuk sisa dari claude agents saat ini, tidak menulis ke file pengaturan Anda, dan memerlukan Claude Code v2.1.172 atau lebih baru. {/* min-version: 2.1.172 */} Contoh berikut mengirim satu sesi pada Opus dan yang berikutnya pada Sonnet:

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

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

• Dari shell, berikan --model dengan claude --bg.
• Lampirkan ke sesi yang berjalan, buka /model, dan tekan s pada model untuk beralih hanya untuk sesi itu. Perubahan bertahan jika sesi direspawn.
• Kirim subagent yang frontmatter-nya menetapkan bidang model.

Mode izin, model, dan upaya

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

Pemilihan penyedia cloud, seperti CLAUDE_CODE_USE_BEDROCK atau CLAUDE_CODE_USE_VERTEX, dan alias ANTHROPIC_DEFAULT_*_MODEL mengikuti shell yang mengirim sesi. Variabel endpoint gateway seperti ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN pasangannya tidak. Lihat proses supervisor untuk cara sesi latar belakang bersumber pengaturan penyedia dan kredensial.

Mode izin tergantung pada cara Anda memulai sesi. Melepaskan sesi yang ada dengan /bg atau ← mempertahankan mode izin saat ini, jadi sesi yang Anda alihkan ke acceptEdits atau auto tetap dalam mode itu setelah detach. Mengirim dari input tampilan agen atau menjalankan claude --bg dari shell Anda menggunakan defaultMode dari pengaturan direktori itu, atau permissionMode dari frontmatter subagent yang dikirim.

Mode izin, model, dan upaya yang sesi latar belakang dimulai dengan, bersama dengan bendera konfigurasi yang dibawanya, semuanya bertahan ketika supervisor kemudian menghentikan dan memulai ulang prosesnya. Sesi yang Anda luncurkan dengan claude --bg --dangerously-skip-permissions atau claude --bg --permission-mode bypassPermissions tetap dalam bypassPermissions setelah restart itu alih-alih kembali ke defaultMode direktori, dan model atau upaya yang Anda ubah di tengah sesi dengan /model atau /effort disimpan.

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

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

--agent menetapkan subagent yang digunakan ketika prompt pengiriman tidak menyebutkan satu, baik dengan @name atau sebagai kata pertama. Ini default ke pengaturan agent jika satu diatur, jika tidak agen catch-all bawaan claude. Menyebutkan subagent dalam input pengiriman menimpa keduanya.

claude agents juga menerima --dangerously-skip-permissions sebagai singkatan untuk --permission-mode bypassPermissions, dan --allow-dangerously-skip-permissions untuk membuat bypassPermissions tersedia dalam siklus Shift+Tab setiap sesi yang dikirim tanpa memulai dalam mode itu. Keduanya cocok dengan bendera CLI tingkat atas.

Bendera ini ditambahkan di seluruh rilis. Versi sebelumnya menolaknya dengan kesalahan unknown-option.

Sebelum v2.1.157, tampilan agen mengabaikan pengaturan agent dan mengirim agen bawaan claude.

Default aktif muncul di footer di bawah input pengiriman.

Tanpa bendera ini, sesi menggunakan defaultMode dari pengaturan direktori itu atau permissionMode dari frontmatter subagent yang dikirim, dan model yang ditampilkan di header tampilan agen.

Menggunakan bypassPermissions atau auto ditolak sampai Anda telah menerima mode itu dengan menjalankan claude dengannya sekali secara interaktif, karena mode tersebut memungkinkan sesi yang tidak Anda tonton bertindak tanpa persetujuan. Hal yang sama berlaku apakah Anda meneruskan mode ke claude agents atau ke claude --bg --permission-mode.

Pengaturan, plugins, dan server MCP

Tampilan agen menerima bendera konfigurasi yang sama dengan claude untuk memuat pengaturan, plugins, server MCP, dan direktori tambahan. Bendera ini memerlukan Claude Code v2.1.142 atau lebih baru. Setiap bendera berlaku untuk tampilan agen itu sendiri dan diteruskan ke setiap sesi yang Anda kirim darinya, jadi plugin atau server MCP yang Anda muat dengan cara ini tersedia di sesi tersebut juga.

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

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

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

Kelola sesi dari shell

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

Bagaimana sesi latar belakang dihosting

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

Proses supervisor

Sesi latar belakang dihosting oleh proses supervisor per-pengguna, terpisah dari terminal Anda dan dari tampilan agen. Supervisor dimulai secara otomatis pertama kali Anda mengirim sesi ke latar belakang atau membuka tampilan agen, dan Anda tidak mengelolanya secara langsung.

Supervisor menjaga satu proses worker yang sudah dipanaskan sebelumnya siap sehingga pengiriman dari tampilan agen atau claude --bg dimulai tanpa penundaan peluncuran dingin. Ketika Anda mengirim, supervisor menugaskan worker yang sudah dipanaskan sebelumnya ke sesi Anda, menerapkan direktori, pengaturan, dan kredensial sesi itu ke dalamnya, dan kemudian memulai pengganti untuk pengiriman berikutnya. Jika tidak ada worker yang sudah dipanaskan sebelumnya yang sehat tersedia, supervisor meluncurkan proses segar sebagai gantinya.

Supervisor dan sesinya mengautentikasi dengan kredensial yang sama dengan sesi interaktif Anda dan tidak membuat koneksi jaringan tambahan di luar API model. Variabel pemilihan penyedia seperti CLAUDE_CODE_USE_BEDROCK dan alias ANTHROPIC_DEFAULT_*_MODEL dibaca dari shell yang mengirim setiap sesi dan diterapkan ke workernya.

{/* min-version: 2.1.174 */}Sesi latar belakang tidak mewarisi variabel titik akhir gateway seperti ANTHROPIC_BASE_URL, variabel URL dasar Bedrock, Vertex, dan Foundry yang setara, atau ANTHROPIC_AUTH_TOKEN yang berpasangan dari shell yang memulai supervisor atau dari shell pengiriman. Sesi menggunakan kredensial yang disimpan Anda dan nilai env apa pun dalam pengaturan direktori proyek sebagai gantinya. Untuk mengarahkan sesi latar belakang dalam proyek ke gateway LLM, atur ANTHROPIC_BASE_URL dalam blok env settings.json .claude/ proyek itu daripada mengekspornya di shell Anda. Sebelum v2.1.174, sesi latar belakang mewarisi variabel-variabel ini dari shell peluncuran supervisor, sehingga dapat menggunakan gateway yang telah Anda konfigurasi di shell itu alih-alih yang dikonfigurasi untuk direktori proyek.

Setiap sesi latar belakang adalah proses Claude Code-nya sendiri, dikelola oleh supervisor daripada terikat pada terminal Anda. Sesi yang secara aktif bekerja, menunggu masukan Anda, atau memiliki terminal yang terpasang membuat prosesnya tetap berjalan. Perintah shell latar belakang yang berjalan, subagen, alur kerja dinamis, atau monitor dihitung sebagai pekerjaan aktif, jadi proses yang berjalan lama seperti server dev membuat sesi tetap hidup.

Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Sesi yang Anda pin dengan Ctrl+T dikecualikan dan membuat prosesnya tetap berjalan saat idle. Transkrip dan status tetap di disk, dan lain kali Anda melampirkan, mengintip, atau membalas sesi yang dihentikan, supervisor memulai proses segar dari tempat ia berhenti. Ketika setiap sesi selesai dan tidak ada terminal yang terhubung, supervisor itu sendiri keluar dan dimulai lagi lain kali Anda membutuhkannya.

Baris kosong yang tersisa dari menekan ← yang tidak pernah diberi prompt dihapus sepenuhnya setelah sekitar lima menit sehingga daftar membersihkan dirinya sendiri. Sesi yang dimulai dengan claude --bg dan sesi yang menunggu prompt pengaturan seperti dialog kepercayaan tidak dihapus dengan cara ini.

Ketika host kekurangan memori, supervisor menghentikan sesi idle non-pin terlebih dahulu dan menghentikan sesi pin idle hanya jika itu tidak membebaskan apa pun.

Supervisor memantau biner Claude Code yang diinstal di disk dan memulai ulang ke versi baru setelah auto-updater reguler menggantinya. Ini adalah pengawasan file lokal, bukan pemeriksaan jaringan. Sesi latar belakang adalah proses terlepas, jadi mereka terus berjalan melalui restart dan supervisor baru terhubung kembali ke mereka. Sesi pin idle juga dimulai ulang di tempat ke versi baru sehingga mengambil pembaruan tanpa Anda melampirkan kembali.

Tempat status disimpan

Status sesi disimpan di bawah direktori konfigurasi Claude Code Anda. Jika Anda menetapkan CLAUDE_CONFIG_DIR, supervisor menggunakan direktori itu alih-alih ~/.claude dan berjalan sebagai instans terpisah dengan sesinya sendiri.

Setiap sesi latar belakang memiliki variabel lingkungan CLAUDE_JOB_DIR yang diatur ke direktori ~/.claude/jobs/<id> nya, jadi perintah shell yang dijalankan sesi dapat menulis file sementara ke $CLAUDE_JOB_DIR/tmp tanpa bertabrakan dengan sesi paralel.

Untuk memeriksa status ini tanpa membaca file secara langsung, jalankan claude daemon status. Ini melaporkan apakah supervisor dapat dijangkau, ID proses dan versinya, direktori soket, dan berapa banyak sesi latar belakang yang aktif. /doctor mencakup ringkasan pemeriksaan yang sama.

Perintah ini juga memperingatkan ketika supervisor yang berjalan berada pada versi yang berbeda dari claude yang Anda panggil, yang terjadi setelah pembaruan yang belum dimulai ulang oleh supervisor. Peringatan menunjukkan kedua versi dan memberi tahu Anda untuk menjalankan claude daemon stop --any untuk mengambil versi baru. Ketika Claude Code diinstal sebagai layanan OS, perintah yang disarankan adalah claude daemon stop tanpa flag.

Di Windows, claude daemon status menampilkan kesalahan file yang mendasar ketika file kunci pipa daemon terkunci atau tidak dapat dibaca alih-alih melaporkan kegagalan koneksi generik.

Matikan tampilan agen

Untuk mematikan agen latar belakang dan tampilan agen sepenuhnya, atur pengaturan disableAgentView setting ke true atau atur variabel lingkungan CLAUDE_CODE_DISABLE_AGENT_VIEW. Administrator dapat memberlakukan ini melalui pengaturan terkelola.

Troubleshooting

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

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

Jika tampilan agen masih tidak terbuka setelah memperbarui, periksa apakah telah dimatikan oleh pengaturan atau variabel lingkungan.

Tampilan agen terbuka tanpa sesi

Sebelum Anda mengirim sesi pertama Anda, tampilan agen menampilkan petunjuk onboarding singkat dengan contoh prompt sebagai pengganti daftar sesi. Ketik prompt dalam input di bagian bawah dan tekan Enter untuk mengirim sesi pertama Anda.

Tidak dapat membuka agen karena pekerjaan sedang berjalan di latar belakang

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

Prompt ditolak karena terlalu pendek

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

Sesi menampilkan sebagai gagal setelah shutdown

Mematikan atau memulai ulang mesin Anda menghentikan sesi latar belakang yang sedang berjalan, sehingga sesi tersebut menampilkan sebagai gagal saat Anda berikutnya membuka tampilan agen. Lampirkan, intip, atau balas sesi apa pun dan sesi itu dimulai ulang dari tempat ia berhenti.

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

Tampilan agen mengatakan layanan latar belakang tidak merespons

Jika melampirkan, mengintip, atau claude logs melaporkan bahwa layanan latar belakang tidak merespons, proses supervisor kemungkinan besar telah macet. Hentikan dan biarkan claude agents berikutnya memulai yang baru. Untuk menjaga sesi latar belakang Anda tetap berjalan melalui restart, berikan --keep-workers:

claude daemon stop --any --keep-workers

Supervisor baru terhubung kembali ke sesi yang sedang berjalan. Tanpa --keep-workers, perintah mengakhiri sesi latar belakang juga. Bendera --any mengonfirmasi Anda ingin menghentikan supervisor yang dimulai sesuai permintaan daripada sebagai layanan yang diinstal, yang merupakan default.

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

Pengiriman gagal dengan `Could not resolve authentication method`

{/* min-version: 2.1.174 */}Jika pengiriman latar belakang gagal dengan Could not resolve authentication method sementara sesi interaktif mengautentikasi secara normal, worker yang menerima pengiriman tidak mengambil kredensial. Pada v2.1.174 dan yang lebih baru, supervisor menyediakan snapshot kredensial segar saat menugaskan worker yang sudah dipanaskan sebelumnya, jadi kesalahan ini berarti tidak ada kredensial yang disimpan tersedia untuk proses supervisor itu sendiri. Konfirmasi Anda telah menjalankan /login atau mengonfigurasi kunci API, kemudian hentikan supervisor:

claude daemon stop --any --keep-workers

claude agents atau claude --bg berikutnya memulai supervisor segar yang membaca kredensial yang disimpan Anda. Jika Anda mengautentikasi dengan variabel lingkungan seperti ANTHROPIC_API_KEY daripada /login, jalankan perintah berikutnya dari shell tempat variabel diatur.

Lihat referensi kesalahan untuk daftar lengkap penyebab dan perbaikan. Sebelum v2.1.174, worker yang sudah dipanaskan sebelumnya yang duduk menganggur dapat menampilkan kesalahan ini saat ditugaskan ke pengiriman bahkan ketika kredensial Anda valid. Tingkatkan untuk memulihkan.

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

Di macOS, host sesi latar belakang berjalan sebagai prosesnya sendiri dan meminta akses ke folder yang dilindungi secara terpisah dari terminal Anda. Jika sesi latar belakang melaporkan Operation not permitted saat membaca ~/Desktop, ~/Documents, ~/Downloads, atau lokasi yang dilindungi lainnya, berikan akses di System Settings di bawah Privacy & Security > Files and Folders, atau aktifkan Full Disk Access untuk entri tersebut.

Dengan installer asli, entri muncul sebagai Claude Code dan pemberian akses tetap ada di seluruh pembaruan. Dengan metode instalasi lain seperti Homebrew atau npm, entri menampilkan jalur biner dan mungkin perlu diberikan akses lagi setelah memperbarui.

Sesi lambat merespons setelah melampirkan

Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Melampirkan memulai proses segar dari tempat ia berhenti, yang membutuhkan waktu sebentar. Sesi yang bekerja, menunggu Anda, atau disematkan tidak dihentikan dengan cara ini, jadi semat sesi dengan Ctrl+T untuk menjaganya tetap responsif.

`.claude/worktrees/` penuh

Menghapus sesi dalam tampilan agen menghapus worktree yang dibuat Claude untuk sesi tersebut. claude rm menyimpan worktree yang memiliki perubahan yang belum dikomit dan mencetak jalurnya. Daftar entri sisa dengan git worktree list di direktori proyek dan hapus masing-masing dengan git worktree remove <path>. Lihat Bersihkan worktrees.

Keterbatasan

Tampilan agen adalah pratinjau penelitian dengan keterbatasan berikut:

• Batas laju berlaku: sesi latar belakang menggunakan kuota langganan Anda sama seperti sesi interaktif, jadi menjalankan sepuluh agen secara paralel menggunakan kuota kira-kira sepuluh kali lebih cepat daripada menjalankan satu.
• Sesi bersifat lokal: sesi latar belakang berjalan di mesin Anda. Sesi ini dipertahankan di seluruh tidur tetapi berhenti jika mesin dimatikan.
• Worktrees yang dibuat Claude dihapus dengan sesi di tampilan agen: gabungkan atau dorong perubahan sebelum menghapus sesi yang mengedit file di worktree-nya sendiri. claude rm menyimpan worktree yang memiliki perubahan yang belum dilakukan; worktree yang Anda buat sendiri dibiarkan di tempat.

Sumber daya terkait

Untuk cara lain menjalankan Claude secara paralel, lihat:

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