Claude Code 调用知识库：让 AI 直接读取文档

知识库建好了，接下来是最关键的一步：让 AI 实际读取和使用你的知识库文档。

这一节教你各种调用知识库的方式，以及每种方式最适合的场景。

基础调用方式一：@ 引用文件

在 Claude Code 对话框里，输入 @文件名 可以直接引用文件：

使用示例：

@产品知识库.md 请用这份知识库里的信息，
帮我写一封给客户王总的产品介绍邮件，
重点突出我们比竞品 A 的优势

AI 会读取 产品知识库.md 的内容，然后基于里面的信息来写邮件，而不是凭空想象。

注意： 使用 @ 引用时，文件必须在 Trae 的当前项目文件夹里。

基础调用方式二：上传文件

如果文件在任意位置，可以：

1. 直接把文件拖入对话框
2. 点击输入框旁边的附件按钮上传

使用场景： 文件不在项目文件夹里，或者你想一次上传多个文件。

进阶调用方式：CLAUDE.md 自动加载

上一章提过 CLAUDE.md 文件，这里再详细说说：

在你的项目文件夹里创建 CLAUDE.md，内容示例：

# 项目上下文说明

这是 [公司名] [部门名] 的工作文件夹。

## 我的角色
- 职位：[你的职位]
- 主要工作：[工作描述]

## 自动加载的知识文档
- 产品信息：参见 knowledge/产品知识库.md
- 写作规范：参见 knowledge/写作规范.md
- 常用模板：参见 knowledge/工作模板.md

## 默认要求
- 所有内容使用中文
- 格式遵循 knowledge/格式规范.md
- 涉及价格信息请提示我核实

配置好 CLAUDE.md 之后，每次在这个文件夹里使用 Claude Code，它会自动读取这些信息，不需要你每次都重新告诉它背景。

组合调用：多文件联合使用

有时候一个任务需要参考多个知识库文档：

我需要写一份竞品分析报告，请参考以下文件：

1. @knowledge/产品知识库.md - 了解我们的产品情况
2. @knowledge/竞品信息.md - 了解竞争对手
3. @knowledge/报告格式模板.md - 按这个格式输出

分析维度：功能、价格、目标用户、优劣势
结论要有可操作的建议

实战案例：客户服务知识库调用

场景： 客服人员收到客户投诉，需要快速生成专业回复

知识库结构：

knowledge/
├── 产品FAQ.md          # 常见问题和标准回答
├── 退款政策.md         # 退款流程和规则
├── 服务承诺.md         # 对客户的承诺和边界
└── 邮件模板库.md       # 各类回复邮件模板

调用方式：

客户投诉内容：[粘贴客户邮件]

请参考以下文件处理这个投诉：
- @knowledge/产品FAQ.md 查看是否是已知问题
- @knowledge/退款政策.md 确认是否符合退款条件
- @knowledge/邮件模板库.md 选择合适的回复模板

生成一封回复邮件，要求：
- 承认客户的不满
- 说明问题原因（如果知道的话）
- 给出解决方案
- 语气专业，体现重视

实战案例：内容创作知识库调用

场景： 运营人员按品牌规范批量生成内容

知识库结构：

knowledge/
├── 品牌声音手册.md     # 品牌语气和风格
├── 禁用词汇.md         # 不能使用的词和表达
├── 成功案例.md         # 效果好的内容示例
└── 平台规范.md         # 各平台的发布规范

调用方式：

我需要为明天的618大促写 5 条微博文案

背景信息请参考：
@knowledge/品牌声音手册.md
@knowledge/禁用词汇.md

参考成功风格：@knowledge/成功案例.md

产品：[产品名和核心卖点]
主题：618优惠，限时折扣

知识库调用的最佳实践

1. 一次不要引用太多文件

每次引用 3-4 个文件为上限，太多文件 AI 处理时可能会遗漏细节。

2. 告诉 AI 每个文件的用途

请参考以下文件（每个文件的用途已说明）：
- @产品规格.md：了解产品的技术参数
- @客户画像.md：了解目标用户的特点
- @写作规范.md：遵循这个格式来写

任务：[任务描述]

3. 定期验证 AI 的知识库理解

有时候 AI 可能没有正确读取文件，可以先问它：

请先读取 @产品知识库.md，然后告诉我：
1. 我们产品的核心卖点是什么？
2. 主要竞品是谁？
3. 有哪些功能是不能承诺给客户的？

确认你理解了这些信息之后，再开始帮我写内容。

常见问题

Q：AI 读取了文件，但回答里没有用到文件里的信息怎么办？ A：明确说”请必须基于 @XXX 里的信息来回答，不要凭空想象”。或者先让 AI 复述文件里的关键点，确认它读懂了。

Q：文件很长，AI 能读完吗？ A：大多数模型能读取几千到几万字的文件。如果文件太长，可以：

1. 把文件拆成几个更小的主题文件
2. 或者告诉 AI 只需要读取文件的特定部分

Q：每次都要 @ 引用文件太麻烦了，有没有更简单的方法？ A：使用 CLAUDE.md 自动加载，把最重要的背景信息配置进去，就不需要每次都手动引用了。

---

下一节，我们来学习如何把知识库用于解决同类问题，真正体现知识沉淀的复利效应。