Claude Code 与 Codex 如何调用 2,000+ AI 模型：先查价格再执行

[denial123789]

SandBase CLI 为 Claude Code、Codex、Cursor 等 25 个 AI 客户端目标提供一套统一的 MCP 调用流程：

发现 → 检查参数和价格 → 执行 → 异步任务轮询

当 Agent 缺少某项专用能力时，可以用它查找其他 LLM、图片/视频生成、Embedding、网页提取、社交数据或结构化 API。若用户已经有专用工具或自己的 API Key，应优先使用现有集成。

中文项目页：https://sandbaseai.github.io/cli/zh/

1. 连接客户端

macOS 和 Linux 推荐使用已经过双平台 CI 验证的官方 Homebrew Formula：

brew install sandbaseai/tap/sandbaseai-cli
sandbase catalog --json
sandbase connect

catalog --json 是只读命令，无需登录，也不会修改客户端配置。当前输出 25 个客户端目标。

不使用 Homebrew 时，可以直接运行固定到 v0.1.17 的 GitHub Release：

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect

在浏览器中完成授权，然后选择已安装的客户端。CLI 会安装按需启动的本地 stdio 桥接器，不会启动常驻后台服务。

2. 先发现候选模型或 API

可以直接对 Agent 说：

使用 sandbase_discover 查找适合生成方形产品插画的图片模型。暂时不要执行付费调用。

sandbase_discover 支持关键词、端点类型、厂商和结果数量筛选；中文别名也可用于部分常见能力搜索。

3. 执行前检查 Schema 与价格

对最佳的两个候选项调用 sandbase_inspect，比较必填参数和当前单次价格，然后推荐一个。先不要执行。

sandbase_inspect 会返回输入 Schema、价格信息以及执行模板，从而避免猜测参数名，也避免在比较之前直接产生费用。

4. 选择后再执行

使用已经确认的提示词和参数执行推荐端点，并告诉我准确的端点名称，以及结果是同步还是异步。

Agent 会通过 sandbase_run 发送符合 Schema 的参数。

视频生成等异步任务会返回 run_id，应使用 sandbase_run_get 轮询，而不是重复创建任务：

每 10 秒检查一次这个 run_id，直到完成或失败；不要创建第二个任务。

5. 查看费用和余额

使用 sandbase_runs 汇总最近 5 次调用及其记录费用，然后通过 sandbase_account 显示剩余余额。

六个 MCP 工具分别是：

• sandbase_discover：搜索 2,000+ 模型与 API
• sandbase_inspect：检查 Schema、价格和执行模板
• sandbase_run：执行模型或 API
• sandbase_run_get：获取异步任务结果
• sandbase_runs：查看近期调用与费用
• sandbase_account：检查账户余额

安全边界

• 每次付费调用前检查当前价格。
• 对可能写入外部系统的 API 保留人工确认。
• 不要在未审核 SandBase 及上游服务商政策的情况下发送密钥、受监管数据或不必要的个人信息。
• 对安装来源要求较高时，先校验 v0.1.17 Release 页面和安装指南中公布的 SHA-256。
• 可使用 doctor 检查配置，使用 unregister 仅移除 SandBase 管理的状态。

相关资源：

• 中文项目页
• 源码与中文安装说明
• 官方 Homebrew Tap
• v0.1.17 Release
• 官方 MCP Registry 收录
• 中国独立开发者项目收录
• 25 客户端中文配置指南
• 英文版实战指南

如果你完成了测试，欢迎分享客户端名称和使用场景，但请不要提交凭证或私密模型输入。如果这套流程节省了集成时间，为 SandBase CLI 点 Star 可以帮助更多 Agent 开发者发现它。

披露：这是 SandBase 官方技术教程，使用 AI 辅助起草，并依据 v0.1.17 源码、托管 Skill 文档与发布元数据复核。

[denial123789]

安装方式更新：SandBase CLI v0.1.17 现在提供官方 Homebrew Formula，支持 macOS 和 Linux。

brew install sandbaseai/tap/sandbaseai-cli
sandbase catalog --json
sandbase connect

使用完整 Formula 名称时，Homebrew 6 只信任 sandbaseai-cli 这一项，不会自动信任整个 Tap。Formula 会校验 v0.1.17 发布包的 SHA-256。macOS 与 Linux 的 style、strict audit、安装和 25-client 测试均已通过：

https://github.com/sandbaseai/homebrew-tap/actions/runs/33129935680

披露：我是 SandBase 项目关联方。本更新使用了 AI 辅助撰写和校验。