实测场景 · 2026-10-15

AI 本地知识库：用自己的文档做问答

把文档放进一个本地文件夹，让 Claude Code 建索引，提问时它只按你的文档回答，并标出出处。实测做法是让它写一个只用 Python 标准库的检索脚本 ask.py，文档里找不到的问题会直接回答「文档中未找到」，不硬凑。

✓用 3 份制度文档实测，67 秒写完检索脚本
✓4 个问题全部答对并给出出处文件；文档里没有的「健身补贴」回答「文档中未找到」
✓实测员 2026-10-15 复跑脚本，4 题结果一致；脚本本身不调用任何 API

先配好环境：改全局配置接上 AICodeWith

环境只配一次，之后所有场景通用。其他工具的接法见接入教程，Key 在哪拿见获取 API Key。

1. 装 Claude Code
按 Claude Code 官方安装文档安装，终端输入 claude --version 能看到版本号就行。
2. 创建 Key，改全局配置
登录后进控制台「密钥管理」创建密钥，不知道在哪的看获取 API Key 教程。
打开全局配置 ~/.claude/settings.json，在 env 里填上 Base URL 和 Key：
~/.claude/settings.json
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```
Base URL 末尾不要加 /v1。改完重开终端，运行 claude 能正常对话就说明接通了。

实测步骤

1. 准备文档，一句话让它建问答工具

新建一个文件夹，把 Markdown 文档放进 docs/ 子目录，在文件夹里运行 claude，输入：

text

docs/ 文件夹里是我们公司的几份制度文档。帮我做一个本地问答小工具：写一个不依赖任何第三方 API Key 的 Python 脚本 ask.py，读取 docs/ 下的 Markdown，按段落切块，用关键词/BM25 检索出最相关的段落，输出答案和出处（文件名+原句）。然后用它回答这几个问题并把结果写进 qa-results.md：（换成你的问题）。文档里没有的要明确说"文档中未找到"，不能编。

最后一句「文档里没有的要明确说文档中未找到，不能编」一定要写，它决定了脚本会不会硬凑答案。

2. 以后直接提问
脚本写好后，不用再开 Claude Code，直接在终端提问：
bash
```
python3 ask.py "入职 12 年有几天年假？"
python3 ask.py -k 3 "借测试手机找谁？"   # 看前 3 个候选段落
```
每次让 Claude Code 写出的脚本细节可能不同，第一次用请拿几个你知道答案的问题试一下。

常见问题自查

明明文档里有，却回答未找到: 让它调低匹配阈值或补同义词，再用这个问题复测。
文档是 Word 或 PDF: 实测只用了 Markdown。可以先让 Claude Code 把文档转成 Markdown 再建索引（这一步未实测）。
401 或请求失败: 检查 Key 是否完整，Base URL 是否为 https://api.aicodewith.ai（不带 /v1），改完重开终端。

FAQ

文档会上传吗？

检索脚本在本地运行、不调用 API，提问时文档不出你的电脑。写脚本那一步会把需求和必要内容发给 Claude Code 所用的接口。

会编答案吗？

实测脚本只返回文档原句和出处，找不到就输出「文档中未找到」。

要装向量数据库吗？

不用。实测脚本只用 Python 标准库，按关键词打分检索。文档很多、需要语义检索时再考虑别的方案。

想要一键版工具？留邮箱

不想自己配环境？我们在评估把「AI本地知识库」做成一键版工具，做好了第一时间通知你。

先配好环境：改全局配置接上 AICodeWith

1. 装 Claude Code

2. 创建 Key，改全局配置