Интеграции

Что здесь меняется

Интеграция — это две строки в настройках инструмента: адрес шлюза и ключ. Тот же клиент, та же библиотека, те же запросы, те же названия параметров.

Потолок вывода этого тоже не меняет: в Chat Completions max_tokens или max_completion_tokens необязателен, и запрос без обоих обслуживается по опубликованному умолчанию в 32768 выходных токенов. Клиенту, который никогда его не слал, не нужно начинать. Как это выглядит в запросе.

Ключ выпускается в консоли и живёт в переменной окружения — обычно KUMO_API_KEY. Инструмент читает её сам или вы вставляете значение в его форму настроек.

1. 1Возьмите ключЭкран ключей в консоли; секрет показывается один раз.
2. 2Найдите настройку провайдераУ каждого инструмента это файл конфигурации или экран настроек.
3. 3Подставьте адрес и ключОстальное в конфигурации не трогайте.
4. 4Сделайте один проверочный вызовИ посмотрите его в журнале консоли.

Проверочный вызов списывает деньги, как и любой другой: пустой кошелёк ответит 402 — сначала пополните его.

Два диалекта

Шлюз говорит на двух протоколах сразу, и от протокола зависит только одно — какой 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 остаётся, сверьте имя модели с каталогом.

Как пишется заголовок с ключом → Как называется модель →

Все рецепты

Ниже — по одному рецепту на инструмент: файл настроек или экран настроек, с кнопкой копирования. Они взяты из того же источника, что и полный гайд подключения, где есть ещё шаги установки, запуска, выбора модели и мышления. Модель в них подставляется из пикера, а везде, где нужен ключ, стоит <KUMO_TOKEN>. К каждому рецепту приложен промпт, которым настройку сделает ваш кодовый агент.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kumorouter.com",
    "ANTHROPIC_AUTH_TOKEN": "<KUMO_TOKEN>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<model>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<model>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<model>"
  },
  "model": "<model>"
}

Set up Claude Code on this machine to use Kumo, an AI gateway that speaks the Anthropic Messages API.
Default model: <model>.
Never print the API key back in your replies or logs. Ask before overwriting any existing file.

1. Install
Install Claude Code with the official installer. Check it with claude --version.
On macOS/Linux run:
```
curl -fsSL https://claude.ai/install.sh | bash
```
On Windows run:
```
irm https://claude.ai/install.ps1 | iex
```

2. Connect to Kumo
Save this file as your user settings. If it already exists, merge the env block and the model line into it. Claude Code sends the key as a bearer token to the Kumo address.
Write the file `~/.claude/settings.json` (macOS/Linux) or `%USERPROFILE%\.claude\settings.json` (Windows). If it already exists, back it up and merge these settings into it instead of replacing unrelated ones:
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kumorouter.com",
    "ANTHROPIC_AUTH_TOKEN": "<KUMO_TOKEN>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<model>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<model>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<model>"
  },
  "model": "<model>"
}
```

3. Launch
Start Claude Code in your project folder; /status shows the address in use. If a model answers 400 about beta fields, add CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 to the env block.
Run:
```
claude
```

4. Models
Switch models with /model in a session, or start with claude --model. These models answer over the Anthropic protocol:
Run:
```
claude --model <model>
```
Models available through Kumo: <model>.

5. Thinking (optional)
Thinking is on by default. Set the effort with /effort, toggle thinking with Alt+T, or keep the choice in settings.json with alwaysThinkingEnabled and effortLevel.
Kumo accepts this setting but does not pass it to the model yet: the model reasons with its own default budget.
Run:
```
/effort high
```

Official docs: https://code.claude.com/docs/en/setup , https://code.claude.com/docs/en/llm-gateway-connect , https://code.claude.com/docs/en/llm-gateway-protocol , https://code.claude.com/docs/en/model-config , https://code.claude.com/docs/en/env-vars , https://code.claude.com/docs/en/settings

Пошаговые гайды

Промпт для агента

Настройку можно не делать руками. У вас на машине уже стоит кодовый агент — отдайте ему реквизиты подключения, и он сам найдёт файл конфигурации, сделает копию, покажет диф и проверит результат.

Промпты платформы написаны по-английски намеренно: агент точнее следует инструкции на языке, на котором написана большая часть его обучающих примеров. Читателю их читать не нужно — их копируют и вставляют.

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.

Начать с Claude Code → Проверить ключ →