MIT 开源 · WINDOWS & MACOS · CURSOR · CLAUDE CODE · CODEX

Bob AI Helper. AI 编程客户端的 API 与模型, 在一个桌面工具里配好。

Bob AI Helper(简称 AI Helper)是一款 MIT 开源的桌面工具,用于在 Windows 和 macOS 上一键配置 Cursor、Claude Code、OpenAI Codex CLI、ChatGPT Desktop、WorkBuddy、Accio Work 与 DeepSeek Harness 的 API 地址、API Key 和模型。它会自动找到本机已安装的客户端,写入配置后做一次流式连通性测试,再帮你重启客户端;Cursor 和 Accio Work 通过内置的本地 Bridge 接入第三方模型,DeepSeek Harness 用一个 Key 按协议自动分流到 Claude、GPT 与国产模型路由。

当前版本 v1.0.88 · 最后更新

  • Windows 10/11 & macOS 11+ 双生态
  • Apple Silicon M 系列 & Intel 双架构
  • 支持 7 款 AI 编程客户端
  • MIT 开源,客户端免费
◎INPUTAI 云端网关
✦CONFIGUREAI Helper
⌁OUTPUTAgent / IDE 进程
向下滚动,进入产品演示
PRODUCT FILM · 01—05

一次滚动,看完整条配置链路。

用动画演示 AI Helper 从发现客户端到写入配置的完整流程。动画中的成功率、延迟等数值为演示数据。

× — +
Bob AI Helper LogoAI Helper Studio LIVE
SCENE 01 · DISCOVERY

正在发现本机 AI 开发环境

自动扫描 PATH、Win32 注册表、NPM 全局脚本、Homebrew、Spotlight 与 Store 隔离包,定位 7 款客户端。

扫描完成
✓OpenAI Codex & ChatGPTWin32 & Store · 已发现
✓Claude CodeNPM · 已发现
✓Cursor IDEConnect-RPC · 已就绪
✓WorkbuddyNative · 已发现
✓Accio WorkRLab Bridge · 已挂接
✓DeepSeek HarnessDesktop · 已发现
专属场景分组 Codex-不降质 · 99.9% 可用 (75ms)
STREAM DIAGNOSTICREADY
// 等待场景推进,或点击下方按钮开始验证...
CORE CAPABILITIES

强悍内核,保持轻盈。

双端系统底层的配置差异和进程生命周期交给 AI Helper,你只需继续专心编码。

统一配置 · 7 款客户端

一个界面,配置 7 款主流 AI 编程客户端。

支持 Cursor、Claude Code、OpenAI Codex CLI、ChatGPT Desktop、WorkBuddy、Accio Work 与 DeepSeek Harness。AI Helper 了解每个客户端的配置格式和位置(JSON、TOML、YAML、环境变量),不需要你手动去隐藏目录里改文件。

Claude Code~/.claude/settings.jsonREADY
OpenAI Codex~/.codex/config.tomlREADY
Cursor IDEConnect-RPC / glm-5.3READY
Workbuddy AImodels.jsonREADY
Accio Workaccio_config.jsonBRIDGE
DeepSeek Harnesscordis.patch.ymlROUTES
↯
< 35 MB

轻量常驻

基于 Rust 与 Tauri 2,使用系统自带 WebView,不捆绑 Chromium;macOS 提供 Apple Silicon 原生构建。空闲时常驻内存约 28–35 MB(未开启 Bridge;实际占用因系统和功能而异)。

◇

原子配置写入

先校验、再落盘,同时注入进程内环境变量与受管凭据,彻底避免配置损坏与重复配置。

VALIDATEWRITESYNC
全新原生 · macOS 全生态支持

macOS 原生视界与双架构支持。

专为 Apple Silicon M 系列芯片深度原生优化,零 Rosetta 2 转译开销;同时完整适配 Intel 架构 Mac。内嵌红绿灯 Overlay 沉浸顶栏,自动识别 Homebrew 与 NVM 多版本 Node 环境。

ARM64 原生 M1–M5 原生运行
红绿灯 Overlay 预留 80px 沉浸边距
Homebrew & NVM 智能锁定最优 CLI
原生快捷键 ⌘+B 极客折叠
v1.0.74 起 · 按客户端分组配置

按客户端分组配置 API Key,并查看通道健康状态

登录 Bob API 账号后,一键配置会把 API Key 分成三组写入(分组是 Bob API 账号下给 API Key 归类的名称,不是模型名,见术语说明):Claude Code 使用 CC-Kiro-Max 分组,Codex 与 ChatGPT 使用 Codex-不降质 分组,Cursor、WorkBuddy、Accio Work 与 DeepSeek Harness 使用 国产Token计划 分组。账号下缺少对应分组的 Key 时会自动创建。客户端内可查看余额、调用日志,以及各通道在 1 / 3 / 6 小时窗口内的成功率与平均 TTFT。下方面板中的数值为演示数据。

Codex-不降质 Codex 桌面/命令行专用
99.9% 运行极佳
99.9% 近 1 小时成功率
75ms 平均 TTFT 延迟
18,420 累计有效请求
0 熔断 健康指数 100
100% 满额可用 95%–99.9% 轻微波动 <95% 异常降级 近 2 小时 (5min/格)
TTFT 波动区间: 74ms ~ 82ms 抖动率: < 2.9%
柱高代表该时间桶的平均 TTFT 近 2 小时 (5min/柱)
💳 账号余额与 API Key 管理 (v1.0.74) 自动创建 Key · 401 自动重试
账户实时余额折算
$98.50 USD ≈ ¥712.80 CNY
缺省令牌自动开通 缺少 Key 时自动创建 · 登录后继续配置
💡 v1.0.74 场景专属规则

Codex 命令行与 ChatGPT 官方桌面端深度依赖高保真流式代码补全与官方原版逻辑,自动对齐专属不降质分组,拒绝降级。

✓ 1h / 3h / 6h 历史遥测 ✓ 三大专属分组场景化对齐 ✓ 缺省令牌全自动远程创建 ✓ 未登录意图断点续传 ✓ 401 凭据透明重试自愈 ✓ 预设 glm-5.3 / deepseek-v4.1-flash
全新集成 · Cursor IDE 深度适配

Cursor 本地 Bridge 协议转译

基于 Rust Axum + Connect-RPC 规范协议转译,支持 gzip 压缩传输、h2c 与即时握手心跳,彻底根除重连循环;一键修补挂接(Patcher)拦截 Agent 与 Composer 域名,提供本地多模态图片安全沙盒防护。

CONNECT-RPCDOMAIN REWRITEIMAGE SANDBOX
客户端总览

客户端总览与「一键配置所有」

首页用 2 × 4 网格展示 7 款客户端的安装与配置状态;「一键配置所有」按分组批量写入 Key 和模型。未登录时点击会先引导登录,登录成功后自动继续刚才的操作。

2×4 MATRIXINTENT RESUMEAUTO-PROVISION
⌁

进程树安全热重启

清理子进程树并轮询文件句柄释放,杜绝僵尸进程、端口冲突和多实例竞争。DeepSeek Harness 这类 Electron 客户端会先收到优雅退出请求,再按先主进程、后渲染进程的顺序收尾,不再弹出 “renderer exited: killed” 崩溃框。

Process treeHandles released
↗

一键打开配置文件

依次尝试用默认编辑器、系统记事本或文件管理器打开客户端的配置文件,方便手动检查 AI Helper 写入的内容。

PANORAMIC ARCHITECTURE · 01—07

功能详解:各项能力是怎么实现的。

向下滑动页面,依次查看 macOS 原生支持、客户端进程扫描、Cursor Bridge、分组配置、账号额度、Accio Work Bridge 与 DeepSeek Harness 协议分流的实现细节。

01 / 07
🍎 macOS 原生视界Apple Silicon & Intel

Apple Silicon 纯原生飞驰,红绿灯沉浸设计。

为 M1/M2/M3/M4/M5 系列芯片提供纯原生 aarch64 构建,彻底消除 Rosetta 2 转译开销。独创原生红绿灯 Overlay 融合,80px 预留安全边距,与 macOS 系统风格浑然一体。

M系列 ARM64 原生架构 Homebrew / NVM 智能探测 Spotlight 深度定位 AppleScript 终端会话拉起
AI Helper · macOS Sonoma / Sequoia
CodexClaudeCursorWorkBuddyAccioDSH
✓ /opt/homebrew/bin/node detected (v22.14.0) ✓ Native Overlay Traffic Lights mounted (80px inset) ✓ Zero Rosetta 2 overhead · 28MB RAM
🪟 Windows 深度熔断Win32 & Store 商店版

单快照并发进程扫描,免特权精准定位应用。

基于 Rust 2024 系统底层 API,实施进程树单快照并发探测。优先遍历用户 AppModel 注册表免特权秒级定位微软商店版 ChatGPT;配置文件更新后,精准执行安全树状熔断与文件句柄释放轮询。

Win32 & 商店版秒级定位 句柄轮询毫秒级释放 Ctrl+B 侧边栏折叠 WebView2 独立渲染隔离
Process Manager · PID Scanner
—□×
AI-Helper.exe (Parent)32MB
├─ Cursor.exe (Connect-RPC)Active
└─ rlab_bridge.exe (Axum :8787)Active
[REGISTRY] HKCU AppModel scan: ChatGPT.exe located [RESTART] Mutex unlocked · Restart completed in 180ms
⚡ Cursor BridgeConnect-RPC & Patcher

Connect-RPC 协议转译与一键修补挂接,根除重连循环。

针对 Cursor 编辑器独家实现 Connect-RPC 规范协议转译与 h2c 支持,gzip 压缩传输与即时握手心跳彻底终结重连循环。一键修补挂接智能拦截 Agent / Composer 域名,内置路径规范化与符号链接安全沙盒,严防本地多模态图片识别攻击。

Connect-RPC 规范协议 gzip 压缩与 h2c Agent/Composer 域名拦截 多模态图片安全沙盒
Cursor Bridge · Connect-RPC Engine
—□×
Cursor IDE→Cursor Bridge :8969→glm-5.3
✓ Handshake Heartbeat: 0ms lag · loop resolved ✓ Image Security: safe_read_local_image sandboxed ✓ Domain Interceptor: Agent/Composer rewritten
🎯 智能场景分发v1.0.74 分组配置

按客户端对齐三个 API Key 分组,缺少 Key 时自动创建。

Claude Code 对应 CC-Kiro-Max 分组,Codex 对应 Codex-不降质 分组,Cursor、WorkBuddy、Accio Work 与 DeepSeek Harness 对应 国产Token计划 分组。账号下没有对应分组的 Key 时,AI Helper 会在 Bob API 自动创建并托管;未登录时会先引导登录,登录后自动继续。

三大专属业务分组 缺省 Token 自动开通 未登录意图断点续传 预设 glm-5.3 / deepseek-v4.1-flash
AI Helper
Codex-不降质gpt-5.6-sol
CC-Kiro-Maxsonnet-5-5
国产Token计划glm-5.3
自动创建 KeyAuto-Provision
💳 账号钱包大盘实时双币折算

双币实时折算与 401 会话透明重试自愈。

实时汇率折算账户可用额度(USD / CNY),掌握每笔 Token 消耗。遭遇 401 会话失效时,自动触发后台无感静默续期与重试自愈,杜绝正在执行的代码生成或补全中断。

美元/人民币实时折算 401 会话透明续期 RSA-OAEP 加密分发 2FA 双因素鉴权护航
当前账号总资产折算$128.60 / ¥930.50
健康运行中
Codex 补全
65%
Claude 推理
25%
Cursor / glm
10%
✓ 401 Handshake Interceptor: Token auto-refreshed (0ms lag)
🧩 本地网关协议路径凭据鉴权

Accio Work 本地 Bridge:协议转换与访问控制。

AI Helper 为 Accio Work 在本机运行 RLab Bridge(基于 Rust Axum,默认监听 127.0.0.1:8787),负责模型列表、聊天、图像生成、Responses API 和 MCP 代理的协议适配。Bridge 使用路径凭据 /i/<token>、Host / Origin 校验、速率限制和请求体大小上限,防止被本机其他进程随意调用。

Axum 高并发网关 路径凭据鉴权 /i/token 元数据防泄露白名单 MCP 显式代理集成
Accio Work→RLab Bridge :8787→glm-5.3 / LLM API
监听地址127.0.0.1:8787
接口OpenAI 兼容 · SSE
鉴权实例令牌 + Origin
🐳 DeepSeek Harnessv1.0.87 新增

一个 Key,按协议自动分流到三条路由。

AI Helper 拉取 Key 下全部可对话模型,按协议写入 DeepSeek Harness 的 aihelper-claude、aihelper-codex、aihelper-cn 三条路由,多个分组的 Key 可以并存。逐行编辑、落盘前语义比对,自建路由、注释、!!js 与官方账号路由原样保留。

协议自动分流 多 Key 并存 无损 YAML 写入 共用写锁
~/.dsh/profiles/desktop/cordis.patch.yml
aihelper-claudeAnthropic Messagesclaude-sonnet-5-5
aihelper-codexOpenAI Responsesgpt-5.6-sol
aihelper-cnChat Completionsdeepseek-v4.1-flash
✓ Custom routes, comments, !!js & official routes kept
STREAMLINED WORKFLOW

从发现到生效,不到 10 秒。

三步完成:探测本机客户端、写入并验证配置、重启客户端使配置生效。

01

环境全域感知

自动扫描 PATH、Win32 注册表、NPM 全局脚本、Store 隔离包与 macOS Spotlight,修复失效路径。

DISCOVER
02

智能分发与自愈

按场景自动绑定三大专属分组,缺省令牌自动开通,流式握手验证延迟与 Token。

VERIFY & PROVISION
03

原子写入与热重启

原子写入配置,等待句柄释放,携最新配置与最优通道平滑重新拉起客户端。

ACTIVATE
OFFICIAL DOWNLOADS

现在开始,把配置工作交出去。

当前官方版本 v1.0.88 · 支持 7 款 AI 编程客户端 · Windows 10/11 与 macOS 11+ · MIT 开源 · 最后更新

推荐首选
WINDOWS INSTALLER

Windows 官方安装包

NSIS 自动安装程序,包含快捷方式、开始菜单、WebView2 检测与平滑自动更新。

  • ✓ Windows 10 1809 及以上 / Windows 11
  • ✓ 64 位系统 · 安装包约 12MB
  • ✓ GitHub Actions 官方自动化构建
PORTABLE ZIP

便携免安装版

解压即用,不写入系统注册表,即插即走,适合 U 盘或企业受限办公环境。

BUILD FROM SOURCE

源码本地构建

基于 Tauri v2 + React 18 + Rust 2024,源码完全开放透明,随心定制扩展。

访问 GitHub ↗
官方构建与安全校验

AI-Helper-v1.0.88-Windows-x64-Setup.exe · 包含全平台二进制 SHA-256 校验和。

Apple Silicon 推荐首选
MACOS APPLE SILICON (ARM64)

Apple Silicon DMG 安装包

专为搭载 M1 / M2 / M3 / M4 / M5 芯片的 Mac 深度原生优化。纯 ARM64 编译,零转译损耗,常驻内存低至 28MB。

  • ✓ MacBook Air / Pro、Mac mini、Mac Studio、iMac
  • ✓ macOS 11.0 (Big Sur) 及更高版本
  • ✓ 原生红绿灯 Overlay 沉浸顶栏支持
MACOS INTEL (X64)

Intel 架构 DMG 安装包

适用于搭载 Intel Core 处理器的经典 Mac 设备,自动化 DMG 打包,保持一致的流畅体验。

GATEKEEPER TIP

macOS 首次打开安全提示

若提示“已损坏”或“未验证的开发者”,只需在终端执行一行命令即可清除隔离属性:

xattr -cr /Applications/AI\ Helper.app
查看完整指引 ↗
macOS 官方构建与安全校验

AI-Helper-v1.0.88-macOS-aarch64.dmg · 包含全平台二进制 SHA-256 校验和。

平台与架构 文件名称 类型 直链下载 国内镜像
Windows x64 AI-Helper-v1.0.88-Windows-x64-Setup.exe NSIS 安装包 下载 ↗ 镜像 ↗
Windows x64 便携 AI-Helper-v1.0.88-Windows-x64-Standalone.zip ZIP 免安装 下载 ↗ 镜像 ↗
macOS Apple Silicon (M系列) AI-Helper-v1.0.88-macOS-aarch64.dmg DMG 镜像 下载 ↗ 镜像 ↗
macOS Intel (x86_64) AI-Helper-v1.0.88-macOS-x64.dmg DMG 镜像 下载 ↗ 镜像 ↗
FAQ

常见问题与解答。

关于 macOS 安装、架构选择、费用、隐私与网络连接,你关心的都在这里。

Bob AI Helper(简称 AI Helper)是一款 MIT 开源的桌面工具,用于在 Windows 和 macOS 上统一配置 AI 编程客户端的 API 地址、API Key 和模型。它支持 Cursor、Claude Code、OpenAI Codex CLI、ChatGPT Desktop、WorkBuddy、Accio Work 和 DeepSeek Harness,会自动探测这些客户端、写入它们的本地配置文件、做流式连通性测试,并在需要时启动或重启客户端。

目前支持 7 款:Claude Code(~/.claude/settings.json)、OpenAI Codex CLI(~/.codex/config.toml)、Cursor(~/.ai-helper/cursor_config.json,经本地 Bridge 接入)、WorkBuddy(~/.workbuddy/models.json)、Accio Work(~/.ai-helper/accio_config.json,经本地 Bridge 接入)、DeepSeek Harness 桌面版(~/.dsh/profiles/desktop/cordis.patch.yml,设置了 DSH_HOME 时以其为准),以及 ChatGPT Desktop(仅做安装探测、启动和设备管理)。

可以。每个客户端的配置面板都支持手动填写 API 地址、API Key 和模型,并可读取该地址的模型列表。对于不在白名单内的地址,AI Helper 会显示目标 Origin 并要求你确认,默认要求 HTTPS,避免 Key 被误发到未授权的站点。

一键配置需要登录 Bob API 账号,并按客户端分组写入 API Key 和推荐模型:Claude Code 使用 claude-sonnet-5-5;Codex 与 ChatGPT 使用 gpt-5.6-sol;Cursor、WorkBuddy 与 Accio Work 使用 glm-5.3;DeepSeek Harness 使用「国产Token计划」分组(Bob API 账号下国产模型专用的令牌分组)的 Key,写入该 Key 下全部可对话模型,默认模型为 deepseek-v4.1-flash。如果账号下没有对应分组的 API Key,AI Helper 会自动创建一个。手动配置时可以改用任意模型。

AI Helper 只修改与接入相关的字段(API 地址、Key、模型),Claude Code、Codex 和 WorkBuddy 的其他配置会被保留;WorkBuddy 中你手动添加的其他模型不会被删除;DeepSeek Harness 只写入 aihelper-* 路由和 AIHELPER_* 密钥引用,你的自建路由、注释和官方账号路由逐字节保留。首次修改前会保存原配置快照,可在设置页一键恢复。重要配置仍建议自行备份。

不会。配置写入全部在本机完成,会话凭据在 Windows 上由 DPAPI、在 macOS 上由钥匙串保护。只有在你执行连通性测试,或 AI 编程客户端发起模型请求时,API Key 才会发送到你配置的那个 API 地址。

Cursor 的部分通信使用 Connect-RPC / HTTP2 和内部消息格式,只改一个 OpenAI Base URL 无法完整接入第三方模型。AI Helper 在本机运行一个 Bridge(默认监听 127.0.0.1:8969),负责在 Cursor 请求与 OpenAI 兼容接口之间做协议转换,并支持流式响应、思考内容和图片输入。对 Cursor 客户端的修补可以随时还原。

不会。AI Helper 只配置 DeepSeek Harness 桌面版(~/.dsh/profiles/desktop/cordis.patch.yml,设置了 DSH_HOME 时以其为准),只写入 aihelper-* 路由和 AIHELPER_* 密钥引用。DeepSeek 官方账号登录、官方 API Key 路由(api.deepseek.com)和你自建的路由都原样保留;如果默认模型指向官方模型,保存时也保持不变。首次使用前请先启动一次 DeepSeek Harness 完成初始化,保存后重启 DeepSeek Harness 即可看到新路由。详细步骤见 DeepSeek Harness 接入 Claude、GPT 与国产模型教程。

AI Helper 会先弹出登录引导,并记住你刚才要执行的配置操作。登录成功后会自动继续执行,不需要再点一次按钮。

是。AI Helper 以 MIT 许可证开源,源码托管在 GitHub(TF49/AI-Helper),个人和企业都可以免费使用。客户端本身不收费,调用模型产生的费用由你所使用的 API 服务商计费。

Apple Silicon 芯片(M1 至 M5 系列,含 Pro / Max / Ultra)的 Mac 请下载 aarch64 版 DMG;Intel 处理器的 Mac 请下载 x64 版 DMG。可以在「关于本机」中查看芯片类型。macOS 需要 11 或更高版本。

这是 macOS Gatekeeper 对未经 Apple 公证的应用的默认隔离。在「终端」执行 xattr -cr /Applications/AI\ Helper.app 清除隔离标记即可;也可以在「访达」中右键点击 AI Helper,选择「打开」并确认。详细步骤见 macOS 提示“已损坏”的解决方法。

能。macOS 上的图形应用不会继承终端的环境变量,所以 AI Helper 会主动检查 /opt/homebrew/bin、/usr/local/bin,并遍历 ~/.nvm/versions/node 选取最高版本的 Node.js,以找到通过 npm 全局安装的 Claude Code 和 Codex CLI。