> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

如果你已经在本地电脑上部署了 Agent，可以将它**接入扣子**，用扣子进行对话管理和操作。
扣子只提供对话入口，Agent 本身仍运行在你自己电脑上，不会迁移到云端。
## 什么是本地 Agent {#6883322d}
在扣子上创建本地 Agent，可以将你电脑上已经安装的 Agent 接入扣子，包括 Claude Code、Codex CLI、基于 OpenClaw 开源框架的各类 Agent。接入后，你可以在扣子中直接和它对话，让它处理本机文件、操作本机软件，或读取、修改和运行本地代码项目。
扣子提供对话入口和协作管理，实际任务仍由你电脑上的本地 Agent 执行。你的本地 Agent 不会被迁移到云端。
## 接入后可以做什么？ {#f3e1e658}
如果你已经在本地部署 Claude Code、Codex CLI、OpenClaw，接入扣子后可以解锁两种新的使用方式：

* **随时随地操作本地 Agent**：原本这些 Agent 部署在本地终端，你需要在电脑前才能使用。接入扣子后，只要终端保持在线，你就可以通过手机给本地 Agent 下指令，在不方便打开电脑时也能推进工作。例如：
   * 出门在外时，用手机让本地 Agent 查看电脑里的 Excel 文件，并帮你提取某个数据。
   * 在路上想到代码问题，让本地 Claude Code 查看本地仓库，定位可能原因。
   * 需要处理本机软件信息时，让本地 Agent 打开浏览器、飞书等应用，完成查询或操作。
* **拉入项目，团队共同指挥本地 Agent**：将本地 Agent 添加到项目后，项目内所有成员均可 **@ 它下达指令**。例如：
   * 开发者在本地通过 Claude Code 开发代码，那么将本地 Claude Code 拉入扣子项目后，产品经理等人员可以直接 @ 它询问开发进展。
   * 一个 Agent 负责编写代码，另一个 Agent 负责审核代码。比如让本地 Codex CLI 完成实现，再让 Claude Code Agent 审查代码，并给出修改建议。

## 怎么接入 {#d27c5ca1}
接入本地 Agent 的核心是在你的电脑上安装并运行一个轻量程序 **coze-bridge**。它负责在扣子和你电脑上的本地 Agent 之间建立连接。
coze-bridge 会识别你电脑上已安装并支持接入的 Agent，包括 OpenClaw、Claude Code、Codex CLI。连接建立后，你在扣子中发送指令，本地 Agent 会在你的电脑上执行任务，并把结果通过扣子对话返回给你。
本地终端对话和扣子中的对话属于不同的会话，对话内容不同步。
:::notice 注意
为保证本地 Agent 正常在线，请在使用期间保持 coze-bridge 进程运行，并建议开启盒盖不休眠。电脑关机、断网、进入休眠状态，或 coze-bridge 进程停止运行，本地 Agent 与扣子的连接会断开。
如果断开连接，你可以重新运行连接命令来恢复连接。具体操作，请参考[本地 Agent 连接掉线了，怎么处理？](/cozespace/coze_app_faq#eda5f9ac)。
:::
## 注意事项 {#ecf4d810}

* 如果将本地 Agent 加入项目，相关配置仍需在 **Agent 设置**页面中完成；项目内不提供 Agent 设置入口。
* 如果在 **Agent 设置**中切换了模型，新模型仅对后续新建项目生效，已创建项目中的模型不会同步变更。
* 接入扣子本身不会出现 Claude 等账号封号风险，风险主要来自你本地配置的账号、Token、调用方式和使用强度。
* 如果本地 Agent 继续使用Claude、OpenAI、OpenClaw 配置，需注意：
   * 请求仍受原服务方条款、限流、计费和风控影响。
   * 多人共享个人账号、代跑账号、高频自动化、长期无人值守批量调用，可能增加风控风险。
   * 接入扣子不代表可以规避服务方限制，也不承诺降低封号风险。

## 套餐权益 {#f64b56c1}
不同套餐支持接入的本地 Agent 数量不同。
<!-- @cols-width: 169,112,112,120,120,100,100,108,100,102,100 -->
| | | | | | | | | | | | \
|**套餐权益** |**个人免费版**  |**个人进阶版**  |**个人高阶版**  |**个人旗舰版**  |**个人尊享版** |**团队高阶版** |**团队旗舰版** |**团队尊享版** |**企业标准版**  |**企业旗舰版**  |
|---|---|---|---|---|---|---|---|---|---|---|
| | | | | | | | | | | | \
|连接本地 Agent 数量 |\
| |1个 |\
| |（限时免费） |1个 |3个 |10个 |不限制 |\
| | | | | | |每个成员3个 |每个成员10个 |不限制 |不限制 |不限制 |

## 前提条件 {#f112c5a3}
在接入本地 Agent 前，请先在本地电脑中安装 OpenClaw、Claude Code CLI、Codex CLI。相关安装说明请参考：

* OpenClaw：请参考 [Install OpenClaw](https://docs.openclaw.ai/zh-CN/install)。
* Claude Code CLI：请参考[Install Claude Code CLI](https://code.claude.com/docs/en/quickstart#step-1-install-claude-code)。
* Codex CLI：请参考[Install Codex CLI](https://developers.openai.com/codex/cli#cli-setup)。

## 接入步骤 {#daa3d068}
你可以参考如下步骤，接入本地 Agent。

:::: tabs
@tab 网页端、桌面端
1. 在[扣子](https://www.coze.cn/)的对话列表中，单击➕ > **新建 Agent**。
   ![Image=234x127](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/18380323ffcb4fc284d8c132a17a7b56~tplv-goo7wpa0wc-image.image)
2. 在**新建 Agent** 面板中，单击**接入本地 Agent**。
3. 单击**复制命令**，复制系统生成的本地连接命令。
   命令中 token 有效期为 60 分钟，请复制后，在 60 分钟内执行命令，完成配对。超过有效期后，请重新生成连接命令。
   ![Image=242x224](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e5e5a47b570e47e2b4921f642c167cd3~tplv-goo7wpa0wc-image.image)
4. 打开本地终端，执行连接命令。
   ![Image=408x128](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5f2d1737767a4a7e9f6495b433115e89~tplv-goo7wpa0wc-image.image)
   回显信息为 **`已配对连接完成，请返回到 coze 平台上点击 "我已执行"`**，则表示执行成功，本地已与扣子云端连接。
5. 返回扣子，单击**已粘贴执行**，系统开始识别本地 Agent。
   ![Image=276x259](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fe5ed88c838944eb8c706693dc72d2f7~tplv-goo7wpa0wc-image.image)
6. 创建 Agent。
   识别成功后，你可以设置 Agent 名称，然后单击**创建 Agent**。
   ![Image=212x234](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/33e42d0cceba4f37a9756cbf7034392f~tplv-goo7wpa0wc-image.image)

创建完成后，你就可以在扣子中与该本地 Agent 对话。
![Image=295x218](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/361b669d37dc46c7a3ef35a6cc384b1e~tplv-goo7wpa0wc-image.image)

@tab 移动端
1. 在扣子 App 顶部，单击➕ > **新增 Agent**。
   ![Image=147x286](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/885dd1b54a5140629fea153ad83eeaa9~tplv-goo7wpa0wc-image.image)
2. 在**新建 Agent** 面板中，单击**接入本地 Agent**。
3. 单击**复制命令**，复制系统生成的本地连接命令。
   命令中 token 有效期为 60 分钟，请复制后，在 60 分钟内执行命令，完成配对。超过有效期后，请重新生成连接命令。 
   ![Image=159x307](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5a65d56552414c83a911b53bcec88a7c~tplv-goo7wpa0wc-image.image)
4. 打开本地终端，执行连接命令。
   ![Image=296x93](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29749465a8324636a1db2c4f54ba0a5c~tplv-goo7wpa0wc-image.image)
   回显信息为 **`已配对连接完成，请返回到 coze 平台上点击 "我已执行"`**，则表示执行成功，本地已与扣子云端连接。
5. 返回扣子，单击**已粘贴执行**，系统开始识别本地 Agent。
   ![Image=136x277](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6b50788cc41249acb2c557a46c6daede~tplv-goo7wpa0wc-image.image)
6. 创建 Agent。
   识别成功后，你可以设置 Agent 名称，然后单击**创建 Agent**。
   ![Image=141x279](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a479fa9ea4ac41ff81868659bd19cb8a~tplv-goo7wpa0wc-image.image)

创建完成后，你就可以在扣子中与该本地 Agent 对话。
![Image=146x286](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b69fd0b50e4e48cb8f08a29917b4d1cd~tplv-goo7wpa0wc-image.image)

::::

## 简单使用 {#ec060ee4}
接入本地 Agent 后，你可以直接在扣子中使用对应的本地 Agent，并用自然语言描述你想完成的任务。
### 团队共用 Claude {#726526a0}
在扣子项目中，所有成员可以共用一个本地 Claude，协助完成任务。例如开发者在本地通过 Claude Code 开发代码，那么将本地 Claude Code 拉入扣子项目后，产品经理、测试、运营等其他成员，可以直接在项目会话里 **@ 它**，询问开发进展、了解功能状态。
示例指令
```Markdown
博客网页这个项目开发完成了吗？你是基于什么语言开发的？
```

![Image=653x279](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5232252dafb94c029d5147a23db374e5~tplv-goo7wpa0wc-image.image)
### 远程任务 {#60f35f8c}
当你不在电脑旁边，但需要使用本地 Claude Agent 帮你生成图片时，可以通过扣子远程下达指令。只要本地终端保持在线，本地 Claude Agent 就可以继续在你的电脑环境中执行任务。
例如，你在手机上想到一张运营配图创意，可以直接在扣子里 @ 本地 Claude Agent，让它根据你的描述生成图片，而不需要回到电脑前操作。
```Plain Text
请帮我生成一张小红书封面图，主题是“春季护肤新品”，风格清新明亮，画面中包含护肤品、花朵和浅色背景。帮忙发送到群里。
```

![Image=368x362](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/87e2013d964541eca57bc291e22ad6a5~tplv-goo7wpa0wc-image.image)
## 常见问题 {#f0d2679b}

* [什么是终端？](/cozespace/coze_app_faq#d3327573)
* [出现 npm not found、npx not found 错误，怎么处理？](/cozespace/coze_app_faq#bebdc231)
* [本地 Agent 连接掉线了，怎么处理？](/cozespace/coze_app_faq#eda5f9ac)
* [本地能接入的 Agent 类型包括哪些？](/cozespace/coze_app_faq#72bd9090)
* [支持接入本地的 Hermes 吗？](/cozespace/coze_app_faq#18704a6b)
* [创建 Agent 之后如何查看 Agent 类型？](/cozespace/coze_app_faq#3bd3c1c1)
* [接入本地 Agent 有数量限制吗？](/cozespace/coze_app_faq#3af8b8f9)
* [如何删除 Agent？](/cozespace/coze_app_faq#5100c0bc)