Интеграции с инструментами разработки
Spectra API совместим со всеми популярными AI-инструментами для разработки. Используйте единый API-ключ для работы в терминале, VS Code, JetBrains и автоматизациях.
Базовые параметры подключения
Claude Code
AI-агент Anthropic для терминала
Claude Code — официальный CLI-инструмент от Anthropic для работы с кодом прямо из терминала. Поддерживает редактирование файлов, запуск команд и навигацию по проекту.
Настройка
Claude Code использует Anthropic-совместимый API (не OpenAI). Настройте переменные окружения в профиле вашего терминала:
export ANTHROPIC_BASE_URL="https://api.spectra.ai"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-ключ"
export ANTHROPIC_API_KEY="" # обязательно пустая строкаANTHROPIC_API_KEY должна быть задана как пустая строка. Если её не указать, Claude Code попытается использовать ключ Anthropic напрямую.Альтернативный способ — через файл настроек Claude Code:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.spectra.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-ваш-ключ",
"ANTHROPIC_API_KEY": ""
}
}Выбор моделей
По умолчанию Claude Code сам выбирает модели. Вы можете переопределить их:
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-opus-4.8"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-3-5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-opus-4.8"Проверка подключения
Перезагрузите терминал
Или выполните source ~/.bashrc
Запустите Claude Code
Выполните claude в каталоге вашего проекта
Проверьте статус
Введите команду /status — вы увидите подключение к Spectra API
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4 | anthropic/claude-opus-4 | Сложные задачи, глубокий анализ |
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Основная работа с кодом |
| Claude Haiku 3.5 | anthropic/claude-haiku-3-5 | Быстрые задачи, субагенты |
Cline
Автономный AI-агент для VS Code
Cline — расширение VS Code для автономной работы с кодом. Создаёт и редактирует файлы, запускает команды, работает с браузером. Поддерживает OpenAI-совместимые провайдеры.
Установка и настройка
Установите Cline из VS Code Marketplace
Откройте Extensions (Ctrl+Shift+X) и найдите Cline
Откройте настройки Cline
Нажмите на иконку Cline в боковой панели, затем откройте настройки провайдера
Выберите провайдер
В выпадающем списке выберите OpenAI Compatible
Введите параметры
Base URL: https://api.spectra.ai/v1
API Key: ваш Spectra API-ключ
Model ID: например, anthropic/claude-opus-4.8
https://api.spectra.ai/v1, а не https://api.spectra.ai/v1/Рекомендуемые модели
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4 | anthropic/claude-opus-4 | Сложные задачи, архитектура |
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Основная разработка, код-ревью |
| Claude Haiku 3.5 | anthropic/claude-haiku-3-5 | Быстрые задачи, автодополнение |
| GPT-5.5 | openai/gpt-5.5 | Универсальный, мультимодальный |
| GPT-5 mini | openai/gpt-5-mini | Экономичный, лёгкие задачи |
| Gemini 3.5 | google/gemini-3.5-flash | Мультимодальный, длинный контекст |
| DeepSeek V3 | deepseek/deepseek-v3 | Экономичный, код и рассуждения |
Roo Code
AI-ассистент с режимами для VS Code
Roo Code — форк Cline с дополнительными режимами работы (Code, Architect, Ask, Debug). Полностью поддерживает OpenAI-совместимые провайдеры.
Установка и настройка
Установите Roo Code из VS Code Marketplace
Откройте Extensions (Ctrl+Shift+X) и найдите Roo Code
Откройте настройки провайдера
В боковой панели Roo Code нажмите на иконку настроек и перейдите на вкладку Providers
Выберите OpenAI Compatible
В выпадающем списке провайдеров выберите OpenAI Compatible
Введите параметры
Base URL: https://api.spectra.ai/v1
API Key: ваш Spectra API-ключ
Выберите модель
Укажите Model ID из таблицы ниже и сохраните настройки
Рекомендуемые модели по режимам
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4 | anthropic/claude-opus-4 | Architect, сложный рефакторинг |
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Code, основная разработка |
| Claude Haiku 3.5 | anthropic/claude-haiku-3-5 | Ask, быстрые вопросы |
| GPT-5.5 | openai/gpt-5.5 | Debug, универсальные задачи |
| DeepSeek V3 | deepseek/deepseek-v3 | Экономичный режим |
OpenCode
AI-агент для терминала на Go
OpenCode — терминальный AI-ассистент с TUI-интерфейсом. Работает с кодом через LSP, поддерживает OpenAI-совместимые провайдеры через пакет @ai-sdk/openai-compatible.
Настройка
Создайте или отредактируйте файл конфигурации OpenCode:
{
"provider": {
"spectra": {
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://api.spectra.ai/v1",
"apiKey": "sk-ваш-ключ"
}
}
}
}Использование
Перейдите в директорию проекта
cd /path/to/your/project
Запустите OpenCode
opencode
Выберите модель
Используйте команду /models для выбора модели Spectra
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4 | anthropic/claude-opus-4 | Сложные задачи, архитектура |
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Основная разработка, код-ревью |
| Claude Haiku 3.5 | anthropic/claude-haiku-3-5 | Быстрые задачи, автодополнение |
| GPT-5.5 | openai/gpt-5.5 | Универсальный, мультимодальный |
| GPT-5 mini | openai/gpt-5-mini | Экономичный, лёгкие задачи |
| Gemini 3.5 | google/gemini-3.5-flash | Мультимодальный, длинный контекст |
| DeepSeek V3 | deepseek/deepseek-v3 | Экономичный, код и рассуждения |
n8n
Платформа автоматизации workflow
n8n — платформа для построения автоматизаций с визуальным интерфейсом. Spectra API подключается через стандартный узел OpenAI Chat Model.
Настройка
Добавьте узел OpenAI Chat Model
Перетащите узел OpenAI Chat Model на canvas вашего workflow
Создайте учётные данные
В настройках узла нажмите Create New Credential и заполните:
API Key: ваш Spectra API-ключ
Base URL: https://api.spectra.ai/v1
Укажите модель
В поле Model введите ID модели, например anthropic/claude-opus-4.8
Настройте параметры (опционально)
| Параметр | Описание |
|---|---|
| Temperature | Креативность ответа (0–2) |
| Max Tokens | Лимит длины ответа |
| Top P | Nucleus sampling (0–1) |
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Генерация контента, анализ |
| GPT-5.5 | openai/gpt-5.5 | Универсальные автоматизации |
| Gemini 3.5 | google/gemini-3.5-flash | Мультимодальные workflow |
| DeepSeek V3 | deepseek/deepseek-v3 | Экономичные автоматизации |
JetBrains IDEs
PyCharm, WebStorm, IntelliJ IDEA, GoLand
Для интеграции Spectra API в JetBrains IDE используется плагин ProxyAI. Он поддерживает чат-ассистента и автодополнение кода через OpenAI-совместимые провайдеры.
Установка и настройка
Установите плагин ProxyAI
Откройте Settings → Plugins → Marketplace и найдите ProxyAI
Перезапустите IDE
После установки перезагрузите IDE для активации плагина
Откройте ProxyAI Chat
Через правую панель или Ctrl+Shift+A → ProxyAI Chat
Настройте провайдер
Template: OpenAI
Custom Name: Spectra AI
API Key: ваш Spectra API-ключ
Chat Completions URL: https://api.spectra.ai/v1
Code Completions URL: https://api.spectra.ai/v1
Конфигурация запроса
В поле Body параметров добавьте JSON с настройками модели:
{
"model": "anthropic/claude-opus-4.8",
"temperature": 0.3,
"max_tokens": 2048
}Рекомендуемые модели по задачам
| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Haiku 3.5 | anthropic/claude-haiku-3-5 | Автодополнение кода (быстрый) |
| Claude Opus 4.8 | anthropic/claude-opus-4.8 | Чат, объяснение кода |
| Claude Opus 4 | anthropic/claude-opus-4 | Сложные задачи, рефакторинг |
| GPT-5.5 | openai/gpt-5.5 | Универсальный вариант |
| DeepSeek V3 | deepseek/deepseek-v3 | Бюджетный вариант |
OpenClaw
AI-агент для терминала с плагинами
OpenClaw — терминальный AI-ассистент с системой плагинов и gateway-архитектурой. Требует Node.js 22+ и поддерживает OpenAI-совместимые провайдеры.
Настройка
Отредактируйте конфигурацию OpenClaw или используйте интерактивную команду:
# Интерактивная настройка
openclaw configure
# Или редактируйте напрямую
nano ~/.openclaw/openclaw.jsonУкажите следующие параметры:
{
"baseUrl": "https://api.spectra.ai/v1",
"apiKey": "sk-ваш-ключ",
"api": "openai-completions"
}~/.openclaw/.env и ссылайтесь на него как ${SPECTRA_API_KEY}.Формат имени модели
OpenClaw использует формат spectra/провайдер/модель:
spectra/anthropic/claude-opus-4.8
spectra/openai/gpt-5.5
spectra/deepseek/deepseek-v3Применение изменений
# Перезапуск gateway
openclaw gateway restart
# Или включите hot reload в настройках| Модель | Model ID | Рекомендация |
|---|---|---|
| Claude Opus 4.8 | spectra/anthropic/claude-opus-4.8 | Генерация и рефакторинг кода |
| GPT-5.5 | spectra/openai/gpt-5.5 | Универсальные задачи |
| DeepSeek V3 | spectra/deepseek/deepseek-v3 | Экономичный вариант |
Устранение неполадок
Ошибка 401 Unauthorized
Проверьте правильность API-ключа. Убедитесь, что ключ начинается с sk- и не содержит лишних пробелов.
Ошибка 402 Payment Required
Недостаточно средств на балансе. Пополните баланс в личном кабинете.
Модель не найдена (404)
Проверьте формат Model ID: провайдер/модель. Актуальный список доступен через GET /v1/models.
Claude Code не подключается
Убедитесь, что ANTHROPIC_API_KEY="" задана как пустая строка. Без этого Claude Code будет пытаться подключиться к Anthropic напрямую.
Trailing slash в Base URL
Некоторые инструменты (Cline, Roo Code) не работают корректно с завершающим слэшем. Используйте https://api.spectra.ai/v1 без / в конце.
Нужна помощь?
Если у вас возникли вопросы по интеграции, обратитесь к нашей команде поддержки.