Windows 版 Bromure Sidecar
Bromure Sidecar 会把 Windows PC 变成 Bromure Agentic Coding 的 原生机器。你 Mac 上的机器是 Linux VM。Sidecar 机器则是一台真正的 Windows PC,直接在 Windows 上、以你自己的 Windows 账户运行编程代理——Claude Code、Codex、Grok Build、Kimi Code、Oh My Pi。
当 PC 登录与 Mac 相同的 bromure.io 账户并 连接 到 Mac 后,它就会作为又一台机器出现在 Bromure Agentic Coding 中。它的会话会显示在 Mac 上,与在 VM 中运行的会话并列:你可以从 Mac 启动它们、查看它们、与它们聊天,并把工作委派给它们。你也可以从 Sidecar 的通知区域图标,在 PC 本身启动会话。
PC 与 Mac 通过 bromure.io 点对点 通信。PC 只会向外连接,因此不需要转发端口、不需要 VPN,也不必输入任何地址。
注意: 由于 Sidecar 上的代理直接在 PC 上运行,它们不会经过机器的网络边界。Squelch、凭据注入、追踪和沙箱策略都是 机器(Linux VM)的功能,不适用于原生机器。Sidecar 代理拥有你 Windows 账户的访问权限;请据此选择它的批准级别(请参阅批准级别)。
本章涵盖 Sidecar 的安装、登录与连接、安装代理、运行会话、设置、更新、卸载、命令行和故障排除。关于远程访问的 Mac 端,请参阅远程访问与客户端。
系统要求
| Windows | Windows 10 版本 1809 或更高版本,或 Windows 11。64 位,Intel/AMD(x64)或 ARM(ARM64)。 |
| Git for Windows | 必需:代理和 Bromure Agentic Coding 的命令都在 Git Bash 下运行。如果缺少,安装程序会提议安装。 |
| Microsoft Edge WebView2 Runtime | Sidecar 的窗口需要它。Windows 11 已内置;如果缺少,安装程序会提议安装。 |
| 账户 | 一个 bromure.io 账户——也就是你 Mac 上的 Bromure Agentic Coding 所登录的账户。 |
| 管理员权限 | 不需要。所有内容都安装在你自己的账户中。 |
在 Windows 11 版本 22H2 及更高版本上,Sidecar 的窗口采用 Windows 11 的半透明样式;在较旧的版本上外观较朴素,但功能相同。
安装
下载适合你 PC 的安装程序:
| PC | 下载 |
|---|---|
| Intel 或 AMD(大多数 PC) | BromureSidecar-x64.exe |
| ARM(例如 Snapdragon 笔记本) | BromureSidecar-arm64.exe |
这些链接始终指向最新版本。不确定需要哪一个?打开 设置 → 系统 → 系统信息,查看 系统类型:“基于 x64 的处理器”表示 x64,“基于 ARM 的处理器”表示 ARM64。ARM64 安装程序拒绝在 x64 PC 上运行,并会告诉你。
运行安装程序。它由 Seclio LLC 签名,因此 Windows 会显示这个发布者。然后:
- 如果缺少 Git for Windows 或 WebView2 Runtime,安装程序会把它们列为组件。保持勾选即可一并安装:Git 来自 winget,WebView2 来自 Microsoft。如果两者都已存在,就会跳过这一页。
- 安装程序会把 Bromure Sidecar 复制到
%LOCALAPPDATA%\Programs\Bromure Sidecar。 - 在最后一页,保持勾选 Start Bromure Sidecar。
安装程序还会:
- 在开始菜单中添加 Bromure Sidecar 快捷方式;
- 让 Sidecar 在你登录 Windows 时启动;
- 注册
bromure-agent-host://链接类型,bromure.io 用它把登录交回给 PC; - 在 设置 → 应用 → 已安装的应用 中添加一个条目,供卸载使用。
通知区域图标与弹出面板
Bromure Sidecar 位于任务栏的通知区域。如果看不到它的图标,请点击 ^ 箭头;你可以把图标拖到任务栏上,让它保持可见。
图标让你一眼看出状态:
| 图标 | 含义 |
|---|---|
| 灰色 | Sidecar 没有运行,或 PC 没有连接到任何 Bromure Agentic Coding。 |
| 彩色 | 已连接。将指针悬停在上面可看到它所连接的 Mac 名称。 |
| 带一个点 | 有代理需要你:它正在等待回复或批准。 |
左键点击 图标会打开 弹出面板,也就是 Sidecar 的面板。点击其他地方或按 Esc 即可关闭。右键点击 会打开一个菜单,包含 Open Bromure Sidecar、Coding Agents… 和 Quit Bromure Sidecar。
弹出面板从上到下显示:
- 标题栏:“Bromure Sidecar”和一行状态,例如“Not signed in to bromure.io”“Signed in as pc-name”或“Attached to Mac as pc-name”。它的两个按钮会打开 Coding agents 和 Settings。
- 横幅(适用时):带 Install 按钮的“Git for Windows is needed”,或带 Update 按钮的“Bromure Sidecar version is available”。
- 连接卡片:登录,或连接到 Mac。
- Sessions:在这台 PC 上运行的代理。
- 页脚:Coding Agents 和 Quit。
登录 bromure.io
弹出面板的连接卡片显示 Reach this PC from Bromure AC。
- 点击 Sign in to bromure.io。浏览器会打开 bromure.io 的登录页面。
- 用你 Mac 所使用的账户登录,并批准添加这台 PC。
- bromure.io 通过
bromure-agent-host://链接把登录交回给 Sidecar;浏览器可能会询问是否打开 Bromure Sidecar。请允许。
状态行会变成“Signing in…”,然后变成“Signed in as pc-name”。
如果浏览器无法打开 Sidecar(例如你在另一台电脑上完成了登录),请从页面复制 bromure-agent-host:// 链接,然后在弹出面板中点击 Paste link。
安全: Sidecar 只接受它自己发起的登录。
bromure-agent-host://链接无论来自浏览器还是粘贴而来,都必须带有你用 Sign in to bromure.io 开始的那次登录的代码;其他任何链接都会被拒绝,并显示“that sign-in link wasn't started here — sign in again from the menu”。这能防止网页或消息把这台 PC 偷偷加入别人的账户。如果看到这条消息,请再点击一次 Sign in to bromure.io 并完成那次登录。
机器名称是 Bromure Agentic Coding 列出这台 PC 时使用的名称。默认是电脑名称后面加上 -native;你可以在设置中更改。
连接到 Bromure Agentic Coding
登录后,连接卡片会列出 你账户中的服务器:Bromure Agentic Coding 处于在线状态的 Mac,每一台都标有 Online 或 Offline,并带有 Attach 按钮。如果一台都没有列出,会显示“No Bromure AC server is online in your account”:请在你的 Mac 上打开 Bromure Agentic Coding(登录同一个账户,并开启通过 bromure.io 的远程访问——请参阅远程访问与客户端)。
点击你 Mac 旁边的 Attach:
- 卡片显示 Connecting。
- 第一次会显示 Waiting for approval:“Allow this PC in Bromure AC's fleet dialog on Mac.”在 Mac 上,当 Bromure Agentic Coding 询问时批准这台 PC。
- 卡片显示 Attached,通知区域图标从灰色变成彩色。
现在这台 PC 会出现在 Mac 的机器之中,位于 Native Machines 下。连接在重启后依然有效:Sidecar 下次启动时会自行重新连接。点击 Detach 即可停止;之后 Mac 会忘记这台 PC,直到你再次连接。
如果连接失败,卡片会说明原因:
- “Can't reach Mac”——Mac 已离线或无法访问。
- “Mac didn't accept this machine (is it up to date?)”——请更新 Mac 上的 Bromure Agentic Coding。
- “Mac refused this machine”——这台 PC 在 Mac 上被拒绝;Sidecar 会在两分钟后重试。
编程代理
Sidecar 不附带任何代理。打开 Coding Agents(弹出面板中的按钮,或通知区域菜单中的 Coding Agents…),选择这台 PC 要运行哪些:
| 代理 | 开发方 | 备注 |
|---|---|---|
| Claude Code | Anthropic | 完整集成:在 Bromure Agentic Coding 中的实时状态、聊天和委派。 |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot AI | |
| Oh My Pi | 开源 |
每张卡片都会显示代理的状态(Installed · version、Not installed、Installing、Queued、Failed),以及其安装程序所运行的确切命令,并带有复制按钮。
- Install / Update 会在你的账户中、无需管理员权限地运行代理自己的安装程序,该安装程序从其开发方下载。Bromure 不会捆绑或托管其中任何一个。安装一次只进行一个。大多数代理之后会自行保持最新。
- Sign in… 会让代理登录其提供方。Sidecar 会显示一次性代码,并带有 Copy 和 Open sign-in page;如果是 Claude Code,请把页面显示的代码粘贴回来,然后点击 Submit。“Agent: signed in”表示已完成。(Oh My Pi 在这里没有登录步骤。)
- Check again 会重新扫描已安装的内容,例如在你自己安装了某个代理之后。
批准级别
每张代理卡片都有一个批准设置。它适用于新的和恢复的会话:
| 级别 | 代理的行为 |
|---|---|
| Ask | 行动前先询问——这是代理本身的默认设置。 |
| Auto | 只在操作有风险时才询问。Codex:从不询问,但保留 Codex 自己的沙箱。Kimi Code:只在需要时询问。 |
| Full | 从不询问,没有任何限制。 |
Oh My Pi 只提供 Ask 和 Full。
警告: 在 Sidecar 上,Full 表示代理可以不经询问,做任何你的 Windows 账户能做的事。除非这台 PC 专供代理使用,否则请优先选择 Ask 或 Auto。
会话
弹出面板的 Sessions 列表会显示这台 PC 上运行的每一个代理——无论是从 Mac 还是从 PC 启动的——连同其标题、代理、文件夹和状态:Working、Needs you 或 Idle。单纯的终端会显示为 Shell。
- 点击会话 即可在终端窗口中打开它(如果已安装 Windows Terminal,就用它)。你随时可以关闭终端窗口:会话会继续运行。
- New 会在 PC 上启动会话:选择一个已安装的代理,浏览到它应该工作的文件夹,然后点击 Start in this folder。终端会在该处打开,而这个会话也会出现在 Mac 上的 Bromure Agentic Coding 中。
- End this session(将指针悬停在某一行上时出现的电源按钮)会停止它。
从 Mac 看,Sidecar 机器的用法和其他机器一样:在上面启动会话、打开它的终端、与 Claude Code 会话聊天,或把工作委派给它。路径以 Linux 的方式显示:你的 Windows 用户配置文件夹是 /home/ubuntu,而 D:\src 是 /d/src。
代理比 Sidecar 活得更久。 它们在独立的后台进程中运行:退出 Bromure Sidecar 或安装更新都不会停止它们。不过在 Sidecar 退出期间,Mac 无法访问它们;当你在代理仍在运行时退出它,会收到警告。重启 Windows、注销 Windows 或卸载则会停止它们。
设置
从弹出面板的标题栏打开 Settings:
- Start at login —— 在你登录 Windows 时启动 Sidecar,让代理在重启后仍可访问。默认开启。
- Machine name —— Bromure Agentic Coding 列出这台 PC 时使用的名称。清空即可恢复默认值(电脑名称-native)。
- SSH host key —— 这台 PC 的 SSH 主机密钥指纹,带有复制按钮,方便从 Mac 核对。
- bromure.io account —— PC 以哪个账户登录,以及 Sign out。退出登录也会断开 PC 的连接,并从 PC 移除该账户的密钥。
页脚会显示 Sidecar 的版本及其 SSH 服务器的地址(请参阅安全性)。
更新
Sidecar 在启动两分钟后检查是否有新版本,之后每 12 小时检查一次。有新版本时,弹出面板会显示“Bromure Sidecar version is available — Agents keep running while it installs.”点击 Update:Sidecar 会下载新的安装程序、加以验证,并静默安装。几秒后 Sidecar 会自行重启;运行中的代理不会被中断。
除非你点击 Update,否则不会更新任何内容。你也可以随时从下载链接运行最新的安装程序,覆盖现有版本来安装新版本。
卸载
打开 设置 → 应用 → 已安装的应用,找到 Bromure Sidecar,然后选择 卸载。如果仍有代理在运行,卸载程序会先询问:“Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?”
卸载会移除程序、开始菜单快捷方式、登录时启动的条目,以及 bromure-agent-host:// 链接类型。它会保留你的数据文件夹 %LOCALAPPDATA%\BromureSidecar(登录信息、设置、日志):如果要彻底清除,请一并删除该文件夹。如果还要把 PC 从你的 bromure.io 账户中移除,请在卸载前退出登录(在设置中)。
安全性
- 只向外连接。 PC 不对网络开放任何端口。它的 SSH 服务器只在
127.0.0.1(端口 2223)上监听,而 Mac 通过 PC 自己连上的 bromure.io 中继来访问它。 - 用密钥,不用密码。 SSH 登录只接受密钥,且只限你自己的 Windows 用户名。密钥来自你 bromure.io 账户中的设备;Sidecar 每三分钟同步一次,并在你退出登录时移除。
- 在 Mac 上批准。 Mac 只有在你于该处批准之后,才会让 Sidecar 连接。
- 你的数据仍属于你。 Sidecar 的文件夹只有你的账户和 Windows 本身可以读取。
- 已签名的软件。 安装程序及其中每一个程序都由 Seclio LLC 签名并加盖时间戳;更新在运行前会与公布的 SHA-256 核对。
- 没有网络边界。 如开头所述,原生机器没有 Linux VM 的网关防护。请把 Sidecar 当作你自己的终端看待,并据此选择代理的批准级别。
命令行
安装文件夹中的 bromure-sidecar.exe 是 Sidecar 的命令行工具。它的 ctl 命令会与运行中的 Sidecar 通信:
| 命令 | 作用 |
|---|---|
bromure-sidecar ctl health | Sidecar 是否在运行? |
bromure-sidecar ctl status | 版本、机器名称、账户、连接状态、SSH 端口与指纹、运行中的代理。 |
bromure-sidecar ctl signin | 打开 bromure.io 的登录页面。 |
bromure-sidecar ctl enroll <code-or-link> | 用你复制的代码或链接登录(与 Paste link 相同)。 |
bromure-sidecar ctl signout | 退出 bromure.io 登录(同时断开连接)。 |
bromure-sidecar ctl servers | 列出账户中的服务器。 |
bromure-sidecar ctl attach {"id":"<server-id>"} | 连接到某个服务器。 |
bromure-sidecar ctl detach | 断开连接。 |
bromure-sidecar ctl machine-name <name> | 重命名 PC。 |
bromure-sidecar ctl install-state | 代理的安装状态。 |
bromure-sidecar ctl quit | 停止 Sidecar(代理会继续运行)。 |
bromure-sidecar claude | 在当前文件夹中以 Sidecar 会话启动 Claude Code,并在此处连上它。按 Ctrl-B 再按 D,即可让它继续运行而离开。 |
bromure-sidecar version | 显示版本。 |
在 PowerShell 中,请用单引号括住 JSON 参数:bromure-sidecar ctl attach '{"id":"<server-id>"}'。
文件和文件夹
| 路径 | 内容 |
|---|---|
%LOCALAPPDATA%\Programs\Bromure Sidecar | 程序。 |
%LOCALAPPDATA%\BromureSidecar | 你的数据:登录信息、设置、会话、SSH 密钥。 |
%LOCALAPPDATA%\BromureSidecar\settings.json | 设置,包括一些没有按钮的项目:sshPort(默认 2223)和 updateFeed(设为 "" 即可关闭更新检查)。编辑后请退出并重新启动 Sidecar。 |
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.log | 日志。 |
故障排除
| 问题 | 处理方法 |
|---|---|
| “Bromure Sidecar isn't running” | 从开始菜单启动 Bromure Sidecar。你的代理并未停止。 |
| 出现“Git for Windows is needed”横幅,或命令失败并显示“Git for Windows isn't installed on this machine” | 点击横幅中的 Install(它会运行 winget install --id Git.Git -e --scope user),或自行安装 Git for Windows,然后再试一次。 |
| “WebView2 isn't available” | 安装 Microsoft Edge WebView2 Runtime,然后再次启动 Sidecar。 |
| “that sign-in link wasn't started here — sign in again from the menu” | 点击 Sign in to bromure.io 并完成那次登录;请参阅登录 bromure.io。 |
| “This machine was removed from your bromure.io account.” | 这台 PC 已在 bromure.io 上被移除。请重新登录。 |
| “Enrolled without the agent-host capability…” | 在 Settings 中退出登录,然后用 Sign in to bromure.io 重新登录。 |
| “No Bromure AC server is online in your account.” | 在 Mac 上启动 Bromure Agentic Coding,登录同一个账户,并开启通过 bromure.io 的远程访问。 |
| 卡在 Waiting for approval | 在 Mac 上的 Bromure Agentic Coding 中批准这台 PC。 |
| 代理说它没有安装 | 从 Coding Agents 安装它。如果安装程序已完成,却仍找不到代理,请点击 Check again,或注销 Windows 后重新登录。 |
| Settings 界面显示“Couldn't start the SSH server” | 有其他程序正在使用端口 2223。在 settings.json 中设置另一个 sshPort,然后退出并重新启动 Sidecar。 |
| 其他任何问题 | 从通知区域菜单退出并重新启动 Sidecar(代理会继续运行),然后查看日志文件。bromure-sidecar ctl status 可一次显示 Sidecar 的状态。 |