工具接入总览
把 TokenRoute 的 API Key 填进你惯用的客户端、IDE 或命令行工具。
Windows 用户：不想手动改配置文件？
ChatGPT、Claude Code、Hermes 和 WorkBuddy 可使用 GSS Deploy（Windows 一键配置）。下载安装程序后，在本机选择工具、填入 API Key，即可自动写入配置。
选哪个工具
| 你想做什么 | 用这个 | 难度 |
|---|---|---|
| 日常聊天、快速试模型 | Chatbox | 低 |
| 桌面客户端、管理多个模型 | Cherry Studio | 低 |
| 在 IDE 里写代码 | VS Code / Cline | 中 |
| 命令行里让 AI 改代码 | Codex CLI | 中 |
| 用 Claude 风格 CLI | Claude Code | 中 |
| 在 WorkBuddy 里加自定义模型 | WorkBuddy | 中 |
| 多 Profile、多工具集的 Agent 工作流 | Hermes | 高 |
没主意就从 Chatbox 开始——装完填三个框就能用，验证 Key 是否正常最快。
开始之前
四件事缺一不可：
| 条件 | 说明 |
|---|---|
| API Key | 在控制台创建，见获取 API Key |
| 可用额度 | 账户或所属部门有余额，否则调用直接失败 |
| 模型名 | 从模型列表复制，大小写敏感 |
| 网络可达 | 本机能访问 api.smartwan.com |
通用配置项
各工具字段名叫法不同，但填的是同样几个东西：
| 配置项 | 填什么 |
|---|---|
| API Key | 控制台创建的 sk- 开头的密钥 |
| Base URL | https://api.smartwan.com 或 https://api.smartwan.com/v1，按工具页说明填 |
| 模型 | 如 deepseek-v4-flash、claude-sonnet-5、gpt-5.5 |
| 接口类型 | OpenAI Compatible 或 Anthropic，按工具支持的协议选 |
Base URL 要不要带 /v1
这是最常见的坑。有的工具会自动补 /v1，你再填一遍就变成 /v1/v1/chat/completions，报 404。
各工具页都标了推荐值，照着填即可。
配完怎么验证
先点工具里的「获取模型 / 刷新模型列表」——能拉到列表说明 Key 和网络都通了。
再新建对话发一句：
你好，请回复一句：配置成功
模型正常回复即接入完成。
失败就按这个顺序查：
- API Key 是否复制完整（首尾有没有漏字符）
- Base URL 的
/v1是多了还是少了 - 模型名是否与模型列表完全一致
- 账户是否还有额度
- 协议与客户端鉴权是否匹配——Messages 可用
x-api-key或 Bearer，按认证说明配置
仍未解决见常见问题。
教程的验证范围
| 范围 | 已确认内容 |
|---|---|
| Python SDK | OpenAI 3.17.0、Anthropic 1.7.0、Google GenAI 2.24.0 的最小真实调用 |
| CLI | Codex CLI 0.155.1 + gpt-5.5、Claude Code 2.1.278 + claude-haiku-4-5 的最小真实调用 |
| Hermes | Provider 名称匹配与配置解析、稳定版工具管理命令；完整 Agent / IM 流程需另行验证 |
| 图形客户端、IDE、安装器 | 配置教程不能代替当前版本、系统和账户的完整流程验证 |
以上真实调用日期为 2026-09-22。升级客户端或更换模型后，请重新完成最小调用，再恢复所需工具和高级参数。
不同系统的注意点
| 系统 | 注意 |
|---|---|
| Windows | 优先用工具自带的图形界面配置；命令行工具注意 PowerShell 和 CMD 的环境变量写法不同 |
| macOS | 可用 Homebrew 装 Node.js 等依赖；配置文件多在 ~/.config、~/.claude、~/.codex |
| Linux | 用 shell 配置为主；注意环境变量的生效范围和文件权限 |