完整上手指南 — 从注册到跑通的 13 步

🎯 本指南目标

本指南带你从 零 开始，一步步完成爱魔豆.run 的完整配置，直到你手上的 AI 客户端（Claude Code、Cursor、Cline 等）能真正跑通。

💡 如果你已经熟悉核心概念，只想快速跑通，请直接看 → 快速入门（4 步版）。本指南是 手把手详细版，覆盖每一步操作细节。

完整流程图：

网站注册 → 下载安装 → 登录 → 启动服务
  → 添加 Provider → 验证模型 → 配置路由
  → 创建令牌 → 一键配置客户端 → 跑通 ✅

📝 第一步：注册账号

打开 imodel.run，点击右上角 「登录 / 注册」。

爱魔豆.run 支持三种注册/登录方式：

💡 推荐先用 手机号码/邮箱注册，便于后续找回密码、接收用量告警。

注册完成后，会自动跳转到用户中心，可以看到你的套餐信息（默认 Free）。

📥 第二步：下载安装

登录后进入 下载页，选择你的操作系统和 CPU：

💡 不确定 CPU？macOS 点左上角 → 「关于本机」→ 看「芯片」一栏。

macOS 安装

1. 双击 .pkg 打开安装包
2. 根据安装向导，一路「下一步」完成安装
3. 安装完成后会「自动启动」，爱魔豆会启动，并驻留在系统栏托盘图标⚡
4. 第一次打开时，若系统提示「无法验证开发者」：

- 前往「系统设置 → 隐私与安全性」 - 找到被阻止的应用，点「仍要打开」

Windows 安装

1. 双击 .exe 安装向导
2. 一路「下一步」完成安装
3. 安装完成后勾选「立即启动」

安装完成后，屏幕右上角（macOS）或右下角（Windows）出现 爱魔豆系统栏托盘图标⚡。

🔐 第三步：登录爱魔豆

首次启动后，右键系统托盘图标 → 「🔑 登录到爱魔豆.run」。

弹出登录窗口后，用刚注册的账号（手机号码/邮件地址）密码登录（或扫码 / OAuth）。

登录成功后：

• 托盘图标变为带绿点的⚡图标
• 浏览器会自动打开 Dashboard

▶️ 第四步：启动服务

登录成功后，爱魔豆模型路由服务会自动启动，用户可以右键点击托盘 → 「▶ 启动服务/■ 停止服务」。

启动后，爱魔豆.run 在本地监听 `127.0.0.1:8788` — 这就是 AI 请求的入口代理。

💡 服务启动后，所有转发到 127.0.0.1:8788 的请求都会被爱魔豆.run 处理。

🖥️ 第五步：打开 Dashboard

右键托盘 → 「🌐 打开 Dashboard」。

浏览器自动打开 Dashboard。Dashboard 是爱魔豆.run 的控制台，包含 4 个 Tab：

右上角的 「⚙️ 小齿轮」 会打开 模型配置弹窗 — 接下来我们要在这个弹窗里添加 Provider、配置各档位路由。

🔌 第六步：添加 Provider

点击右上角齿轮 ⚙️ 打开 模型配置弹窗。

点击 「➕ 添加 Provider」，弹出 Provider 编辑器。

选择供应商

编辑器的「Provider 名称」下拉列出了爱魔豆.run 预置的 20+ 供应商：

💡 选套餐很重要！ 例如火山方舟有 Coding Plan / Agent Plan / 标准 Token 三种，计费方式不同；爱魔豆.run 会根据所选套餐自动填入对应的服务地址和默认模型。

填写 API Key

在「API Key」输入框填入从供应商官网获取的 Key。

💡 还没有 API Key？去对应供应商官网注册 → 创建 Key → 复制粘贴过来。

✅ 第七步：验证模型

填完 API Key 后，点击 「🔍 验证」 按钮。

爱魔豆.run 会向供应商逐个查询每个模型的可用性：

验证失败时，建议：

• 取消勾选不可用的模型
• 或调整套餐 / API Key
• 检查供应商账户余额

清理不用的模型

供应商通常提供几十个模型，但你可能只用其中几个。把不用的模型取消勾选，可以让路由更快、界面更清爽。

🧠 第八步：配置路由（核心！）

Provider 配置好后，继续在同一弹窗内向下滚动，进入路由档位配置区。

这是爱魔豆.run 的省钱核心 — 为不同复杂度的请求分配不同的模型。

路由分三档（企业版四档）

💡 分类器是自动判断请求属于简单/中等/复杂的小模型，配好后能大幅提升路由准确率。

主模型 + 备用模型

每一档都可以设置 1 个主模型 + 多个备用模型：

• 主模型优先使用
• 主模型出错、超时、限流时，自动切换到备用模型
• 可设置 冷却时间（出错后多久不再尝试该模型）

多 Provider 场景

如果你有多个 Provider（如 DeepSeek 作为主力，OpenAI 作为备用）：

• 在每一档后面 「+ 添加备用」
• 把不同 Provider 的同级别模型加入

💾 第九步：保存配置

路由配置完成后，务必点击「保存配置」。

保存按钮区有三个选项：

💡 推荐 保存配置 + 导出到云端，双保险。

保存成功后，模型路由表会显示所有已就绪的模型。

🔑 第十步：创建转发令牌

切换到 Dashboard 的 「🔑 转发令牌」 Tab。

令牌是 AI 客户端连接爱魔豆.run 的凭证（类似供应商的 API Key，但更灵活）。

点击右上角 「➕ 添加令牌」，弹出创建对话框：

填写令牌信息

💡 一个 AI 客户端对应一个令牌；多客户端建议分开创建，便于分别统计用量。

生成的令牌

创建后，系统会生成一个以 sk-... 开头的 API Key。复制保存好（只显示一次）。

⚡ 第十一步：设置路由模式

每个令牌都有独立的路由模式，决定了请求如何被路由：

💡 指定模型 是 KV Cache 优化的关键技巧！详见 → KV Cache 缓存命中

在令牌卡片上点 「Routing」下拉 切换模式。

🚀 第十二步：一键配置客户端

回到令牌 Tab，点击令牌卡片上的 「🧩 配置」 → 「一键配置到本地应用」。

爱魔豆.run 会自动扫描你电脑上已安装的 AI 客户端：

💡 如果没扫到你的客户端，可以手动复制 URL + Key 填入。

勾选要配置的客户端 → 点击 「一键配置」 → 自动完成！

💡 手动配置方法详见 → 客户端一键配置

🧪 第十三步：测试生效

现在，打开你刚配置好的 AI 客户端，发一条消息测试。

然后回到 Dashboard 概览页 观察：

🎉 全部完成！ 你已经成功配置并跑通了爱魔豆.run。

🆘 常见问题速查

💡 更详细的故障排查 → 常见问题 FAQ

📚 延伸阅读