xujfcn's picture
Switch to utm_source/medium/campaign tracking for GA4
e8f7f62
---
license: mit
tags:
- tutorial
- crazyrouter
- chatbox
- cherry-studio
- nextchat
- lobechat
- chatgpt
- ai-client
- llm
language:
- en
- zh
---
# 💬 Crazyrouter 客户端配置指南
> 一个 API Key,在所有主流 AI 客户端中使用 624+ 模型
[Crazyrouter](https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community) 完全兼容 OpenAI API,因此所有支持自定义 OpenAI 端点的客户端都可以直接使用。
## 通用配置信息
所有客户端的配置都用这三个值:
| 配置项 | 值 |
|--------|-----|
| API Base URL | `https://crazyrouter.com/v1` |
| API Key | `sk-your-crazyrouter-key`(在 [crazyrouter.com](https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community) 获取) |
| 模型 | `gpt-4o``claude-sonnet-4-20250514``deepseek-chat` 等 |
---
## ChatBox
[ChatBox](https://chatboxai.app/) 是一款跨平台 AI 桌面客户端,支持 Windows、macOS、Linux、iOS、Android。
### 配置步骤
1. 打开 ChatBox → 设置(Settings)
2. 选择 **AI Provider****OpenAI API Compatible**
3. 填写:
- **API Host**: `https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community`
- **API Path**: `/v1/chat/completions`
- **API Key**: `sk-your-crazyrouter-key`
- **Model**: 输入模型名称,如 `gpt-4o`
4. 点击 **Save**
### 多模型切换
在 ChatBox 中可以创建多个 AI Provider 配置:
- 配置 1:`gpt-4o`(通用对话)
- 配置 2:`claude-sonnet-4-20250514`(编程分析)
- 配置 3:`deepseek-chat`(省钱日常)
在对话中随时切换。
---
## Cherry Studio
[Cherry Studio](https://cherry-ai.com/) 是一款功能丰富的 AI 客户端,支持多模型对话、知识库、AI 绘画。
### 配置步骤
1. 打开 Cherry Studio → 设置 → 模型服务商
2. 点击 **添加服务商** → 选择 **OpenAI**
3. 填写:
- **名称**: `Crazyrouter`
- **API 地址**: `https://crazyrouter.com/v1`
- **API 密钥**: `sk-your-crazyrouter-key`
4. 点击 **获取模型列表**(自动拉取 624+ 模型)
5. 选择需要的模型,保存
### 特色功能
- 支持自动获取模型列表
- 多模型同时对话对比
- 内置知识库 RAG
- 支持 DALL-E 绘画(通过 Crazyrouter)
---
## NextChat (ChatGPT Next Web)
[NextChat](https://github.com/ChatGPTNextWeb/ChatGPT-Next-Web) 是最流行的开源 ChatGPT 网页客户端。
### 本地部署
```bash
docker run -d -p 3000:3000 \
-e OPENAI_API_KEY="sk-your-crazyrouter-key" \
-e BASE_URL="https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community" \
yidadaa/chatgpt-next-web
```
### Vercel 一键部署
1. Fork [NextChat 仓库](https://github.com/ChatGPTNextWeb/ChatGPT-Next-Web)
2. 在 Vercel 导入项目
3. 设置环境变量:
- `OPENAI_API_KEY` = `sk-your-crazyrouter-key`
- `BASE_URL` = `https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community`
- `CUSTOM_MODELS` = `+gpt-4o,+claude-sonnet-4-20250514,+deepseek-chat,+gemini-2.0-flash`
4. 部署
### 网页端设置
如果已部署,在设置页面:
- **接口地址**: `https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community`
- **API Key**: `sk-your-crazyrouter-key`
- **自定义模型名**: 添加需要的模型
---
## LobeChat
[LobeChat](https://github.com/lobehub/lobe-chat) 是一款现代化的开源 AI 聊天框架。
### Docker 部署
```bash
docker run -d -p 3210:3210 \
-e OPENAI_API_KEY="sk-your-crazyrouter-key" \
-e OPENAI_PROXY_URL="https://crazyrouter.com/v1" \
lobehub/lobe-chat
```
### 网页端设置
1. 打开 LobeChat → 设置 → 语言模型
2. 找到 **OpenAI** 配置
3. 填写:
- **API Key**: `sk-your-crazyrouter-key`
- **API 代理地址**: `https://crazyrouter.com/v1`
4. 开启 **自定义模型名称**,添加模型
### 添加其他模型
LobeChat 支持多个 Provider,你可以把 Crazyrouter 配置为 OpenAI Provider,然后在模型列表中添加所有需要的模型名。
---
## Open WebUI
[Open WebUI](https://github.com/open-webui/open-webui) 是一款类 ChatGPT 的开源 Web UI。
### Docker 部署
```bash
docker run -d -p 8080:8080 \
-e OPENAI_API_BASE_URL="https://crazyrouter.com/v1" \
-e OPENAI_API_KEY="sk-your-crazyrouter-key" \
ghcr.io/open-webui/open-webui:main
```
### 网页端设置
1. 登录 Open WebUI → 管理面板 → 设置 → 连接
2. 添加 OpenAI API 连接:
- **URL**: `https://crazyrouter.com/v1`
- **Key**: `sk-your-crazyrouter-key`
3. 保存后自动拉取模型列表
---
## BotGem (原 AMA)
[BotGem](https://botgem.com/) 支持 macOS、iOS、Android、Windows。
### 配置步骤
1. 打开 BotGem → 设置 → 服务商
2. 选择 **OpenAI Compatible**
3. 填写:
- **Endpoint**: `https://crazyrouter.com/v1`
- **API Key**: `sk-your-crazyrouter-key`
- **Model**: `gpt-4o`
4. 保存
---
## Chatwise
[Chatwise](https://chatwise.app/) 是一款简洁的 macOS/iOS AI 客户端。
### 配置步骤
1. 设置 → 模型 → 添加自定义模型
2. 选择 **OpenAI Compatible**
3. 填写 API URL 和 Key
4. 手动输入模型名称
---
## LibreChat
[LibreChat](https://github.com/danny-avila/LibreChat) 是一款功能强大的开源 AI 聊天平台。
### Docker 部署
`.env` 文件中配置:
```env
OPENAI_API_KEY=sk-your-crazyrouter-key
OPENAI_REVERSE_PROXY=https://crazyrouter.com/v1/chat/completions
```
`librechat.yaml` 中添加自定义端点:
```yaml
endpoints:
custom:
- name: "Crazyrouter"
apiKey: "${CRAZYROUTER_API_KEY}"
baseURL: "https://crazyrouter.com/v1"
models:
default: ["gpt-4o", "gpt-4o-mini", "claude-sonnet-4-20250514", "deepseek-chat", "gemini-2.0-flash"]
titleConvo: true
titleModel: "gpt-4o-mini"
```
---
## Coze / 扣子
[Coze](https://www.coze.com/) 支持自定义模型接入。
### 配置步骤
1. 在 Coze 工作台 → 插件 → 自定义模型
2. 选择 OpenAI 兼容格式
3. 填写 Crazyrouter 的 API 地址和 Key
4. 选择模型
---
## Dify
[Dify](https://dify.ai/) 是一款开源的 LLM 应用开发平台。
### 配置步骤
1. 设置 → 模型供应商 → 添加 **OpenAI-API-compatible**
2. 填写:
- **模型名称**: `gpt-4o`(或其他模型)
- **API Key**: `sk-your-crazyrouter-key`
- **API endpoint URL**: `https://crazyrouter.com/v1`
3. 保存并测试
可以添加多个模型,在不同的应用中使用不同的模型。
---
## 通用技巧
### 环境变量方式
很多客户端支持环境变量,统一设置后所有客户端自动生效:
```bash
export OPENAI_API_KEY="sk-your-crazyrouter-key"
export OPENAI_API_BASE="https://crazyrouter.com/v1"
```
### 模型推荐
| 场景 | 推荐模型 | 原因 |
|------|----------|------|
| 日常对话 | `gpt-4o-mini` | 快速、便宜 |
| 深度分析 | `gpt-4o` / `claude-sonnet-4-20250514` | 最强推理 |
| 编程辅助 | `deepseek-chat` / `claude-sonnet-4-20250514` | 代码能力强 |
| 长文档 | `gemini-2.0-flash` | 100万 token 上下文 |
| 数学推理 | `deepseek-reasoner` / `o3-mini` | 链式推理 |
| 省钱 | `deepseek-chat` | $0.14/百万 token |
---
## 链接
- 🌐 [Crazyrouter](https://crazyrouter.com/?utm_source=huggingface&utm_medium=tutorial&utm_campaign=dev_community) — 获取 API Key
- 🤖 [在线 Demo](https://huggingface.co/spaces/xujfcn/Crazyrouter-Demo)
- 💰 [价格对比](https://huggingface.co/spaces/xujfcn/Crazyrouter-Pricing)
- 📖 [快速入门](https://huggingface.co/xujfcn/Crazyrouter-Getting-Started)
- 💬 [Telegram 社区](https://t.me/crazyrouter)
- 🐦 [Twitter @metaviiii](https://twitter.com/metaviiii)