Kelola sesi

Beri nama, lanjutkan, cabang, dan beralih antar percakapan Claude Code. Mencakup --continue, --resume, --from-pr, pemilih /resume, penamaan sesi, ekspor transkrip, 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 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:

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

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.

Setelah sesi diberi nama, kembali ke sesi dengan claude --resume <name> atau /resume <name>. Lihat Lanjutkan sesi untuk cara resolusi nama berperilaku di seluruh worktrees.

{/* min-version: 2.1.196 */}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:

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 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 -p dengan --output-format json atau stream-json untuk 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 --resume untuk mengirim prompt tindak lanjut, seperti permintaan ringkasan, dan tangkap respons terstruktur.
• Bereaksi terhadap peristiwa sesi: baca bidang transcript_path yang diterima hooks dan perintah status line sebagai input. Hook SessionEnd dapat mengarsipkan transkrip ketika sesi berakhir.
• Sematkan Claude dalam aplikasi TypeScript atau Python: gunakan Agent SDK untuk menerima setiap pesan secara terprogram.

Contoh di bawah menggunakan antarmuka kedua. Ini mengirim prompt tindak lanjut ke sesi yang ada dan membaca jawaban dengan jq:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

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:

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