在你的工具中使用
用一个 API 密钥，把 Claude Code、Codex CLI、Gemini CLI、桌面聊天应用和官方 SDK 指向 Lovely Router。
任何允许修改 API base URL 的工具都能配合 Lovely Router 使用。你只需改两项设置：base URL 和密钥，其余一切照旧。开始前，你需要先有一个 API 密钥。
一键配置#
API 密钥页面的每个密钥上都有一个 接入客户端 按钮，刚创建的密钥旁边则有一个 接入客户端… 按钮。它会打开一个对话框，里面是下列每个客户端的配置（已填入你的密钥），另附一键导入链接：
- Claude Code、Codex CLI、Gemini CLI：用 CC Switch 一键导入 会把 Lovely Router 作为供应商添加到 CC Switch 桌面应用中，模型已预先设好。需已安装 CC Switch。
- Cherry Studio、DeepChat、AionUI：在该应用中打开 会把 Lovely Router 添加为供应商。需已安装该应用。
刚创建密钥时，对话框中已经包含该密钥。对于已有的密钥，请把完整密钥粘贴到对话框中：Lovely Router 只保存哈希，无法再次显示密钥。
配置你的客户端#
每篇指南都包含一个客户端的完整配置：命令和配置文件、该选哪些模型，以及常见错误的解决方法。
Anthropic Messages API。两个环境变量或 settings.json，提示缓存照常生效。
OpenAI Responses API，使用 GPT 模型。在 config.toml 中添加一个模型供应商。
Gemini API。两个环境变量。
桌面聊天应用。兼容 OpenAI 的供应商，支持一键导入。
桌面聊天应用。兼容 OpenAI 的供应商，支持一键导入。
面向模型和智能体的桌面应用。兼容 OpenAI 的供应商，支持一键导入。
任何支持自定义 OpenAI 端点的应用、智能体框架或库。
官方 OpenAI、Anthropic 和 Google Gen AI SDK，含 Python 和 Node.js 示例。
各 API 格式的 base URL#
base URL 取决于客户端使用的 API，而不是模型：
| API 格式 | 客户端 | Base URL |
|---|---|---|
| Anthropic Messages | Claude Code、Anthropic SDK | https://lovelyrouter.com |
| OpenAI Chat Completions 和 Responses | Codex CLI、OpenAI SDK、OpenAI 兼容应用 | https://lovelyrouter.com/v1 |
| Gemini | Gemini CLI、Google Gen AI SDK | https://lovelyrouter.com |
| 兼容 OpenAI 的 "API 地址" | Cherry Studio、DeepChat、AionUI | https://lovelyrouter.com（应用会自行追加 /v1） |
通过 MCP 为智能体提供数据工具#
位于 https://lovelyrouter.com/mcp 的 MCP 服务器可以为任意 MCP 客户端提供数据工具和浏览器智能体，费用从同一余额中扣除。它使用同一个密钥进行身份验证。Claude Code、Codex CLI 和 Gemini CLI 的指南中各有一条添加命令。其他客户端的配置以及完整的 MCP 工具列表，请参阅 MCP 服务器。
故障排查#
| 现象 | 解决方法 |
|---|---|
401，消息为 Missing API key | 工具没有发送密钥。检查变量名，并确认你是在启动该工具的 Shell 中 export 的。 |
401，消息为 Invalid or revoked API key | 密钥输错、被截断或已吊销。重新粘贴，或创建一个新密钥。 |
404，消息为 Model '...' is not available | 该模型 ID 不存在。从 GET /v1/models 或模型列表中复制 ID。 |
404，消息为 Unknown endpoint | 工具调用了 Lovely Router 不提供的 API，例如 embeddings 或 audio。请把它切换到 Chat Completions、Responses API，或 Anthropic、Gemini 格式。 |
路径包含 /v1/v1/ 时返回 404 | 应用会自行追加 /v1。请把 https://lovelyrouter.com 填为地址。 |
402 | 余额已用完，或密钥已达到消费上限。请参阅额度与计费。 |
各客户端的指南列出了该客户端特有的错误。其他所有状态码请参阅错误。