Muse Bridge

English · 简体中文

在 Muse 的 agent VM 上一键部署 Claude Code：装好之后，用手机或电脑的浏览器打开一个网址，就能用 Claude Code 写代码、处理文件、跑命令。也可以选装 dimensio，一个能接各家模型 API 的 agent 工作台，支持 Anthropic、OpenAI、Gemini、DeepSeek、Kimi、智谱、通义、小米 MiMo 等。

部署交给 Muse 自己做：你只要把一段话发给它，它会下载安装包、问你四个问题、装好、注册自愈看门狗，再一步步带你上手。整个过程不用碰命令行。

亮点

• 一句话部署：把开场提示词发给 Muse，剩下的它来做，大约 5–10 分钟。
• 手机、电脑都能用：打开网址就是完整的工作台，界面支持简体中文和 English，默认跟着浏览器语言。
• 安卓 app：就是 bridge 的安卓 App（同一个 apk）：在设置根页「插件」分组里的「安卓 App」下载，或者直接下载 apk。界面打包在 App 里，网速慢也秒开，连上后显示 Muse Bridge 品牌（桌面图标名字仍是 The Bridge）；App 版本跟着所连服务器走，临时地址变了一般会自动跟过去，没跟上就在「设置 › 关于 › 服务器地址」里更换。
• Claude Code 完整体验：由官方 Claude Agent SDK 驱动，支持工具调用、子 agent、工作流、上下文压缩和会话续接。右侧工作台有终端、文件、任务和改动审阅，设置页像手机的「设置」一样一层层点进去。另有权限模式与审批卡、计划卡，Claude 干活时可以插话或排队，会话搜索与归档，拉取请求跟踪，对话里直接画交互图表，撞上 5 小时限额后额度一恢复自动接着做。
• 一处配好所有模型（模型中心）：在「设置 → 模型中心」里加一次服务（DeepSeek、Kimi、OpenRouter、Anthropic / OpenAI / Gemini 兼容接口等），自动识别有哪些模型，按模型勾给 Claude、dimensio 或 Media Studio；Claude 里的模型出现在模型菜单的「More models」里；管理员和每个成员各有自己的一份。
• 能连 bridge 的 Windows 桌面客户端：绑了自己的域名（固定地址）时有完整的桌面体验——标题栏、快问浮窗、把电脑登记成设备让 Claude 操作；临时地址下客户端只当网页窗口用。
• 让 agent 来操作它：「设置 → Agent 接入」可以生成密钥，别的 agent（包括部署它的 Muse）拿到后能读项目手册、经 HTTP 操作 Muse Bridge。
• dimensio 多模型工作台：模型从模型中心来，随时切换模型；自带工作区、记忆和子 agent，能和 Claude 互开子会话。
• Media Studio（可选，默认关）：图像、视频、配音、音乐四个创作页放在一起，模型和 Key 自己接（Google Vertex、OpenAI、OpenRouter、fal 等），作品能拖进对话或工作空间。
• Claude 的「项目对话」：一件大事交给协调者拆开，几条讨论串并行去做，带项目概览、项目说明和项目记忆。
• 各家原生联网搜索：当前对话用哪家模型，就先用哪家自己的搜索，失败了自动换下一家，最后才退回 DuckDuckGo。
• VM 重启自动恢复：Muse 的 VM 会不定期重启，看门狗在 60 秒内把服务拉起来；临时地址变了，Muse 会主动告诉你新地址。
• 主动提醒更新：有新版本时，Muse 会用一两句话告诉你更新了什么，问你要不要更新。更新会等没人在聊天时才切换，新版本起不来会自动退回。
• 可以多人用：用邀请码注册，每个账号有独立的目录，可以按人分配 agent 和额度。管理员默认只看得到成员的会话标题、时间和用量，看对话内容要成员自己同意。

开始使用

把这段话整段发给你的 Muse：

我想请你在这台 VM 上安装 Muse Bridge，装好后教我怎么用。这是我自己选的一个开源项目（MIT 协议）：一个能用浏览器打开的 Claude Code / AI agent 工作台。源码和发布包在 https://github.com/Wode44398/muse-bridge （项目比较新，搜索引擎可能还搜不到，直接打开这个链接就行）。

第一步，下载最新的发布包并核对校验和。这台 VM 出站要走 hatch-egress-proxy 代理：

```bash
export HTTPS_PROXY=http://hatch-egress-proxy:3128 HTTP_PROXY=http://hatch-egress-proxy:3128
REL=/home/hatch/bridge-releases/$(date +%Y%m%d-%H%M%S) && mkdir -p "$REL" && chmod 755 /home/hatch/bridge-releases "$REL"
cd /tmp && curl -fLO --retry 3 https://github.com/Wode44398/muse-bridge/releases/latest/download/muse-bridge.tgz && curl -fLO --retry 3 https://github.com/Wode44398/muse-bridge/releases/latest/download/muse-bridge.tgz.sha256 \
  && sha256sum -c muse-bridge.tgz.sha256 && tar -xzf muse-bridge.tgz -C "$REL" && echo "解压到 $REL/bridge"
```

第二步，读 `$REL/bridge/deploy/muse/MUSE.md`，这是项目专门写给你的安装指南。按它来：先按第 1 节用一条消息问我四个安装问题，然后安装、配好看门狗 hook、检查结果，再带我上手。里面如果有你觉得不对或不安全的地方，停下来问我。

每条命令都要我批准，所以请尽量少跑命令。安装脚本会自己打印进度，不用拿 tail、ps、sleep 去轮询。每一步都把真实输出给我看。

Muse 会下载安装包、读安装指南，然后一次问你四个问题：

1. 装什么：只要 Claude Code、只要 dimensio，还是两个都要。只选一个时，打开网址直接就是那个 agent。
2. 有没有自己的域名（托管在 Cloudflare）：没有就用免费的临时地址，VM 重启后地址会变，变了 Muse 会告诉你；有的话可以换成固定地址。
3. 自己用还是多人用：选多人用，就可以给朋友发邀请码。
4. 出了故障要不要自动报告给开发者：要的话，服务崩溃、更新失败会自动发一份报告。报告只有版本、服务状态和程序自己的报错位置，不含对话、文件、key、地址。

拿不准就选：只要 Claude Code、临时地址、自己用。这些以后都能改。

你需要准备

• 一个 Muse 账号。
• 用 Claude Code：一个 Claude Pro 或 Max 订阅。令牌要在你自己的电脑上运行 claude setup-token 生成（Muse 会带你做），不要在 Muse 的 VM 上登录 Claude。
• 用 dimensio：至少一家模型厂商的 API key。

dimensio 支持哪些模型

厂商	key 的名字	联网搜索
Anthropic（Claude）	ANTHROPIC_API_KEY	✓ 自家搜索
DeepSeek	DEEPSEEK_API_KEY	✓ 自家搜索
Google Gemini	GEMINI_API_KEY	✓ Google 搜索
Kimi（Kimi for Coding 订阅，sk-kimi- 开头）	KIMI_API_KEY	✓ 自家搜索
智谱 GLM	ZHIPU_API_KEY	✓ 自家搜索
通义千问	QWEN_API_KEY	✓ 自家搜索
小米 MiMo（按量付费或 Token Plan）	MIMO_API_KEY	见下
任意 OpenAI 兼容服务	在模型中心里添加	—

这些厂商的 key 都在网页的「设置 → 模型中心」里填（加之前请 Muse 先放行这家的接口网站）；从旧版本升上来时，以前配过的 key 会自动搬进模型中心。

小米的联网搜索是控制台「插件管理」里的一个插件，按次计费（约 ¥16 / 千次），钱从账户余额里扣，所以只有按量付费的 key 能用。如果你聊天用的是 Token Plan 订阅的 key（tp- 开头），可以再建一把按量付费的 key，单独配给搜索：set-api-key MIMO_SEARCH_API_KEY <sk-…>，聊天照旧用 Token Plan 的额度。不配也行，小米搜不了会自动换别家。

安卓 app

用手机浏览器打开你的 Muse Bridge 地址并登录，进「设置」，在「插件」分组里点「安卓 App」，「下载 apk」那一行点「下载」。也可以从 GitHub 直接下载 apk，或者从服务器自己下载（/download/android）。第一次打开 app，在「连接你的 bridge 服务器」页点「扫码连接」扫另一台已登录设备上的配对二维码（网页版在「设置 › 关于 › 让另一台设备扫码连接」），或者点「手动填写地址（有账号密码 / 配对码）」，填服务器地址（可以把 Muse 回复的整句话直接粘进去）和 8 位配对码（也可填访问令牌），点「连接」。服务器升级后，app 里设置根页的「软件更新」会提示新版本。用过旧版 Muse app 的话，它会提示换装新版：装好新 app、连上登录后，再把旧版卸载（两个 app 包名不同，不能覆盖升级）。

app 只是把同一个网页界面装进独立窗口，新功能不用更新 app。连不上服务器时（比如 VM 重启后临时地址变了），app 会给出「更换地址」按钮，问 Muse 要现在的地址粘进去就行。手机拦着不让装时，按提示允许浏览器安装应用。iPhone 目前没有 app，可以用 Safari 的「分享 → 添加到主屏幕」。

常见问题

Muse 老让我批「允许 Muse 与 … 分享信息？」，是怎么回事？ Muse 的 VM 每访问一个新网站，都要你在 Muse 里批一次。安装和填 key 时，Muse Bridge 会趁你在场，把要用到的网站提前访问一遍，把审核卡片都弹出来。卡片可能在输入框上方，也可能在右侧的「待审核」面板里。「允许一次」只放行这一次，服务以后在后台再访问这个网站时还会再问，那时没人批就会卡住；「允许一次」旁边下拉里的「总是允许此站点」以后不再问（可以在 Muse 的设置 → 权限里撤销）。怎么选由你决定。如果某个对话一直停在「等待模型回复」，多半是有一张卡片没人批。

地址隔几个小时就变了？ 临时地址（*.trycloudflare.com）会随 VM 重启而变。变了 Muse 会主动告诉你新地址，登录令牌不变，换了地址重新登录一次就行。嫌麻烦就换成自己的域名，Muse 会带你配。

怎么更新？ 什么都不用做。有新版本时 Muse 会来问你，你说「更新」就行。也可以随时问它「有新版本吗」，或者让它开自动更新。

某个功能怎么用？ 直接问 Muse（「怎么分享文件」「以前的对话在哪」「带我熟悉一下 dimensio」）。安装包里带着一份写给 Muse 的使用说明书（deploy/muse/guide/），它照着你这个版本的说明书回答，不靠猜；也可以让它带你上手：5 分钟快速版、Claude Code / dimensio 深入、管理员与多人使用、手机上用。已知问题也会随更新频道下发，Muse 能告诉你某个现象是不是已知问题、怎么绕过。

遇到 bug 怎么告诉开发者？ 直接跟 Muse 说。一句话就行，不用 GitHub 账号：Muse 先判断是不是已知问题，再出草稿给你看，你同意了才作为 Issue 提交到本仓库，自动附上版本、服务状态和程序自己的报错，不含对话、文件、key 和地址，发送前可以先看内容。别人报过同一个问题的话，你的报告会变成对原报告的 +1；修好的版本发布时 Muse 会告诉你。安全问题私下发给维护者，不公开。（网页里「设置 → 提交反馈」写的东西只留在你自己的服务器上，Muse 能读到，不会自动发给开发者。）

花钱吗？ Muse Bridge 本身免费开源。Claude Code 用的是你自己的 Claude 订阅；dimensio 用的是你自己的模型 API key，费用由各家厂商按量收取。

限制

• Muse 的 VM 起不了浏览器沙箱，所以 agent 没有「打开网页、截图」这类浏览器工具；联网搜索和抓网页内容照常可用。
• 这是 Muse 平台的 VM，不是正式服务器：平台随时可能调整网络，长期对外提供服务也可能违反平台条款。别放重要数据，也别当生产环境用。

在普通 Linux 服务器上装

不在 Muse 上也能用。在 Debian / Ubuntu + systemd 的机器上：

git clone https://github.com/Wode44398/muse-bridge.git /opt/muse-bridge && cd /opt/muse-bridge
sudo bash deploy/muse/install.sh --agents claude,dimensio

install.sh --help 查看全部选项。服务只听本机 127.0.0.1，对外访问需要你自己配隧道或反向代理（加 --tunnel-token 可以顺带起一条 Cloudflare 命名隧道）。更新用 sudo bash scripts/server/update.sh。

目录

路径	内容
src/、web/、harness/、modules/、scripts/、docs/	bridge 公开版（服务端、前端、dimensio、脚本），用 deploy/muse/sync/sync-from-bridge.mjs 整体同步过来；要改去 bridge 本体改，不在这里改
deploy/muse/	Muse 专属的全部东西：一键部署 bootstrap.sh / 装机 install.sh 和运维件模板 ops/、Muse 插件 plugin/（设置里的安卓 App 页、项目手册的「Muse 部署」一章）、问题报告工具 feedback/、给 Muse 看的说明书 MUSE.md、使用说明书 guide/（Muse 回答使用问题的依据）、已知问题清单 known-issues.json、同步脚本
feedback-worker/	问题反馈的中继（Cloudflare Worker）：把用户同意过的报告提交成 GitHub Issue；GitHub App 的私钥只在它那里，各台装机上没有。报告格式与 deploy/muse/feedback/ 共用

Muse Bridge 和 bridge 的差别只经声明表达，由 bootstrap.sh 装机时写：config.json 里的品牌和默认语言、服务单元的环境变量、plugins.json（关掉 Muse VM 上用不了的功能），以及 Muse 插件。

发布新版本（维护者）

推一个 v* 标签。建议用带说明的标签，说明会作为更新内容展示给用户：

git tag -a v0.2.0 -m "这次更新了什么（给用户看的一两句）"
git push origin v0.2.0

GitHub Actions（.github/workflows/release.yml）不再构建安卓 app，而是从 bridge 公开 Release 取同版本的 apk、校验 sha256，放进安装包的程序目录（ClaudeBridge-offline-<版本号>.apk），并在 Release 上挂一份 MuseBridge.apk；另外打包 muse-bridge.tgz，生成 .sha256 和更新频道 latest.json，并创建 Release。已经装好的 Muse 每 6 小时读一次 latest.json，发现新版本就问用户要不要更新。beta（如 v0.2.0-beta.1）也会推送。只有标签里带 -test 的（如 v0.2.0-test.1）会发成预发布版，不进更新频道，是给维护者在新 Muse 上试装用的。

apk 用仓库 Actions secrets 里的密钥签名（ANDROID_KEYSTORE_BASE64、ANDROID_KEYSTORE_PASSWORD、ANDROID_KEY_ALIAS、ANDROID_KEY_PASSWORD）。没配（比如 fork）就退回 debug 签名：照样能装，但不能覆盖安装官方发布的包。

使用说明书（deploy/muse/guide/）跟界面对不上时发版流程会直接失败（deploy/muse/test/guide.test.mjs）。打标签前再跑一次说明书问答测试（node deploy/muse/test/guide-qa/run.mjs，用本机的 claude 命令行）。已知问题写在 deploy/muse/known-issues.json：每次发版写进 latest.json；只改这个文件推到 main，.github/workflows/known-issues.yml 会直接改写最新 Release 的 latest.json，不用发版，已经装好的 Muse 6 小时内就能知道这个问题和绕过办法。

协议

MIT。Claude Code 与 Claude Agent SDK 的使用受 Anthropic 自己的条款约束；在 Muse 上部署，请同时遵守 Muse 的平台条款。