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

​
Mulai cepat

Panduan ini mencakup loop tampilan agent 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 agent, jadi Anda dapat pergi dan kembali ke sesi tersebut.
1

Buka tampilan agent

Dari shell Anda, jalankan:
Jika Anda belum menerima dialog kepercayaan workspace untuk direktori tersebut, Claude Code menampilkannya sebelum tampilan agent terbuka, dialog yang sama yang ditampilkan claude. Terima untuk menyimpan kepercayaan untuk workspace dan lanjutkan. Jika Anda menolak, Claude Code keluar tanpa membuka tampilan agent.Tampilan agent terbuka dengan input di bagian bawah dan tabel yang terisi saat sesi dimulai. Tekan Esc untuk kembali ke shell Anda; jika Anda membuka tampilan agent 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 agent 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 agent. Mode izin yang dimulainya tergantung pada cara Anda membuka tampilan agent.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 agent.
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 agent, jalankan /bg di dalamnya, atau tekan ← pada prompt kosong untuk mengirimnya ke latar belakang dan membuka tampilan agent 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 agent 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 agent selesai, dan ketika sesi latar belakang selesai sementara tidak ada yang memerlukan input Anda, petunjuk 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 agent secara default

Untuk membuat claude tanpa argumen membuka tampilan agent 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:
2

Mulai Claude Code

Keluar dari sesi, kemudian jalankan claude tanpa argumen:
Tampilan agent 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 agent.

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

​
Baca status sesi

Setiap baris dimulai dengan ikon yang warna dan animasinya menunjukkan status sesi: Secara terpisah, bentuk ikon memiliki artinya sendiri: 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: 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: /model, /effort, /rename, dan /usage langsung berjalan. Balasan lain masuk ke antrean pesan sesi alih-alih menginterupsi respons, dan berlaku saat input dalam antrean berlaku. Perintah lain 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. Ketika balasan tidak dapat dikirim, pesan kesalahan menyebutkan apakah balasan tersebut disimpan. Balasan dengan awalan ! atau / tidak pernah disimpan. Claude Code mengirim balasan yang disimpan sebagai prompt berikutnya untuk sesi tersebut pada saat berikutnya Anda memulai ulang sesi; kirim lagi balasan lainnya. 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