Agent 概览
连接 Claude
让 Claude 桌面版、Cowork 或 Claude Code 通过本机 MCP 使用 Beav 的数据、工具和 Beav Agent。
核对日期：2026-10-07。适用于包含 Claude 接入的新版 Beav；以下 Claude 桌面版、Cowork、Claude Code 的安装步骤已核对源码，尚未在真实宿主中逐一验收。
Beav 为 Claude 准备三种安装包，对应三个使用场景。三者连接的是同一个本机 Beav，共用一份可在 Beav 中撤销的授权。
| 场景 | 安装包 | 用法 |
|---|---|---|
| Claude 桌面版聊天 | beav-creator.mcpb | 双击安装为扩展 |
| Cowork | beav-creator-plugin.zip | 作为插件上传 |
| Claude Code | 本机插件市场 | 用 claude plugin 命令安装 |
Claude 插件里的本机 MCP 只在 Cowork 和 Claude Code 中生效；在 Claude 桌面版的普通聊天中使用，请安装 .mcpb 扩展。
1. 准备安装包
在 Beav 所在的电脑上打开终端，运行桌面版内置的 Beav 程序（macOS 标准安装位置如下；其他系统请使用实际安装位置）：
"/Applications/Beav.app/Contents/MacOS/beav" extension prepare claude命令会在需要时启动 Beav，为 Claude 创建本机授权，并打印三样东西的位置。macOS 上它们位于：
~/Library/Application Support/Beav/claude-marketplace/这些安装包写入了本机 Beav 的位置，只能在这台电脑上使用，不要拷给别人。授权凭证保存在 Beav 的私有目录，安装包只记录它的路径；不要把凭证内容发给任何 AI。
2. 安装到 Claude
Claude 桌面版聊天：双击 beav-creator.mcpb，在 Claude 弹出的窗口中确认安装；也可以在 Claude 设置的“扩展”中选择这个文件安装。扩展使用 Claude 桌面版自带的 Node 运行。
Cowork：在 Cowork 的插件管理中上传 beav-creator-plugin.zip。
Claude Code：在终端依次运行（路径换成准备命令打印的位置）：
claude plugin marketplace add "<准备命令打印的插件市场位置>"
claude plugin install beav-creator@beav-local安装后重新启动 Claude Code 或开一个新会话。
3. 验证连接
在 Claude 中让它调用 creator_status、creator_capabilities 和 workspace_list。三者都有正常返回，说明已经连上本机 Beav。之后可以直接让 Claude 检索知识库、读写稿件、使用生图生视频等工具，也可以让它把整件事交给 Beav Agent。想自己翻看素材时，可以让 Claude 打开本机素材库网页。
Beav 升级后，重新运行一次准备命令，再按上面的方式更新安装包。准备命令会保留原有授权；只有在你明确要替换已撤销的授权时，才加上 --reauthorize。