Mascot Logo
ai-agents-tutorial

Part 1 · 第 5 课,共 16 课

用 Claude Code 处理真实文件

让智能体定位到笔记、Word 文档或 CSV 表格。

10 min

第 1 步 / 共 5 步 · 为什么要指定特定文件?

每次让 Claude Code 做事时,它都需要正确的上下文才能准确回答。但上下文是要花 tokens 的——既费钱又拖慢速度。如果让智能体在一个包含数千个文件的巨大文件夹里翻找,每个回答都会更慢、更贵。

解决办法是把真正重要的文件直接交给 Claude。最干净的做法是使用 @ 文件提及,它能把某个特定文件拉进当前对话。

第 2 步 / 共 5 步 · 创建一个示例文本文件

让我们创建一个文本文件来测试。在终端中,确保你仍处于 agent-playground 目录,然后运行:

echo "Claude Code is an agentic tool. It helps automate coding tasks, run terminal commands, and maintain codebases." > intro.txt

这会创建一个名为 intro.txt 的文件,其中包含一段对 Claude Code 的简短描述。

第 3 步 / 共 5 步 · 启动 Claude 并用 @ 提及文件

在你的 playground 文件夹中启动 Claude Code:

claude

当提示符准备就绪后,输入 @ 加文件名。当你输入 @ 时,Claude Code 会弹出文件选择器,让你挑选确切的文件:

@intro.txt

@ 提及会告诉 Claude 去读取那个特定文件并放入对话——无需猜测,也不会扫描整个文件夹。

第 4 步 / 共 5 步 · 要求对文件进行总结

现在,让 Claude 处理你刚提及的文件。在同一个提示中输入:

用一句话总结 @intro.txt。

Claude 会读取该文件并回答。因为你显式地指向了文件,它无需浪费 tokens 去猜你指的是哪个文件。

完成后,输入 /exit(别名 /quit)关闭会话。

第 5 步 / 共 5 步 · 检查点与本节回顾

本节回顾

  • 上下文优化:指定特定文件可以节省 tokens 并提升智能体速度。
  • @文件名:提及一个文件,让 Claude 把该文件读入上下文(输入 @ 时会出现选择器)。
  • 在一个提示中可提及多个文件;用 --add-dir 为会话添加另一个文件夹。
  • /exit(别名 /quit):安全地关闭会话。