Скилл подключения к API kosareva.cloud для Claude Code и Codex

Агент сам находит в проекте клиент OpenAI или Anthropic, меняет адрес и ключ, подбирает модель и проверяет подключение бесплатным запросом — платные только с вашего «да».

Скачать скилл Как установить

Коротко: скилл знает про наш API то, на чём чаще всего ошибаются: адрес с /v1 для OpenAI SDK и без него для Anthropic SDK, имена моделей через дефисы, ключ только из KOSAREVA_API_KEY. Агент правит клиент в вашем коде, а не переписывает проект, и проверяет подключение запросами, которые не тратят деньги. Скилл бесплатный, запуск на Claude Sonnet 5.5 — ≈ 41 ₽.

/ Что делает

Что знает скилл

Всё из документации API, собранное так, чтобы агенту не приходилось угадывать.

Правильный адрес

https://api.kosareva.cloud/v1 для OpenAI SDK, без /v1 для Anthropic SDK и Claude Code — главная причина ошибки 404.

Ключ без утечек

Только из переменной KOSAREVA_API_KEY: строка в .env.example, проверка .gitignore, ключ не печатается в вывод.

Модель под задачу

Справочник рекомендуемых моделей с ценами из каталога: код, длинные документы, дешёвый поток, данные в России.

Все эндпоинты

Чат, Responses, Messages, эмбеддинги, картинки, озвучка, распознавание речи, видео и API кабинета — с примерами.

Проверка без трат

Скрипт check_connection.py делает только бесплатные запросы: список моделей и баланс.

Агенты на нашем ключе

Настройки Claude Code и Codex CLI, разбор ошибок 401, 402, 404, 429 и 504 по-русски.

/ Для кого

Кому пригодится

Разработчику

Перевести проект с OpenAI или Anthropic на оплату в рублях, не переписывая код.

Команде

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

Тем, кто пишет код с агентом

Не объяснять каждый раз Claude Code или Codex, какой base_url и какие имена моделей у kosareva.cloud.

/ Пример

Как попросить и что получите

Агент меняет три вещи — ключ, адрес и модель — и проверяет подключение. Ниже — пример правки и вывод проверки.

Подключи этот проект к kosareva.cloud. Ключ — в переменной KOSAREVA_API_KEY, модель для чата — claude-sonnet-5-5, для эмбеддингов — gemini-embedding-2. Платные запросы — только с моего подтверждения.

 import os
 from openai import OpenAI

-client = OpenAI(api_key="sk-...")
+client = OpenAI(
+    api_key=os.environ["KOSAREVA_API_KEY"],
+    base_url="https://api.kosareva.cloud/v1",
+)

 resp = client.chat.completions.create(
-    model="gpt-4o",
+    model="claude-sonnet-5-5",
     messages=messages,
 )

$ python3 scripts/check_connection.py --model claude-sonnet-5.5
✓ Ключ найден в KOSAREVA_API_KEY (сам ключ не показываю)
✓ API отвечает: этому ключу доступно 165 моделей
✓ Модель есть в списке как claude-sonnet-5-5: вариант с точкой
  шлюз поймёт, но в коде лучше писать claude-sonnet-5-5
✓ Остаток на балансе: 3 756,49 ₽

/ Что внутри

Файлы скилла

Обычные текстовые файлы и скрипты на Python без сторонних зависимостей — перед установкой их можно прочитать целиком.

/ Архив, 13 КБ

kosareva-api.zip

Папка kosareva-api — распакуйте её в папку скиллов агента.

SKILL.md — Пять правил, порядок работы, готовые правки для OpenAI и Anthropic SDK, Claude Code и Codex, разбор ошибок
references/endpoints.md — Все эндпоинты с примерами: чат, Responses, эмбеддинги, картинки, озвучка, распознавание речи, видео, API кабинета
references/models.md — Рекомендуемые модели с ценами из каталога и как выбирать
scripts/check_connection.py — Бесплатная проверка: ключ, адрес, модель, баланс

Скачать архив

/ Отдельно

SKILL.md

Инструкция для агента — обычный Markdown. По ней видно, что и как агент будет делать с вашими файлами.

В начале — name и description: по ним агент решает, когда включать скилл
Справочники из references/ агент открывает, только когда они нужны
Скрипт проверки обращается только к kosareva.cloud и только бесплатными запросами
Ключ берётся из переменной окружения и не печатается
Это обычный текст — поправьте под свои шаблоны и правила

Скачать SKILL.md

/ Установка

Поставить за минуту

Архив — это папка скилла. Её нужно положить туда, где агент ищет скиллы, и перезапустить агента, если он уже открыт.

/1
Скачайте архив
kosareva-api.zip — внутри папка kosareva-api со SKILL.md и остальными файлами.
/2
Распакуйте в папку скиллов
Claude Code — ~/.claude/skills/, Codex — ~/.agents/skills/, Cursor — ~/.cursor/skills/. Для одного проекта — те же папки внутри проекта.
/3
Подключите агента к ключу
Чтобы платить за токены в рублях, Claude Code и Codex подключаются к kosareva.cloud переменными окружения — инструкция.

Получить API-ключ

Пути проверены по документации Claude Code, Codex и Cursor 9 октября 2026.

# macOS / Linux
S=kosareva-api
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.claude/skills
unzip -o $S.zip -d ~/.claude/skills/

# Windows (PowerShell)
$S = "kosareva-api"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.claude\skills" -Force

# Запуск: в Claude Code наберите /kosareva-api
# или просто опишите задачу — агент подхватит скилл сам

# macOS / Linux
S=kosareva-api
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.agents/skills
unzip -o $S.zip -d ~/.agents/skills/

# Windows (PowerShell)
$S = "kosareva-api"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.agents\skills" -Force

# Запуск: в Codex наберите $kosareva-api или откройте список /skills

# macOS / Linux
S=kosareva-api
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.cursor/skills
unzip -o $S.zip -d ~/.cursor/skills/

# Windows (PowerShell)
$S = "kosareva-api"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.cursor\skills" -Force

# Cursor читает и ~/.claude/skills — второй копии не нужно
# Запуск: в чате агента наберите /kosareva-api

/ Сколько стоит запуск

Скилл бесплатный — платите за токены агента

Считаем один запуск: проект на Python или Node.js: агент читает скилл и 3–5 файлов проекта, правит клиент API и .env.example, запускает бесплатную проверку — 15 обращений к модели, контекст растёт с 30 до 65 тыс. токенов, ответ ~600 токенов за обращение. Цены — из каталога kosareva.cloud за 1 млн токенов, в рублях.

Модель	Вход / выход за 1 млн	С кэшем	Без кэша
Claude Sonnet 5.5 — Claude Code	216 / 1 080 ₽	≈ 41 ₽	≈ 164 ₽
GPT-5.6 — Codex	432 / 2 160 ₽	≈ 75 ₽	≈ 327 ₽

За запуск уходит ≈ 713 тыс. токенов на вход, из них ≈ 648 тыс. — повтор уже прочитанного, и ≈ 9 тыс. на выход. Claude Code и Codex кэшируют повторяющийся контекст сами: он идёт по цене чтения из кэша (у Claude Sonnet 5.5 — 21,6 ₽ за 1 млн), поэтому реальная цена ближе к колонке «С кэшем». Точная сумма — в расходах по ключу в кабинете. В Cursor скилл работает на моделях вашей подписки Cursor — этот расход мы не считаем.

/ Как пользоваться

Как подключить проект

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

Получите ключ

В кабинете, раздел «API-ключи». Под каждый проект удобно завести свой ключ с лимитом в рублях — расход виден по каждому.

Получить ключ

Положите ключ в окружение

Не в код и не в конфиг под git. Агент допишет пустую строку в .env.example и проверит .gitignore.

export KOSAREVA_API_KEY="ваш-ключ"
# Windows: $env:KOSAREVA_API_KEY = "ваш-ключ"

Попросите агента

Назовите задачу и модель, если она уже выбрана. Агент найдёт, где создаётся клиент, и поправит только его.

/kosareva-api подключи проект, модель claude-sonnet-5-5

Проверьте бесплатно

Скрипт запрашивает список моделей и баланс — эти запросы не списывают деньги.

python3 scripts/check_connection.py --model claude-sonnet-5-5

Один живой запрос

Агент спросит разрешения и назовёт цену: короткий запрос с max_tokens 50 на большинстве текстовых моделей стоит копейки.

/ Честно

Чего скилл не делает

Подключаете что-то необычное — свой фреймворк, очередь, n8n?

Написать в Telegram

Создание ключа и пополнение

Только в кабинете — так безопаснее, если ключ утечёт.

Перевод самого Cursor на наш ключ

Облако Cursor закрыто для России, свой ключ возвращает только чат. Замена — расширение для VS Code.

Гарантия параметров модели

Поддержку tools, JSON-режима и картинок на входе смотрите на карточке модели в каталоге.

Платные проверки без спроса

Каждый запрос к модели списывает деньги, поэтому перед первым живым запросом агент спросит разрешения.

/ FAQ

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

Чем скилл лучше инструкции из документации?

Инструкцию читаете вы, скилл — агент. Он сам находит, где в проекте создаётся клиент, и правит только его; правила про /v1, имена моделей и ключ в окружении не нужно повторять в каждом запросе.

Работает ли с LangChain и Vercel AI SDK?

Да, примеры есть в справочнике скилла. Для AI SDK — OpenAI-совместимый провайдер: он ходит в /v1/chat/completions, где доступны все модели.

Можно ли подключить видео и распознавание речи?

Да: POST /v1/videos ставит задачу на ролик, /v1/audio/transcriptions расшифровывает аудио моделью gemini-3-5-transcribe. Каждый ролик стоит денег, поэтому генерацию агент запускает только с вашего подтверждения.

Нужен ли VPN?

Нет. API kosareva.cloud отвечает из России напрямую, оплата — в рублях.

/ Дальше

Дальше

Запускайте скиллы на ключе kosareva.cloud

Claude Code и Codex подключаются к нашему API за пару минут. Оплата в рублях — картой РФ или СБП от 50 ₽, юрлицам по счёту.