> ## Documentation Index
> Fetch the complete documentation index at: https://docs.study.faroapi.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Claude Code 命令行连接 Open Study

> 两行命令从 GitHub 安装插件，在会话里输入 /mcp 完成授权。

Claude Code 命令行从官方 GitHub 仓库安装，之后也从同一来源更新。已有用户用这种方式连上 Open Study。用 Claude Code 桌面端、不敲命令的，看[Claude Code 桌面端](https://docs.study.faroapi.cn/connect/claude-desktop.md)。

## 安装插件

在终端里执行，对本机所有项目生效：

```bash theme={null}
claude plugin marketplace add https://github.com/moonlight-code-space/open-study.git
claude plugin install open-study@open-study --scope user
```

这两行不带分支参数，走仓库默认分支，插件内容和稳定分支 `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 时用；已经从 GitHub 装过的，保留原来的来源，恢复连接后再更新。
>
> 登录网站，打开左侧 **快速开始**，在页面下方 **离线包** 里下载 **Codex 插件**（里面也带着 Claude Code 的清单），完整解压到准备长期保留的文件夹，然后把第一条命令换成指向解压出来的 `open-study-codex-marketplace-v版本号` 文件夹：
>
> ```bash theme={null}
> claude plugin marketplace add <解压出来的文件夹路径>
> claude plugin install open-study@open-study --scope user
> ```

## 授权

装完会显示 `! Needs authentication`，这是正常的。在 Claude Code 会话里输入 `/mcp`，选中 open-study，浏览器会打开 Open Study 的授权页，登录后点 **允许连接**。习惯终端的话，也可以运行：

```bash theme={null}
claude mcp login "plugin:open-study:open-study"
```

服务名带 `plugin:` 前缀，引号不能省。这条命令需要交互终端，AI 的终端工具跑不了。

**让 AI 代为授权**：插件加载后（重启或新开会话后），Claude Code 会给 AI 一个 open-study 的授权工具（名字里带 `authenticate`）。AI 调用后拿到授权链接，可以替你在浏览器里打开，或把链接发给你；你登录后点 **允许连接**，Claude Code 会自动重连。还没有 Open Study 账号，先到 [study.faroapi.cn](https://study.faroapi.cn) 注册。密码只填在网站的授权页，不用发给 Agent。

## 不想自己敲命令

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

## 确认能用

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

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

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

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

## 更新与遇到问题

从官方 GitHub 仓库安装的，沿用原来源更新；第一条失败时先处理错误：

```bash theme={null}
claude plugin marketplace update open-study
claude plugin update open-study@open-study --scope user
```

更新后退出当前会话重新启动 Claude Code，新会话里发上面「确认能用」那句。

本地目录或其他仓库装的，先保留原配置、核对原来的安装方式，不要添加同名来源去覆盖它。

GitHub 上的版本有时比网站上显示的晚，这是正常的：保留 GitHub 来源，不要为了追版本换成本地下载的文件。

* **连接问题**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **官方说明**：[Claude Code 插件](https://code.claude.com/docs/en/plugins-reference)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.