安装插件
codex 命令的，先装 Codex CLI，或者把快速开始里的安装提示词发给 Codex 桌面端让它代装。
已经装过的，先按原安装方式更新，不要重复添加来源，也不要换成本地下载目录。
连不上 GitHub 时
连不上 GitHub 时
只在第一次安装、又连不上 GitHub 时用；已经从 GitHub 装过的，保留现有插件，恢复连接后再更新。
- 登录网站，打开左侧 快速开始，在页面下方 离线包 里下载 Codex 插件，完整解压到准备长期保留的文件夹。
- 先确认终端能运行
codex plugin --help；macOS / Linux 还要有 Python 3，缺了先装 Codex CLI 或 Python 3。 - 在解压出来、包含
install.sh的那个文件夹里运行：macOS / Linux 用sh ./install.sh --offline，Windows 用powershell -ExecutionPolicy Bypass -File .\install.ps1 -Offline。 - 装好后保留这个文件夹，再按下面的步骤授权。
授权
有的 Codex 版本装完会自己弹出授权，跟着走完即可。 桌面端：打开 设置 → 插件，切到顶部的 MCP 页签，插件带来的服务在「来自插件」里，open-study 那一行点 进行身份验证（英文界面是 Authenticate）。浏览器打开 Open Study 的授权页后，登录并点 允许连接。 这个按钮有时点了不会打开浏览器。没反应就改用下面的命令，桌面端和命令行共用同一份授权。 命令行：https://study.faroapi.cn/authorize 开头的授权链接，再尝试打开浏览器，然后在本机等你最多 5 分钟。登录后点 允许连接，等命令显示 Successfully logged in to MCP server 'open-study'。浏览器没自己打开时，把打印出来的链接复制到浏览器里打开。不要加 --no-browser：加了它，命令会要求把跳转后的地址粘贴回终端。
让 Codex 里的 AI 代为授权：AI 能运行 codex 命令时，可以替你运行上面这条命令，从输出里取出授权链接，用默认浏览器打开并发给你，再等命令显示成功。Codex 可能请你批准联网或本机端口，照实批准即可。
还没有 Open Study 账号，先到 study.faroapi.cn 注册。密码只填在网站的授权页，不用发给 Agent。
不想自己敲命令
这一节写给人看：登录网站，打开左侧 快速开始，点 Codex CLI 或 Codex 桌面端 那张卡片，在 提示词 页签复制安装提示词发给 Codex。它会读这一页、代你安装，再引导你授权。确认能用
完全退出并重开 Codex（命令行退出当前会话再启动；桌面端重开后点 新建任务），把这段发过去：请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。
更新与遇到问题
-
先看原来的来源：
名称
open-study应只出现一次，来源是 Git 仓库moonlight-code-space/open-study；结果里有ref、refName或gitRef时应为plugin-stable。来源是本地目录、别的仓库或有重复条目时，先保留配置，把结果告诉维护者。 -
核对无误后依次运行，第一条失败时先处理错误，不继续下一条：
-
旧版
update.sh提示无法确认 ref：部分 Codex 版本的结果不带 ref 字段。核实是唯一的官方 Git 来源后，直接用上面两条命令更新；显示别的 ref 或核实不了来源时不要继续。这个提示不代表插件坏了。