作者:互联网 时间: 2026-07-29 11:30:02
很多人给 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?这个怎么弄?auth_manager.py status 显示已认证。notebook_manager.py list 能看到你存的所有笔记本。全部弄完记得检查下 ~/.claude/skills/notebooklm/data/ 这个目录:这里存着你的认证信息和笔记本数据,千万别提交到 Git,也别随便发给别人。配置能跑通只是最基础的,要够稳定、可核对、不会乱暴露账号信息,才算真的接好用顺了。