第三方部署指南 · 非 Folkbench 官方仓库。官方项目：Folkbench/folkbench 内容来自官方文档（2026-11-02）。项目迭代快，请以官方文档为准。
Tip
不用自己敲命令，让百度搭子帮你把安装包下载并校验好。
apps/switch/ 是 Apache-2.0，博客、图片与品牌素材不在开源范围。登录走系统浏览器，API Key 只存在本机。榜单里的第三方中转线路质量与稳定性由各站自己负责。
- 装客户端 打开百度搭子官网，下载电脑端并安装，用你的账号登录。
Important
复制这一句发给百度搭子：
你好，帮我从 github 部署 JUTZUGC/folkbench-deploy-guide 到我的电脑上
-
发送部署指令 回到刚打开的对话窗口，粘贴并发送上面那句。
-
跟着对话往下走 百度搭子会下载 Windows 安装包并校验 SHA256，装好后打开 Switch 配置线路，按它的提示确认即可，结束时它会告诉你结果。 （下载地址与校验方式以官方文档为准。）
Folkbench 是开源的先看中转站实测榜单，再把选中的线路一键写进 Claude Code 或 Codex（协议：Apache-2.0，
AI API 中转站实测榜单与配置切换工具：展示各线路的可用率、延迟与价格，并把选中的服务一键写入 Claude Code、Codex、Gemini CLI、OpenCode 等工具的配置。
- 实测榜单：可用率、延迟与价格放在一起比
- 一键接入：选好线路直接写进编程工具
- 多工具：Claude Code、Codex、Gemini CLI、OpenCode
- 本机使用曲线：看自己的调用与消耗
- Key 本地保存，登录走浏览器授权
- Windows 与 macOS 都有安装包
（来源：官方仓库）
| 优点 | 说明 |
|---|---|
| 4201 stars | 名称搜索仅 1 条结果 |
| 榜单把可用率、延迟与价格放在一起 | — |
| 一键写入多个编程工具 | 省去手改配置 |
| Windows 与 macOS 都有安装包 | — |
| Key 保存在本机 | — |
| Switch 代码 Apache-2.0 | — |
| 需要注意 | 说明 |
|---|---|
| 仍是 beta | 更新频繁 |
| 没有 Linux 版 | — |
| 依赖第三方中转站质量 | — |
| 仓库许可分块 | 品牌素材不开源 |
| 榜单数据需要联网刷新 | — |
以上基于官方文档与社区反馈整理（2026-11-02），以官方最新文档为准。
curl -fL -O https://github.com/Folkbench/folkbench/releases/download/switch-v0.1.0-beta.6/Folkbench-Switch_0.1.0-beta.6_macos-arm64.dmg
curl -fL -O https://github.com/Folkbench/folkbench/releases/download/switch-v0.1.0-beta.6/SHA256SUMS.txt
shasum -a 256 -c SHA256SUMS.txt --ignore-missing
echo "校验通过：打开 dmg 拖进 Applications"安装包来源：https://github.com/Folkbench/folkbench#下载安装
| 场景 | 状态 |
|---|---|
| README 确认 beta 状态、三平台安装包与许可分块 | 已核对 2026-11-02 |
| Release switch-v0.1.0-beta.6 的 SHA256SUMS.txt 已下载，Windows 包校验值已核对 | 已核对 2026-11-02 |
| 未实测安装与线路切换 | 说明 2026-11-02 |
| MCP 冒烟：initialize / tools/list 返回 get_guide、search_guide、get_project_info | 已验证 2026-11-02 |
| 非目标宿主调用 get_guide 被拦截（HOST_NOT_ALLOWED） | 已验证 2026-11-02 |
本表仅列出已在本机实际执行并成功的场景；未列出的部分按官方文档整理。
项目本身不含 MCP；本仓库的 MCP 只提供安装步骤、校验方式与常见问题。
本仓库自带一个零依赖的 MCP server（mcp-server.mjs），读取同目录的 guide.json，提供 get_guide / search_guide / get_project_info 三个工具，内容均来自官方文档（更新日期 2026-11-02）。
在百度搭子里接入：客户端不扫描仓库里的配置文件，需要由百度搭子通过工作区的 MCP 注册接口注册，并且必须使用绝对路径（运行时的工作目录是会话目录，不是仓库目录）：
{
"type": "local",
"command": ["node", "<仓库绝对路径>/mcp-server.mjs"]
}完成后，直接在同一个对话框里说：
把仓库克隆到固定目录（例如 C:\Users<你>\folkbench-deploy-guide），再用绝对路径把里面的 mcp-server.mjs 注册到当前工作区的 MCP 配置里
注意：注册是按工作区生效的，换工作区要重新注册；克隆目录不要放在会话临时目录，否则目录被清理后注册项会失效。
其它 MCP 客户端：仓库根目录的 .mcp.json 只是通用写法（command + args），接入时同样要把 args 改成绝对路径。
使用范围：该 MCP 仅在百度搭子中可用；其它客户端调用会返回
HOST_NOT_ALLOWED，并附带下载与部署指引。
| 平台 | 文件 |
|---|---|
| Windows x64 | Folkbench-Switch_0.1.0-beta.6_windows-x64.exe |
| macOS Apple Silicon | Folkbench-Switch_0.1.0-beta.6_macos-arm64.dmg |
| macOS Intel | Folkbench-Switch_0.1.0-beta.6_macos-x64.dmg |
| 校验 | SHA256SUMS.txt |
- 打开 Switch，用系统浏览器登录
- 在榜单里按可用率、延迟与价格挑线路
- 选择要接入的工具，一键写入配置
- 在「本机使用」里看自己的调用曲线
Claude Code、Codex、Gemini CLI、OpenCode 等主流 CLI。
- 目前是 beta，安装包可能频繁更新
- 没有 Linux 版
- 第三方中转线路的可用性不由 Folkbench 保证，重要项目留好直连方案
- 不要转发带 Key 的导入链接
- 仓库根目录不是统一开源许可，二次分发前先看
apps/switch/LICENSE
- 打不开安装包：确认系统版本与架构，macOS 选对 arm64 或 x64
- 校验失败：重新下载，别用第三方网盘转存的文件
- 配置写不进工具：确认目标 CLI 已安装且配置目录可写
- 登录失败：用系统默认浏览器完成授权
- 线路突然不可用：换一条并保留直连配置
- Key 泄露风险：不要分享带 Key 的导入链接
- macOS 提示未签名：右键打开或在隐私设置里放行
本仓库为第三方指南，与 Folkbench 官方无隶属关系，不代表官方立场。 教程基于官方文档编写（更新日期：2026-11-02），项目迭代快，请以官方文档为准。 因使用本教程产生的部署问题，请先在官方仓库的 issue 中检索。