客户端接入总览¶
RouteFast 基于 sub2api 提供模型接口；客户端负责对话、读写文件和工具执行。这里整理常见客户端的配置方法，不需要把这些客户端安装在 RouteFast 的服务器上。
选择你的工具¶
| 工具 | 本站教程范围 | 入口 |
|---|---|---|
| Claude Code | CLI，Anthropic Messages 接入 | Claude Code |
| Codex CLI | 自定义 Responses provider | Codex CLI |
| OpenClaw | 自定义模型 provider、默认模型与本地验证 | OpenClaw |
| Hermes Agent | Nous Research 的 Hermes，自定义推理端点 | Hermes Agent |
| Kilo | 按版本区分扩展/CLI 的自定义 provider | Kilo |
| OpenCode | 常用 v1 配置，另说明 v2 的差异 | OpenCode |
| CC-Switch | 用图形界面管理 Claude Code / Codex CLI 的接入配置 | CC-Switch |
选择客户端后，按对应教程确认版本、协议、密钥分组和模型，再进行首次连接测试。
接入前准备三项信息¶
- 正确分组的密钥。 GPT 使用
OpenAI-ChatGPT；Claude 使用Anthropic-Claude。按设备或客户端单独建 Key，便于核对用量和轮换。 - 准确模型 ID。 先按 快速开始 查询
/v1/models。教程示例使用gpt-5.6-terra或claude-sonnet-5，仍以你的密钥权限为准。 - 对应协议的地址。 常见 OpenAI 客户端填写
https://api.routefast.ai/v1。Claude Code / OpenClaw 的 Anthropic 配置使用根地址，但其他 SDK 可能要求带/v1，请按对应教程填写。
实际请求应落到下列接口，而不是落到客户端厂商的计费网关：
| 协议 | 完整请求地址 |
|---|---|
| OpenAI Responses | https://api.routefast.ai/v1/responses |
| OpenAI Chat Completions | https://api.routefast.ai/v1/chat/completions |
| Anthropic Messages | https://api.routefast.ai/v1/messages |
RouteFast 是自定义端点：不要选择 OpenRouter、Nous Portal、Kilo Gateway 或 OpenCode Zen/Go 后直接粘贴 RouteFast Key。这些入口有自己的域名与认证方式；“支持 OpenAI 兼容”不等于选择“OpenRouter”。
模型名前缀怎么填¶
发给 RouteFast API 的模型 ID 使用本站模型列表中的原值，例如 gpt-5.6-terra，不要照搬其他平台的 openai/... 或 anthropic/... 前缀。
部分客户端在本地使用 提供商ID/模型ID 来选择模型，例如 routefast-gpt/gpt-5.6-terra。这里的 routefast-gpt 是本地配置名，不是要额外加到 RouteFast 模型 ID 上的上游厂商前缀。具体位置在各教程中分别说明。
分两步验证，避免配置好就直接跑大任务¶
第一步，在空白或测试目录中发送“只回复 OK，不调用工具”，确认完整回答，并到 使用记录 按时间、Key、模型核对。客户端显示配置成功或列出模型，只能说明对应步骤完成。
第二步，在不含凭证的临时测试目录中，授权一次简单只读工具操作，例如读取你提供的测试文本。核对工具调用、结果回传与最终回答后，再逐步增加权限和任务规模。不要直接用生产仓库、支付操作或批量修改来测试配置。
文本请求成功不代表工具、图像、长上下文、缓存、MCP 或后台运行都成功；这些能力见 接口与兼容性。连续代理任务可能产生多次模型调用和费用，应设置应用侧停止条件与 Key 额度。
常见问题¶
- 第一次就提示模型不存在： 核对 Key 分组、模型 ID 和客户端本地 provider 前缀，不能只看公开模型广场。
404： 检查选的是 Responses、Chat Completions 还是 Messages；也要排除重复/v1/v1。- 文字能回复，工具失败： 检查客户端权限、工具定义、协议转换与模型支持，保留脱敏错误；不要用无限重试解决。
- 显示扣费与本站不同： 客户端的内置价格可能是厂商参考价或占位值，RouteFast 扣费以 使用记录 为准。不要填
0来表示免费。 - 服务重启后密钥丢失： 终端环境变量未必被后台服务、桌面扩展或另一个 shell 继承，应按软件自己的凭证加载方式配置。
- 调用了其他服务： 主模型接入 RouteFast 不会自动接管辅助模型、搜索、浏览器、语音、图片服务或遥测；分别核对其端点和凭证。
配置与权限安全¶
修改前备份已有配置，不要整份覆盖。配置文件、客户端数据库及备份都可能包含明文凭证，不要上传公开仓库或把真实 Key 放进导入链接。仅下载项目官方发行版；不要关闭 TLS 校验、关闭系统安全检查或启用自动批准全部工具作为接入步骤。
OpenClaw / Hermes 所说的本地 Gateway 是客户端自身的运行服务，不是 RouteFast API。普通接入不需要将它暴露到公网，也不需要把 RouteFast Key 当作本地管理后台的登录密码。
接入遇到问题时，请查看 故障排查。