Kelola sesi
Beri nama, lanjutkan, cabang, dan beralih antar percakapan Claude Code. Mencakup
--continue,--resume,--from-pr, pemilih/resume, penamaan sesi, dan tempat penyimpanan transkrip.
Sesi adalah percakapan yang disimpan yang terikat pada direktori proyek. Claude Code menyimpannya secara lokal saat Anda bekerja, sehingga Anda dapat melanjutkan dari tempat Anda berhenti, membuat cabang untuk mencoba pendekatan berbeda, atau beralih antar tugas.
Aplikasi desktop, Claude Code di web, dan ekstensi VS Code masing-masing mempertahankan riwayat sesi mereka sendiri. Halaman ini mencakup CLI:
- Lanjutkan percakapan sebelumnya berdasarkan flag, nama, atau PR
- Beri nama sesi sehingga Anda dapat menemukannya nanti
- Jelajahi sesi dengan pemilih
/resume - Cabang percakapan untuk mencoba pendekatan berbeda
- Ekspor transkrip dan temukan di disk
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 |
Sesi yang dibuat dengan 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>.
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.
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 |
Setelah sesi diberi nama, kembali ke sesi dengan claude --resume <name> atau /resume <name>. Lihat Lanjutkan sesi untuk cara resolusi nama berperilaku di seluruh worktree.
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 |
Setiap baris menampilkan nama sesi jika diatur, jika tidak ringkasan percakapan atau prompt pertama, bersama dengan waktu sejak aktivitas terakhir, jumlah pesan, dan cabang git. Jalur proyek muncul setelah Anda memperluas ke semua proyek dengan 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:
/branch try-streaming-approach
Dari baris perintah, gabungkan --continue atau --resume dengan --fork-session:
claude --continue --fork-session
Sesi asli tidak berubah dan tetap tersedia di pemilih sesi. Konfirmasi /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
Untuk cara pemadatan berinteraksi dengan CLAUDE.md, skills, dan aturan, lihat panduan jendela konteks. Untuk strategi tentang kapan harus menghapus versus memadatkan, lihat Praktik terbaik.
Ekspor dan temukan data sesi
Jalankan /export untuk menyalin percakapan saat ini ke clipboard Anda atau simpan sebagai file teks biasa, dengan pesan dan output alat dirender sebagai teks yang dapat dibaca. Teruskan nama file untuk menulis langsung ke file tersebut.
Transkrip disimpan sebagai JSONL di ~/.claude/projects/<project>/<session-id>.jsonl, di mana <project> berasal dari jalur direktori kerja Anda. Setiap baris adalah objek JSON untuk pesan, penggunaan alat, atau entri metadata. Untuk menyimpan sesi di tempat lain selain ~/.claude, atur CLAUDE_CONFIG_DIR. File lokal ini dihapus setelah 30 hari secara default; ubah ini dengan cleanupPeriodDays.
Untuk menekan penulisan transkrip sepenuhnya, atur CLAUDE_CODE_SKIP_PROMPT_HISTORY, atau dalam mode non-interaktif gunakan --no-session-persistence.
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