> ## 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

> 从网站下载 .plugin 文件，在桌面端的插件页上传，再在插件页里完成授权。

在 Claude Code 桌面端装插件不用敲命令：从网站下载 `.plugin` 文件，在插件页上传即可。

## 安装插件

**1. 下载插件文件**

登录网站，打开左侧 **快速开始**，点 **Claude Code 桌面端** 那张卡片，在 **插件文件** 页签下载 `.plugin` 文件。

**2. 上传到桌面端**

在桌面端的插件页选择上传文件，选这个 `.plugin`。不要传离线包里 Codex 那个 ZIP，桌面端会报找不到 `plugin.json`。

## 授权

装完会显示未授权，这是正常的。在桌面端的 Open Study 插件页面按提示点授权，也可以在对话里输入 `/mcp` 选中 open-study。浏览器打开后登录 Open Study，点 **允许连接**，等桌面端显示授权成功。

授权状态每个客户端各存各的：命令行里授权过，不代表桌面端也授权了。还没有 Open Study 账号，先到 [study.faroapi.cn](https://study.faroapi.cn) 注册。密码只填在网站的授权页，不用发给 Agent。

## 也可以让 AI 带你装

这一节写给人看：在 **快速开始** 的 Claude Code 桌面端卡片里，**提示词** 页签有一段安装提示词。在桌面端新开一个对话发过去，它会读这一页，告诉你下载哪个文件、在哪里上传和授权。

## 确认能用

完全退出并重新打开桌面端，新开一个对话，把这段发过去：

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

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

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

## 更新与遇到问题

* **更新**：重新下载新版本的 `.plugin` 上传，再完全退出并重新打开桌面端，新开对话发上面「确认能用」那句。
* **连接问题**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **官方说明**：[Claude Code 桌面端](https://code.claude.com/docs/en/desktop)。


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