BridgeAI

BridgeAI — Claude Code 插件

bridgeaibrasil.com.br · 巴西本地托管， 让你的编码 Agent 独立运行。

将 Claude Code 连接到 BridgeAI 平台。借助它，Claude 不再需要在黑暗中工作：它可以创建项目、查看数据库、日志、费用和线上运行状态，并在花费你的钱之前显示价格。

服务器、PostgreSQL 数据库、缓存和文件都位于巴西的机器上，使用 Pix 预付额度——无需订阅、账单或国际信用卡。你逐项购买，未订购的项目不会收费。

价格见 bridgeaibrasil.com.br/precos，这里刻意不列出：该页面由生成账单的同一份目录生成，因此两者不可能不一致。在这份 README 中输入的金额，会在目录变更的第一天就与实际价格不符，而这份文件没人会重新阅读。

它旨在配合guardrail 使用，而非取代它。guardrail 负责任何项目的安全和质量；本插件负责平台。请同时安装两者。

---

⚠️ 你可能不需要这个插件

自 15/09/2026 起，BridgeAI 的所有内容——工具、规则和指南——都由 MCP 服务提供。一个命令即可连接，无需重启任何内容：

claude mcp add --transport http bridgeai https://mcp.bridgeaibrasil.com.br/mcp

然后在聊天中输入 /mcp → 选择 bridgeai → 完成身份验证。这是 OAuth：浏览器只需打开一次，访问权限便会保存在客户端中。

分步指南见 bridgeaibrasil.com.br/comecar。

在本机运行的工具

隧道——它可以将你的 npm run dev 连接到云端数据库，无需 Docker——只需运行一个命令，也无需安装：

npx bridgeaibrasil tunnel --dev

在手机或网页端使用（claude.ai/code）

Claude Code 也可以在云端运行：你可以通过手机或浏览器开启会话，由 Anthropic 的一台机器代替你的电脑——克隆 GitHub 项目、安装并运行。这台机器不会产生额外费用；Claude 的工作会占用你套餐的额度，一如既往。

在云端，只需两个步骤即可连接 BridgeAI，且只需操作一次：

1. 将 BridgeAI 连接为连接器，前往 claude.ai/customize/connectors：添加自定义连接器，地址为 https://mcp.bridgeaibrasil.com.br/mcp。GitHub 会要求你授权，BridgeAI 随后会显示 “将 BridgeAI 连接到 Claude” 页面——确认这是你的账号，然后点击 连接。网页端、手机端和桌面端均适用。
2. 在云端环境的网络设置中允许两个域名（会话标题中的云图标 → Edit → Network access Custom，并勾选默认列表）： mcp.bridgeaibrasil.com.br 和 br-se1.magaluobjects.com。否则，开发数据库和文件将无法传输到云端机器。

其余步骤由服务器自行告知 Claude：设置 .env 并开启隧道。

⚠️ **云端的限制：**在云端运行的应用无法在你的手机上打开——localhost 属于 Anthropic 的机器。Claude 会通过截图展示页面；要实际查看，请将其发布。

---

仍要安装插件

插件仍可使用，也仍在发布。它现在新增的是快捷命令（/bridgeai:publicar、/bridgeai:custo）和两个 hook。平台提供的任何功能都不依赖此插件。

/plugin marketplace add marcoshenriquemaia/bridgeai-plugin
/plugin install bridgeai@bridgeai

如果出现 Run /reload-plugins to activate，请输入 /reload-plugins。

创建第一个项目

/bridgeai:comecar

它会准备机器、在 BridgeAI 中创建项目，并让项目在你的电脑上运行。发布到互联网只需执行 git push：具体步骤就在该命令中。

需要 Node.js

登录、隧道和检查均通过 Node 运行。使用 node --version 检查；如果报错，请从 nodejs.org 下载 LTS 版本。/bridgeai:comecar 也会在 Windows 上自动安装。

---

包含内容

命令

命令	用途
/bridgeai:entrar	将此机器连接到你的账户
/bridgeai:comecar	从空机器开始，让项目运行起来
/bridgeai:publicar	发布项目，无需在 GitHub 中进行任何配置
/bridgeai:doutor	“无法正常工作”时——检查并修复
/bridgeai:custo	查看花费了多少，以及可以在哪些方面节省

技能

当相关话题出现时会自动加载——你无需调用。

技能	适用场景
publicar-mobile	手机应用：测试、分发、发布到应用商店
painel-do-projeto	管理区域、CMS、指标

自动保护

• 不可逆操作需要审批码。 创建项目、更改套餐或删除应用，都必须使用你从控制面板复制的审批码。Claude 无法生成此代码——这能防止隐藏在日志或数据库记录中的指令破坏任何内容。
• 先了解成本，再决定是否花费。 提出的任何资源都必须标明每月的雷亚尔价格。
• 发送前检查 GitHub 连接。 访问权限过期时，你会收到重新连接的步骤，而不是一条英文错误消息。

---

规则来自服务端，而非此处

自 15/09/2026 起，平台规则通过 MCP 服务的 instructions 字段提供，不再由此插件的 hook 提供。它们现已适用于任何 MCP 客户端——Claude Code、Codex、Cursor——无需安装任何内容。

技能和模板也是如此：它们由 get_guide 工具提供。

⚠️ 因此，使用 BridgeAI 不再需要此插件。 它仍可正常工作，也仍在发布；目前公布的使用方式仅限 MCP 服务。本地工具——隧道、端口注册——位于 npx bridgeaibrasil 中，无需安装。

---

结构

.claude-plugin/plugin.json   manifesto
.mcp.json                    conexão com o MCP da BridgeAI (login por OAuth)
hooks/hooks.json             início de sessão e proteções
commands/                    os comandos acima
skills/                      carregadas sob demanda
scripts/                     túnel, portas, login e hooks — Node sem dependências
bin/bridgeai.js              o comando do `npx bridgeaibrasil`
package.json                 o pacote npm com as ferramentas locais
templates/publicar.yml       o workflow que publica o seu projeto

⚠️ 这里已不再有 rules/。 平台规则位于 MCP 服务中（mcp/rules/，由 instructions 提供）；若在此 hook 中重复这些规则，就会让安装了此插件的用户在每次对话中重复消耗约 25,000 个 token。scripts/hooks.test.js 会验证这一目录不存在。

许可证

MIT。