内容
# FreeModel 中转服务器
**停止为每项任务支付高昂的费用。 将编码任务路由到 DeepSeek，推理任务路由到 Qwen，写作任务路由到 Gemini — 自动完成。 一个 API 密钥，25+ 平台，每次都选择最合适的模型。**
```bash
npx freemodel-mcp
```
FreeModel 是一个 **Claude Code 的模型路由工具**。它会分析您正在执行的操作 — 编写代码、分析数据、翻译文本 — 并为该特定任务选择最佳模型。不仅仅是选择最便宜的或最流行的模型，而是实际在相关基准测试中得分最高的模型。
---
## 为什么存在
每个模型路由工具都做同样的事情：“将廉价的提示路由到廉价的模型。” 它们通过复杂度进行分类（简单 → Haiku，复杂 → Opus）就结束了。
FreeModel 回答了一个不同的问题：**哪个模型实际上在这种类型的任务中表现良好？**
```
其他路由工具： FreeModel：
"这有多难？" "这是什么类型的任务？"
↓ ↓
简单 / 中等 / 困难 编码 / 推理 / 写作
↓ ↓
选择更便宜的模型 选择在该任务类型基准测试中得分最高的模型
```
区别在于数据。FreeModel 使用 18 个公共基准测试（LiveCodeBench、MMLU-Pro、MATH-500、IFEval、SimpleQA 等）评估每个模型在六个维度（代码、知识、数学、指令、安全、效率）上的得分。分数公开在 [model.leyijian.com/classification.html](https://model.leyijian.com/classification.html)。
---
## 与其他工具的比较
| | mcp-multi-model | claude-code-llm-router | llm-routing | **FreeModel** |
|---|---|---|---|---|
| 路由逻辑 | yaml 中的关键词匹配 | 复杂度回归 | 置信度得分 | **6 维基准测试得分** |
| 任务类型 | 无 | 简单/中等/困难 | 无 | **编码、推理、写作、聊天、创意、多模态** |
| 模型目录 | 12 个平台，手动配置 | 20 个平台，自动检测 | 20 个平台 | **25 个平台，982 个模型** |
| 为什么选择这个模型？ | “您配置了它” | “复杂度匹配” | “置信度得分” | **“在编码基准测试中得分 92”** |
| 分级系统 | 无 | 无 | 无 | **L1–L5，公开评分标准** |
| 订阅路由 | 无 | 无 | 无 | **是，自动优先考虑付费订阅** |
| 定价 | 静态 yaml | 静态 | 静态 | **实时 API 价格** |
| 数据透明度 | 不适用 | 不适用 | 不适用 | **公开分类页面** |
---
## 工作原理
### 分级系统（L1–L5）
每个模型根据六个维度基准测试得分获得一个等级 — 不是营销文案，不是感觉。
| 等级 | 标签 | 阈值 | 示例 |
|------|-------|-----------|---------|
| L1 | 专家 | 单维卓越 | DeepSeek-R1（推理 95） |
| L2 | 专业 | ≥70 综合 | Claude Opus 4, GPT-5 |
| L3 | 合格 | ≥55 综合 | Qwen3-Max, DeepSeek-V4 |
| L4 | 能力 | ≥35 综合 | GLM-4-Flash, ERNIE-Speed |
| L5 | 基础 | <35 综合 | 小型/快速模型 |
### 任务自动检测
在路由之前，从用户的提示中检测 6 种任务类型：
- **编码** — 编写代码、调试、爬虫、API、构建、修复
- **推理** — 分析、数学、架构、安全审计、规划
- **写作** — 翻译、写作、总结、报告、文档
- **创意** — 头脑风暴、命名、设计、营销
- **聊天** — 问答、推荐、比较、讨论（默认）
- **多模态** — 图片、OCR、视频
任务类型 → 筛选出在相关基准测试中得分良好的模型 → 选择最佳价格/性能。
### 评分维度
```
代码 ────────── LiveCodeBench, SWE-bench, HumanEval
知识 ───── MMLU-Pro, GPQA Diamond
数学 ────────── MATH-500, AIME 2024
指令 ─── IFEval, MT-Bench
安全 ──────── SimpleQA, TruthfulQA
效率 ──── 速度, 吞吐量, 成本
```
18 个数据源，6 个维度，全部公开。
---
## 快速开始
### 选项 1：npx（推荐）
添加到 `~/.claude/mcp.json`：
```json
{
"mcpServers": {
"freemodel": {
"command": "npx",
"args": ["-y", "freemodel-mcp"],
"env": {
"FREEMODEL_KEY": "sk-your-key"
}
}
}
}
```
在 [model.leyijian.com](https://model.leyijian.com) 获取密钥 → 设置 → API 密钥。
### 选项 2：git clone
```bash
git clone https://github.com/yummy342/freemodel-mcp.git
cd freemodel-mcp && npm install
```
```json
{
"mcpServers": {
"freemodel": {
"command": "node",
"args": ["/path/to/freemodel-mcp/server.js"],
"env": {
"FREEMODEL_KEY": "sk-your-key"
}
}
}
}
```
---
## 中转服务器工具
| 工具 | 功能 |
|------|-------------|
| `freemodel_key_health` | 订阅状态、平台健康、推荐模型 |
| `freemodel_status` | 会话摘要：活动模型、健康计数 |
| `freemodel_models` | 列出可用的平台和模型 |
| `freemodel_recommend` | 描述任务 → 获取 2-3 个模型选择及原因 |
| `freemodel_run` | 在特定模型（平台 + 模型名称）上执行 |
### 具备技能（推荐）
安装 Claude Code 技能以实现全自动路由：
1. 将 `skill.md` 复制到 `~/.claude/skills/freemodel/skill.md`
2. Claude Code 在启动时自动加载它
3. 每个任务都被自动分类 → 路由到最佳模型 → 执行
该技能添加了：订阅优先级路由、平台健康排序、配额耗尽预防、任务类型自动检测和模型备用链。
---
## 您需要
1. FreeModel API 密钥（[在此获取](https://model.leyijian.com)）
2. 在仪表盘中添加平台密钥（DeepSeek、Alibaba 等）
3. Node.js ≥ 18
就这样。配置文件中不需要 API 密钥 — 所有内容都存储在您的 FreeModel 账户中，并加密。
---
## 隐私
这是一个本地中继。提示从您的机器 → FreeModel API → 目标平台。无遥测，无分析。您的平台 API 密钥在您的 FreeModel 账户中保持加密。
---
## 数据
所有分级分数、基准测试结果和数据源都是公开的：
→ [model.leyijian.com/classification.html](https://model.leyijian.com/classification.html)
---
## 许可证
MIT
