09-多模型配置指南

09-多模型配置指南

适用版本：Cursor 3.0.9（user setup）
本文说明如何用OpenRouter 一个 API Key，同时配置并使用以下四款模型：GLM-5、Kimi 2.5、Claude Opus 4.6、Claude Haiku。

一、为什么选择 OpenRouter？

1.1 一个 Key，多款模型

1.2 OpenRouter 优势

• ✅一个 Key：sk-or-v1-...搞定所有模型
• ✅统一接口：OpenAI 兼容格式，Cursor 原生支持
• ✅按需付费：用多少充多少，无月费
• ✅模型丰富：200+ 模型，包括国内外主流大模型
• ✅价格透明：官网实时显示各模型价格

二、四款模型分工与 OpenRouter ID

2.1 使用策略

最难的任务（架构设计、复杂重构）→ Claude Opus 4.6 日常 Agent 写代码 → GLM-5 或 Kimi 2.5 读长文档 / 中文需求 → Kimi 2.5 快速补全 / 简单问答 → Claude Haiku

2.2 成本控制技巧

默认用 GLM-5（便宜 + 中文好） 复杂任务才切 Opus（贵但强） Tab 补全用 Haiku（最快最便宜）

三、配置步骤（全程只需 5 分钟）

3.1 注册 OpenRouter 并获取 API Key

步骤 1：注册账号

1. 访问 openrouter.ai
2. 点击Sign Up，可用邮箱或 Google 账号注册
3. 完成邮箱验证

步骤 2：创建 API Key

1. 登录后点击左侧Keys
2. 点击Create Key
3. 填写名称（如 “Cursor-Config”）
4. 复制生成的 Key（格式：sk-or-v1-xxxxxxxx）

步骤 3：充值（必须）

1. 点击左侧Credit
2. 选择金额充值（支持支付宝/信用卡）
3. 建议先充$5-10测试，用完后随时续充

⚠️重要：OpenRouter 是预付费模式，余额为 0 时无法调用模型。

3.2 查找模型 ID

在 OpenRouter 网站确认准确的模型 ID：

1. 点击左侧Models
2. 搜索框输入模型名称：
   • 搜zhipu→ 找到 GLM 系列（如zhipu/glm-4-5）
   • 搜kimi或moonshot→ 找到 Kimi 系列（如moonshotai/kimi-k2-5）
   • 搜claude→ 找到 Claude 系列
3. 记下完整的Model ID（如anthropic/claude-opus-4）

常见模型 ID 参考：

请以 OpenRouter 官网实时显示的 ID 为准，模型提供商会更新版本。

3.3 在 Cursor 中配置

第一步：填写 OpenRouter API Key

1. 打开 Cursor
2. 按Ctrl + ,打开Settings
3. 左侧点击Models
4. 找到OpenAI API Key：
   • 打开开关（切换按钮）
   • 粘贴 OpenRouter 的 Key：sk-or-v1-...

第二步：填写 Base URL

1. 在同一页面找到Override OpenAI Base URL：
   • 打开开关
   • 填入：https://openrouter.ai/api/v1

第三步：验证连接

1. 点击Verify按钮（如果有）
2. 等待验证通过
3. 如果失败，检查：
   • Key 是否复制完整（不要有多余空格）
   • Base URL 是否拼写正确
   • OpenRouter 账户是否有余额

第四步：添加自定义模型（关键）

Cursor 可能不自动显示 OpenRouter 的所有模型，需要手动添加：

方法 A：Settings 界面添加（推荐尝试）

1. 在 Models 页面找到Custom Models、Model Overrides或Add Model
2. 点击Add Model或+
3. 依次添加四个模型：
   • Name:GLM-5, ID:zhipu/glm-4-5（以实际为准）
   • Name:Kimi-2.5, ID:moonshotai/kimi-k2-5
   • Name:Claude-Opus, ID:anthropic/claude-opus-4
   • Name:Claude-Haiku, ID:anthropic/claude-haiku-4

方法 B：直接修改 settings.json

按Ctrl+Shift+P→ 输入Open Settings (JSON)：

{"cursor.customModels":[{"name":"GLM-5","provider":"openrouter","modelId":"zhipu/glm-4-5"},{"name":"Kimi-2.5","provider":"openrouter","modelId":"moonshotai/kimi-k2-5"},{"name":"Claude-Opus","provider":"openrouter","modelId":"anthropic/claude-opus-4"},{"name":"Claude-Haiku","provider":"openrouter","modelId":"anthropic/claude-haiku-4"}],"openai.apiKey":"sk-or-v1-your-openrouter-key","openai.baseUrl":"https://openrouter.ai/api/v1"}

⚠️ 注意：键名cursor.customModels、openai.apiKey等可能因 Cursor 版本而异，请以 3.0.9 实际界面为准。

3.4 验证配置

1. 重启 Cursor（重要）

2. 打开任意项目

3. 按Ctrl+L打开Chat面板

4. 点击顶部/底部的模型下拉框

5. 确认能看到以下四个模型（或你添加的自定义名称）：

   • GLM-5
   • Kimi-2.5
   • Claude-Opus
   • Claude-Haiku

6. 测试每个模型：

   • 切换到 GLM-5，发送 “你好，请用中文介绍自己”
   • 切换到 Kimi-2.5，发送 “总结这段话：【粘贴长文本】”
   • 切换到 Claude-Opus，发送 “设计一个 Python 项目的架构”
   • 切换到 Claude-Haiku，发送 “快速解释这段代码”

7. 在 OpenRouter 网站Usage页面，确认有请求记录和消费明细

四、项目级配置（可选）

如果你想为不同项目设置默认模型，可在项目根目录创建.cursor/settings.json：

{"ai":{"model":"zhipu/glm-4-5","temperature":0.2},"models":{"default":"zhipu/glm-4-5","chat":"moonshotai/kimi-k2-5","tab":"anthropic/claude-haiku-4","agent":"zhipu/glm-4-5","codeReview":"anthropic/claude-opus-4"}}

字段名可能因 Cursor 版本而异，若不生效以界面手动选择为准。

五、模型切换技巧

5.1 快捷切换方式

5.2 根据任务快速选择

写代码 / 改代码 / 生成函数 → GLM-5（快、中文好、便宜） 读长文档 / 分析需求文档 → Kimi-2.5（长上下文、中文强） 架构设计 / 复杂算法 / 重构 → Claude-Opus（推理最强） 快速补全 / 简单问答 → Claude-Haiku（最快、最便宜）

5.3 提示词配合模型选择

GLM-5 / Kimi 中文任务：

"请用中文详细解释这段代码的逻辑，并给出优化建议"

Claude-Opus 复杂任务：

"请设计一个可扩展的微服务架构，包含： 1. 服务拆分策略 2. API 网关设计 3. 数据库选型 4. 部署方案"

Claude-Haiku 快速任务：

"快速检查这段代码是否有明显 Bug，只列出问题点"

六、成本控制与监控

6.1 各模型价格参考（OpenRouter）

价格会波动，请以 openrouter.ai/models 实时显示为准。

6.2 省钱策略

默认用 GLM-5（最便宜的中文模型） 复杂任务才切 Opus（贵但强，控制用量） Tab 补全用 Haiku（如果支持） 长文档用 Kimi（性价比平衡）

6.3 监控用量

1. OpenRouter 网站 →Usage页面
2. 查看：
   • 每日/每月消费
   • 各模型调用次数
   • Token 消耗明细
3. 设置Low Credit Alert（余额不足提醒）

七、常见问题

Q1: 验证失败 “Invalid API Key”

• 检查 Key 是否复制完整（不要有多余空格或换行）
• 确认 Key 格式是sk-or-v1-...开头
• 确认没有用过期的 Key

Q2: 验证失败 “Insufficient Credit”

• OpenRouter 需要预充值，余额为 0 时无法调用
• 前往 openrouter.ai/credit 充值

Q3: 模型下拉框里没有添加的模型

• 重启 Cursor
• 检查 settings.json 语法是否正确（JSON 格式）
• 尝试在 Chat 输入框直接输入@model zhipu/glm-4-5调用
• 确认 OpenRouter 官网该模型处于Active状态（非维护中）

Q4: 模型响应慢或失败

• OpenRouter 会自动路由，偶尔可能拥堵
• 尝试切换到其他模型（如 GLM-5 切到 Kimi）
• 检查 OpenRouter 官网Status页面是否有服务公告

Q5: 想临时切回 Cursor 内置模型

• Settings → Models → 关闭OpenAI API Key开关
• 或在下拉框中选择 Cursor 自带的模型（如 “cursor-small”）

八、高级技巧

8.1 使用 OpenRouter 的优先路由

OpenRouter 支持为同一模型配置多个 Provider（备用线路），在 Settings →Priority中设置：

主选：官方 Provider（质量最好） 备选：第三方 Provider（价格便宜）

8.2 使用 OpenRouter 的缓存功能

对于重复性任务，OpenRouter 支持Prompt Caching，可降低 Token 费用（需模型支持）。

8.3 导出账单分析

OpenRouter 支持导出 CSV 账单，可用于：

• 分析团队各成员用量
• 统计各项目消耗
• 优化模型选择策略

九、完整配置检查清单

☐ 注册 OpenRouter 账号 ☐ 创建 API Key（格式：sk-or-v1-...） ☐ 充值 $5-10 测试 ☐ 在 OpenRouter 查找准确的模型 ID ☐ Cursor Settings → OpenAI API Key → 填入 OpenRouter Key ☐ Cursor Settings → Override Base URL → 填入 https://openrouter.ai/api/v1 ☐ 添加四个自定义模型（GLM-5、Kimi-2.5、Claude-Opus、Claude-Haiku） ☐ 重启 Cursor ☐ 在 Chat 下拉框验证四个模型都可见 ☐ 分别测试四个模型都能正常响应 ☐ 在 OpenRouter Usage 页面确认有消费记录

十、下一步

配置完成后：

1. 在 08-实战：Python数据分析工具 中实战测试各模型
2. 根据任务类型灵活切换，建立使用习惯
3. 定期查看 OpenRouter 账单，优化成本

继续学习 10-项目规划测试代码审查实战，在复杂项目中体验多模型协作。