Интеграции
Направьте инструмент, который у вас уже стоит, на шлюз: base URL и ключ. Живые рецепты платформы, пошаговые гайды и промпт, которым настройку делает ваш агент.
Что здесь меняется
Интеграция — это две строки в настройках инструмента: адрес шлюза и ключ. Тот же клиент, та же библиотека, те же запросы, те же названия параметров.
Одно отличие всё же есть, и оно единственное: в Chat Completions потолок вывода на Kumo обязателен — max_tokens или max_completion_tokens. Клиент, который никогда его не слал, должен начать его слать, иначе запрос будет отвергнут при проверке. Как это выглядит в запросе.
Ключ выпускается в консоли и живёт в переменной окружения — обычно KUMO_API_KEY. Инструмент читает её сам или вы вставляете значение в его форму настроек.
- Возьмите ключЭкран ключей в консоли; секрет показывается один раз.
- Найдите настройку провайдераУ каждого инструмента это файл конфигурации или экран настроек.
- Подставьте адрес и ключОстальное в конфигурации не трогайте.
- Сделайте один проверочный вызовИ посмотрите его в журнале консоли.
Проверочный вызов списывает деньги, как и любой другой: пустой кошелёк ответит 402 — сначала пополните его.
На страницах, чьи примеры называют модель, над ними есть пикер модели. Выберите модель — и её идентификатор подставится во все примеры этой страницы, включая копирование. Любой такой гайд принимает выбор прямо в адресе: передайте каноническое имя модели параметром model в адресе страницы (?model), и страница откроется уже с ней.
Два диалекта
Шлюз говорит на двух протоколах сразу, и от протокола зависит только одно — какой base URL вы впишете.
- OpenAI-совместимый — base URL
https://api.kumorouter.com/v1, он заканчивается на/v1. Клиент дописывает к нему/chat/completions,/responses,/embeddings. - Anthropic-совместимый — base URL
https://api.kumorouter.com, голый origin, без/v1. Клиенты этого протокола дописывают/v1/messagesсами, и адрес, в котором/v1уже есть, даст у них путь с удвоеннымv1— и 404.
Это типичная причина 404 у рабочего ключа, но не единственная: тем же кодом отвечает и неизвестный идентификатор модели. Если сомневаетесь, какой диалект у инструмента, — смотрите, какой SDK он тянет; если адрес и диалект верны, а 404 остаётся, сверьте имя модели с каталогом.
| Инструмент | Диалект | Base URL |
|---|---|---|
| Claude Code | Anthropic | https://api.kumorouter.com |
| Codex CLI | OpenAI | https://api.kumorouter.com/v1 |
| Cursor | OpenAI | https://api.kumorouter.com/v1 |
| Cline Roo Code Continue | OpenAI | https://api.kumorouter.com/v1 |
| Aider Zed OpenClaw | OpenAI | https://api.kumorouter.com/v1 |
| Ваш код через SDK | оба | по выбранному SDK |
Как пишется заголовок с ключом → Как называется модель →
Все рецепты
Ниже — рецепты, которые публикует сама платформа: по одному на инструмент, с готовой конфигурацией и кнопкой копирования. Модель в них подставляется из пикера. У инструментов, которые настраиваются не файлом, а экраном, вместо конфигурации лежит промпт для вашего кодового агента.
Готовые настройки для инструментов, которые уже включены на этой площадке. Адрес шлюза подставлен платформой, модель — та, что выбрана в шапке статьи.
Пошаговые гайды
Промпт для агента
Настройку можно не делать руками. У вас на машине уже стоит кодовый агент — отдайте ему реквизиты подключения, и он сам найдёт файл конфигурации, сделает копию, покажет диф и проверит результат.
Промпты платформы написаны по-английски намеренно: агент точнее следует инструкции на языке, на котором написана большая часть его обучающих примеров. Читателю их читать не нужно — их копируют и вставляют.
Общий промпт для любого инструмента. Замените `<TOOL>` на имя инструмента и передайте текст агенту.
Goal: connect <TOOL> on this computer to Kumo — a gateway compatible with the OpenAI and
Anthropic APIs — by changing only the provider configuration: the endpoint and the API key.
Nothing about how I use the tool should change.
Connection details:
- OpenAI-compatible base URL: https://api.kumorouter.com/v1
- Anthropic-compatible base URL: https://api.kumorouter.com
^ the bare origin, no /v1: Anthropic-style clients append /v1/messages themselves.
- Auth header: Authorization: Bearer <KUMO_API_KEY>
^ my key, read from the KUMO_API_KEY environment variable.
- Model ID to configure: <model>
Rules:
- You are running on my computer: read the real files before editing them, and never guess a
path you have not verified exists.
- Back up every config file you touch and show me a diff BEFORE writing.
- Add Kumo alongside what I already have — do not delete other providers, profiles or keys.
- Never print my key in full into the chat, a log, or a file that is committed to git.
- If the installed version documents different key names, follow the INSTALLED version and
tell me what was different.
- If the tool cannot be pointed at a custom endpoint, say so plainly and stop. Do not invent
a setting.
Steps:
1. Confirm the tool is installed here and report its version.
2. Work out which dialect it speaks — OpenAI or Anthropic — and take the matching base URL.
3. Find where its model provider is configured, show me what is there now, and back it up.
4. Set the base URL, the key from the environment variable, and the model ID.
5. Verify: make one test call, then make the tool itself answer one prompt.
Done when: the tool answers a test prompt through Kumo, and the request appears in the Kumo
console on the Logs page.
Reply: list every file you changed, what you set in it, and paste the test output.