跳转到主要内容
ZCode 能直接安装 Claude Code 格式的插件。装好之后还要你亲手点一次 打开授权：ZCode 不会自动发起授权，也没有给 AI 用的授权命令，这一步不点，Open Study 会一直显示「需要授权」。

​
安装插件

1

打开插件市场

进入 设置 → 插件。插件页要先打开任意一个工作区才能用；提示「打开一个工作区以管理插件」时，先随便打开一个项目。
2

添加 Open Study 的插件市场

点右上角 创建 → 添加插件市场，来源选 GitHub 仓库，填下面这一串：
3

安装

添加成功后，在 个人 分段找到 Open Study，点 安装。状态变成「已安装」就好了，新装的插件默认启用。
只在第一次安装、又连不上 GitHub 时用；已经从 GitHub 装过的，保留原来的来源。登录网站，打开左侧 快速开始，在页面下方 离线包 里下载 Codex 插件（ZCode 也用它），解压到一个固定目录，不要放在下载文件夹或临时目录。回到 创建 → 添加插件市场，选本地的市场清单目录，指向解压出来的 open-study-codex-marketplace-v版本号 文件夹（里面有 .claude-plugin）。

​
授权

1

找到 open-study

进入 设置 → MCP 服务器。插件带来的服务在 Plugin MCP 服务器 那一组，open-study 那一行会显示「需要授权」。
2

点「打开授权」

ZCode 会用系统浏览器打开 Open Study 的授权页。登录你的 Open Study 账号，点 允许连接。
3

回到 ZCode

ZCode 会自动重连并加载 Open Study 的工具。新开一个对话再用。
还没有 Open Study 账号，先到 study.faroapi.cn 注册。密码只填在网站的授权页，不用发给 Agent。

​
也可以让 AI 带你装

这一节写给人看：登录网站，打开左侧 快速开始，点 ZCode 那张卡片，在 提示词 页签复制安装提示词，到 ZCode 里新开一个对话发过去。它会读这一页，一步步告诉你在界面上点哪里。插件市场和「打开授权」都要你自己点。

​
确认能用

新开一个对话，把这段发过去：

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

收到资料列表或「资料库为空」，就说明连上了。之后直接把视频链接发给它，说明你想做什么。

​
只想连上工具

不装插件、只加连接也可以，但拿不到 Open Study 的使用说明（Skill），AI 不知道什么时候该用它。
  1. 进入 设置 → MCP 服务器，点右上角 新建 MCP 服务器。
  2. 类型选 HTTP，名称填 open-study，地址填 https://study.faroapi.cn/mcp，点 添加。
  3. 回到列表，这一行显示「需要授权」时点 打开授权，按上面的授权步骤完成。

​
更新

插件有新版本时，在 设置 → 插件 点 Open Study 打开详情页，底部有更新入口；也可以在 管理已安装 里点 检查更新。更新后 ZCode 会自动刷新受影响的会话。GitHub 上的版本有时比网站上显示的晚，这是正常的：保留 GitHub 来源，不要为了追版本换成本地下载的文件。

​
遇到问题

  • 一直显示「需要授权」：确认点过 打开授权，并在浏览器里点了 允许连接。新建会话时授权没完成，ZCode 只会把这一个服务标成失败，不影响别的。
  • 换了服务地址或授权范围：要重新授权一次。
  • 其他情况：见插件更新与连接问题。
  • ZCode 官方说明：插件、MCP。