Сценарий использования

Claude Code и Codex CLI на API-ключе с оплатой по факту

Claude Code, Codex CLI и Gemini CLI на одном предоплаченном API-ключе: кеш промпта не остывает, лимит расходов на разработчика, инструменты данных через MCP.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
claude code$ export ANTHROPIC_BASE_URL=https://lovelyrouter.com$ export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY$ claude> Fix the flaky test in billing.test.ts ⏺ Read billing.test.ts · Grep "settle" ⏺ Edit src/billing.ts (+6 −2) cache read 41,280 tokens · write 1,212 ✓ npm test — 214 passed

Вы хотите, чтобы Claude Code, Codex CLI или Gemini CLI оплачивались по факту использования, с отдельным ключом для каждого разработчика и без подписки. Поменяйте две настройки — базовый URL и ключ, — а всё остальное оставьте как есть. Оплата идёт за токены с предоплаченного баланса, кеш промпта продолжает работать, потому что каждая сессия остаётся на канале, где хранится её кеш, а тот же ключ даёт агенту веб-поиск, инструменты данных и браузер через MCP.

01

Как это работает

010203
  1. Создайте ключ для каждого разработчика

    На странице API-ключи создайте по ключу на каждого человека или CI-задачу и задайте лимит расходов. Кнопка Использовать в инструментах у любого ключа открывает готовые настройки для каждого CLI с уже подставленным ключом.

  2. Направьте агента на шлюз

    Задайте базовый URL и ключ в оболочке или в конфигурационном файле агента. Каждый CLI работает с тем API, под который он создан: Anthropic, OpenAI или Gemini.

  3. Пишите код как обычно

    Каждая сессия закреплена за одним каналом, поэтому её кеш промпта не остывает. В Логах видны токены, попадания в кеш и списание по каждому вызову с разбивкой по ключам.

02

Настройка агента для программирования

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
claude

ANTHROPIC_MODEL — основная модель, а ANTHROPIC_DEFAULT_HAIKU_MODEL выполняет быстрые фоновые задачи; подойдёт любой id модели Claude, например claude-opus-5.5. См. руководство по Claude Code и страницу Claude API.

Codex CLI#

Codex CLI использует OpenAI Responses API. Добавьте Lovely Router как провайдера моделей, затем экспортируйте ключ, указанный в env_key:

~/.codex/config.toml
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"
Shell
export LOVELY_API_KEY="lr-..."
codex

Используйте модель GPT (gpt-*): именно они обслуживаются через Responses API. Текущие версии Codex больше не принимают wire_api = "chat". См. руководство по Codex CLI и модели GPT.

Gemini CLI#

Shell
export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro
03

Почему закрепление диалога определяет ваш счёт

Агент для программирования на каждом ходе заново отправляет весь диалог: системный промпт, определения инструментов и каждый файл, который он уже прочитал. С кешем промпта большая часть этих входных токенов оплачивается по цене чтения кеша — это лишь доля обычной цены входа. Но кеш живёт на том канале, который его записал. Если ход попадает на другой канал, кеша там нет, и за весь префикс приходится платить заново.

Шлюз держит каждый диалог на канале, который обслужил его первый ход:

Claude Code

отправляет заголовок x-claude-code-session-id, а Codex — prompt_cache_key для каждой сессии; по ним шлюз узнаёт ходы одного диалога.

Закрепление действует до часа

и продлевается, пока сессия активна. После 30–60 минут без запросов оно истекает.

Загруженный канал не ломает кеш

Ход ненадолго ждёт свой закреплённый канал (около секунды для коротких промптов, до десяти секунд для длинных), вместо того чтобы переехать и заплатить за новую запись в кеш.

У каждого вызова в Логах видны кешированные токены, доля попаданий в кеш и привязка (sticky, new или explicit). Подробности — в разделе Кеш промпта.

04

Ключ на каждого разработчика со своими лимитами

Все ключи расходуют один баланс, но у каждого свои лимиты, а в списке ключей видно, сколько потратил каждый.

ЛимитЧто делает
Лимит расходовМаксимум, который ключ может потратить за всё время — на модели, инструменты данных и браузерного агента. Это пожизненный потолок, а не месячный бюджет.
Запросов в минуту, макс. число параллельных запросовПритормаживают зациклившийся процесс или не дают одному человеку отнять ресурсы у остальных.
Список разрешённых моделейТолько те модели, которые этот ключ может вызывать.
ИстекаетПосле этой даты ключ перестаёт работать.

Ключ, достигший лимита расходов, получает 402 с сообщением This API key has reached its spend limit.; лимит частоты или параллельности возвращает 429 с заголовком Retry-After. Отклонённые запросы не оплачиваются. См. API-ключи.

05

Дайте агенту для программирования интернет, инструменты данных и браузер

Тот же ключ подключает MCP-сервер, так что агент может искать в интернете, читать страницу документации в виде Markdown, получать структурированные данные из Google Maps, LinkedIn или Reddit и проходить в браузере многошаговые сценарии:

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"
Web
Веб-поиск

Поиск в интернете: до 50 результатов с заголовком, URL, датой, сайтом, коротким фрагментом и подробным пересказом для моделей (и текстом страницы по запросу). Операторы: site:, -site:, "exact phrase", -word, lang:, after:, before:.

$0.0009 / searchПодробности →
Web
Чтение веб-страницы

Любая публичная веб-страница в виде чистого Markdown: заголовок и текст без навигации и рекламы. Для одной страницы, URL которой уже известен.

$0.0009 / pageПодробности →
Web
Обход сайта в Markdown

Обходит весь сайт (или его раздел) и возвращает каждую страницу в чистом Markdown, готовом для LLM. Подходит для RAG и сайтов документации.

$0.01 / page + $0.01 / callПодробности →
Any website
Браузерный агент

Задайте цель и стартовую страницу — ИИ-агент выполнит задачу в настоящем браузере: переходы по страницам, заполнение форм, вход с сохранёнными секретами, запрос кодов у вас, передача управления на CAPTCHA, ожидание вашего подтверждения перед покупками и возврат структурированного JSON по вашей схеме. Для задач, где нужно взаимодействие; чтобы просто прочитать страницу, используйте «Чтение веб-страницы» (web-fetch). $0.006 за шаг в быстром режиме, $0.012 в точном (при сомнениях смотрит на скриншоты, может запускать код только для чтения данных). В каждый шаг входит 1 минута; время сверх этого (например, ожидание вашего подтверждения) стоит $0.005/мин. Полный API: /v1/browser.

$0.006 / stepПодробности →

Веб-поиск подходит для быстрых справок, Чтение веб-страницы читает одну страницу, а Обход сайта в Markdown — целый раздел документации. Браузерный агент работает в облаке, поэтому справляется с публичными сайтами, но не с localhost.

06

Удачные конфигурации

Opus для сложной работы, Haiku для остального

Задайте ANTHROPIC_MODEL=claude-opus-5.5 и оставьте ANTHROPIC_DEFAULT_HAIKU_MODEL на небольшой модели для фоновых задач.

Ключ для подрядчика

Дата истечения, лимит расходов и список разрешённых моделей из одной модели.

Агент в CI

Собственный ключ с лимитом расходов и лимитом запросов в минуту, чтобы зациклившийся процесс не набежал на крупный счёт.

Сначала прочитать, потом писать код

Попросите: «Прочитай журнал изменений по этому URL и обнови наши вызовы SDK под него». Один web_fetch — и страница у агента.

07

Сколько это стоит

Вызовы моделей оплачиваются за токены: вход, выход, чтение кеша и запись в кеш, каждое по цене модели за миллион токенов. Запросы, вернувшие ошибку, не оплачиваются. Инструменты данных оплачиваются за результат, а браузерный агент — за шаг, с того же баланса. Нет ни подписки, ни автоматического пополнения: вы пополняете баланс от $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

USD за 1 млн токенов, актуальные данные из каталога.

МодельКонтекстВходВыводЧтение кеша
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

USD за 1 млн токенов, актуальные данные из каталога.

08

Частые вопросы

?
Можно ли использовать Claude Code с API-ключом с оплатой по факту?+

Да. Задайте ANTHROPIC_BASE_URL равным https://lovelyrouter.com, а ANTHROPIC_AUTH_TOKEN — вашему ключу Lovely Router, и Claude Code будет оплачиваться за токены с предоплаченного баланса, без подписки.

Работает ли кеш промпта с Claude Code и Codex?+

Да. Поля запроса вроде cache_control и prompt_cache_key передаются без изменений, а шлюз держит каждый ход сессии на канале, где хранится её кеш, — по id сессии, который отправляет Claude Code, или по prompt_cache_key, который отправляет Codex.

Какие модели может использовать 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, например gemini-3.1-pro. См. руководство по Gemini CLI и страницу Gemini API.

Запускаете много агентов одновременно? См. LLM-приложения с высокой параллельностью. Все остальные клиенты и SDK описаны в разделе Использование с вашими инструментами.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.