QuickRouter Switch 一键配置工具（新手推荐）
适用范围：本页 QuickRouter Switch 2.3.0 桌面安装包与路由开关设置。
版本与验证：2026-09-28 核对本文配置项、步骤和资料入口，补齐验证与排错说明。仅核对本页已列出的安装包与流程，未声称 2.3.0 是当前最新发布。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| 安装包 | 对应系统与 CPU 架构 | Windows x64、macOS Apple Silicon 或 Intel。 |
| 提供商 | QuickRouter | 填写并保存自己的令牌。 |
| 模型接口 | 按目标工具与协议配置 | OpenAI /v1、Anthropic 根地址、Gemini 原生地址不能混用。 |
| 路由开关 | 总开关及目标应用开关 | 只对需要路由的目标程序启用。 |
还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key
为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。
下载对应系统版本，输入 QuickRouter API Key，即可快速完成 Claude Code、OpenCode、Codex、Gemini 等工具的本地配置。
支持 Claude Code、OpenCode、Codex、Gemini、OpenClaw、Hermes
本地运行，填入后台获取的令牌（API Key）即可，切换前保留已有配置；以客户端实际写入结果为准
QuickRouter Switch 一键配置桌面客户端下载
统一管理多种 AI 编程工具的 Base URL、API Key 和模型参数。
| 平台 | 架构 | 文件 | 下载 |
|---|---|---|---|
| Windows | x64 | QuickRouter-switch_2.3.0_windows_x64_setup.exe | 下载 |
| macOS | 苹果 M 系列芯片 | QuickRouter-switch_2.3.0_mac_arm64.dmg | 下载 |
| macOS | Intel 芯片 | QuickRouter-switch_2.3.0_mac_x64.dmg | 下载 |
macOS 用户注意
第 1 步：下载并安装
如首次打开提示无法验证开发者，请进入 系统设置 → 隐私与安全性 → 点击「仍要打开」。
如果提示 App 已损坏，请将 App 拖入应用程序后，在终端执行：
xattr -cr /Applications/QuickRouter-switch.app然后在「应用程序」中打开（步骤：访达 → 应用程序）。
Claude Code 、Codex工具需要打开路由开关
第 1 步：点击设置按钮
打开应用后，点击齿轮的设置按钮
第 2 步：打开路由开关
在设置页面选择「路由」选项卡，需要完成以下操作：
- 打开路由总开关（确保状态显示为「运行中」）
- 在「路由启用」区域，打开目标工具（Claude Code 或 Codex）的应用开关
确认路由状态为「运行中」，并选中当前使用的工具。重启目标工具后再发送测试请求。
填写提供商并验证写入结果
在 QuickRouter Switch 中选择目标工具，填写 QuickRouter API Key、该工具所用协议地址和可用模型后保存。目标工具重启后，核对它实际读取的配置与调用日志；Switch 保存成功不能替代一次目标工具的请求验证。本文保留 2.3.0 下载资源说明，不将其标记为当前最新版本。
怎样确认配置已生效
- 选中正确提供商，路由状态显示运行中。
- 从目标工具发出短消息，QuickRouter 有调用记录。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 目标工具没走路由 | 核对总开关、目标应用开关及实际启动的应用。 |
| 路由无法启动 | 检查端口占用与应用日志，保留错误信息。 |
| 安装后软件打不开 | 确认安装包架构与系统相符，再按发行说明处理。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。