Lanjutkan sesi
Sesi disimpan secara berkelanjutan ke file transkrip lokal saat Anda bekerja, sehingga Anda dapat kembali ke satu setelah keluar atau menjalankan/clear. Gunakan titik masuk ini:
| Perintah | Apa yang dilakukannya |
|---|---|
claude --continue | Melanjutkan sesi terbaru di direktori saat ini |
claude --resume | Membuka pemilih sesi |
claude --resume <name> | Melanjutkan sesi bernama secara langsung |
claude --from-pr <number> | Melanjutkan sesi yang ditautkan ke permintaan tarik tersebut |
/resume | Beralih ke percakapan berbeda dari dalam sesi aktif |
claude -p atau Agent SDK tidak muncul di pemilih sesi, tetapi Anda masih dapat melanjutkan satu dengan meneruskan ID sesinya ke claude --resume <session-id>. Jalankan ini dari direktori tempat sesi dimulai: pencarian ID sesi dibatasi pada direktori proyek saat ini dan git worktrees-nya, jadi sesi yang dibuat di tempat lain melaporkan No conversation found with session ID: <session-id>.
Tempat pemilih sesi mencari
Sesi disimpan per direktori proyek. Secara default, pemilih sesi menampilkan sesi interaktif dari worktree saat ini, ditambah sesi yang dimulai di tempat lain yang menambahkan direktori saat ini dengan/add-dir. Gunakan Ctrl+W untuk memperluas ke semua worktree repositori atau Ctrl+A untuk memperluas ke setiap proyek di mesin ini.
Dari v2.1.169, memindahkan sesi dengan /cd memindahkannya ke penyimpanan proyek direktori baru, sehingga muncul di pemilih direktori tersebut setelahnya. Sejak v2.1.196, sesi yang dipindahkan tetap keluar dari pemilih direktori lama bahkan setelah kerusakan atau keluar paksa. Pada versi sebelumnya, sesi juga dapat muncul kembali di daftar direktori lama setelah keluar yang tidak bersih ketika jalur lama berisi karakter khusus seperti garis bawah.
Memilih sesi dari worktree lain dari repositori yang sama melanjutkannya di tempat. Memilih sesi dari proyek yang tidak terkait menyalin perintah cd dan resume ke clipboard Anda.
Melanjutkan berdasarkan nama diselesaikan di seluruh repositori saat ini dan worktree-nya. Kedua bentuk mencari kecocokan yang tepat dan melanjutkannya secara langsung bahkan jika berada di worktree berbeda:
| Perintah | Kecocokan tepat | Nama ambigu |
|---|---|---|
claude --resume <name> | Melanjutkan secara langsung | Membuka pemilih sesi dengan nama yang sudah diisi sebagai istilah pencarian |
/resume <name> | Melanjutkan secara langsung | Melaporkan kesalahan; jalankan /resume tanpa argumen untuk membuka pemilih sesi |
Beri nama sesi Anda
Berikan sesi nama deskriptif sehingga dapat ditemukan di pemilih sesi dan dapat dilanjutkan berdasarkan nama. Ini paling penting ketika Anda mengerjakan beberapa tugas secara paralel.| Kapan | Cara mengatur nama |
|---|---|
| Saat startup | claude -n auth-refactor |
| Selama sesi | /rename auth-refactor. Nama juga muncul di bilah prompt |
| Dari pemilih sesi | Sorot sesi dan tekan Ctrl+R |
| Pada penerimaan rencana | Menerima rencana dalam mode rencana memberi nama sesi dari konten rencana kecuali Anda sudah menetapkan satu |
claude --resume <name> atau /resume <name>. Lihat Lanjutkan sesi untuk cara resolusi nama berperilaku di seluruh worktrees.
Sesi interaktif yang tidak pernah Anda beri nama masih mendapatkan nama tampilan default saat dimulai. Memerlukan Claude Code v2.1.196 atau lebih baru. Default menggabungkan nama direktori kerja dengan akhiran dua karakter, misalnya my-app-3f, dan mengidentifikasi sesi dalam daftar sesi yang sedang berjalan, seperti tampilan agen dan output claude agents --json.
Default bukan pegangan resume: claude --resume <name>, /resume <name>, dan pemilih sesi hanya cocok dengan nama yang Anda tetapkan. Memberi nama sesi menggantikan default.
Gunakan pemilih sesi
Jalankan/resume di dalam sesi, atau claude --resume tanpa argumen, untuk membuka pemilih sesi interaktif. Gunakan pintasan keyboard ini untuk menavigasi, mencari, dan memperluas daftar:
| Pintasan | Tindakan |
|---|---|
↑ / ↓ | Navigasi antar sesi |
→ / ← | Perluas atau ciutkan sesi yang dikelompokkan |
Enter | Lanjutkan sesi yang disorot |
Space | Pratinjau konten sesi. Ctrl+V juga berfungsi di terminal yang tidak menangkapnya sebagai tempel |
Ctrl+R | Ubah nama sesi yang disorot |
/ atau karakter yang dapat dicetak lainnya selain Space | Masuk mode pencarian dan filter sesi. Tempel URL permintaan tarik atau gabung GitHub, GitHub Enterprise, GitLab, atau Bitbucket untuk menemukan sesi yang membuatnya |
Ctrl+A | Tampilkan sesi dari semua proyek di mesin ini. Tekan lagi untuk kembali ke repositori saat ini |
Ctrl+W | Tampilkan sesi dari semua worktree repositori saat ini. Tekan lagi untuk kembali ke worktree saat ini. Hanya ditampilkan di repositori multi-worktree |
Ctrl+B | Filter ke sesi dari cabang git saat ini. Tekan lagi untuk menampilkan semua cabang |
Esc | Keluar dari pemilih sesi atau mode pencarian |
Ctrl+A.
Sesi yang dicabangkan dibuat dengan /branch, /rewind, atau --fork-session dikelompokkan di bawah sesi akar mereka. Tekan → untuk memperluas grup.
Cabang sesi
Pencabangan membuat salinan percakapan sejauh ini dan beralih Anda ke dalamnya, meninggalkan yang asli tetap utuh. Gunakan untuk mencoba pendekatan berbeda tanpa kehilangan jalur yang Anda jalani. Dari dalam sesi, jalankan/branch dengan nama opsional:
--continue atau --resume dengan --fork-session:
/branch mencetak dua ID sesi: cabang baru yang sekarang Anda masuki dan yang asli. Untuk kembali ke yang asli, teruskan ID-nya ke /resume, gunakan pemilih sesi, atau jalankan /resume <original-name>. Izin yang Anda setujui dengan “izinkan untuk sesi ini” tidak dibawa ke cabang baru. Jika Anda melanjutkan sesi yang sama di dua terminal tanpa forking, pesan dari keduanya saling bersisipan menjadi satu transkrip.
Untuk rewind berbasis checkpoint dalam satu sesi, lihat Checkpointing.
Kelola konteks dalam sesi
Perintah ini mengontrol apa yang ada di jendela konteks tanpa meninggalkan sesi:/clear: mulai segar dengan konteks kosong. Percakapan sebelumnya disimpan dan dapat dilanjutkan/compact [instructions]: ganti riwayat dengan ringkasan, secara opsional berfokus pada apa yang Anda tentukan/context: tampilkan apa yang saat ini mengonsumsi konteks
Ekspor dan temukan data sesi
Jalankan/export untuk membuka menu yang memungkinkan Anda menyalin percakapan saat ini ke clipboard atau menyimpannya sebagai file teks biasa, dengan pesan dan output alat dirender sebagai teks yang dapat dibaca. Teruskan nama file untuk melewati menu dan menulis langsung ke file tersebut.
Akses percakapan dari skrip
/export menghasilkan transkrip yang dirender untuk dibaca oleh seseorang. Antarmuka di bawah ini menghasilkan data terstruktur untuk skrip diurai: hasil JSON dari suatu run, jalur ke file transkrip sesi, atau aliran peristiwa langsung. Pilih berdasarkan apa yang memicu skrip:
- Jalankan Claude sekali dan tangkap hasilnya: panggil
claude -pdengan--output-format jsonataustream-jsonuntuk menangkap hasil, ID sesi, penggunaan, dan biaya dari run non-interaktif sebagai JSON terstruktur. - Tanyakan pertanyaan ke sesi yang ada: teruskan ID sesi ke
claude -p --resumeuntuk mengirim prompt tindak lanjut, seperti permintaan ringkasan, dan tangkap respons terstruktur. - Bereaksi terhadap peristiwa sesi: baca bidang
transcript_pathyang diterima hooks dan perintah status line sebagai input. HookSessionEnddapat mengarsipkan transkrip ketika sesi berakhir. - Sematkan Claude dalam aplikasi TypeScript atau Python: gunakan Agent SDK untuk menerima setiap pesan secara terprogram.
jq:
Tempat transkrip disimpan
Secara default, transkrip disimpan sebagai JSONL di~/.claude/projects/<project>/<session-id>.jsonl, di mana <project> adalah jalur direktori kerja Anda dengan karakter non-alfanumerik diganti dengan -. Setiap baris adalah objek JSON untuk pesan, penggunaan alat, atau entri metadata. Format entri bersifat internal untuk Claude Code dan berubah antar versi, jadi skrip yang mengurai file ini secara langsung dapat rusak pada rilis apa pun. Untuk membangun data sesi, gunakan /export atau antarmuka skrip sebagai gantinya.
Lokasi, retensi, dan perilaku penulisan dapat dikonfigurasi:
| Untuk | Atur | Di mana |
|---|---|---|
Pindahkan penyimpanan dari ~/.claude | CLAUDE_CONFIG_DIR | Variabel lingkungan |
| Ubah retensi 30 hari | cleanupPeriodDays | settings.json |
| Tekan penulisan transkrip di semua mode | CLAUDE_CODE_SKIP_PROMPT_HISTORY | Variabel lingkungan |
| Tekan penulisan untuk satu run non-interaktif | --no-session-persistence | Flag CLI dengan claude -p |
Lihat juga
Halaman-halaman ini mencakup mekanik sesi dan paralelisme terkait:- Worktrees: jalankan sesi paralel terisolasi di cabang terpisah
- Checkpointing: putar ulang kode dan percakapan ke titik sebelumnya
- Jendela konteks: apa yang mengisi konteks dan apa yang bertahan dari pemadatan
- Mode non-interaktif: perilaku sesi di bawah
claude -p