你希望 Claude Code、Codex CLI 或 Gemini CLI 按用量计费，每位开发者一个密钥，而且不用订阅。只需改两项设置：base URL 和密钥，其余一切照旧。费用按 token 从预付费余额中扣除；每个会话都固定在持有其缓存的渠道上，所以提示缓存照常生效；同一个密钥还能通过 MCP 让智能体使用网页搜索、数据工具和浏览器。
配置你的编程智能体
Claude Code#
导出这些设置后启动，或者写入 ~/.claude/settings.json，让设置在多个会话间保留：
export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claudeANTHROPIC_MODEL 是主模型，ANTHROPIC_DEFAULT_HAIKU_MODEL 负责快速的后台任务；任何 Claude 模型 ID 都可以使用，例如 claude-opus-5.5。参阅 Claude Code 指南和 Claude API 页面。
Codex CLI#
Codex CLI 使用 OpenAI Responses API。把 Lovely Router 添加为模型供应商，然后导出 env_key 中指定的密钥：
model = "gpt-6.1-sol"
model_provider = "lovely"
[model_providers.lovely]
name = "Lovely Router"
base_url = "https://lovelyrouter.com/v1"
env_key = "LOVELY_API_KEY"
wire_api = "responses"export LOVELY_API_KEY="lr-..."
codex请使用 GPT 模型（gpt-*）：Responses API 提供的正是这些模型。当前版本的 Codex 已不再接受 wire_api = "chat"。参阅 Codex CLI 指南和 GPT 模型。
Gemini CLI#
export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro为什么对话固定决定了你的账单
编程智能体每一轮都会重新发送整个对话：系统提示词、工具定义，以及它到目前为止读过的每一个文件。有了提示缓存，这些输入 token 中的大部分都按缓存读取价格计费，只有普通输入价格的一小部分。但缓存存在于写入它的渠道上。如果某一轮落到了另一个渠道，那里没有这份缓存，整个前缀就要重新付费。
网关会让每个对话始终留在服务其第一轮的渠道上：
会为每个会话发送 x-claude-code-session-id 请求头，Codex 则发送 prompt_cache_key；网关据此识别同一对话的各轮请求。
，会话活跃期间会不断续期。30 到 60 分钟内没有请求，固定就会过期。
这一轮会短暂等待它固定的渠道（短提示词约一秒，长提示词最多十秒），而不是换到别的渠道、再为新的缓存写入付费。
日志中的每次调用都会显示缓存 token 数、缓存命中率和亲和状态（sticky、new 或 explicit）。详情参阅提示缓存。
每位开发者一个密钥，各有各的限制
所有密钥共用一个余额，但每个密钥都有自己的限制，密钥列表会显示每个密钥已经花了多少。
| 限制 | 作用 |
|---|---|
| 消费上限 | 该密钥累计最多可消费的金额，涵盖模型、数据工具和浏览器智能体。这是终身上限，不是每月预算。 |
| 每分钟请求数、最大并发请求数 | 给失控的循环降速，或防止某个人挤占其他人的容量。 |
| 模型允许列表 | 该密钥只能调用列表中的模型。 |
| 过期日期 | 过了这一天，密钥即停止工作。 |
达到消费上限的密钥会收到 402 和 This API key has reached its spend limit.；触及速率或并发限制则返回 429，并带有 Retry-After 响应头。被拒绝的请求不计费。参阅 API 密钥。
让编程智能体用上网页、数据工具和浏览器
同一个密钥还能连接 MCP 服务器，让智能体搜索网页、把文档页面读取为 Markdown、从 Google Maps、LinkedIn 或 Reddit 获取结构化数据，并操作浏览器完成多步骤流程：
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
--header "Authorization: Bearer $LOVELY_API_KEY"搜索网页：最多 50 条结果，包含标题、URL、日期、站点、简短摘要和供模型阅读的长摘要（需要时可附带网页正文）。支持运算符：site:、-site:、"精确短语"、-词、lang:、after:、before:。
把任意公开网页读取为干净的 Markdown：标题和正文，不含导航和广告。适用于已知 URL 的单个页面。
爬取整个网站（或其中一部分），把每个页面转成干净、可直接给 LLM 使用的 Markdown。适合 RAG 和文档站点。
Give it a goal and a start page; an AI agent drives a real browser to do it: navigate, fill forms, log in with saved secrets, ask you for codes, hand over for CAPTCHAs, wait for your approval before purchases, and return structured JSON in your schema. For tasks that need interaction; to just read a page, use Read a web page (web-fetch). $0.006 per step in fast mode, $0.012 in accurate mode (looks at screenshots when unsure, can run read-only code to read data). Each step includes 1 minute; time beyond that (e.g. waiting for your approval) costs $0.005/min. Full API: /v1/browser.
网页搜索用于查找信息，读取网页读取单个页面，网站爬取则读取整个文档板块。浏览器智能体在云端运行，因此它能处理公开网站，但无法访问 localhost。
好用的配置组合
设置 ANTHROPIC_MODEL=claude-opus-5.5，并让 ANTHROPIC_DEFAULT_HAIKU_MODEL 保持为小模型，用于后台任务。
设置过期日期、消费上限，以及只包含一个模型的允许列表。
给它单独的密钥，设置消费上限和每分钟请求数限制，这样即使循环失控也不会刷出巨额账单。
这样提问：“阅读这个 URL 上的更新日志，并据此更新我们的 SDK 调用。” 一次 web_fetch 就能把页面交给智能体。
费用说明
模型调用按 token 计费：输入、输出、缓存读取和缓存写入，各按模型的每百万 token 价格计算。返回错误的请求不收费。数据工具按结果计费，浏览器智能体按步计费，都从同一个余额中扣除。没有订阅，也没有自动充值：你从 $5 起充值，扣费永远不会超过你充入的金额。参阅价格页和完整的模型列表。
| 模型 | 上下文 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|---|
| Claude Fable 5.1 claude-fable-5.1 | 1M | $10.00 | $50.00 | $0.25 |
| Claude Opus 5.5 claude-opus-5.5 | 1M | $4.00 | $20.00 | $0.20 |
| Claude Sonnet 5.5 claude-sonnet-5.5 | 1M | $2.00 | $10.00 | $0.10 |
| Claude Haiku 5.5 claude-haiku-5.5 | 1M | $0.10 | $0.50 | $0.01 |
| Claude Fable 5 claude-fable-5 | 1M | $10.00 | $50.00 | $1.00 |
| Claude Opus 5 claude-opus-5 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 5 claude-sonnet-5 | 1M | $2.00 | $10.00 | $0.20 |
| Claude Opus 4.8 claude-opus-4.8 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Opus 4.7 claude-opus-4.7 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Opus 4.6 claude-opus-4.6 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 4.6 claude-sonnet-4.6 | 1M | $3.00 | $15.00 | $0.30 |
| Claude Opus 4.5 claude-opus-4.5 | 200K | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 4.5 claude-sonnet-4.5 | 1M | $3.00 | $15.00 | $0.30 |
| Claude Haiku 4.5 claude-haiku-4.5 | 200K | $1.00 | $5.00 | $0.10 |
每 100 万 token 的美元价格，实时来自目录。
| 模型 | 上下文 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|---|
| GPT-6 Astra gpt-6-astra | 1.05M | $10.00 | $50.00 | $1.00 |
| GPT-6.1 Sol gpt-6.1-sol | 1.05M | $2.00 | $10.00 | $0.10 |
| GPT-6 Sol gpt-6-sol | 1.05M | $2.00 | $10.00 | $0.20 |
| GPT-6.1 Terra gpt-6.1-terra | 1.05M | $1.00 | $5.00 | $0.05 |
| GPT-5.6 Sol gpt-5.6-sol | 400K | $2.00 | $10.00 | $0.20 |
| GPT-5.6 Terra gpt-5.6-terra | 400K | $2.00 | $12.00 | $0.20 |
| GPT-5.6 Luna gpt-5.6-luna | 400K | $0.20 | $1.20 | $0.02 |
每 100 万 token 的美元价格，实时来自目录。
常见问题
可以用按量付费的 API 密钥使用 Claude Code 吗？+
可以。把 ANTHROPIC_BASE_URL 设为 https://lovelyrouter.com，把 ANTHROPIC_AUTH_TOKEN 设为你的 Lovely Router 密钥，它就成了 Claude Code 的 API 密钥，Claude Code 会按 token 从你的预付费余额中计费，无需订阅。
Claude Code 和 Codex 能用提示缓存吗？+
可以。cache_control、prompt_cache_key 等请求字段原样透传，网关会根据 Claude Code 发送的会话 ID 或 Codex 发送的 prompt_cache_key，把一个会话的每一轮都留在持有其缓存的渠道上。
Codex CLI 可以使用哪些模型？+
GPT 模型（gpt-*），因为 Codex 使用 OpenAI Responses API，而该 API 提供的是 GPT 模型。在供应商配置中设置 wire_api = "responses"。
如何限制每位开发者的消费？+
给每位开发者一个单独的密钥并设置消费上限，就能为整个团队设置 Claude Code 用量限制；还可以按需设置每分钟请求数限制、模型允许列表和过期日期。密钥达到上限后，请求会以 402 失败，不会再产生任何费用。
也能用 Gemini CLI 吗？+
可以。把 GOOGLE_GEMINI_BASE_URL 设为 https://lovelyrouter.com，把 GEMINI_API_KEY 设为你的密钥，然后用 gemini-3.1-pro 等 Gemini 模型启动它。参阅 Gemini CLI 指南和 Gemini API 页面。
要同时运行大量智能体？参阅高并发 LLM 应用。其他所有客户端和 SDK 的配置都在在你的工具中使用中。