管理 sessions

命名、恢復、分支和在 Claude Code 對話之間切換。涵蓋 --continue、--resume、--from-pr、/resume 選擇器、session 命名、匯出文字記錄，以及文字記錄的儲存位置。

session 是與專案目錄相關聯的已儲存對話。Claude Code 在您工作時將其儲存在本地，因此您可以從中斷的地方繼續、分支以嘗試不同的方法，或在任務之間切換。

桌面應用程式、Claude Code 網頁版和 VS Code 擴充功能各自維護自己的 session 歷史記錄。本頁涵蓋 CLI。

恢復 session

Sessions 在您工作時會持續儲存到本地文字記錄檔案，因此您可以在退出或執行 /clear 後返回到一個。使用這些進入點：

使用 claude -p 或 Agent SDK 建立的 sessions 不會出現在 session 選擇器中，但您仍然可以透過將其 session ID 傳遞給 claude --resume <session-id> 來恢復它。從啟動 session 的目錄執行此命令：session ID 查詢的範圍限於目前專案目錄及其 git worktrees，因此在其他地方建立的 session 會報告 No conversation found with session ID: <session-id>。

session 選擇器查看的位置

Sessions 按專案目錄儲存。預設情況下，session 選擇器顯示來自目前 worktree 的互動式 sessions，以及在其他地方啟動並使用 /add-dir 新增目前目錄的 sessions。使用 Ctrl+W 擴展到儲存庫的所有 worktrees，或使用 Ctrl+A 擴展到此機器上的每個專案。

從 v2.1.169 開始，使用 /cd 移動 session 會將其重新定位到新目錄的專案儲存空間，因此之後會出現在該目錄的選擇器中。從 v2.1.196 開始，移動的 session 即使在當機或強制退出後，也會保持不在舊目錄的選擇器中。在較早的版本上，當舊路徑包含特殊字元（例如底線）時，在不乾淨的退出後，它也可能在舊目錄的清單中重新出現。

從同一儲存庫的另一個 worktree 選擇 session 會在原地恢復它。從不相關的專案選擇 session 會將 cd 和恢復命令複製到您的剪貼簿。

按名稱恢復會在目前儲存庫及其 worktrees 中解析。兩種形式都會尋找完全相符的項目，並直接恢復它，即使它位於不同的 worktree 中：

命名您的 sessions

為 sessions 提供描述性名稱，以便在 session 選擇器中找到它們並按名稱恢復。當您並行處理多個任務時，這最為重要。

session 命名後，使用 claude --resume <name> 或 /resume <name> 返回到它。請參閱恢復 session 以了解名稱解析在 worktrees 中的行為方式。

{/* min-version: 2.1.196 */}您從未命名的互動式 sessions 在啟動時仍會獲得預設顯示名稱。需要 Claude Code v2.1.196 或更新版本。預設名稱結合了工作目錄的名稱和一個兩字元的後綴，例如 my-app-3f，並在執行中 sessions 的列表中識別該 session，例如 agent view 和 claude agents --json 輸出。

預設名稱不是恢復控制代碼：claude --resume <name>、/resume <name> 和 session 選擇器只符合您設定的名稱。命名 session 會取代預設名稱。

使用 session 選擇器

在 session 內執行 /resume，或不帶引數執行 claude --resume，以開啟互動式 session 選擇器。使用這些快捷鍵來導航、搜尋和擴展清單：

每一列顯示 session 名稱（如果已設定），否則顯示對話摘要或第一個提示，以及自上次活動以來的時間、訊息計數和 git 分支。使用 Ctrl+A 擴展到所有專案後，專案路徑會出現。

使用 /branch、/rewind 或 --fork-session 建立的分支 sessions 會分組在其根 session 下。按 → 展開群組。

分支 session

分支會建立迄今為止對話的副本並將您切換到其中，保持原始對話完整。使用它來嘗試不同的方法，而不會失去您所在的路徑。

從 session 內，執行 /branch 並使用可選名稱：

/branch try-streaming-approach

從命令列，將 --continue 或 --resume 與 --fork-session 結合：

claude --continue --fork-session

原始 session 保持不變，並在 session 選擇器中保持可用。/branch 確認會列印兩個 session ID：您現在所在的新分支和原始分支。要返回原始分支，將其 ID 傳遞給 /resume、使用 session 選擇器或執行 /resume <original-name>。您使用「允許此 session」核准的權限不會轉移到新分支。如果您在兩個終端中恢復同一 session 而不進行分支，來自兩者的訊息會交錯到一個文字記錄中。

有關單個 session 內基於 checkpoint 的 rewind，請參閱 Checkpointing。

在 session 內管理上下文

這些命令控制上下文視窗中的內容，而無需離開 session：

• /clear：以空上下文重新開始。先前的對話已儲存並可恢復
• /compact [instructions]：用摘要替換歷史記錄，可選擇性地專注於您指定的內容
• /context：顯示目前消耗上下文的內容

有關壓縮如何與 CLAUDE.md、skills 和規則互動，請參閱上下文視窗指南。有關何時清除與壓縮的策略，請參閱最佳實踐。

匯出和定位 session 資料

執行 /export 以開啟一個選單，讓您將目前對話複製到剪貼簿或將其儲存為純文字檔案，訊息和工具輸出呈現為可讀文字。傳遞檔案名以略過選單並直接寫入該檔案。

從指令碼存取對話

/export 產生供人閱讀的呈現文字記錄。下列介面產生供指令碼解析的結構化資料：執行的 JSON 結果、session 文字記錄檔案的路徑，或事件的即時串流。根據觸發指令碼的內容選擇：

• 執行 Claude 一次並擷取結果：使用 --output-format json 或 stream-json 叫用 claude -p，以將非互動執行的結果、session ID、使用情況和成本擷取為結構化 JSON。
• 詢問現有 session 一個問題：將 session ID 傳遞給 claude -p --resume，以傳送後續提示（例如摘要要求），並擷取結構化回應。
• 對 session 事件做出反應：讀取 hooks 和 status line commands 作為輸入接收的 transcript_path 欄位。SessionEnd hook 可在 session 結束時封存文字記錄。
• 在 TypeScript 或 Python 應用程式中嵌入 Claude：使用 Agent SDK 以程式設計方式接收每條訊息。

下列範例使用第二個介面。它傳送後續提示給現有 session，並使用 jq 讀取答案：

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

文字記錄儲存位置

根據預設，文字記錄儲存為 JSONL，位置為 ~/.claude/projects/<project>/<session-id>.jsonl，其中 <project> 是您的工作目錄路徑，非英數字元已被 - 取代。每一行都是訊息、工具使用或中繼資料項目的 JSON 物件。項目格式是 Claude Code 的內部格式，在版本之間會變更，因此直接解析這些檔案的指令碼可能在任何版本上中斷。若要建立在 session 資料上，請改用 /export 或 指令碼介面。

位置、保留期和寫入行為可設定：

另請參閱

這些頁面涵蓋相關的 session 和平行處理機制：

• Worktrees：在單獨的分支上執行隔離的平行 sessions
• Checkpointing：將程式碼和對話 rewind 到較早的點
• Context window：什麼填充上下文以及什麼在壓縮中存活
• Non-interactive mode：claude -p 下的 session 行為