很多人给 NotebookLM 接 Claude Code 的时候，最容易踩坑的不是装命令，而是认证和本地数据这块。notebooklm-skill 是靠浏览器自动化去访问 Gemini Notebook 的，你的登录状态、笔记本库还有浏览器配置都会存在 Skill 的目录里。配置的时候得先把「登录稳不稳」的问题搞定，再去琢磨怎么让 Claude 自动选对应笔记本。

第一步：认证配置怎么做？

cd ~/.claude/skills/notebooklm
python scripts/run.py auth_manager.py status
python scripts/run.py auth_manager.py setup

跑 setup 的时候会弹出一个可见的 Chrome 窗口，你手动登一下 Google 账号就行。这个仓库的认证说明写得还挺细的：它会同时存浏览器 profile 和 state.json，就是为了让 session cookie 更稳。配完之后记得再跑一遍 status 确认，别光看浏览器窗口登进去了就完事。

第二步：笔记本库别乱命名

加笔记本的时候，最好让 Claude 先问清楚这个笔记本是讲啥的，再存名称、描述和主题。你手动加也没问题，但 --description 和 --topics 别写太空泛的词。等之后你说「查 API 文档」的时候，Claude 全靠这些字段判断该调哪个 NotebookLM 的内容。

python scripts/run.py notebook_manager.py list
python scripts/run.py notebook_manager.py add --url "notebook link" --name "API Docs" --description "接口鉴权和错误码说明" --topics "api,auth,error"

第三步：查询配置要带上下文

这个 Skill 的查询是独立的问题模型，每次都会开新的浏览器会话，所以别问「继续刚才那个」这种没头没尾的问题。更靠谱的提问方式是：先指定哪个笔记本、说清楚要做啥、列清楚要的字段，还要提前说如果资料里没有就直接说找不到。

• 好问题：Ask my API notebook: in version 2.4, what auth headers are required for refresh token errors?
• 差问题：这个怎么弄？

配置完成后怎么验收？

1. 跑 auth_manager.py status 显示已认证。
2. 跑 notebook_manager.py list 能看到你存的所有笔记本。
3. 问一个资料里有明确答案的问题，返回结果得和原资料对得上。
4. 再问一个资料里根本没有的问题，Claude 不能瞎编。

全部弄完记得检查下 ~/.claude/skills/notebooklm/data/ 这个目录：这里存着你的认证信息和笔记本数据，千万别提交到 Git，也别随便发给别人。配置能跑通只是最基础的，要够稳定、可核对、不会乱暴露账号信息，才算真的接好用顺了。