帮助

什么是 Claude Code Helper？

Claude Code Helper 是一个桌面查看器，用于查看保存在您本地机器上的 Claude Code 会话。它会在 Windows 和 WSL 中找到这些会话，将它们列在一个可搜索的位置，并将每次对话渲染为可读、可导出的聊天记录。

Claude Code 将您过去的会话保存在隐藏的、特定于机器的存储位置，这些位置分散在几个地方：一个 Windows 存储，以及您运行 Claude 的每个 WSL（适用于 Linux 的 Windows 子系统）发行版内部的一个单独存储。目前没有内置方法可以浏览或重新阅读它们。此应用程序是前端：它从每个存储中显示这些会话，用来源标记每个会话，自动连接标题和对话记录两部分，并将每次对话显示为干净的聊天记录，您可以搜索、复制和保存——而无需触及原始文件。

您可以用它做四件事：浏览您的会话、阅读对话记录、保存或分享对话记录，以及调整一些设置。

浏览您的会话

左侧窗格列出了在此机器上找到的所有 Claude Code 会话，最新会话在前。每个条目显示会话的标题、运行它的项目文件夹、您上次关注它的时间，以及一个指示其来源的徽章。单击一个条目可在右侧打开其对话记录。

会话和对话记录

会话是一次 Claude Code 对话。其对话记录是其中所有言语和操作的完整记录。这两者在您的机器上是分开存储的：会话的标题和基本详细信息存储在一个位置，而对话记录本身存储在另一个位置。应用程序会读取两者并通过共享的会话 ID 进行匹配，因此列表和可读的对话记录会整合在一起。

您无需自行管理。这只因一个原因而重要：只有当其对话记录实际可找到时，会话才会被列出。如果 Claude Code 已删除旧的对话记录（它会在一段时间后清除它们），则没有可供阅读的内容，因此该会话根本不会出现在列表中，而不是显示为空条目。

会话的来源 — 来源徽章

每个条目都带有一个小的来源徽章，告诉您该会话实际存储在哪里：

Windows — 会话是在 Windows 上使用 Claude Code 运行的。
发行版名称（例如 Ubuntu） — 会话是在该 WSL Linux 环境中运行的。Claude Code 在每个 WSL 发行版中都维护一个完全独立的存储，并且应用程序会读取所有这些存储。

同一台机器可以轻松同时包含这两种类型，存储之间没有任何关联。徽章让您一目了然地知道一个条目属于哪个环境。只有当前正在运行的 WSL 发行版才会被扫描 — 停止的发行版的会话会在您启动它时立即显示。

列表上方，每个存储都会出现一个来源芯片 — Windows 优先，然后是每个正在运行的发行版。每个芯片都带有一个计数，并可以切换该来源的开启或关闭状态，这样您就可以将列表集中在例如仅您的 WSL 会话上，并隐藏 Windows 会话 (显示或隐藏此来源的会话)。

活动、已归档和丢失的会话

每个会话都属于以下三个类别之一，每个类别都有自己的筛选芯片和列表上方的实时计数：

活跃 — 一个正常的当前会话。
已归档 — 您在 Claude 中归档的会话。它在这里仍然完全可读；该标签仅反映其状态。
已丢失 — 一个没有匹配 Claude Desktop 条目的 Windows 对话记录。由于条目通常包含标题，丢失的会话没有存储的标题，因此应用程序会从对话中的第一条消息中恢复一个标题。没有这个，丢失的会话将没有标题可供列出，并且将是不可见的。

这三个芯片在您寻找对话时显示或隐藏每个类别，它们的计数反映了当前显示的任何来源。以这种方式恢复的条目也带有自己的丢失标签 — 将其理解为“这里的标题是重建的，而非原始标题”。

应用程序从不更改您的会话

Claude Code Helper 只读取您的会话 — 它从不写入、重命名或删除它们。复制和导出会创建新的剪贴板文本和新文件；原始文件保持原样。

这很重要，因为这些文件是 Claude Code 本身的实时工作数据。一个修改它们的查看器可能会损坏会话。因此，您可以自由浏览和导出，而不会对 Claude 造成任何风险。

唯一的注意事项是：当 Claude 正在积极使用某个会话时，请勿手动编辑该会话的底层文件（例如，您通过在文件夹中显示对话记录文件访问的文件）——那是在 Claude 不知情的情况下编辑实时数据，这与此应用程序所做的任何事情都不同。

筛选列表

在列表上方的筛选框中开始输入，以缩小范围。筛选器同时匹配会话标题和项目路径，因此您可以根据会话的主题或运行它的文件夹来查找会话。筛选框中会出现一个清除按钮，一键清除并再次查看所有内容。上面描述的来源和类别芯片会进一步缩小文本筛选器留下的范围。

按标题或路径筛选… — 筛选框；将列表缩小到标题或项目路径包含您输入内容的条目。
清除筛选 — 清除筛选框。

刷新列表

应用程序打开时，列表会读取一次。如果您在应用程序运行时在 Claude Code 中启动或继续会话 — 或启动之前已停止的 WSL 发行版 — 请使用列表顶部的刷新控件重新读取存储并引入新会话。

刷新列表 — 重新读取会话存储，以便显示自应用程序打开以来创建的会话（或启动的发行版）。

阅读对话记录

选择一个会话，其对话内容将填充右侧窗格。

对话记录的显示方式

对话记录以聊天的形式呈现。您的消息位于右侧。Claude 的回复占据左侧的宽度。Claude 在此过程中完成的工具工作以块的形式出现在其回复中。所有内容都从 Markdown 渲染 — 标题、列表、代码和图像都正确显示 — 因此原始的机器记录会显示为您实际进行的对话。

工具块 — 调用及其结果的折叠

每当 Claude 使用工具时，会发生两件事：它发送了一个请求，并得到了一个结果。应用程序将这对信息折叠成一个单独的可折叠块。单击该块以打开它 — 请求显示在顶部，结果显示在下方 — 然后再次单击以关闭它。

工具请求和结果通常很庞大，因此这些块默认是关闭的，让您无需深入机器细节即可阅读对话。当您想查看工具具体做了什么时，打开您关心的那个块。（非常长的请求或结果会被截断，以确保大型会话也能快速渲染。）

展开或折叠所有工具详情

对话记录工具栏中的“全部展开”控件可以一键打开或关闭当前对话记录中的所有工具块 — 当您想要查看完整画面，或者想将其全部折叠起来以便快速浏览时，这非常方便。您仍然可以通过单击来打开和关闭单个块。

展开或折叠工具详情 — 一次性打开或关闭当前对话记录中的所有工具块。

整个会话、单个答案或一个表格都可以离开应用程序。转录工具栏中的三个控件处理整个转录——将其复制到剪贴板、将其保存为文件或在磁盘上打开原始文件——另外两个位于对话本身中，当您将鼠标悬停在所需部分时出现。

导出的 Markdown 是什么样子

复制为 Markdown 和 导出为 Markdown 文件 都会生成相同的内容：一个包含整个对话的独立 Markdown 文档。每个轮次都有一个标题，工具工作内容以内联方式显示。Claude 接收或生成的任何图像都直接嵌入到文档中，因此它本身就是完整的——它可以在任何编辑器或笔记应用中打开、渲染和搜索，无需此查看器。

一个轮次会以这种形式显示：

### User

Can you rename the helper function and update its callers?

### Claude

Done — renamed it and updated the two call sites.

### Tool result

(the file edits Claude made, shown inline)

这些标题（### User、### Claude、### Tool result）是导出文档本身的一部分，因此即使远离此应用也能清晰阅读。

复制为 Markdown

将整个对话记录以 Markdown 格式复制到剪贴板，可以直接粘贴到笔记、聊天或编辑器中。

复制为 Markdown — 将整个对话记录以 Markdown 格式复制到剪贴板。

复制 Claude 的一个回答

有时您只需要一个回复，而不是整个对话。将鼠标悬停在 Claude 的任何回答上，其下方就会出现一个复制按钮；点击它会将该单个回答以 Markdown 格式复制到剪贴板，格式与完整导出时完全相同。按钮会短暂显示一个勾号以确认，因此您知道它已成功复制。

此功能仅适用于 Claude 的回答 — 您自己的消息已经是您编写的文本，并已包含在上述的完整对话副本中。

复制答案为 Markdown — 将该回答以 Markdown 格式复制到剪贴板。

复制表格

表格是答案中最常需要复制到其他地方的部分，例如比较、设置列表或结果集。将鼠标悬停在转录中的任何表格上，其右上角会出现一个复制按钮。

它会同时以两种形式复制表格，您粘贴到的应用程序会选择它能理解的那一种：

粘贴到电子表格、文字处理器或文档编辑器中，您会得到一个真实的表格——行和列保持完整，而不是一堆文本。
粘贴到纯文本编辑器中，您会得到制表符分隔的行，大多数编辑器和数据工具会将其读取为列。

您无需选择它们；两者会通过一次复制操作一起传输。

复制表格 — 复制您正在悬停的表格。

导出为 Markdown 文件

打开保存对话框，以便您选择 .md 文件的保存位置和名称。使用它来存档会话或将其交给其他人。

导出为 Markdown 文件 — 将对话记录保存到您选择的 Markdown 文件中。

在其文件夹中显示源文件

打开您的文件管理器，并选中会话的原始对话记录文件。当您需要文件本身时使用它——例如备份、检查或将其指向另一个工具。（读取和复制是安全的；在 Claude 使用该会话时编辑它则不安全——请参阅应用从不更改您的会话。）

在文件夹中显示文本文件 — 在您的文件管理器中打开原始对话记录文件，并选中它。

设置

从顶部栏的按钮打开设置。有两个选项卡：显示用于语言和主题，关于用于应用版本。

打开设置 — 打开设置对话框（语言、主题和应用版本）。

语言

从列表中选择界面语言。您的选择将在下次打开应用时被记住。

语言 — 选择界面语言。

主题

选择浅色或深色界面。选择会立即生效并被记住。

主题 — 在浅色和深色界面之间切换。

更新通知

应用启动时，它会悄悄检查是否有新版本发布。如果有新版本，顶部会出现一个横幅，其中包含发布说明的链接和下载按钮。它只会告知您——绝不会自行安装任何东西。

您可以通过三种方式处理横幅：

下载 — 打开页面以获取新版本。
忽略 — 在本次运行中隐藏横幅；它可能在下次启动时再次出现。
跳过此版本 — 隐藏横幅，直到发布更新的版本，这样您就不会再收到此版本的提醒。
新功能 — 打开新版本的发布说明。

如果您处于离线状态、已是最新版本或已跳过此版本，则不会出现横幅。

其他控件

GitHub — 在您的浏览器中打开应用在 GitHub 上的源代码仓库。
帮助 — 以您当前的语言打开此帮助页面。

帮助