工具接入总览
把 TokenRoute 的 API Key 填进你惯用的客户端、IDE 或命令行工具。
选哪个工具
| 你想做什么 | 用这个 | 难度 |
|---|---|---|
| 日常聊天、快速试模型 | Chatbox | 低 |
| 桌面客户端、管理多个模型 | Cherry Studio | 低 |
| 在 IDE 里写代码 | VS Code / Cline | 中 |
| 命令行里让 AI 改代码 | Codex | 中 |
| 用 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是多了还是少了 - 模型名是否与模型列表完全一致
- 账户是否还有额度
- 协议是否选对——Anthropic 接口不能用 OpenAI 的
Authorization头
仍未解决见常见问题。
不同系统的注意点
| 系统 | 注意 |
|---|---|
| Windows | 优先用工具自带的图形界面配置；命令行工具注意 PowerShell 和 CMD 的环境变量写法不同 |
| macOS | 可用 Homebrew 装 Node.js 等依赖；配置文件多在 ~/.config、~/.claude、~/.codex |
| Linux | 用 shell 配置为主；注意环境变量的生效范围和文件权限 |