集成

Claude Code

用 Lovely Router API 密钥使用 Claude Code：设置 base URL 和密钥，选择 Claude 模型，提示缓存照常生效。

Claude Code 是在终端里运行的编程智能体。它使用 Anthropic Messages API，Lovely Router 原生提供该 API，因此你只需改两项设置：base URL 和密钥，其余一切照旧。开始前，你需要先有一个 API 密钥。

一键配置#

在 API 密钥页面，依次点击 接入客户端 → Claude Code。对话框会显示下面的配置，并已填入你的密钥；用 CC Switch 一键导入 会把 Lovely Router 作为供应商添加到 CC Switch 桌面应用中，模型已预先设好。需已安装 CC Switch。

刚创建密钥时，对话框中已经包含该密钥。对于已有的密钥，请把完整密钥粘贴到对话框中：Lovely Router 只保存哈希，无法再次显示密钥。

设置 base URL 和密钥#

设置 base URL 和密钥，然后照常启动 Claude Code：

Shell

export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude

如需让设置在多个会话间保留，改为写入 ~/.claude/settings.json，并填入完整密钥：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://lovelyrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "lr-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

选择模型#

ANTHROPIC_MODEL 是主模型，ANTHROPIC_DEFAULT_HAIKU_MODEL 负责快速的后台任务。GET /v1/models 中的任意 Claude 模型 ID 都可以使用，例如 claude-opus-5.5。模型列表中有全部 ID。

提示缓存#

Claude Code 的提示缓存通过 Lovely Router 照常生效：每个会话都固定在持有其缓存的渠道上。请参阅提示缓存。

通过 MCP 添加数据工具#

位于 https://lovelyrouter.com/mcp 的 MCP 服务器可以为 Claude Code 提供数据工具和浏览器智能体，费用从同一余额中扣除。它使用同一个密钥进行身份验证：

Shell

claude mcp add --transport http lovely https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

这只会把它添加到当前项目。加上 --scope user 即可在所有项目中使用。运行 claude mcp list 检查是否已连接。如需通过 .mcp.json 与团队共享该服务器，或查看完整的工具列表，请参阅 MCP 服务器。

故障排查#

现象	解决方法
`401`，消息为 `Missing API key`	Claude Code 没有发送密钥。检查 `ANTHROPIC_AUTH_TOKEN` 是否已在启动 `claude` 的 Shell 中 export，或已写入 `~/.claude/settings.json`。
`401`，消息为 `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或创建一个新密钥。
`404`，消息为 `Model '...' is not available`	该模型 ID 不存在。从 `GET /v1/models` 或模型列表中复制 Claude 模型 ID。
路径包含 `/v1/v1/` 时返回 `404`	`ANTHROPIC_BASE_URL` 以 `/v1` 结尾，而 Claude Code 会自行追加 `/v1`。请将其设为 `https://lovelyrouter.com`。
`402`	余额已用完，或密钥已达到消费上限。请参阅额度与计费。

其他所有状态码请参阅错误。