你明明在 Finder 或文件资源管理器里看到了笔记,桌面 Agent 却一直问“文件在哪里”。只说“读一下桌面上的笔记”,它可能不知道你指的是哪个文件。把准确路径、读取任务和核对方式一起告诉它,才能减少来回解释。
先复制文件的位置:
Windows 11: 在文件资源管理器中选中文件,打开右键菜单,选择 Copy as path(复制文件地址),再用 Ctrl+V 粘贴。Microsoft 的 Windows 11 版本说明记录了这个命令及其快捷键。
Mac: 在 Finder 中选中文件,按 Option+Command+C,再用 Command+V 粘贴。我们在 macOS 26.4 上实际验证了文件和文件夹的这项操作。
直接跳到:Agent 快速开始、Windows 步骤、Mac 步骤,或找不到文件时的排查。
文件路径告诉应用文件存放在哪里。复制路径不会移动文件,也不能证明 Agent 已经读过文件。下面以本机上的 .md、.txt 文件为例,说明如何在 Claude Code、Codex 或 DeepSeek Harness 中把这个动作完成。
快速开始:让桌面 Agent 知道该读哪个文件
- 在 Finder 或文件资源管理器中找到要读取的
.md或.txt文件。 - 用上面的操作复制路径,单独粘贴在提示词的一行中。
- 说明要读什么,以及读完需要做什么。
- 要求先返回文档标题或第一个非空行,再输出结果,便于核对它是否读对文件。
把下面虚构的 Mac 路径替换成你刚复制的实际路径:
请读取这个本地文件:
/Users/alex/Documents/Project Notes/meeting notes.txt
先原样返回文件的第一个非空行,再用三个要点总结待办事项。
只读取,不修改文件。
如果无法打开,请告诉我你尝试的路径和具体错误,不要猜测内容。Windows 用户只需替换路径那一行,例如 C:\Users\alex\Documents\Project Notes\meeting notes.txt。文件名里的空格要保留。这是一段给 Agent 的自然语言指令,不是终端命令,不要额外给普通路径添加命令行转义符。
如果文件位于 Agent 已打开的项目里,也可以使用项目相对路径,同时写清项目根目录:
请使用 website 项目,项目根目录是:
/Users/alex/Projects/website
读取相对于这个根目录的文件:
docs/meeting-notes.md
先原样返回文件的第一个非空行,再列出已确定的决策和待解决的问题。
只读取,不修改任何文件。
如果你当前项目的根目录不同,请先告诉我,再继续。把返回的标题或第一个非空行与原文件对照。如果不一致,先纠正路径再继续。只得到一份看起来合理的总结,还不足以证明它打开了正确文件。
在 Windows 11 中复制文件路径
- 打开文件资源管理器,找到目标文件。
- 右键点击文件本身,不要点击文件夹内的空白区域。
- 选择 Copy as path。
- 打开纯文本编辑器或目标输入框,按 Ctrl+V 粘贴。
Microsoft 在 Windows 11 Insider 版本说明中记录了 Ctrl+Shift+C;可以在选中文件后尝试,或使用菜单命令。本节依据官方文档,包括这份历史记录;本次没有在 Windows 电脑上实测。Microsoft 命令与快捷键说明。
完整文件路径包含完整文件名;如果文件有扩展名,也要包含扩展名。例如:
C:\Users\alex\Documents\Project Notes\meeting notes.txt正文里的 alex 路径是虚构示例,截图使用的是另一份合成测试文件。你电脑上的名字和位置会不同。把路径交给其他应用前,还要检查两端是否带引号,具体见空格与引号。
只复制当前文件夹的位置
在文件资源管理器中打开该文件夹,按 Alt+D 选中地址栏,再按 Ctrl+C 复制其文字。Microsoft 列出了 Alt+D 的地址栏操作。Windows 键盘快捷方式。
这个方法适用于普通文件系统中的文件夹。地址栏不会自动加上选中文件的名字。如果要让 Agent 读 meeting notes.txt,应复制这个文件的路径。
在 Mac 中复制文件路径
- 打开 Finder,单击选中目标文件。
- 同时按 Option+Command+C。
- 点击目标文本输入位置,按 Command+V。
也可以右键点击文件,按住 Option,选择将该项目拷贝为路径名称的菜单项。Apple 在文件和文件夹路径指南中说明了这个操作。
如果要复制文件夹路径,先选中文件夹,再用同一个快捷键。无需逐层打开父目录,也无需手动拼写路径。
我们实际测试了什么
我们于 2026 年 9 月 11 日,在 macOS 26.4、build 25E246 的简体中文 Finder 中,复制了自建文件 report 中文 sample.txt 和文件夹 Plain Folder,再粘贴到 TextEdit 并保存为纯文本。
快捷键保留了完整位置、空格和中文。原生“拷贝为路径名称”菜单动作得到的文件路径与快捷键一致。实际粘贴的文字两端有普通单引号;换成虚构位置后,格式如下:
'/Users/alex/Documents/Path Test/report 中文 sample.txt'这是一次单机功能验证,没有测速度或跨版本兼容性。菜单动作通过辅助功能接口调用,没有另行测试物理按住 Option 时的菜单视觉切换。其他系统版本或接收应用的格式处理可能不同。
在 Finder 中查看文件夹层级
选择 显示 → 显示路径栏。在路径栏中按住 Control 点击目标文件夹,再使用复制路径名称的命令。要选中你真正需要的那一级:父文件夹的位置与文件本身的位置不同。Apple 路径栏说明。
文件路径、文件夹路径和相对路径有什么区别
粘贴前,先确认接收方需要的是哪一种位置:
| 类型 | 示例 | 指向的对象 |
|---|---|---|
| Mac 完整文件路径 | /Users/alex/Documents/Project Notes/meeting notes.txt | 一个具体文件 |
| Mac 文件夹路径 | /Users/alex/Documents/Project Notes | 文件所在的文件夹 |
| Windows 完整文件路径 | C:\Users\alex\Documents\Project Notes\meeting notes.txt | C: 盘上的一个具体文件 |
| 项目相对路径 | docs/meeting notes.txt | 从指定项目根目录出发找到的文件 |
绝对路径包含起始位置,例如 Mac 上的 /,或示例中的 Windows 盘符根目录。相对路径需要一个基准目录。只给出 docs/meeting notes.txt,却不说项目根目录,接收方就需要猜测你指的是哪个 docs 文件夹。
假设项目根目录是 /Users/alex/Projects/website,那么相对路径 docs/meeting notes.txt 对应:
/Users/alex/Projects/website/docs/meeting notes.txt要明确指向本机上的某个文件,可以用绝对路径。Agent 已打开同一项目、且双方知道项目根目录时,可以使用项目相对路径。
路径中有空格和引号,该怎么粘贴
保留文件名里的空格和其他字符。把 meeting notes.txt 改成 meetingnotes.txt,指向的就是另一个名字。
两端的引号需要按使用场景处理。它可能是终端命令需要的语法,但接收原始路径的输入框未必需要它。
- 普通路径输入框: 按应用要求填写。如果带引号的路径被拒绝,可以只去掉首尾配对的外层引号,保留路径本身。
- Mac Terminal 命令: 含空格的路径需要正确引用或转义。对于名字里没有撇号的文件夹,示例是
cd '/Users/alex/Documents/Path Test'。Apple 说明了引号和反斜杠转义的用法。Terminal 路径指南。 - 给 Agent 的消息: 把原始路径单独放一行或放在代码块里,并说明这是文件还是文件夹。不要把 Shell 转义形式机械地套进自然语言提示词。
不要习惯性再套一层引号。先看实际粘贴的内容,再看目标需要的格式。上面的命令是 Mac Shell 示例;Windows 命令或名字本身包含引号的文件,需要按具体工具的语法处理。
在 Claude Code、Codex 和 DeepSeek Harness 中使用路径
以下应用操作根据官方文档整理。我们另于 2026 年 9 月 17 日,在 macOS 26.4 上用 Codex CLI 0.153.4 完成了一次只读验证:返回的第一个非空行与合成文件完全一致,文件内容未变。截图把真实输入和结果保存为文本后在 TextEdit 展示,并非 Codex App 或 Terminal 界面。Claude Code、DeepSeek Harness 和 Codex 桌面 App 仍未实测。
Claude Code: 从目标项目目录启动会话。输入 @ 并选择文件建议,或者引用 @docs/meeting-notes.md,再附上快速开始中的读取任务。官方说明文件引用可使用相对路径或绝对路径;引用目录只会提供文件列表,因此要读正文时应指明文件。启动本地会话、引用文件。
Codex: 在关联了目标文件夹的本地项目中打开任务,粘贴完整路径和读取要求。项目文档说明了文件夹关联方式;提示词指南建议明确相关文件、目标和验证要求。本地项目、Codex 提示词。如果使用 Codex CLI,还可以使用官方文档中的 @ 文件路径补全;这里没有把 CLI 交互当作桌面 App 的具体按钮操作。
DeepSeek Harness: 在已打开的本地 Harness 会话中选对项目工作区,再发送上面的项目相对路径提示词。官方指南说明了本机运行界面中发送请求前选择工作区的流程。Harness 工作区指南。先指定一个具体的 .md 或 .txt 文件,要求返回标题或第一个非空行,再进行总结。
无论使用哪一种工具,都应把返回的文字与原文件核对。只复述你提供的路径,不能证明它读过文件内容。
复制路径时,需要额外工具吗
已经找到文件时,优先使用当前电脑里的文件管理器。额外软件应当解决你任务中的其他需要。
| 你的情况 | 实用选择 | 依据与限制 |
|---|---|---|
| 已找到文件,只需要它的位置 | Finder 或文件资源管理器 | Finder 文件/文件夹复制已实测;Windows 只核对了文档 |
| 已在代码项目中工作 | VS Code | 官方说明了绝对路径与工作区相对路径复制;本次未实测 |
| 已使用其他 Mac 文件管理器 | Path Finder | 官方版本说明记录了 UNIX 路径默认行为;本次未安装或实测 |
VS Code: 使用文件的 Copy Path 获取绝对路径;需要相对于工作区文件夹根目录的位置时,使用 Copy Relative Path。这个区别见 VS Code 官方功能说明。复制相对路径前,先确认打开的是正确工作区。仅为复制一次 Finder 路径,不必安装编辑器。
Path Finder: 如果你已经在使用它,其 26.1.1 版本说明指出,父级 Copy Path 菜单项默认复制 UNIX 路径。Path Finder 更新说明。我们没有测试它的界面、速度或付费方案;原生方法已经能完成基本任务。
Agent 为什么还是读不到文件
给到的是文件夹。 你可能复制了地址栏或父目录。重新选中文件并复制,检查路径最后一段是不是想要的文件名。
相对路径从错误的位置出发。 让 Agent 说明它当前使用的项目根目录或工作目录,与提示词里的根目录对照。使用绝对路径可以消除这一类歧义。
粘贴时改变了空格或引号。 把路径单独放一行,保留真实文件名,检查首尾引号。不要因为看到过终端示例,就在自然语言提示词里把空格替换成反斜杠。
文件移动了,或者读到的是另一份副本。 重新复制当前位置。文件移动后,旧路径不会自动更新。把 Agent 返回的标题或第一个非空行与目标文档核对。
Agent 报告无权访问。 准确位置不等于访问授权。让它给出尝试的路径和具体错误,再检查所选项目及产品访问设置。“不要修改文件”描述的是任务要求,不会替你切换工具的权限模式。
回答很泛,也没有确认文件内容。 要求先读取指定文件并返回约定的识别文字。先解决找不到文件或无法访问的问题,再依赖后续总结。