English | 中文

Claude Arc Bridge

Claude Arc Bridge 是一个让官方 Claude 浏览器扩展在 Arc 浏览器中正常工作的补丁工具。

它解决的核心问题很简单：Claude 官方扩展依赖 Chrome 的 chrome.sidePanel API 来打开右侧侧边栏，但 Arc 浏览器不支持这个 API，所以扩展按钮在 Arc 里可能点了没有反应，或者无法显示 Claude 面板。Claude Arc Bridge 会把这个侧边栏能力桥接成一个可注入网页的右侧浮动面板，让 Arc 也能获得接近 Chrome 的 Claude 扩展体验。

这个项目能做什么

• 点击 Arc 工具栏里的 Claude 扩展按钮，在当前网页右侧打开 Claude 面板。
• 支持 Cmd+E / Ctrl+E 快捷键打开或关闭面板。
• 面板可以拖拽调整宽度，并且会记住上次的宽度。
• 面板打开时会给网页预留空间，避免直接盖住网页内容。
• 支持两种安装方式：文件夹安装、ZIP 安装。

为什么需要它

官方 Claude 浏览器扩展是按 Chrome 的能力设计的。Chrome 支持 chrome.sidePanel，所以扩展可以直接打开浏览器原生侧边栏。

Arc 浏览器虽然兼容大部分 Chrome 扩展，但它缺少这个 side panel 能力。结果就是：Claude 扩展可以安装，但点击扩展按钮时无法像 Chrome 那样打开右侧 Claude 面板。

Claude Arc Bridge 做的事情是：保留官方 Claude 扩展本身，把 Arc 不支持的 side panel 调用转换成网页里的右侧面板。这样用户在 Arc 里点击 Claude 扩展按钮时，也能看到右侧 Claude 面板，并继续使用 Claude 扩展的主要功能。

安装前准备

你需要先准备：

• Arc 浏览器
• Chrome 浏览器
• 已安装在 Chrome 里的官方 Claude 扩展

这个项目会从 Chrome 里复制官方 Claude 扩展文件，然后生成一个适合 Arc 使用的新扩展包。

生成扩展包

在项目目录中运行脚本：

./patch.sh

如果脚本没有自动找到 Chrome 里的 Claude 扩展，可以手动指定路径：

./patch.sh /path/to/claude/extension/directory

运行完成后会生成：

• claude-arc-bridge/：可直接加载的扩展文件夹
• claude-arc-bridge.zip：ZIP 安装包

如果只想重新打包已经生成好的扩展，可以运行：

./build-crx.sh

安装方法

方法一：文件夹安装

这是最稳定的方式，适合开发者或需要反复更新的人。

1. 打开 arc://extensions
2. 打开右上角的 Developer mode
3. 点击 Load unpacked
4. 选择项目里的 claude-arc-bridge/ 文件夹
5. 在 Arc 里禁用其它 Claude 扩展，避免冲突

方法二：ZIP 安装

适合想下载压缩包后手动安装的人。

1. 解压 claude-arc-bridge.zip
2. 打开 arc://extensions
3. 打开 Developer mode
4. 点击 Load unpacked
5. 选择解压出来的 claude-arc-bridge/ 文件夹

ZIP 本质上仍然是文件夹安装，只是更方便传输和保存。

使用方法

安装完成后，在普通网页里使用：

• 点击工具栏里的 Claude 扩展按钮，打开或关闭右侧面板。
• 按 Cmd+E（Mac）或 Ctrl+E（Windows / Linux），打开或关闭右侧面板。
• 拖动面板左边缘，可以调整宽度。
• 点击面板顶部的 X，可以关闭面板。

不要在这些页面测试：

• arc://...
• chrome://...
• chrome-extension://...
• claude.ai
• OAuth 登录或回调页面

这些页面通常不允许普通扩展注入脚本。

工作原理

Claude Arc Bridge 由几部分组成：

文件	作用
patch.sh	复制官方 Claude 扩展，并注入 Arc 兼容补丁
floating-panel.js	在网页右侧创建可拖拽、可关闭的 Claude 面板
sw-patch.js	接管 chrome.sidePanel 调用，并把点击扩展按钮的行为转发给网页面板
arc-tabs-patch.js	修复 iframe 中获取当前标签页的问题
build-crx.sh	重新生成 ZIP 安装包
auto-repatch.sh	可选：检测官方扩展更新后自动重新生成补丁包

整体流程如下：

用户点击 Claude 扩展按钮
        |
        v
sw-patch.js 捕获点击事件
        |
        v
向当前网页发送打开面板的消息
        |
        v
floating-panel.js 在网页右侧创建 Claude 面板
        |
        v
面板中加载官方 Claude 的 sidepanel.html

Arc 缺少的是浏览器原生 side panel。这个项目补上的不是一个新的 Claude 客户端，而是一个让官方 Claude 扩展能在 Arc 里显示出来的桥接层。

常见问题

点击扩展按钮没有反应

可以尝试：

1. 刷新当前网页
2. 确认扩展已在 arc://extensions 启用
3. 确认当前页面不是 arc://、chrome://、claude.ai 等受限制页面
4. 打开开发者工具查看是否有扩展报错

面板里没有登录状态

先在 Chrome 或 Claude 网页中确认已经登录 Claude。扩展的登录状态取决于官方 Claude 扩展本身。

macOS 提示没有权限

如果运行脚本时出现 Operation not permitted，可以执行：

xattr -cr /path/to/claude-arc-bridge
bash patch.sh

更新方式

当官方 Claude 扩展更新后：

1. 在 Chrome 里更新官方 Claude 扩展
2. 回到本项目目录运行 ./patch.sh
3. 在 Arc 的 arc://extensions 中重新加载或重新安装生成的扩展

安全说明

• 本项目不会收集或上传你的数据。
• 本项目不会替你登录 Claude。
• 本项目只是复制官方 Claude 扩展并添加 Arc 兼容层。
• 如果你不信任任何本地生成的扩展包，请使用文件夹安装并自行检查源码。

许可证

MIT - 见 LICENSE。

免责声明

Claude Arc Bridge 不是 Anthropic 官方项目，也不代表 Arc 浏览器官方。Claude 是 Anthropic, PBC 的商标。