直接把 Zotero 文献库交给 Claude Code 去读，这件事我前前后后折腾了两周。在 Windows 和 Mac 两台机器上反复试，踩了权限、路径、锁文件、二进制解析各种坑，总算整理出一套能从零跑通的完整流程。这篇文章把关键步骤、配置代码和排查方法都写清楚，给同样想把文献管理接进 AI 工作流的朋友省点时间。
先说清楚“接入”到底指什么。Zotero 是一个本地文献管理工具，所有 PDF、笔记、标签、元数据都存在本地文件夹里，核心数据是一个 SQLite 数据库外加一堆附件文件。Claude Code 是 Anthropic 官方出的命令行编程助手，能在终端里读文件、写代码、执行命令。把两者接起来，本质就是让 Claude Code 获得读取 Zotero 数据目录的权限，然后你就能在终端里直接问它“帮我整理某篇论文的笔记结构”或者“根据我的 Zotero 标签体系给新文献分类”。这个组合对写论文、做综述、维护长期研究资料的人非常实用，技术门槛不高，但细节确实不少。
1. 接入前必须想清楚的三件事
1.1 这个接入本质上是在配置什么
我在动手之前先梳理了一个问题：Zotero 和 Claude Code 之间并没有官方插件，那“接入”到底接入的是什么？答案很简单，就是给 Claude Code 这个终端工具配置文件系统访问权限，让它能读取 Zotero 的数据文件夹。
Claude Code 本身是一个命令行程序，它默认只能读取当前工作目录里的文件。如果你在某个项目文件夹里启动claude，它能操作的就是这个项目内的内容。但 Zotero 的数据目录通常在家目录下，不在项目文件夹里，所以你必须通过配置文件显式地告诉它“你可以读这个地方”，这个过程就是“接入”。
搞清楚这一点非常关键，因为很多人会误以为需要装插件或者写复杂的同步脚本，其实不需要。Claude Code 有专门的权限配置机制，支持细粒度地允许或拒绝读取某个路径。我们把 Zotero 目录加进允许列表，就算完成了基础接入。后续所有能力，包括让它读 PDF、分析笔记、整理标签，都建立在这个路径权限之上。
1.2 你能用它做什么，以及不该让它做什么
接入之后最实用的几个场景，我实测下来是这样：
- 文献笔记整理：让 Claude 读取你 Zotero 里的笔记文件，按主题重新组织。前提是你的笔记是纯文本或 Markdown 格式，如果是 Word 或网页剪藏，解析效果会差很多。
- 标签体系梳理：Zotero 的标签存储在数据库里，Claude 读取后可以帮你统计标签频率、找出重叠标签、提出合并建议。
- PDF 元数据提取：读取 PDF 文件的开头部分，提取标题、作者、摘要。注意这是读取二进制文件，成功率看 PDF 内部格式，后面我会详细讲。
- 文献综述辅助：让 Claude 看若干篇 PDF 的摘要页，帮你快速对比不同文献的核心结论。
但有一件事我特别不建议：不要指望它直接管理你的 Zotero 数据库文件。Zotero 的zotero.sqlite是 SQLite 数据库，Claude 虽然能读但不应直接写。真要改动数据库，极易损坏实体文件，Zotero 官方也会拒绝加载被外部改动的数据库。所以接入后控制好权限，给只读就够了。
1.3 两台机器一个坑：操作系统差异
Windows 和 Mac 在这件事上的差异比我想象的大得多。表面看都是“给一个路径授权”，实际差别在于：
- 路径写法不同：Windows 是
C:\Users\用户名\Zotero，Mac 是/Users/用户名/Zotero。 - 系统权限机制不同：Windows 上主要是 CLI 自身的权限控制，Mac 上还涉及 macOS 的“完全磁盘访问权限”或者“文件和文件夹访问权限”，不止一道门槛。
- 同步方式不同：很多人 Windows 上用 Zotero 自带的文件同步，Mac 上用 iCloud 同步数据库，这两者的文件锁定机制不一样，直接影响 Claude 能不能顺利读到最新数据。
所以这篇文章我把 Windows 和 Mac 分成两条线来写，步骤不通用，踩坑的点也不一样，照着对应系统操作就行。
2. Windows 平台实操：一步步把 Zotero 目录授权给 Claude Code
2.1 先摸清你的 Zotero 数据目录在哪
Zotero 默认的数据目录在 Windows 上是：
C:\Users\[你的用户名]\Zotero里面有三个东西很重要：
zotero.sqlite——文献元数据数据库，包含标题、作者、期刊、标签、笔记等结构化信息。storage\[一串字符]\——每个文献条目对应的附件文件夹，PDF 文件在这里。styles和translators等文件夹——样式和转换器文件，Claude 基本用不到，别让它碰。
很多人的 Zotero 用了自定义数据目录，比如放在 D 盘或者开了 Zotero 自带的“链接附件”功能，这时候 PDF 可能分散在别的地方。所以不要凭默认路径直接配权限，先在 Zotero 里打开“编辑 → 设置 → 高级 → 文件和文件夹”，看一下“数据存储位置”到底是什么路径。
也有一种常见情况是你之前把数据目录迁移过。如果原目录还在，Zotero 会生成一个zotero.sqlite.old文件，Claude 读到这个旧文件时给出的文献列表可能是过时版本，这一点排查时要留意，别被它误导。
2.2 在 settings.json 里写入路径授权
Claude Code 的权限配置支持全局配置和项目级配置两种方式。我推荐做项目级，因为大多数情况下你是在某个专门整理的目录里启动 Claude，不需要全局放权。
操作步骤：在你要启动 Claude Code 的项目根目录下，找到（或新建）这个文件：
.claude\settings.json然后写入类似这样的内容：
{ "permissions": { "allow": [ "Read(C:\\Users\\你的用户名\\Zotero\\**)", "Read(C:\\Users\\你的用户名\\Zotero\\**\\*.pdf)", "Read(C:\\Users\\你的用户名\\Zotero\\**\\*.md)" ], "deny": [ "Write(C:\\Users\\你的用户名\\Zotero\\**)", "Edit(C:\\Users\\你的用户名\\Zotero\\**)" ] } }这里有几个细节值得展开说。
首先，路径分隔符必须用双反斜杠。Claude Code 在 Windows 上解析 JSON 配置，单反斜杠会被当成转义符，写C:\Users\...会直接解析失败。我一开始就栽在这上面，写了之后 Claude 完全不认这个路径，后来换成双反斜杠才通过。如果你觉得双反斜杠看着难受，也可以用正斜杠C:/Users/用户名/Zotero/**，实测 Claude Code 也能接受，但这属于我个人测试的结果，建议还是按照官方推荐的双反斜杠写更稳妥。
其次，Read(...)这个权限模式只允许读，不允许写。这是我在配置时特意限制的，理由前面说过：Zotero 数据库被外部工具写入容易损坏。配置里同时把Write和Edit都禁掉，Double保险。让 Claude 只读文献数据，它照样能完成整理、分析、总结这些核心工作，但绝对不会因为某个命令误操作破坏了你的数据库。
第三，**通配符的意思是递归匹配所有子目录和文件。如果你只写Read(C:\Users\...\Zotero\*)，那只能读取这个目录下的一级文件，storage 下面那些深层附件是读不到的，因为 Zotero 附件路径是storage\字母数字文件夹\文件.pdf，至少有三层深度。
2.3 Windows 上最容易踩的路径坑
在 Windows 上接入，我遇到了几个典型问题，这里直接列出来，遇到类似情况可以对号入座。
坑一：WSL 路径和 Windows 原生路径混用。很多人装的 Claude Code 不是在原生 Windows 命令行，而是跑在 WSL 里。如果你的终端是 WSL 的 Ubuntu 窗口，那你看到的路径是/mnt/c/Users/...，跟 Windows 原生的C:\Users\...是一个东西的两个写法。这时候配置权限到底写哪种？我的实验结果是：要看 Claude Code 跑在哪个环境里。如果在 WSL 里，就用/mnt/c/...这种路径；如果在 PowerShell 或 CMD 里，就用C:\...。写反了权限配置不会报错，但 Claire 就是读不到文件，排查起来特别隐蔽。
坑二：Zotero 正在运行时数据库被锁。Windows 上 Zotero 运行时会独占zotero.sqlite文件，Claude Code 尝试读取时会遇到权限异常，有时甚至直接卡住。不要慌，这不是配置错了，是正常的文件占用。要么退出 Zotero 再操作，要么拷贝一份数据库副本放到其他目录，让 Claude 读副本。实测中我一般先退出 Zotero，因为数据库副本会让文献信息滞后。如果你正在 Zotero 里查看某篇文献，突然切换到终端做同步分析，最好先重启 Zotero 或者确认没有正在执行的读写。
坑三：隐藏目录和 OneDrive 同步目录。有些朋友把家目录整个放到 OneDrive 同步，这时候 Zotero 数据路径里会带OneDrive字样，路径长度也容易超限。Claude Code 读这种路径虽然一般没问题，但 OneDrive 的“按需文件”功能可能导致文件只有云端占位符，本地没有实际内容，Claude 读到的就是空洞文件。这种情况建议把 Zotero 数据目录排除出同步范围，或者干脆保持本地存储不联动云同步。
3. Mac 平台实操：路径、沙盒与隐私权限
3.1 路径格式和 Windows 的差异
Mac 上 Zotero 的默认数据目录是：
/Users/[你的用户名]/Zotero如果用了自定义路径，同样要先在 Zotero 设置里确认“数据存储位置”。这步我建议直接打开 Finder，按Cmd + Shift + G输入路径跳转，看看实际文件夹结构，确认zotero.sqlite在里面，顺便检查有没有storage文件夹。
在 Mac 上写 Claude Code 的权限配置，路径就是标准的 Unix 格式，没有 Windows 那些转义问题，直接写到.claude/settings.json里：
{ "permissions": { "allow": [ "Read(/Users/你的用户名/Zotero/**)", "Read(/Users/你的用户名/Zotero/**/*.pdf)", "Read(/Users/你的用户名/Zotero/**/*.md)" ], "deny": [ "Write(/Users/你的用户名/Zotero/**)", "Edit(/Users/你的用户名/Zotero/**)" ] } }Mac 上路径这一关比 Windows 简单，真正难在下一层——macOS 系统的隐私权限。
3.2 macOS 隐私权限：少一步就全白搭
macOS 对终端访问“桌面、文稿、下载”以及“完全磁盘访问权限”是有系统级控制的。Claude Code 本质上是个命令行工具，运行在终端 App 里，你需要先把终端（或者你用的编辑器内置终端）加入允许访问 Zotero 数据目录的列表。
具体操作是：系统设置 → 隐私与安全性 → 完全磁盘访问权限（或“文件和文件夹”访问权限），把你要用来跑 Claude Code 的终端 App（比如 Terminal、iTerm2、VS Code 等）添加进去并开启开关。
这一步卡了我很久。当时我在 iTerm2 里启动 Claude Code，配置文件全部写对了，但它读 Zotero 目录时始终报操作不允许。后来发现是 iTerm2 没有获得 “文件夹访问权限”。Mac 上默认只能访问一些常用目录（桌面、文稿、下载），你的 Zotero 目录如果在~/Documents之外，就必须主动授权。
还有一点要注意：如果你用的是 VS Code 里的集成终端跑 Claude Code，授权时要给Visual Studio Code这个 App 授权，而不是给Terminal授权。运行 Claude Code 的进程本质上是 VS Code 的子进程，权限继承自 VS Code。给错了 App 授权，改多少次配置都是白费。类似地，如果你用 Zed、Cursor 等编辑器，也要给对应的 App 授权。
3.3 Mac 上 iCloud 同步导致的路径幽灵
Mac 用户的 Zotero 数据目录往往有个变体：如果开启了 iCloud 云盘，并且把 Zotero 文件夹放进了 iCloud Drive，那实际路径可能是：
/Users/[用户名]/Library/Mobile Documents/iCloud~md~obsidian/Documents/...甚至 Zotero 数据目录会在：
/Users/[用户名]/Library/Mobile Documents/com~apple~CloudDocs/Zotero这类路径下。这个路径里包含空格和特殊符号，配置时要用引号包裹，或者用正斜杠路径直接写。我的实际建议是：不要在 iCloud Drive 里放 Zotero 数据目录。Zotero 的 SQLite 数据库被 iCloud 同步时极易产生版本冲突，轻则同步异常，重则数据库文件损坏。如果你已经放进去了，建议在 Zotero 里改回本地目录，并做一次完整导出备份。
如果实在要用 iCloud 同步附件，也可以在授权时把 iCloud 路径也加进 allow 列表。注意，这种路径在 Claude Code 里读写性能会明显下降，因为 iCloud 会在后台做文件占位和按需下载，Claude 读取时可能触发下载，响应很慢。实测读一个 10MB 的 PDF，iCloud 路径比本地路径慢三到五倍，如果有大量文献批量分析还是本地目录更实际。
4. 进阶玩法与权限边界控制
4.1 用 CLAUDE.md 固定你的工作规则
完成基础授权后，如果你想让 Claude Code 每次都按你的需求处理 Zotero 数据，我建议在项目目录里创建一个CLAUDE.md文件。这是 Claude Code 在启动时会自动读取的说明文件，相当于给它的“工作手册”。
我自己写的CLAUDE.md大概长这样：
# 文献工作规则 - 你在读取 Zotero 数据时只能获取只读权限，严禁修改 zotero.sqlite 和 storage 目录。 - 当用户要求梳理文献时，优先读取 Zotero 数据目录中的 .md 和 .txt 笔记。 - 如果需要提取 PDF 信息，请告知用户 PDF 是二进制文件，识别准确率有限，并建议先手动确认。 - 标签统计任务：读取 zotero.sqlite 前先询问用户是否已退出 Zotero，避免读取到不完整的数据库。为什么要写这个文件？因为 Claude Code 本身有自主判断能力，但在不明确规则时它会做一些有风险的动作，比如尝试直接重命名文件、把笔记写入 Zotero storage 目录等。有了CLAUDE.md约束，这些误操作能大幅减少。我实测后觉得，这是整个接入流程里最值得花时间的一个文件，比任何配置文件都更能决定使用体验。
4.2 配合 Zotero 7 的“笔记导出”功能更顺滑
Zotero 7 的笔记系统比旧版好用很多，支持 Markdown 格式的独立笔记。我在实际使用中发现，如果直接让 Claude 读取杂乱无章的笔记内容，处理效果一般；但先做一层整理会好很多。
我的做法是：在 Zotero 里把所有重点文献的笔记都写成 Markdown，并统一存到storage文件夹的附件中。这样 Claude 读取后能很顺畅地提取出结构化的结论。你也可以在 Zotero 里选中若干文献条目，右键导出为“CSV”或“Better BibTeX 的 .json 文件”，放在项目目录里，让 Claude 读取这个文件来快速掌握文献清单。
强烈推荐用Better BibTeX插件，它能把 Zotero 文献库导出成一个references.json，包含所有条目信息。Claude 读 JSON 比读 SQLite 数据库稳定得多。这也是我在 Mac 上的主力方案，Windows 上同样适用，只是安装插件时注意 Zotero 7 的版本兼容性，去插件源下载最新版，别用旧版硬装。
4.3 权限边界：只开 Zotero 目录，不要全盘放权
我见过有人图省事，直接在 settings.json 里写Read(/Users/用户名/**)，把整个家目录都开放给了 Claude。这种做法非常危险。
Claude Code 是 AI 驱动工具，虽然它在设计上会征求用户同意再执行敏感操作，但你有多少私密文件在里面？浏览器配置、SSH 密钥、银行 PDF，这些如果被它读取，等于把你电脑的整个数字身份暴露给了 AI。我强烈建议权限遵循最小化原则：只开放 Zotero 数据目录和你的项目目录，其他一概不写。如果 Claude 需要读其他文件，运行时它会主动申请权限，你手动确认就好，这不麻烦，反而安全。
对应地，deny 列表里我建议把 SSH 配置和.aws这类敏感目录也保护起来，例如：
{ "deny": [ "Read(/Users/你的用户名/.ssh/**)", "Read(/Users/你的用户名/.aws/**)" ] }这算是我摔过跟头之后的经验。当时为了测试方便放开了家目录读取权限，第二天发现 Claude 自己在闲聊时引用了某个配置文件里的信息，虽然没造成实际损失，但心里很不舒服。从那以后我所有机器的权限配置都改成最小化白名单了。
5. 常见问题与排查技巧实录
5.1 权限配置没被识别，怎么排查
如果你发现 Claude Code 读不到 Zotero 目录，先不要急着改配置文件。按下面顺序排查：
- 确认配置文件生效位置：Claude Code 启动时会读取当前目录的
.claude/settings.json和用户目录的~/.claude/settings.json。你写错位置了，配置是不会被加载的。注意.claude是隐藏文件夹，macOS 上 Finder 默认不显示，Windows 上资源管理器也需要开启“显示隐藏项目”才能看到。启动 Claude 时看它输出的启动日志，里面会加载哪些配置文件的记录。 - 检查路径是否真实存在：在终端里手动
ls或者dir一下你写的路径，确认 Zotero 目录存在。Windows 上如果用户目录有中文用户名，路径写法也要用实际的中文字符，不要用拼音代替。 - 确认没有路径大小写问题：macOS 默认文件系统大小写不敏感，但如果你用了大小写敏感的分区，路径写错字母大小写也会读取失败。Windows 则不区分大小写，这个一般不是问题。
- 查看 Claude 的权限日志：启动 Claude Code 时设置环境变量
CLAUDE_CODE_DEBUG=1可以输出详细日志，里面会包含文件访问被拒绝的记录。这个日志能清楚告诉你系统尝试读取了什么路径，以及是被 Claude 的配置拒绝还是被操作系统拒绝。我排查 Mac 隐私权限问题时就是靠这个日志定位的。
5.2 读取 PDF 时是乱码，怎么办
这是新人最常遇到的问题。Zotero 里大部分附件是 PDF，而 PDF 本质是二进制文件，Claude Code 可以读取文件头信息（标题、作者），但遇到正文有时会显示出乱码或者只提取出部分文字。
这不是接入失败，而是 PDF 格式本身的局限。我常用的解决方案是：
- 优先读取 Zotero 里存的 Markdown 笔记和文本附件，这些是纯文本，Claude 解析得又快又好。
- 对 PDF 做预处理：如果你必须让 Claude 读 PDF 正文，先用工具把 PDF 转换出文本文件。Windows 上可以用
pdftotext（安装 poppler 工具包）；Mac 上系统自带的textutil和 Python 库PyPDF2、pdfplumber都可以。把 PDF 转成 txt 文件放在项目目录后，Claude 读起来完全没障碍。 - 限制篇幅：即使转成文本，一篇几十页的论文转出来也很大，Claude 上下文窗口有限。建议一次只处理一篇或者给 Claude 明确的“读前 5 页”指令，效果最好。
这里再说个冷知识：Zotero 的 storage 文件夹里，每个文献条目对应的文件夹里除了 PDF 之外，可能还有 Zotero 自动生成的.txt全文提取文件（取决于是否安装并启用了全文提取插件）。如果你装了 Zotero 自带的 PDF 索引功能，那这些.txt文件就是现成的文本资源，Claude 读起来比 PDF 顺畅得多。配置里我已经把.md加入允许列表，如果要用.txt也要一并加。
5.3 Zotero 数据库文件被占用，读不到
这个问题 Windows 和 Mac 上都有，只是触发场景不同。
Windows 上，Zotero 运行时会锁定zotero.sqlite，Claude 读取会失败。Mac 上，如果你开了 Zotero 同步，同步进程也会短暂占用数据库文件。解决办法要么临时退出 Zotero，要么我用的方式：复制一份数据库出来，让 Claude 读副本。复制时要用命令行工具做一致性的拷贝，不能直接在 Finder 里拖拽，否则可能复制到一半正在写入的脏数据。
顺便提醒：如果你用 Zotero 的“同步”功能同步了数据库文件，那么在你多台设备之间，zotero.sqlite的内容可能并不一致。我在 Windows 和 Mac 两台机器上测试时，就发现 Mac 上读到的文献数量比 Windows 少了几条，原因是同步还没完成。遇到文献数量对不上时，先在 Zotero 里手动触发一次“立即同步”，再退出 Zotero 操作，能避免很多所谓“灵异问题”。
5.4 配置没问题但速度很慢
有时候配置全部正确，Claude 能读取 Zotero 文件，但处理起来异常慢。常见原因有两个。
一个是目录太大。如果你的 Zotero 库里积累了几百上千个 PDF，Claude 在递归识别文件时会卡很久。我的处理方式是在项目目录里做一个软链接（Windows 上叫符号链接），只把最近需要处理的文献子集链接过来，让 Claude 只扫描这个子集。比如：
# Windows (管理员终端) mklink /D C:\Users\你\myproject\zotero_subset C:\Users\你\Zotero\storage\ABC123 # Mac ln -s /Users/你/Zotero/storage/ABC123 /Users/你/myproject/zotero_link另一个是Zotero 目录里文件类型太杂。Zotero 会存储网页快照（.html）、图片（.png、.jpg）等非文本资源，Claude 在读取这些文件时要么报错要么跳过，白白浪费时间。你可以在CLAUDE.md里明确告诉它“只处理 .md、.txt、.json、.csv 文件，不要尝试读取图片和网页存档”，这样它不会浪费精力尝试打开 HTML 和图片文件。
6. 两侧协同工作流：多设备同步的配置策略
6.1 为什么需要多端协同，以及如何设计
既然是在 Windows 和 Mac 两台机器上操作，就绕不开一个问题：两边的 Zotero 数据和 Claude Code 配置怎么协同。
Zotero 数据本身的同步用官方同步功能或者 WebDAV 就能解决，但 Claude Code 的接入配置不会自动同步。我的做法是：把.claude目录放进一个单独的项目仓库（私有 Git 仓库），里面包含settings.json和CLAUDE.md，Windows 和 Mac 分别 clone 下来，作为自己的工作目录。这样两边的配置保持一致，唯一的差异是路径里的用户名不同。
需要特别注意：绝对不要把 Zotero 数据目录本身放进 Git 仓库。zotero.sqlite是二进制数据库，每次改动都是大文件变更，仓库会飞速膨胀；而且 Zotero 数据库在使用中被改动时，Git 同步容易出现文件冲突。这也是我踩过的坑，一次仓库提交后数据库损坏，后来只能从 Zotero 的备份恢复，前后损失了几个小时的笔记。
6.2 跨平台路径差异处理
多端协同下，Windows 和 Mac 的路径不同，但settings.json里写死了绝对路径，这就会导致同一份配置在一端好用另一端报错。
我的解法是：项目级的settings.json里只放相对路径和项目内文件的权限，把 Zotero 目录的授权放到用户级的全局配置~/.claude/settings.json。这样每台机器上写各自的本机 Zotero 路径，互不干扰。项目仓库里的CLAUDE.md是共享的，它只写工作规则，不涉及具体路径，天然适合跨设备复用。
大概的职责划分是：
~/.claude/settings.json —— 放 Zotero 数据目录的路径授权，每台电脑独立 项目/.claude/settings.json —— 放项目目录、临时目录的权限，仓库内共享 项目/CLAUDE.md —— 放工作规则，仓库内共享这样设计后，我在 Windows 和 Mac 上启动 Claude Code，进入同一个项目仓库，体验几乎是一致的。Claude 知道两边的 Zotero 路径不同（读全局配置），但工作规则相同（读 CLAUDE.md），两边产出可以无缝衔接。
6.3 OneDrive 和 iCloud 的多端同步坑
多端协同的另一个大坑是云同步目录被 AI 读取。你如果把工作目录放在 OneDrive 或 iCloud Drive 里，Claude Code 读文件时会遇到两问题：一是按需下载导致文件不存在，二是同步状态变更导致 Claude 对同一文件的两次读取结果不同。
我自己最终的做法是：项目工作目录放本地，不复用云盘目录；Zotero 数据目录也在本地；只有文献引用数据通过 Zotero 官方同步在两端同步。这样虽然少了点“全云端”的便利，但稳定性和可靠性高了很多。如果你确实需要一个跨设备工作目录，建议用 Git 仓库来同步代码和配置，靠文件代码和数据区分开：代码和配置走 Git，文献数据走 Zotero 同步协议，不要把两者放在同一个网盘文件夹里。
6.4 长任务和大量文献处理时的注意点
多端协同还有一个容易忽略的细节：Claude Code 处理长任务时默认是流式输出，你看着它一行行打印结果。如果你在 Windows 上处理了大量 PDF 转文本任务，终端输出会很密集，建议用-o参数把输出重定向到文件，避免终端内容过多导致终端卡顿。同样，在 Mac 上如果任务时间太长，建议用nohup或者tmux方式在后台运行，避免窗口关闭任务中断。
另一件需要提前规划的事：Zotero 文献库越大，Claude 单次能处理的量就越有限。我通常要求 Claude 每次最多分析 5 篇文献并输出对比表，超过这个量它会开始遗漏信息。经验是分批处理比一次塞给它几十篇稳定得多。这一点在 Windows 和 Mac 上完全一样——AI 工具不分平台，这个限制是一样的。
7. 最终效果与个人体会
这套流程完整跑通之后，我在两台机器上的日常工作流变成了这样：上午在 Windows 上收集一批新的 PDF 放进 Zotero，下午在 Mac 上启动 Claude Code，让它读取最新同步的文献数据，整理笔记、补充标签、写综述段落。中间不需要手动导出任何东西，两个工具之间靠的就是那个 Zotero 数据目录的只读授权。
实际操作中我最有成就感的一个场景是写文献综述时，让 Claude 按年份和主题快速梳理了我 Zotero 里四十多篇相关文献的摘要信息，输出了一张对比表，省去了一整天的手工翻阅时间。事后我还是逐篇核对了它输出的准确率，大概 90% 左右的条目信息是准确的，个别文献的年份和期刊名有错。这提醒我：AI 读取文献数据做初步整理非常好用，但最终提交到论文里的任何信息都必须人工核对原文。
还有个小技巧我用了很久：在 Zotero 里把所有想重点跟进的文章都打上#to-read标签，Claude 读取标签列表时就能快速找出这个集合，并按我的CLAUDE.md规则生成阅读清单，精确到每篇文章的存储路径。这个习惯对长期维护研究资料特别有用，推荐你也试试。
最后再分享一点心得。接入 Zotero 和 Claude Code 的本质不是“让 AI 帮我管理文献”，而是“让我现有工作流里多了一个能理解文献背景的助手”。它不会替代你在 Zotero 里的手动整理，但能帮你把那些重复性、机械性的梳理工作消解掉。配置过程只要耐心走一遍，后续使用体验非常顺。遇到问题先看权限配置，再看数据库锁定情况，最后检查操作系统隐私设置，九成问题都能在这三层里找到答案。
