文件浏览器

📁 Browse files（浏览文件）让你无需离开对话，就能查看中继所在机器上的文件：智能体工作的文件夹、机器上的其余部分，以及智能体自己的会话所保留的文件夹。你可以用它查看智能体改了什么、打开文件、为下一条消息复制引用，以及整理文件。当你开始对话或更改其工作目录时，也是用同一个浏览器来选择文件夹。

打开方式 #

浏览器以对话框形式在对话上方打开。它的标题说明你处于哪个根目录：Repository Browser（仓库浏览器）、Drives Browser（驱动器浏览器）或 Session Browser（会话浏览器）。用 × 或 Escape 关闭它。

在桌面上，对话框有两个并排的窗格。左窗格 File tree（文件树）只显示文件夹。右窗格显示所打开文件夹中的文件，上方有一个路径栏。在手机上，两个窗格上下排列，树在上方。点击树中的文件夹即可打开它。⌖ Focus（定位）会把树折叠到当前打开的文件夹。旁边的计数器显示树中有多少条目，例如工作区中显示 12 nodes，其他地方显示 12 entries。

List（列表）和 Icons（图标）可将文件窗格在行和卡片之间切换。卡片会为图片显示缩略图。

三个根目录 #

工具栏左侧的三个按钮决定浏览器显示什么。

工作区是哪个文件夹 #

工作区根目录就是对话的工作目录。它跟随你打开的对话，而正在运行的会话会保留它实际工作所在的目录。对话 ⋯ 菜单中的 🗂️ Change CWD（更改工作目录）会为智能体的下一次启动更换它，或者用 🚀 Set new CWD and (re)launch（设置新工作目录并重新启动）立即更换；参见稍后更改。工作目录改变时，浏览器会丢弃它已打开的内容，转而显示新的目录。在对话消息中输入 cd 不会让浏览器跟着移动。

Claude Cloud 对话在你的机器上没有工作目录，也没有文件浏览器：智能体在 Anthropic 那边的一个克隆上工作。

驱动器和会话文件夹 #

驱动器根目录能访问整台机器，而不只是工作目录。限制对话可以在哪里启动的允许列表（workspaceRootAllowList，参见限制对话可以在哪里启动）并不限制你能浏览的范围。

会话文件夹列出智能体的提供商为此会话保留的文件。你可以查看并打开它们。在 Session Browser 中，浏览器只提供 New folder（新建文件夹），没有 Rename（重命名）或 Delete（删除）。这是页面的规则，而不是中继的规则。通过 📀 打开同一个文件夹时，会提供 Rename 和 Delete，中继也不会拒绝这些操作。

工具栏 #

Hidden 和 Heavy 初始时都是关闭的。一个既是隐藏又是大型的名称，需要两个开关都打开才会显示。更改会立即生效并刷新树。

你的浏览器会记住这些筛选设置：工作区的 Hidden、驱动器和会话根目录的 Hidden（两者共用一个设置），以及 Heavy。它不会记住根目录、视图或哪些文件夹处于打开状态；这些只在页面保持打开期间有效，经过 Refresh 以及关闭再重新打开对话框后仍会保留，但重新加载页面后不会保留。

打开文件 #

点击文件窗格中的文件，即可在文件查看器中打开它。在文件夹选择器（见下文）中无法打开文件。

在消息中引用文件或文件夹 #

有两个控件会把引用复制到剪贴板，并用反引号包裹。它们不会把引用放进输入区：你需要自己把它粘贴到消息中。

在工作区中，路径相对于工作目录，例如 @folder:src/components。在驱动器和会话根目录中，它是机器上的完整路径。智能体收到引用后得到什么，以及图片如何附加，见文件引用。

文件夹和文件 #

0.9.10 新增 你可以新建文件夹、重命名文件和文件夹，以及删除它们。这在工作区和驱动器中都可用。在会话文件夹中，浏览器只提供新建文件夹。

新建文件夹 #

📁+ New folder 会在文件窗格顶部打开一个名称字段。输入名称并按 Enter：文件夹会创建在当前打开的文件夹内，浏览器随即打开它。按 Escape 取消。提示内容为 Folder "name" created.。名称已被占用或被系统拒绝时，会在字段下方报告，字段保持打开。当前位置无法容纳文件夹时（例如 Windows 的驱动器列表），该按钮处于禁用状态。

上下文菜单 #

右键点击树中的文件夹或文件窗格中的文件。在手机上则是长按。菜单提供：

对于根目录（工作目录、/ 或某个驱动器）以及 Session Browser 中的任何内容，都不提供 Rename 和 Delete。你重命名的文件夹在树中保持原位，并保持打开。

删除 #

Delete 会先询问中继哪些内容将被删除，对话框会在删除任何内容之前告诉你：

对于有内容的文件夹，红色的 🗑 Delete 按钮会一直处于禁用状态，直到你在 Type the folder name to confirm（输入文件夹名称以确认）字段中输入该文件夹的名称。删除会把文件或文件夹从磁盘上移除，不会进入回收站。

名称和链接 #

• 名称只能是一个路径片段：不能为空，不能是 . 或 ..，不能包含 / 或 \，且最多 255 字节。
• 当中继在 Windows 上运行时，名称还不能包含 < > : " | ? * 或控制字符，不能以点或空格结尾，也不能是 Windows 保留的名称，例如 con 或 nul。
• 名称按完全一致进行比较：文件夹中已有的名称会被拒绝，并显示 That name is already taken。只改变名称的大小写是允许的。
• 链接（符号链接）永远不会被重命名或删除：中继会以 Links cannot be changed here 拒绝。工作区树不列出链接。在 Linux 和 macOS 上，驱动器和会话根目录会列出链接，并把指向文件夹的链接显示为文件夹，因此你可以通过它打开和读取内容；受保护的只是链接本身。经过指向文件夹的链接的路径，仍然能到达链接背后的文件夹。在工作区中，指向工作目录之外的链接会被视为无效路径而拒绝。
• 操作系统不允许的更改会报告为 Permission denied。被拒绝的重命名或删除会以提示显示；被拒绝的新建文件夹会显示在名称字段下方。

作为文件夹选择器 #

同一个浏览器也用来为 New chat（新建对话）和 🗂️ Change CWD 选择文件夹：按路径字段旁边的 📁。浏览器会在驱动器根目录打开，底部的一栏显示所选文件夹（或 Select a folder…），✅ Use this folder as CWD（将此文件夹设为工作目录）会把它交回。三个根目录仍然可用。在此模式下文件无法打开，也不提供 Rename 和 Delete；📁+ New folder 和 📁 New folder here 可以使用，因此你可以一次完成新建项目文件夹并选中它。参见工作目录。

限制 #

• 工作区树在你打开某个文件夹时才加载它，一次一个。隐藏和大型的名称会被排除，直到你打开对应开关。
• 中继无法读取的文件夹会以空内容打开，而不是显示错误。它无法读取的条目不会出现在列表中。
• 对于尚未写入任何文件的 Claude 或 DeepSeek 会话，会话根目录是空的，这不是错误。

按提供商 #

对于所有在中继所在机器上的某个文件夹中工作的提供商，浏览器都是一样的。不同的是 🕵️ 背后的会话文件夹。