QuickRouter Switch 一键配置工具（新手推荐）
下载对应系统版本，输入 QuickRouter API Key，即可快速完成 Claude Code、OpenCode、Codex、Gemini 等工具的本地配置。
⚠️
支持 Windows、macOS
支持 Claude Code、OpenCode、Codex、Gemini、OpenClaw、Hermes
本地运行，填入后台获取的令牌（API Key）即可，不破坏现有配置，随意切换
支持 Claude Code、OpenCode、Codex、Gemini、OpenClaw、Hermes
本地运行，填入后台获取的令牌（API Key）即可，不破坏现有配置，随意切换
QuickRouter Switch 一键配置桌面客户端下载
统一管理多种 AI 编程工具的 Base URL、API Key 和模型参数。
| 平台 | 架构 | 文件 | 下载 |
|---|---|---|---|
| Windows | x64 | QuickRouter-switch_2.1.5_windows_x64_setup.exe | 下载 |
| macOS | 苹果 M 系列芯片 | QuickRouter-switch_2.1.5_mac_arm64.dmg | 下载 |
| macOS | Intel 芯片 | QuickRouter-switch_2.1.5_mac_x64.dmg | 下载 |
macOS 用户注意
第 1 步：下载并安装
如首次打开提示无法验证开发者，请进入 系统设置 → 隐私与安全性 → 点击「仍要打开」。
如果提示 App 已损坏，请将 App 拖入应用程序后，在终端执行：
xattr -cr /Applications/QuickRouter-switch.app然后在「应用程序」中打开（步骤：访达 → 应用程序）。
Claude Code 工具需要打开路由开关（其他工具不需要）
第 1 步：点击设置按钮
打开应用后，点击齿轮的设置按钮
第 2 步：打开路由开关
在设置页面选择「路由」选项卡，需要完成以下操作：
- 打开路由总开关（确保状态显示为「运行中」）
- 在「路由启用」区域，打开 Claude 应用开关
如图所示，点击打开就可以，其他不用改。
常见问题
| 现象 | 原因 | 处理方式 |
|---|---|---|
| macOS 提示无法验证开发者 | 应用未签名 | 系统设置 → 隐私与安全性 → 点击「仍要打开」 |
| macOS 提示 App 已损坏 | macOS 安全隔离 | 终端执行 xattr -cr /Applications/QuickRouter-switch.app |
| Windows 提示 SmartScreen 已阻止 | 未经过微软签名认证 | 点击「更多信息」→「仍要运行」 |
| 配置后 Claude Code 连不上 | 路由模式未开启 | 在工具设置中打开路由模式 |
| 路由状态显示未运行 | 路由总开关未开启 | 在设置 → 路由中打开路由总开关 |
一键配置工具（新手推荐） API 中转配置要点
如果你通过搜索“一键配置工具（新手推荐） 配置教程”“一键配置工具（新手推荐） API 中转”“一键配置工具（新手推荐） QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。
| 配置项 | 填写建议 | 常见问题 |
|---|---|---|
| API Key | 填写 QuickRouter 控制台创建的密钥 | 401 通常是 Key 错误、过期或额度不足 |
| Base URL | 按本页工具要求填写 QuickRouter 接口地址；OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1 | Claude/Anthropic 类工具不一定带 /v1 |
| 模型 ID | 从价格页复制完整模型名 | model not found 通常是模型名或分组权限问题 |
常见排查方向
- 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
- 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
- 连接超时：确认工具里的 Base URL 没有多写路径或空格。
- Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。
相关入口
常见问题
一键配置工具（新手推荐） 可以通过 QuickRouter API 接入大模型吗？
可以。只要 一键配置工具（新手推荐） 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。
一键配置工具（新手推荐） 的 Base URL 应该怎么填？
按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。
一键配置工具（新手推荐） 提示 model not found 怎么办？
到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。