Home

StackFerry 使用教程

StackFerry 是面向 Codex、Claude Code、Grok Build 的本地桌面控制面。它不替代这些 CLI，只负责：保存官方登录或自定义网关、启用时备份并写入该 CLI 的配置、按需在本机 127.0.0.1 做故障转移，以及把 Skills 与 MCP 收在一处再投影到你真正在用的工具上。

当前文档对应 1.0.9。下载最新版 · 提交问题

阅读顺序

1. 安装 — 下载、各平台注意、应用更新
2. 快速开始 — 从打开应用到发出第一条请求
3. 供应商 — Codex / Claude / Grok 的字段与启用规则
4. 故障路由 — 队列、熔断、直写与退出还原
5. Skills · MCP — 技能与 MCP 的集中管理
6. CLI 工具 · 设置 — 安装 CLI、外观、公告
7. 导入供应商 · 数据迁移 — 一键导入与从旧版 / cc-switch 迁入
8. 配置落点 · 常见问题

它做什么

• 按 CLI 分开管理供应商。 左侧 Codex、Claude、Grok 各有一份列表，互不影响。
• 启用才会写盘。 添加只是入库；点「启用」才会先备份，再写入该 CLI 的 live 配置。
• 故障路由可选。 队列非空时，请求走本机代理，按顺序尝试上游，并带熔断。官方登录不会进队列。
• Skills / MCP 只维护一份。 在 StackFerry 里安装或导入，再勾选投影到 Claude、Codex、Grok。
• 关闭窗口不是退出。 关窗口会藏到托盘，路由继续跑；选「退出」才会把路由写回的配置还原成直连。

五分钟上手

1. 从 Releases 安装 StackFerry，并在本机装好要用的 CLI（也可在 设置 → CLI 工具 里安装）。
2. 打开应用，左侧选 Codex、Claude 或 Grok。
3. 添加自定义网关（地址和 API Key），或继续用官方登录。
4. 点 启用。直写模式请重启对应 CLI 或终端；若已开故障路由，切换上游通常不必重启。
5. 需要备用上游时，在供应商菜单里选 加入队列。
6. 再到 Skills / MCP 导入并勾选目标 CLI。

中转站也可以发 stackferry:// 导入链接。应用会先弹出确认，只新增、不自动启用、不覆盖同名条目。协议见 导入供应商。