SandBase CLI 中文指南：一个 MCP Bridge 连接 25 种 AI 客户端
使用开源 SandBase CLI 连接 Codex、Claude Code、Cursor、Gemini CLI 等 25 种客户端，通过六个 MCP 工具访问 2,000+ AI 模型与 API。
支持 MCP 的 AI 编程客户端越来越多，但它们使用的配置文件、命令和安装流程并不相同。要让 Codex、Claude Code、Cursor、Gemini CLI 或 Windsurf 使用同一组工具，开发者经常需要维护多套容易过期的配置说明。
SandBase CLI 是一个 Apache-2.0 开源的 TypeScript CLI 和本地 MCP Bridge。它检测已安装的客户端，使用带 PKCE 的 OAuth device flow 完成授权，并且只修改由 SandBase 自己管理的配置。
当前 v0.1.17 提供 25 种客户端目标，通过 6 个 MCP 工具访问 2,000+ AI 模型和 API。
登录前先检查兼容性
下面的命令只输出机器可读的客户端目录，不登录，也不修改本地配置：
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json固定的 GitHub Release 地址可以避免 npm latest 尚未同步到当前版本时安装旧包。发布资产来自不可变的 v0.1.17 tag，SHA-256 校验值也随 Release 公布。
连接检测到的 AI 客户端
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect也可以只连接一个指定客户端：
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursorCLI 会打开浏览器完成一次授权，然后为能够安全自动配置的客户端写入 SandBase 自己拥有的 MCP 条目。对于没有稳定配置接口的客户端，它会生成明确的启动命令或待确认步骤，不会假装安装已经完成。
支持哪些客户端
当前目录覆盖：
- Codex
- Claude Code 与 Claude Desktop
- Cursor 与 Cursor CLI
- Gemini CLI
- Windsurf
- OpenCode、Qwen Code 与 Kimi CLI
- Kiro IDE 与 Kiro CLI
- Warp、Amp、Hermes 与 OpenClaw
- 需要工作区级人工确认的 ChatGPT 与 Cowork 流程
自动配置、引导配置和手动配置会在 catalog --json 中明确区分，方便 CI、支持脚本和安全审查读取。
六个 MCP 工具
连接后，Agent 使用一组紧凑工具，而不是一次加载巨大的静态模型清单：
| 工具 | 用途 |
|---|---|
sandbase_discover | 搜索模型和 API 目录 |
sandbase_inspect | 获取输入 schema、价格和请求模板 |
sandbase_run | 执行选定模型或 API |
sandbase_run_get | 轮询视频生成等异步任务 |
sandbase_runs | 查看近期调用和成本信息 |
sandbase_account | 在不发起付费任务的情况下查看余额 |
推荐的调用顺序是：
discover -> inspect -> runAgent 在运行之前先读取当前 schema 和价格，避免只根据模型名称猜测参数。
配置所有权与回滚
CLI 对本地配置采用所有权感知的更新方式：
- 凭据不会出现在命令行参数或 URL 中；
- 本地凭据文件使用受限权限；
- 保留原有 JSONC 注释和其他 MCP 条目；
- 安装失败时回滚 SandBase 管理的改动；
unregister只移除 SandBase 拥有的配置；doctor读取实际安装状态，并指出仍需客户端确认的步骤。
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor查看源码与当前发行版
如果这个 CLI 能减少你维护多套 MCP 配置的工作量，欢迎在 GitHub 给 SandBase CLI 一个 Star。这会帮助更多 Agent 开发者发现和评估项目。
