常见问题
这里整理的是接入过程中最常见的问题。排查时建议先确认三件事：Base URL 是否正确、API Key 是否有效、模型名称是否和控制台一致。
Base URL 应该填什么？
OpenAI 兼容客户端通常填写：
https://app.lofeerouter.com/v1
Claude Code 等 Anthropic 协议工具，请填写控制台展示的 Claude/Anthropic 接入地址。
不要把完整接口路径填进 Base URL。例如 OpenAI 兼容客户端一般不要填写 /chat/completions、/responses 这类路径，客户端会自己拼接。
API Key 可以给多个工具共用吗？
可以，但不推荐。为不同工具创建不同 API Key，更方便统计消耗和处理泄露风险。
推荐按工具创建，例如：
| 工具 | 建议 Key 名称 |
|---|---|
| Claude Code | claude-code-mac |
| Codex | codex-work |
| Cursor | cursor-desktop |
| Cherry Studio | cherry-studio-home |
API Key 创建后还能再次查看完整内容吗？
通常不建议依赖二次查看。创建成功后请立即复制保存。如果忘记保存，最安全的处理方式是删除旧 Key，然后重新创建一个新的 Key。
为什么模型名称填写后不可用？
请确认模型名称与控制台展示完全一致。模型名称通常区分大小写，也不要添加多余空格。
如果客户端支持手动添加模型，请直接复制控制台中的完整模型名称。带日期、后缀或横线的模型名不要简写。
为什么客户端提示 401？
通常是 API Key 无效、复制不完整、前后多了空格，或该 Key 已被删除。建议重新复制或创建新 Key。
如果你刚刚禁用、删除或重新创建过 Key，请确认客户端里已经更新到新的 Key。有些桌面客户端会缓存旧配置，保存后需要重启应用。
如果你使用 Codex，且是在升级 Codex 到 0.149.0 及以上版本后才出现 401 或 API_KEY_REQUIRED，Key 本身通常没有问题：新版不再允许自定义 Provider 在未开启 requires_openai_auth 时自动继承 auth.json 里的鉴权。按 导入到 Codex 的 env_key 方式配置即不受影响；如果旧配置依赖 auth.json，请在 Provider 配置中加上 requires_openai_auth = true 后重启 Codex。通过 CC Switch 或 Codex++ 写入的配置默认已带该字段，不受影响。
为什么客户端提示 404？
常见原因是 Base URL 写错，或把完整接口路径填进了 Base URL。OpenAI 兼容客户端一般只需要填到 /v1。
Claude Code 如果填成 https://app.lofeerouter.com/v1 也可能失败，因为它使用的是 Claude/Anthropic 协议配置。请回到 API 密钥页面点击「使用密钥」，复制 Claude Code 对应配置。
为什么客户端提示模型不支持或接口格式错误？
这通常是协议不匹配。Codex、Cursor、Cherry Studio 多数情况下走 OpenAI 兼容接口；Claude Code 走 Claude/Anthropic 相关环境变量。请确认你没有把 Claude Code 的地址填进 OpenAI 客户端，也没有把 OpenAI 的 /v1 地址填进 Claude Code。
为什么响应很慢？
可能与模型本身、上游线路、并发、网络环境有关。可以换模型测试，也可以查看控制台公告或服务状态页。
建议先用短提示测试，例如只让模型回复一句话。如果短提示正常、长任务慢，通常是模型推理或上下文长度导致；如果短提示也慢，再检查网络、服务状态或当前模型可用性。
如何确认请求真的走到了 LofeeRouter？
配置完成后，发送一条短消息，然后回到 LofeeRouter 控制台查看使用记录。如果使用记录出现了对应时间的请求，说明客户端已经走到 LofeeRouter；如果没有记录，通常是客户端仍在使用旧 Provider、旧环境变量或内置服务。
Key 泄露了怎么办？
立即在控制台禁用或删除泄露的 Key，然后重新创建新 Key 并更新客户端配置。如果你不确定泄露范围，建议同时检查最近使用记录，确认是否有异常消耗。