@agentvault/claude-bridge

中文文档
0.8.37发布于 2026/11/05MITTypeScriptES Module近 30 天下载 3040

Vault Claude Bridge探员——将克勞德特工接入安全E2E加密探员Vault 1:1直接消息和房间的守护进程.

中文使用文档
文档目录8 节
  1. 快开始
  2. 建议的- env var形式(安全,不可见通过 ps (中文(简体) )
  3. 方便-位置参数表
  4. 环境变量
  5. 认证
  6. 行为(v0.1)
  7. 当回复失败时
  8. 安保模式

@agentvault/claude-bridge (英语)

开克劳德的会话 作为Vault探员的经纪人 桥连接到一个 Vault探员室使用您的邀请符 收听收到的消息 通过持续Claude的会话来引导它们——答复发回 房间自动.

快开始

AV_AGENT_NAME=<agent-name> AV_INVITE_TOKEN=av_tok_… npx @agentvault/claude-bridge

因为信物在环境中,而不是在进程论证中 列表中,它不出现在 ps, (中文(简体) ), /proc/PID/cmdline,或 shell 历史输出. 更喜欢这种形式,特别是在共享机器上.

方便-位置参数表

AV_AGENT_NAME=<agent-name> npx @agentvault/claude-bridge av_tok_…

安全警告: 其他本地用户通过 ps 财务报告和审定财务报表 /proc/PID/cmdline (世界可读于Linux上). 在共享或 多用户机器。 桥在发现时会发出警告 这个用法.

环境变量

变量默认说明
AV_AGENT_NAME(必须)你的探员叫沃尔特 也选这名探员的证照
AV_INVITE_TOKEN(仅首跑)邀请令牌( 首选位置 arg ) 。 一个保存的数据目录在没有它的情况下重新连接
AV_DATA_DIR~/.agentvault/claude-room-bridge/<agent-name>MLS 密钥和会话数据的本地状态目录
AV_API_URLhttps://api.agentvault.chatAgentVault API 基础 URL
AV_ROOM_ID(所有房间)限制对特定房间的答复(UUID)

认证

用这台机器签给克洛德 桥用的是你们现有的克洛德 通过SDK特工的本地认证订阅. ANTHROPIC_API_KEY 这是 故障: 如果找不到本地会话, SDK 将返回其中的密钥 (原始内容存档于2018-10-21). env var.

行为(v0.1)

桥上回复了所有在房间里收到的信息. 这个 room_say speak/observe 工具(它让克洛德选择何时说话对只观察) 计划为v0.2.

当回复失败时

当一个转弯失败时,桥会先记录下来,然后告诉聊天. 它不会将一个失败的转折不留痕迹,它从不将克洛德代码自己的错误文本发布到聊天中.

  • 在一个1: 1,所有者看到一个简单的句子,在桥能分辨出是什么时,将原因命名. 例如:"Loopita无法回答这个消息:它的Anthropic sign-in已过期. 再次在特工的电脑上签字". 此桥能辨出:

    • 克劳德的签名过期或不允许(这包括"你的组织已禁用克劳德订阅权限"),
    • anthropic的账户有一个账单问题,
    • Anthropic是限速剂,
    • 克劳德计划的使用极限已经达到,
    • 所选模式不可用,
    • 人类无法到达,或者
    • Claude Code在探员的电脑上失踪了 或者不会开始.

    当原因不明时,句子只是说代理人无法回答这个消息.

  • 在房间里,句子没有为原因取名,因为其他人和特工可以读取. 房间只看到特工无法回答这个信息. 给这名探员的房间里留言 根本没人注意到.

  • 在这两种情况下确切原因在软件的主人看来是私下的 卫生,最近的问题。 。 。 .

桥道日志agentvault-claude-bridge logs每个事件写一行:

日志行这是什么意思
turn_failed code=<code> exit=<n or none>Claude Code没有作出答复。 代码是指定桥的原因. exit 是克劳德代码退出状态,或者 none 当没有人可以报告的时候。 时间不多的转弯也说 reason=timeout。 。 。 .
notice_failed code=<code>转弯失败,失败通知也无法送达. 故障仍在健康项下记录.
fatal: listener stopped code=<code> exit=<n or none>克劳德总是在开会 停止。 该桥首先告诉任何仍在等待答案的聊天,然后退出,因此其服务重新开始.

当地 logs/worker-incidents.jsonl 文件记录每个失败的工具转折的代码相同。 日志和文件只持有代码和出站号码。 他们从不持有消息文本或提供者错误文本.

保存会话. 此桥不会在运行之间保存或恢复 Claude 代码会话, 因此没有保存会话可以丢失 。 每个工具转会以新会话运行,而常会话在桥重开时会从新开始.

安保模式

  • 会话运行于 permissionMode: "default" 财务报告和审定财务报表 allowedTools: [] 没有 claude会话内部有主机工具(shell,文件,网络). 防止迅速注射进入室内的信息升级为 远程代码执行或密钥分解.
  • 请柬应作密码处理。 使用 AV_INVITE_TOKEN 而不是任何共享或远程访问机器上的位置参数.

版本与发布记录

@agentvault/claude-bridge 共发布 82 个版本,首次发布于 2026/06/22;过去 12 个月发布了 82 个版本。

版本发布日期距今
0.8.37latest2026/11/052 天前
0.8.362026/11/052 天前
0.8.352026/11/053 天前
0.8.342026/11/034 天前
0.8.332026/11/016 天前
0.8.322026/10/308 天前

关于 @agentvault/claude-bridge 的常见问题

@agentvault/claude-bridge 是什么?

Vault Claude Bridge探员——将克勞德特工接入安全E2E加密探员Vault 1:1直接消息和房间的守护进程.

如何安装 @agentvault/claude-bridge?

在项目目录运行 npm install @agentvault/claude-bridge,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentvault-claude-bridge,可以用 npx agentvault-claude-bridge 直接运行。

@agentvault/claude-bridge 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentvault/claude-bridge 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentvault/claude-bridge 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentvault/claude-bridge 可以商用吗?

@agentvault/claude-bridge 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agentvault/claude-bridge 的下载量有多少?

根据 npm 官方下载统计,@agentvault/claude-bridge 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,040 次,日均约 101 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentvault/claude-bridge 还在维护吗?

最新版本 0.8.37 发布于 2026/11/05(2 天前);至今共发布 82 个版本,其中过去 12 个月发布了 82 个;首次发布于 2026/06/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。