# 连接 Claude

> 让 Claude 桌面版、Cowork 或 Claude Code 通过本机 MCP 使用 Beav 的数据、工具和 Beav Agent。

- 原文: https://beav.pro/docs/agent/claude

核对日期：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 标准安装位置如下；其他系统请使用实际安装位置）：

```text
"/Applications/Beav.app/Contents/MacOS/beav" extension prepare claude
```

命令会在需要时启动 Beav，为 Claude 创建本机授权，并打印三样东西的位置。macOS 上它们位于：

```text
~/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**：在终端依次运行（路径换成准备命令打印的位置）：

```text
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 打开[本机素材库网页](https://beav.pro/docs/agent/local-library)。

Beav 升级后，重新运行一次准备命令，再按上面的方式更新安装包。准备命令会保留原有授权；只有在你明确要替换已撤销的授权时，才加上 `--reauthorize`。