Документация API

Инструменты для кода

Как подключить Kilo Code, OpenCode, Claude Code, Codex и похожие агенты к AIGate.

Скачать инструкцию для агента .md

AIGate можно использовать как своего провайдера в инструментах для кода, если они умеют работать с API в формате OpenAI или Anthropic. Указывайте точный id модели из /v1/models и храните ключ в переменной окружения или в хранилище секретов самого инструмента.

Базовый адресДля инструментов в формате OpenAI используйте https://api.aigate.shop/v1. Для Claude Code укажите ANTHROPIC_BASE_URL как https://api.aigate.shop; Claude Code сам добавляет маршрут Anthropic Messages.

Быстрая проверка

Перед настройкой редактора проверьте, что ключ и выбранная модель работают на минимальном запросе.

curl
curl https://api.aigate.shop/v1/chat/completions \  -H "Authorization: Bearer sk-your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-5.5",    "messages": [{ "role": "user", "content": "Say OK." }],    "stream": false  }'

Kilo Code

В настройках Kilo Code выберите провайдера OpenAI Compatible и заполните эти поля. Если модель не появилась в списке автоматически, введите id модели вручную.

Настройки Kilo Code
Provider: OpenAI CompatibleBase URL: https://api.aigate.shop/v1API key: sk-your-api-keyModel ID: openai/gpt-5.5
  • Используйте точный id модели AIGate, например openai/gpt-5.5.
  • Если Kilo просит полный адрес маршрута, а не базовый адрес, укажите https://api.aigate.shop/v1/chat/completions.
  • При ошибке model not found откройте /v1/models и скопируйте id без изменений.

OpenCode

Запустите /connect, выберите Other, задайте id провайдера aigate и вставьте API-ключ AIGate. Затем создайте или обновите opencode.json в корне проекта.

opencode.json
{  "$schema": "https://opencode.ai/config.json",  "provider": {    "aigate": {      "npm": "@ai-sdk/openai-compatible",      "name": "AIGate",      "options": {        "baseURL": "https://api.aigate.shop/v1",        "apiKey": "{env:AIGATE_API_KEY}"      },      "models": {        "openai/gpt-5.5": {          "name": "GPT 5.5"        },        "anthropic/claude-sonnet-4.6": {          "name": "Claude Sonnet 4.6"        }      }    }  }}
  • Задайте AIGATE_API_KEY в том же терминале, из которого запускается OpenCode.
  • После сохранения файла выполните /models и выберите модель AIGate.
  • Для /v1/chat/completions используйте @ai-sdk/openai-compatible. Если будущая настройка требует только /v1/responses, поменяйте пакет провайдера на @ai-sdk/openai.

Claude Code

Claude Code работает через формат Anthropic Messages. Направьте его на AIGate через ANTHROPIC_BASE_URL и укажите id модели Anthropic, доступной в вашем каталоге.

macOS / Linux
export ANTHROPIC_BASE_URL=https://api.aigate.shopexport ANTHROPIC_API_KEY=sk-your-api-keyexport ANTHROPIC_MODEL=anthropic/claude-sonnet-4.6export ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic/claude-sonnet-4.6export ANTHROPIC_DEFAULT_OPUS_MODEL=anthropic/claude-opus-4.7export ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-4.5claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.aigate.shop"$env:ANTHROPIC_API_KEY="sk-your-api-key"$env:ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"$env:ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"$env:ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.7"$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"claude
  • AIGate принимает x-api-key и bearer-авторизацию на /v1/messages.
  • Если Claude Code выбирает не ту встроенную модель, закрепите ANTHROPIC_MODEL и переменные по умолчанию для Sonnet, Opus и Haiku.
  • Чтобы модели шлюза появились в выборе модели Claude Code, используйте свежую версию Claude Code и при необходимости включите поиск моделей шлюза.

Codex

Codex читает своих провайдеров из ~/.codex/config.toml на macOS/Linux или из %USERPROFILE%\.codex\config.toml на Windows. Для AIGate используйте Responses API.

config.toml
model_provider = "aigate"model = "openai/gpt-5.5"[model_providers.aigate]name = "AIGate"base_url = "https://api.aigate.shop/v1"env_key = "AIGATE_API_KEY"wire_api = "responses"
Переменная окружения
# macOS / Linuxexport AIGATE_API_KEY=sk-your-api-key# Windows PowerShell$env:AIGATE_API_KEY="sk-your-api-key"
  • Перезапустите Codex после изменения config.toml или переменных окружения.
  • Если конкретная версия Codex не может вызвать модель через Responses, выберите модель с поддержкой /v1/responses или используйте другой клиент через /v1/chat/completions.
  • Не кладите реальный ключ прямо в config.toml; используйте env_key.

Общее правило

Для любого другого помощника по коду выбирайте тип провайдера по маршруту: клиенты в формате OpenAI используют /v1/chat/completions или /v1/responses с Authorization: Bearer, а клиенты в формате Anthropic используют /v1/messages с x-api-key или bearer-авторизацией.