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