已支持
01 · 编码 CLI
Claude Code
合并现有 settings.json，保留权限与工具设置。
CLAUDEBEEAPI CONFIGURATOR · 8 TOOLS
把 BeeAPI，接入你
常用的 AI 工具。
GetBeeAPI 是 BeeAPI 的快捷配置器。它识别本机已有工具，连接你的 BeeAPI 密钥配置与模型，备份原配置后完成写入——不用再逐个寻找配置文件和字段。
不替代你的 AI 工具只负责把 BeeAPI 接进去
curl -fsSL https://getbeeapi.com/install.sh | shLinux · macOS · WindowsSHA-256 校验安装包不输入账户密码
首次输入 beeapi 完成连接；以后输入即可按工具配置或切换 Key 与模型、查看余额，也可用 beeapi update 安全更新。
一条命令，配置这些工具
Claude Code
Claude Desktop
Codex
Gemini CLI
Grok Build
OpenCode
OpenClaw
Hermes
- 01选择可用入口
- 02连接 BeeAPI
- 03配置本地工具
脚本安装成功···正在读取安装统计
已适配工具8可检测，也可预配置
桌面系统3Linux · macOS · Windows
官方入口2beeapi.ai · beeapi.dev
安装脚本会自动完成 SHA-256、写入与版本验证，无需手动运行命令；只汇总下载来源、版本、系统、架构与日期，不保存 IP、账号或 Key。
SUPPORTED TOOLS
熟悉的工具，
现在都能接上 BeeAPI。
当前版本 · 8 项适配
同时检查可执行文件与已有配置，推荐本机已安装的工具；你也可以预先配置尚未安装的工具。
已支持
02 · 桌面应用
Claude Desktop
Windows/macOS 写入独立 3P 配置，不修改 Claude Code。
DESKTOP已支持
03 · 编码 CLI
Codex
只更新默认配置的 BeeAPI provider，不改 ChatGPT 登录与 MCP。
CODEX已支持
04 · 编码 CLI
Gemini CLI
只更新原生 .env 连接变量与鉴权选择。
GEMINI已支持
05 · 编码 CLI
Grok Build
在默认配置中增加 BeeAPI model，保留 UI 与 MCP。
GROK已支持
06 · 编码 CLI
OpenCode
深度合并 BeeAPI provider 与默认模型。
OPENCODE已支持
07 · 个人智能体
OpenClaw
同步 provider、模型列表与主模型选择。
OPENCLAW已支持
08 · 智能体 CLI
Hermes
局部更新 model 与原生 .env，保留 agent、MCP 等设置。
HERMES关于 Claude Desktop它与 Claude Code 使用独立配置。Windows/macOS 支持原生 3P gateway 直连；切换后完全退出并重开 Desktop 生效。
CLAUDE DESKTOP · 3P环境扫描选择一个工具选择 Key 与模型独立备份写入验证
BEEAPI ACCESS
BeeAPI 访问入口
CLI 内置两个候选域名，并在你的网络中实时检查可访问性与响应速度。无法直连或希望进一步提速时，再进入 Cloudflare IP 优选。
可访问情况以用户本机的实时检测结果为准。
HOW IT WORKS
从 BeeAPI 密钥配置，到工具里的可用模型。
首次运行只负责可用入口与 BeeAPI 账户连接。完成后再次输入 beeapi，会进入四项主页；工具、Key、模型和多套方案都按工具独立配置。
选择可用入口
先检查内置域名的健康状态，再读取并验证 BeeAPI 官方入口列表。能直接访问就使用最快入口；确实不可用时才进入 IP 优选。
healthz → 官方列表 → 按需优选连接 BeeAPI
在 BeeAPI 官方页面完成 OAuth 授权。首次连接只保存账户会话并读取余额，不会提前领取或创建 API Key。
OAuth → 保存账户 → 进入主页配置本地工具
一次选择一个工具，再选择一枚兼容的 BeeAPI Key、模型和工具专属参数。每个工具可保存多套独立方案并随时切换。
tool → key → model → named config
AUTHORIZATION
用熟悉的方式，
连接 BeeAPI。
推荐通过 BeeAPI OAuth 连接账户：首次只保存账户会话并读取余额。以后配置某个工具时，再查看兼容 Key 与模型；只有你在终端选中 Key 后，才会一次性领取。不会创建新 Key，也可以直接粘贴单个 Key 回退。
01推荐
OAuth 连接 BeeAPI 账户
桌面端使用浏览器 + PKCE 回到本机，SSH 使用设备码并始终显示完整网址。账户连接与工具 Key 选择分开；配置工具时选择哪一个，才领取哪一个。
GetBeeAPI 请求连接账户账户资料 · 余额 · Key 与模型
- 密码、2FA 与网页 Cookie 不进入 CLI
- SSH 终端始终显示完整授权网址与设备码，可在其他设备打开
- 账户 Token 采用 DPoP 绑定，不能用于模型调用
- API Key 先选择、再一次性领取、保存成功后立即确认清除
- 令牌交换与 Key 导出响应中断时复用原请求恢复；保存后可从本地断点继续
02兼容回退
直接粘贴 API Key
如果设备授权暂时不可用，或你已经准备好要使用的 Key，可以直接粘贴。终端会尽量关闭输入回显。
API KEY
sk-••••••••••••••••••••••仅保存到本机- 优先使用系统钥匙串或凭据存储
- 回退文件使用仅限当前用户的权限
BeeAPI 服务端契约
OAuth public client 使用 PKCE、标准 Device Grant、轮换 Refresh Token 与持久 DPoP 设备绑定。账户 Token 只允许读取已授权的账户资源，不能进入模型转发；API Key 选择性导出采用短期、幂等、保存后 ACK 的一次性交付。
查看设计文档 ↗SMART ROUTE SELECTION
为 BeeAPI 选择
能访问、也更快的线路。
CloudflareSpeedTest 先筛出 TCP 443 可达的 IP；CLI 再用 BeeAPI 域名的 TLS 与 /healthz 复验前 20 个候选，并按真实 API 响应选择更快线路。
01 TCP 可达性筛选02 TLS / API 实测03 失败自动回退
beeapi.ai可访问性检测
beeapi.dev可访问性检测
- 01
检查官方域名可用性先判断是否需要优选，并记录可以直接使用的入口
HTTPS - 02
筛选 TCP 443 可达 IP按连接延迟与丢包筛出前排候选
可访问 - 03
实测 TLS 与 /healthz并发复验前 20 个候选，选择真实 API 响应更快的线路
低延迟 - 04
写入 Hosts 或自动回退业务复验通过才写入；全部失败则继续使用可用域名
可恢复
SAFE BY DEFAULT
连接更顺畅，
安全边界不变。
每一个会影响系统或凭据的步骤，都有明确验证、授权与恢复边界。
下载可验证
发行文件来源固定；优先走 GetBeeAPI 边缘缓存，失败回退 GitHub，并始终核对 SHA-256。
线路可验证
候选 IP 仍使用 BeeAPI 域名完成 TLS 握手，证书不匹配立即拒绝。
修改可恢复
配置与 Hosts 写入前分别备份，受管区块不触碰用户的其他内容。
授权看得见
网页明确列出账户、余额与 Key 读取范围；CLI 不接触密码、2FA 或 Cookie，只领取你随后在终端明确选中的 Key。
FAQ
开始之前，
再确认几件事。
01线路优选具体在选择什么？＋
正常入口可访问时不会启动优选。只有需要修复或你主动选择时，才先按 TCP 443 延迟与丢包筛选 Cloudflare IP，再用 BeeAPI 域名的 TLS 与 /healthz 复验前排候选；全部失败会自动回退到已有可用入口。
02它会弄乱我现有的配置吗？＋
不会。它先完整备份原文件，再只更新 BeeAPI 的 API 地址、Key、模型、provider 与必要鉴权字段；权限、MCP、主题、插件和其他 provider 保留。任一步失败会自动回滚，也可以运行 beeapi rollback latest。
03线路优选会直接修改 Hosts 吗？＋
不会。只有官方入口不可用，或你主动希望使用更快线路时，CLI 才会在展示结果后请求写入；原始 Hosts 会先完整备份。
04不方便使用网页授权怎么办？＋
选择第二项，粘贴 BeeAPI 控制台生成的单个 API Key 即可。兼容模式仍不会要求账户密码。
05能保存并切换多套配置吗？＋
可以。每个工具独立保存多套方案，每套方案绑定自己的 BeeAPI Key、模型和专属参数。切换 Codex 不会改动 Grok Build、Gemini CLI 或其他工具。
06Claude Desktop 和 Claude Code 会互相覆盖吗？＋
不会。两者使用独立适配器。Claude Desktop 仅在 Windows/macOS 写入自己的 3P gateway 配置，并只开放可直连的 Claude 模型；Linux 暂不写入 Desktop 配置。
你的工具不变，
现在接上 BeeAPI。
8 项工具适配 · 自动识别 · 独立备份 · 一键回滚
安装 beeapi ↑