跳转到主要内容
会话是与项目目录关联的已保存对话。Claude Code 在您工作时将其本地存储，因此您可以从中断处恢复、分支以尝试不同的方法，或在任务之间切换。 桌面应用、claude.ai/code 和 VS Code 扩展各自维护自己的会话列表，桌面应用还可以恢复 CLI 会话。本页涵盖 CLI。

​
恢复会话

会话在您工作时持续保存到本地会话记录文件，因此您可以在退出或运行 /clear 后返回到一个会话。使用这些入口点：

​
恢复正在运行的后台会话

当您使用 claude --resume 或 /resume 恢复的对话属于仍在运行的后台会话时，Claude Code 会打开运行中的会话本身。在命令行上使用 --bg 时，恢复改为后台调度。在 v2.1.285 之前，Claude Code 会拒绝并告诉您使用 claude attach <id> 打开会话，或首先使用 claude stop <id> 停止它。
  • 从您的 shell：claude --resume <session> 在同一终端中对该会话运行 claude attach，而不是自行加载会话记录。您在命令行上传递的提示词，如 claude --resume <session> "check the tests too"，会首先作为下一轮发送到该会话，Claude Code 在附加之前打印 Sent your prompt to the background session (<id>); opening it…。在终端中输入的 claude -p --resume <session> "prompt" 执行相同操作，因此 -p 不会使该运行保持非交互式。 当命令行包含以下任何内容时，Claude Code 不会打开会话：
    • 管道或重定向的输入或输出
    • 配置会话的标志，例如 --permission-mode、--model 或 --settings
    • 读取输出的标志，例如 --output-format json 或 --json-schema
    • 限制或倒带运行的标志，例如 --max-turns 或 --max-budget-usd
    使用这些中的任何一个，或当 Agent 视图被关闭时，Claude Code 不发送任何内容并以状态 1 退出，打印会话正在后台运行以及打开它的 claude attach <id> 命令，或在无法确定 ID 时告诉您在 claude agents 中找到它。添加 --fork-session 以改为恢复对话的副本。要在您自己的会话中继续对话本身并应用您的标志，请运行 claude stop <id>，然后重复该命令。 以 / 或 ! 开头的提示词不会被发送，会话等待您回答问题时的任何提示词也不会。在这两种情况下，Claude Code 都不会打开会话，消息中包括 Your prompt was not sent to it 和原因。
  • 从会话内：/resume 将您当前的对话移到后台，并将此终端附加到运行中的会话，打印 Opening "<title>", running in the background (<id>)。在空输入框中按 ← 返回 Agent 视图，其中也列出您离开的对话。当当前对话无法移到后台时，例如因为您已附加到后台会话或会话持久化已关闭，/resume 会打印应改为运行的 claude attach 命令。

​
恢复的会话恢复的内容

当 Claude Code 从其会话记录加载对话时，恢复的会话会恢复对话以及保存在其中的状态：
  • 对话历史：消息、工具调用和结果。如果会话已被压缩，对话会在 Conversation compacted 行处打开。Claude 会基于最后一次压缩的摘要、该次压缩未摘要的消息以及此后的每条消息继续。最后一次压缩已摘要的消息不会再次加载。
  • 中断的工具调用：如果工具在上一个进程结束时仍在运行（例如在崩溃中），当您恢复时它不会重新运行。
  • 模型：会话继续使用它之前使用的模型，设置模型中所述的情况除外。
  • Agent：使用 --agent 或 agent 设置启动的会话继续作为该 Agent 运行，保持其工具限制和模型。在恢复时传递 --agent 以选择不同的 Agent；关于任一情况下的系统提示词，请参阅恢复对话中的系统提示词标志。Claude Code 在两个地方查找 Agent：会话的原始目录（前提是您已信任该工作区），然后是您恢复时所在的目录，因此项目范围的 Agent 在您从另一个目录恢复时仍会加载。如果 Claude Code 在任一位置都找不到该 Agent，会话会以默认工具恢复并显示指明该 Agent 的警告。
  • 权限模式：如果您从终端使用 claude --continue、claude --resume <session-id> 或 claude --resume <name>（当名称与一个会话匹配时）恢复，且不带 -p，Claude Code 会恢复会话所在的权限模式，恢复时的权限模式中的情况除外，该部分也涵盖会话选择器、/resume 和使用 claude -p 恢复。传递 --permission-mode 或 --dangerously-skip-permissions 以覆盖恢复的模式。
  • 活跃目标：会话结束时仍然活跃的目标会延续；其轮次计数、计时器和 token 支出基线会重置。
  • 会话范围的定时任务：未过期的任务会被恢复。后台 Bash 和监视任务不会。
  • 后台工作：随上一个进程结束的后台子代理、后台 Bash 命令或工作流，会在恢复的会话记录中显示为未完成的注记。Claude Code 不会因这些注记启动轮次；Claude 会随您的下一个提示词读取它们。
并非原始启动的每个配置标志都会被恢复。如果会话依赖于 --mcp-config、--settings、--plugin-dir、--fallback-model 或使用 --add-dir 添加的目录，请在恢复时再次传递它们；在会话中途使用 /add-dir 添加的目录也不会被恢复，尽管会话选择器仍然使用它们来定位会话。标准设置文件（如 settings.json 和 settings.local.json）会在启动时重新读取，因此存放在其中的配置不需要再次传递。关于 --system-prompt 和 --append-system-prompt，请参阅恢复对话中的系统提示词标志。

​
恢复时的权限模式

Claude Code 以何种权限模式启动恢复的会话取决于您如何恢复。下面的情况适用于 Claude Code 从其会话记录加载对话时；当您改为打开仍在运行的后台会话时，该会话保持它所在的权限模式。
  • 终端：claude --continue、claude --resume <session-id> 或 claude --resume <name>（当名称与一个会话匹配时），不带 -p。Claude Code 恢复会话所在的权限模式，表中的情况除外。传递 --permission-mode 或 --dangerously-skip-permissions 以覆盖恢复的模式。
  • 非交互式：claude -p --resume 或 claude -p --continue。Claude Code 以新的 claude -p 运行会启动的权限模式启动该运行，但在下面的条件下，以计划模式结束的会话会以计划模式恢复。
  • VS Code：扩展的对话面板。该表仅涵盖以计划模式结束的对话；其余情况请参阅恢复过去的对话。
  • 启动时的会话选择器：您从会话选择器中选择的会话，无论您是单独使用 claude --resume、使用 claude --from-pr，还是使用与多个会话匹配的名称打开它。Claude Code 以从同一命令行启动新会话时的权限模式启动该会话，但以计划模式结束的会话会以计划模式恢复。如果您传递 --permission-mode、--dangerously-skip-permissions 或 --fork-session，Claude Code 不会恢复计划模式。不会恢复其他存储的权限模式。
  • 会话内的 /resume，带或不带参数：您切换到的对话继续使用您当前会话所在的权限模式，但以计划模式结束的对话会以计划模式恢复，即使您使用 --permission-mode 或 --dangerously-skip-permissions 启动了 Claude Code。如果该对话在本次运行 Claude Code 期间已经打开过，例如您开始时的对话，或您通过 /clear 或 /resume 离开的对话，则它会改为继续使用您当前的权限模式。
如果某条拒绝规则移除了 ExitPlanMode 工具，Claude 就无法呈现计划以供批准，因此 Claude Code 不会恢复计划模式。会话以从同一命令行启动新会话时的权限模式启动。使用 /resume 时，对话继续使用您当前的权限模式。 在非交互式和 VS Code 路径上恢复计划模式需要 Claude Code v2.1.246 或更高版本。每一行列出会话结束时的权限模式、您通过终端、非交互式和 VS Code 中的哪条路径恢复它，以及 Claude Code 启动恢复会话时的权限模式。 claude -p --resume 或 claude -p --continue 运行仅在以下所有条件都成立时才以计划模式恢复：

​
“Resume this conversation?” 对话框

如果您在恢复会话时看到 “Resume this conversation?” 对话框，其中的估算值是仅保存的对话本身就会占用的 5 小时用量限制的份额。该估算不计入您已经使用的用量。 在 Pro、Max 和 Ultra 计划中，当您在长时间中断后或在不同的模型上恢复较长的对话时，可能会出现该对话框。估算的用量在您选择 Resume 后发送第一条消息时产生，而不是在您选择它时产生。请根据您的下一个任务是否仍需要保存的对话来选择：
  • Resume：继续在保存的对话中工作。
  • Start a new conversation：切换到不需要保存的对话的工作。要稍后重新打开它，请在输入框中运行 /resume。该估算不适用于您在新对话中的第一条消息。如果该选项表明 Claude 可以查找此对话，您仍然可以在新对话中引用之前的工作。

​
会话选择器查看的位置

Claude Code 按项目目录存储会话。默认情况下，会话选择器显示：
  • 来自当前 worktree 的会话，包括后台会话，在列表中标记为 bg
  • 在其他地方启动但使用 /add-dir 添加了当前目录的会话
使用 Ctrl+W 扩展到仓库的所有 worktrees，或使用 Ctrl+A 扩展到此计算机上的每个项目。

​
/loop、-p、Agent SDK 和后台会话

第一个提示词是 /loop 命令的会话不会出现在选择器中，claude --continue 也会跳过它们。在对话中稍后运行 /loop 不会隐藏会话。 Claude Code 将使用 claude -p 或 Agent SDK 创建的会话排除在会话选择器和 claude --continue 之外。您仍然可以通过将其会话 ID 传递给 claude --resume <session-id> 来恢复它。当您运行 claude -p --continue 时，Claude Code 包括 -p、SDK 和 /loop 会话。 claude --continue 打开已完成的后台会话，但不打开仍在运行的会话；打开已完成的后台会话需要 Claude Code v2.1.257 或更高版本。如果您最近的对话是您移到后台的会话，并且它仍在那里运行，Claude Code 会以 Your most recent conversation is running in the background 和该会话的 ID 退出。从 claude agents 附加到会话，或运行 claude --resume 选择另一个。

​
其他 worktrees 和项目中的会话

从同一仓库的另一个 worktree 选择会话时，Claude Code 会在原地恢复它；当会话自己的 worktree 不再存在时，Claude Code 会在您的当前目录中恢复它。从不相关项目选择会话时，Claude Code 会改为将 cd 和恢复命令复制到您的剪贴板。如果该项目的目录不再存在，Claude Code 会在您的当前目录中恢复会话，而不是复制会失败的 cd 命令。 使用 /cd 移动会话会将其重新定位到新目录的项目存储，因此之后它会出现在该目录的选择器中。

​
按会话 ID 或名称恢复

您可以从任何目录运行 claude --resume <session-id>，因此可以恢复在其他地方启动或使用 /cd 移动过的会话。Claude Code 按以下顺序查找该 ID：
  1. 当前项目目录及其 git worktrees
  2. 此计算机上的所有其他项目
跨项目搜索仅在恰好一个其他项目持有具有该 ID 的消息的会话记录时解析 ID，因此手动复制的重复项会导致 Claude Code 报告未找到，而不是恢复任意副本。如果没有存储的会话与 ID 匹配，Claude Code 会报告 No conversation found with session ID: <session-id>。 按名称恢复会在当前仓库及其 worktrees 范围内解析。两种形式都会查找精确匹配并直接恢复，即使它位于不同的 worktree 中：

​
命名您的会话

为会话提供描述性名称，以便在会话选择器中可以找到它们，并可以按名称恢复。当您并行处理多个任务时，这一点最重要。 通过 CLI 路由或从 claude.ai 命名会话后，使用 claude --resume <name> 或 /resume <name> 返回到它；桌面应用会话在 桌面应用 中恢复。有关名称解析如何跨 worktrees 工作的信息，请参阅恢复会话。 您未命名的会话仍会获得 Claude Code 分配的两个标签。只有生成的标题可用作恢复句柄：
  • 默认显示名称：您从未命名的交互式会话在启动时仍会获得默认显示名称。默认名称将工作目录的名称与两个字符的后缀组合在一起，例如 my-app-3f，并在运行会话的列表中标识会话，例如 agent view 和 claude agents --json 输出。默认名称不是恢复句柄。如果您将其传递给 claude --resume 或 /resume，Claude Code 不会找到该会话。
  • 生成的标题：如果您不命名会话，Claude Code 会为其生成会话标题。该标题是您第一个提示的简短摘要，由对小型/快速模型（通常是 Haiku 级别的模型）的后台请求编写。您直接从 shell 或脚本启动的 claude -p 运行不会获得一个。 接受计划会将生成的标题替换为基于计划的标题。您可以将任一标题传递给 claude --resume 或 /resume，Claude Code 会以与您设置的名称相同的方式解析它。

​
使用会话选择器

在会话内运行 /resume，或不带参数运行 claude --resume，以打开交互式会话选择器。使用这些快捷键导航、搜索和扩展列表： 每行显示会话名称（如果已设置），否则显示 AI 生成的会话标题、对话摘要或第一个提示词，以及自上次活动以来的时间、git 分支和文件大小。 使用 /branch 或 --fork-session 创建的会话会获得自己的会话 ID 并显示为单独的行。当选择器为同一会话找到多个条目时，它会将它们分组在单个行下。按 → 展开一个组。 如果 Claude Code 无法从 claude --resume 选择器加载您选择的会话，它会打印 Failed to resume the conversation 并显示重试命令，然后以代码 1 退出。从会话内的 /resume 选择器，Claude Code 会报告失败，您当前的对话会继续运行。

​
分支会话

分支创建迄今为止对话的副本并将您切换到其中，保持原始对话完整。使用它来尝试不同的方法而不会丢失您所在的路径。 从会话内，运行带有可选名称的 /branch：
如果您省略名称，Claude Code 会根据对话中的第一个提示词为新分支命名。 从命令行，将 --continue 或 --resume 与 --fork-session 结合：
/branch 确认打印两个会话 ID：您现在所在的新分支和原始分支。原始分支在磁盘上保持不变，并在会话选择器中保持可用；使用 /resume <original-name> 返回到它，或将其 ID 传递给 /resume。 /branch 复制文本记录并将运行的 Claude Code 进程切换为写入到它。这种区别决定了分支继承的内容： 如果您在两个终端中恢复同一会话而不分叉，来自两者的消息会交错到一个文本记录中。对于单个会话内基于 checkpoint 的回退，请参阅 Checkpointing。

​
管理会话内的上下文

这些命令控制上下文窗口中的内容而不离开会话：
  • /clear：以空上下文重新开始。Claude Code 保存之前的会话；可通过 /resume 恢复它，或在同一个 Claude Code 进程中，从倒带菜单的上一个会话条目恢复。不带参数时，新会话保留您使用 --name 或 /rename 设置的名称，但不保留 AI 生成的会话标题。若要改为给您即将离开的会话命名，请传递名称，如 /clear release-prep；新会话随后将以未命名状态开始
  • /compact [instructions]：用摘要替换历史记录，可选地专注于您指定的内容
  • /context：显示当前消耗的上下文
有关压缩如何与 CLAUDE.md、skill 和规则交互的信息，请参阅上下文窗口指南。有关何时清除与压缩的策略，请参阅最佳实践。

​
导出和定位会话数据

运行 /export 打开一个菜单，让您将当前对话复制到剪贴板或将其保存为纯文本文件，消息和工具输出呈现为可读文本。传递文件名以跳过菜单并直接写入该文件。

​
从脚本访问对话

/export 生成一个供人阅读的呈现文本记录。下面的接口生成结构化数据供脚本解析：运行的 JSON 结果、会话文本记录文件的路径或事件的实时流。根据触发脚本的内容选择：
  • 运行 Claude 一次并捕获结果：使用 --output-format json 或 stream-json 调用 claude -p 以捕获非交互式运行的结果、会话 ID、使用情况和成本作为结构化 JSON。
  • 向现有会话提问：将会话 ID 传递给 claude -p --resume 以发送后续提示（例如摘要请求），并捕获结构化响应。
  • 对会话事件做出反应：读取 hooks 和 status line commands 作为输入接收的 transcript_path 字段。SessionEnd hook 可以在会话结束时存档文本记录。
  • 在 TypeScript 或 Python 应用中嵌入 Claude：使用 Agent SDK 以编程方式接收每条消息。
下面的示例使用第二个接口。它向现有会话发送后续提示，并使用 jq 读取答案：

​
文本记录存储位置

默认情况下，Claude Code 将文本记录存储为 JSONL，位置为 ~/.claude/projects/<project>/<session-id>.jsonl，其中 <project> 是您的工作目录路径，非字母数字字符被替换为 -。对于转换后的名称超过 200 个字符的工作目录，Claude Code 将名称截断为 200 个字符，并附加完整路径的哈希值，以便目录名称保持在文件系统限制范围内。 每行是一个 JSON 对象：消息、工具使用或结果、Claude Code 向模型发送的请求的记录，或元数据条目。条目格式是 Claude Code 的内部格式，在版本之间会发生变化，因此直接解析这些文件的脚本可能在任何版本上中断。要基于会话数据构建，请改用 /export 或 脚本接口。 位置、保留期和写入行为是可配置的：

​
删除会话数据

会话记录在 保留扫描规则 下过期。要更快地删除项目的会话记录和相关状态，请运行 claude purge。如果您使用 claude rm <id> 删除 后台会话，其会话记录保留在磁盘上，并且仍可通过 claude --resume 访问。

​
自己命名项目目录

默认情况下，Claude Code 从整个工作目录路径派生 <project> 名称。要自己选择名称，请将 CLAUDE_CODE_PROJECT_DIR_NAME 与 CLAUDE_CONFIG_DIR 一起设置。Claude Code 然后将该会话的文本记录和 自动内存 存储在您的名称下。这适合嵌入 Claude Code 的主机，并为每个会话提供自己的配置目录。需要 Claude Code v2.1.234 或更高版本。 例如，此启动将租户 A 的数据保留在 /srv/tenant-a 下，并将其项目目录命名为 work：
Claude Code 将会话的文本记录写入 /srv/tenant-a/projects/work/，将其自动内存写入 /srv/tenant-a/projects/work/memory/，无论工作目录是什么。 设置时适用三条规则：
  • 也设置 CLAUDE_CONFIG_DIR：名称不随工作目录变化，因此在默认 ~/.claude 下，它会将每个项目的文本记录和自动内存合并到一个目录中。当 CLAUDE_CONFIG_DIR 未设置时，Claude Code 忽略 CLAUDE_CODE_PROJECT_DIR_NAME。
  • 使用 1-64 个字母、数字、连字符或下划线：不要使用 Windows 设备名称，例如 con。Claude Code 忽略任何其他值，并使用派生的名称。
  • 在启动 claude 的 shell 环境中设置它：Claude Code 在启动时从该环境读取一次，因此设置文件中的 env 块无法设置它。
一旦您命名了配置目录的项目目录，请继续使用该名称启动。如果您使用相同的 CLAUDE_CONFIG_DIR 但没有 CLAUDE_CODE_PROJECT_DIR_NAME 启动 Claude Code，它会再次读取和写入派生目录。存储在您的名称下的会话保留在磁盘上：在 会话选择器 中按 Ctrl+A 以列出该配置目录下每个项目目录中的会话（包括固定的会话），无论您如何启动，claude --resume <session-id> 都会找到存储在任一名称下的会话。

​
另请参阅

这些页面涵盖相关的会话和并行性机制：