База знаний
Платформа: студия, тьютор, агенты, файлы, API

Как подключить Synty к Claude Code, Codex, Cursor и другим редакторам

2 мин чтенияОбновлено 20 сентября 2026

Synty умеет говорить на трёх «диалектах» API — OpenAI Chat, OpenAI Responses и Anthropic Messages, — поэтому редакторы и агенты для разработчиков подключаются заменой адреса и ключа, без переписывания. Одна оплата в рублях, модели разных разработчиков, роутер, который сам подберёт модель.

Что нужно

Ключ API из кабинета (/account → API → Создать ключ, область chat). Тариф платный: бесплатный до API не допускается. Ключ показывается один раз — сохраните.

Claude Code

export ANTHROPIC_BASE_URL=https://api.synty.pro
export ANTHROPIC_API_KEY=sk-synty-…
export ANTHROPIC_MODEL=anthropic/claude-sonnet-5   # необязательно
claude

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

Codex CLI

export OPENAI_BASE_URL=https://api.synty.pro/v1
export OPENAI_API_KEY=sk-synty-…
codex --model openai/gpt-5.6

Или в ~/.codex/config.toml как провайдер с base_url = "https://api.synty.pro/v1" и wire_api = "responses".

Cursor, Cline, Continue, Aider, Open WebUI

В настройках провайдера OpenAI: Base URL = https://api.synty.pro/v1, API Key = sk-synty-…, модель — публичный id из GET /v1/models (список подхватится сам). Function calling работает, поэтому агентные режимы этих редакторов — тоже.

Роутер: пусть модель выберется сама

Укажите модель synty/auto — роутер отнесёт запрос к ярусу (короткий, рабочий, сложный) и отправит подходящей модели. Политика задаётся на ключе: off — только модели из каталога, auto — synty/auto и незнакомые имена решает роутер, cost_effective — то же, но ярусом дешевле. Реальная модель всегда видна в ответе; списание — по ней.

Что ещё есть в API

Собственный формат /v1/chat с инструментами Synty (поиск, чтение страниц, вычисления, курсы, графики, глубокое исследование), генерация изображений, видео, речи и 3D задачами, сотни инструментов витрины, приложения, агенты, файлы, вебхуки, идемпотентность. SDK для Python и TypeScript, MCP-сервер для ИИ-агентов, узел для n8n. Полная документация — на /developers.

Типичные проблемы

  • 401. Ключ в неверном заголовке: для клиентов Anthropic — x-api-key, для остальных — Authorization: Bearer. Принимаются оба.
  • 404 «модель не найдена». Имя не из каталога, а роутер на ключе выключен. Возьмите id из GET /v1/models или включите routing: auto.
  • 402. Не хватает SC на худший случай ответа: клиенты вроде Claude Code просят до 32 000 токенов вывода, и на балансе должна быть сумма под них. Это проверка, а не списание — спишется по факту.