一个界面,配置 7 款主流 AI 编程客户端。
支持 Cursor、Claude Code、OpenAI Codex CLI、ChatGPT Desktop、WorkBuddy、Accio Work 与 DeepSeek Harness。AI Helper 了解每个客户端的配置格式和位置(JSON、TOML、YAML、环境变量),不需要你手动去隐藏目录里改文件。
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 · 最后更新
用动画演示 AI Helper 从发现客户端到写入配置的完整流程。动画中的成功率、延迟等数值为演示数据。
自动扫描 PATH、Win32 注册表、NPM 全局脚本、Homebrew、Spotlight 与 Store 隔离包,定位 7 款客户端。
// 等待场景推进,或点击下方按钮开始验证...
双端系统底层的配置差异和进程生命周期交给 AI Helper,你只需继续专心编码。
支持 Cursor、Claude Code、OpenAI Codex CLI、ChatGPT Desktop、WorkBuddy、Accio Work 与 DeepSeek Harness。AI Helper 了解每个客户端的配置格式和位置(JSON、TOML、YAML、环境变量),不需要你手动去隐藏目录里改文件。
基于 Rust 与 Tauri 2,使用系统自带 WebView,不捆绑 Chromium;macOS 提供 Apple Silicon 原生构建。空闲时常驻内存约 28–35 MB(未开启 Bridge;实际占用因系统和功能而异)。
先校验、再落盘,同时注入进程内环境变量与受管凭据,彻底避免配置损坏与重复配置。
专为 Apple Silicon M 系列芯片深度原生优化,零 Rosetta 2 转译开销;同时完整适配 Intel 架构 Mac。内嵌红绿灯 Overlay 沉浸顶栏,自动识别 Homebrew 与 NVM 多版本 Node 环境。
登录 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。下方面板中的数值为演示数据。
基于 Rust Axum + Connect-RPC 规范协议转译,支持 gzip 压缩传输、h2c 与即时握手心跳,彻底根除重连循环;一键修补挂接(Patcher)拦截 Agent 与 Composer 域名,提供本地多模态图片安全沙盒防护。
首页用 2 × 4 网格展示 7 款客户端的安装与配置状态;「一键配置所有」按分组批量写入 Key 和模型。未登录时点击会先引导登录,登录成功后自动继续刚才的操作。
清理子进程树并轮询文件句柄释放,杜绝僵尸进程、端口冲突和多实例竞争。DeepSeek Harness 这类 Electron 客户端会先收到优雅退出请求,再按先主进程、后渲染进程的顺序收尾,不再弹出 “renderer exited: killed” 崩溃框。
依次尝试用默认编辑器、系统记事本或文件管理器打开客户端的配置文件,方便手动检查 AI Helper 写入的内容。
向下滑动页面,依次查看 macOS 原生支持、客户端进程扫描、Cursor Bridge、分组配置、账号额度、Accio Work Bridge 与 DeepSeek Harness 协议分流的实现细节。
三步完成:探测本机客户端、写入并验证配置、重启客户端使配置生效。
自动扫描 PATH、Win32 注册表、NPM 全局脚本、Store 隔离包与 macOS Spotlight,修复失效路径。
DISCOVER按场景自动绑定三大专属分组,缺省令牌自动开通,流式握手验证延迟与 Token。
VERIFY & PROVISION原子写入配置,等待句柄释放,携最新配置与最优通道平滑重新拉起客户端。
ACTIVATE当前官方版本 v1.0.88 · 支持 7 款 AI 编程客户端 · Windows 10/11 与 macOS 11+ · MIT 开源 · 最后更新
NSIS 自动安装程序,包含快捷方式、开始菜单、WebView2 检测与平滑自动更新。
解压即用,不写入系统注册表,即插即走,适合 U 盘或企业受限办公环境。
基于 Tauri v2 + React 18 + Rust 2024,源码完全开放透明,随心定制扩展。
AI-Helper-v1.0.88-Windows-x64-Setup.exe · 包含全平台二进制
SHA-256 校验和。
专为搭载 M1 / M2 / M3 / M4 / M5 芯片的 Mac 深度原生优化。纯 ARM64 编译,零转译损耗,常驻内存低至 28MB。
适用于搭载 Intel Core 处理器的经典 Mac 设备,自动化 DMG 打包,保持一致的流畅体验。
若提示“已损坏”或“未验证的开发者”,只需在终端执行一行命令即可清除隔离属性:
xattr -cr /Applications/AI\ Helper.app
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 镜像 | 下载 ↗ | 镜像 ↗ |
关于 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。