聊天板桥
一个小的本地主机服务器, 它让 ChatPannel Chrome 扩展到 在你的机器上编码代理。 浏览器扩展不能生成本地进程, 因此,这弥补了差距.
- 克劳德代码 - 嵌入通过
@anthropic-ai/claude-agent-sdk时,使用您的 已存在的 Claude 代码登录( 或)ANTHROPIC_API_KEY) (中文(简体) ). - 代码 驱动通过
codex execCLI,用你的电话codex login。 。 。 . - 反重力CLI 驱动通过
agy -pCLI,使用你的抗重力登录. 这是谷歌对双子座CLI的接班人; 双子座CLI 它本身仍然可用 用于商业/企业(支付API密钥),可作为定制代理添加.
带出您已经安装的代理设备—— 扩展自动检测 那些桥报到的.
运行它
macOS / Linux — 一行, 需要节点. js
curl -fsSL https://dl.chatpanel.net/bridge/install.sh | bash
下载独立的二进制, 安装, 并设定从登录开始 (通过卷发进行总和可以避免macOS"被损坏"的快取). 重跑是干净的 现场升级.
Windows — 通过节点( 建议)
Windows SmartScreen旗下未签名下载,因此在Windows上运行桥接通 节点——如果使用克洛德代码/Codex(两者均为npm CLis),则已经拥有了, 没有安全提示:
npm i -g @chatpanel/bridge
chatpanel-bridge --install # starts hidden at login
只是尝试一下? npx @chatpanel/bridge 一次在前地运行它.
任何地方管理它 : chatpanel-bridge --status • 妇女 --uninstall。 。 。 .
手工下载
从中抓取二进制 最新发布 和:
# macOS (clear the download quarantine first, then install)
xattr -cr chatpanel-bridge-macos-arm64
chmod +x chatpanel-bridge-macos-arm64
./chatpanel-bridge-macos-arm64 --install
# Windows (PowerShell) — click "More info → Run anyway" if SmartScreen warns
.\chatpanel-bridge-windows-x64.exe --install
这些二进制还没有签名,所以macOS/Windows可能会在第一跑时警告 (弯曲/npm的路线在边上). 麦克情报? 没有 x64 二进制 使用 npm (% 1)
npx @chatpanel/bridge. 苹果硅的使用chatpanel-bridge-macos-arm64。 。 。 .
先决条件
您想要使用的代理必须已经设置 :
- 克劳德代码: 安装并签字于(
claude),或设置ANTHROPIC_API_KEY。 。 。 . - 代码数字 :
codex在你身边PATH财务报告和审定财务报表codex login结束了. - 反重力CLI数字 :
agy在你身边PATH并签名(安装反重力应用程序,然后运行)agy一次签入). 替换双子双子CLI;企业/企业用户仍然可以运行gemini作为定制代理.
延长投票 /health 并显示可用的/无法使用的每个代理.
开发( 从源)
除非你是黑进桥里
git clone https://github.com/chatpanel/chatpanel-bridge
cd chatpanel-bridge
npm install
npm start # → http://127.0.0.1:4319
API 密码
| 方法 | 路径 | 目的 |
|---|---|---|
GET | /health | { ok, version, agents:[{id,label,available,reason}] } |
POST | /chat | SSE 流-体 { agent, system, options, messages } |
GET | /v1/models | OpenAI 可兼容的本地代理列表 |
POST | /v1/chat/completions | OpenAI-相容的聊天补全(流出与非流出) |
POST | /v1/completions | OpenAI 兼容后遗症文本 完成(流出与非流出) |
POST | /v1/responses | OpenAI 兼容响应 API(流与非流) |
POST | /v1/messages | Anthropic- 兼容信件 API( 流与非流) |
GET | /skills | 安装于此机上的技巧, 遍及每个代理设备 + 配置的文件夹 |
GET | /skills/<name> • 妇女 /skills/<name>/file/<path> | · 一个参考文件 |
POST | /mcp | MCP端点 - chatpanel_skill_* 任何 CLI 可调用的工具( ChatPannel 聊天驱动时加上浏览器工具) |
/chat 串流服务器- 恒定事件 : {type:'delta',text} 正如答案是
生成, {type:'tool',name,summary} 编号 : {type:'status'} 用于活动,a
最终 {type:'done'} (或 {type:'error',error}) (中文(简体) ).
使用任意 CLI 中的技能
桥发现了你机器上安装的技能——克洛德代码,代码,副驾驶,
双子座 赫尔墨斯, ~/.agents/skills,以及任何您配置的文件夹——并将其曝光为 MCP
工具 (单位:千美元)chatpanel_skill_list 编号 : _open 编号 : _read) (中文(简体) ). 指向任何 MCP 客户端
http://127.0.0.1:4319/mcp 它可以列出并加载它们,没有打开浏览器.
对于 一个 添加本地服务器 历史 (聊天、会议、说明-编辑)
并行 你的技能,添加
隐私网关 转而指向您的 CLI
时间 chatpanel-gateway mcp。网关代表这些技能工具,并将编辑放在前面.
options 每个代理( 在聊天板设置中设置) :
{
"workingDir": "/path/to/project", // where the agent reads/works
"permissionMode": "default", // default | acceptEdits | bypassPermissions
"model": "" // optional model override
}
OpenAI 和 Anthropic SDK 兼容性
兼容路径运行本地编码代理; 它们不调用提供者
API (英语). 使用从 ~/.chatpanel/bridge-token 作为 SDK API
键。 符号保护可以启动本地进程的端点, 所以不要设置
以浏览器发送的代码或共享它.
对于 OpenAI 客户端, 设置基础 URL 为 http://127.0.0.1:4319/v1 并使用
已安装代理 id 如 codex 作为模式:
import OpenAI from 'openai';
import { readFileSync } from 'node:fs';
const client = new OpenAI({
apiKey: readFileSync(`${process.env.HOME}/.chatpanel/bridge-token`, 'utf8').trim(),
baseURL: 'http://127.0.0.1:4319/v1',
});
const result = await client.responses.create({
model: 'codex',
input: 'Explain this project in three bullets.',
});
console.log(result.output_text);
client.chat.completions.create(...) 遗产 client.completions.create(...)
通过同一基址工作。 对于Anthropic SDK,使用
http://127.0.0.1:4319 作为其基础URL,与其 API 密钥相同;
请求 /v1/messages 也可以使用 model: "codex"。 。 。 .
模型字段选择本地代理. codex/gpt-5.5例如,选择
密码代理和通行证 gpt-5.5 因为它的CLI模型覆盖。 高级桥
设置可以通过额外方式提供 chatpanel 请求对象 :
{
"model": "codex",
"messages": [{ "role": "user", "content": "Fix the failing tests." }],
"chatpanel": {
"working_dir": "/absolute/path/to/project",
"permission_mode": "acceptEdits",
"use_local_config": true
}
}
适配器目前覆盖文本对话. 提供者托管的功能工具, 存储的回复、日志概率和准确的符号核算不 可用; 不支持的工具请求返回 HTTP 400, 使用数为零 .
安全问题
- 捆绑到
127.0.0.1只有这个 每个请求都必须有回放Host(无 DNS 重新约束)和,如果它有Origin,允许使用(没有网页). - 谁可以经营经纪人. 启动本地进程的路径需要 对齐
呼叫者: ChatPannel 出版的 Chrome/ Edge 扩展名( 因其扩展名而识别)
id – 浏览器从不让一个扩展发送另一个的出处) 或每个安装
符号在
~/.chatpanel/bridge-token(0600;桌面应用和CLIS读取). 一个 包括查特帕内尔自己的Firefox建筑, 其来源为每张可见的 UUID —— 仍可聊天,但运行被封入 对话层次:没有文件,没有外壳,没有网络,没有工作目录, 工作空间、证书或请求机构的许可模式选项。 答复 告诉用户为什么. - 相对相.
chatpanel-bridge pair打印一次性代码(5分钟,5次尝试). 在 ChatPanel 中输入 – 设置 → 编码代理 , 而浏览器从那时起持有此符号 继续 Dev 建筑可以由 id 来支撑:CHATPANEL_BRIDGE_EXTENSION_IDS=<id>。 。 。 . 问桥对你的感受POST /whoami→{ trust, paired }。 。 。 . - 克劳德的工具是 默认只读 (阅读/Grep/Glob/WebFatch). 书写和
shell 只在代理许可模式为时运行
acceptEdits或者说bypassPermissions。 。 。 . - 在您信任的工作目录中指定每个代理.
运行为背景服务( 可选)
macOS(启动d)实例——保存到 ~/Library/LaunchAgents/app.chatpanel.bridge.plist数字 :
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0"><dict>
<key>Label</key><string>app.chatpanel.bridge</string>
<key>ProgramArguments</key>
<array><string>/usr/local/bin/node</string><string>/ABSOLUTE/PATH/chatpanel/bridge/src/server.js</string></array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
</dict></plist>
礛 launchctl load ~/Library/LaunchAgents/app.chatpanel.bridge.plist。 。 。 .
许可证
PolyForm盾牌许可证 1.0.0 - 运行和修改,供自己使用
不用来提供产品或服务 竞争 与查特帕内尔。 时间
软件包和二进制舰只的精度。 上面记载了这座桥所做的一切
以设计为界: 它听 127.0.0.1 只开你已经有的CLI探员
与您自己的登录, 没有发送任何自己的地方—— 每一个外出连接
你的一个特工在跟自己的供应商说话 隐私问题:
隐私@ chatpanel.net; 安全报告: 页:1。 。 。 .
商标和品牌
名称 “专题小组”,标志,和品牌资产是 查特班的商标, 未取得执照 根据上述规定——"盾牌"牌照仅涵盖密码. 不要在 ChatPannel 名称或标记下再分配一叉(例如到 npm).