跳转到主要内容
Claude Code 命令行从官方 GitHub 仓库安装，之后也从同一来源更新。已有用户用这种方式连上 Open Study。用 Claude Code 桌面端、不敲命令的，看Claude Code 桌面端。

​
安装插件

在终端里执行，对本机所有项目生效：
这两行不带分支参数，走仓库默认分支，插件内容和稳定分支 plugin-stable 相同。 只想在当前仓库用，把 --scope user 换成 --scope project（写进仓库的 .claude/settings.json，随代码共享）或 --scope local（只在本机这个目录）。 在 Claude Code 会话里也可以输入 /plugin marketplace add https://github.com/moonlight-code-space/open-study.git，再输入 /plugin install open-study@open-study，作用域选「User」。 已经装过的，先核对原来的安装来源再更新，不要重复添加来源，也不要换成本地下载目录。
只在第一次安装、又连不上 GitHub 时用；已经从 GitHub 装过的，保留原来的来源，恢复连接后再更新。登录网站，打开左侧 快速开始，在页面下方 离线包 里下载 Codex 插件（里面也带着 Claude Code 的清单），完整解压到准备长期保留的文件夹，然后把第一条命令换成指向解压出来的 open-study-codex-marketplace-v版本号 文件夹：

​
授权

装完会显示 ! Needs authentication，这是正常的。在 Claude Code 会话里输入 /mcp，选中 open-study，浏览器会打开 Open Study 的授权页，登录后点 允许连接。习惯终端的话，也可以运行：
服务名带 plugin: 前缀，引号不能省。这条命令需要交互终端，AI 的终端工具跑不了。 让 AI 代为授权：插件加载后（重启或新开会话后），Claude Code 会给 AI 一个 open-study 的授权工具（名字里带 authenticate）。AI 调用后拿到授权链接，可以替你在浏览器里打开，或把链接发给你；你登录后点 允许连接，Claude Code 会自动重连。还没有 Open Study 账号，先到 study.faroapi.cn 注册。密码只填在网站的授权页，不用发给 Agent。

​
不想自己敲命令

这一节写给人看：登录网站，打开左侧 快速开始，点 Claude Code CLI 那张卡片，在 提示词 页签复制安装提示词，在 Claude Code 里发过去。它会读这一页、代你安装，再引导你授权。浏览器里的 允许连接 要你自己点。

​
确认能用

退出当前会话重新启动 Claude Code，把这段发过去：

请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。

收到资料列表或「资料库为空」，就说明连上了。

​
更新与遇到问题

从官方 GitHub 仓库安装的，沿用原来源更新；第一条失败时先处理错误：
更新后退出当前会话重新启动 Claude Code，新会话里发上面「确认能用」那句。 本地目录或其他仓库装的，先保留原配置、核对原来的安装方式，不要添加同名来源去覆盖它。 GitHub 上的版本有时比网站上显示的晚，这是正常的：保留 GitHub 来源，不要为了追版本换成本地下载的文件。