Интеграции с инструментами разработки

Spectra API совместим со всеми популярными AI-инструментами для разработки. Используйте единый API-ключ для работы в терминале, VS Code, JetBrains и автоматизациях.

Для всех инструментов используется единый API-ключ Spectra. Создайте его в разделе API-ключей.

Базовые параметры подключения

OpenAI-совместимый:https://api.spectra.ai/v1
Anthropic-совместимый:https://api.spectra.ai
API-ключ:sk-ваш-ключ из личного кабинета
Формат модели:провайдер/модель (например, anthropic/claude-opus-4.8)
>

Claude Code

AI-агент Anthropic для терминала

Claude Code — официальный CLI-инструмент от Anthropic для работы с кодом прямо из терминала. Поддерживает редактирование файлов, запуск команд и навигацию по проекту.

Настройка

Claude Code использует Anthropic-совместимый API (не OpenAI). Настройте переменные окружения в профиле вашего терминала:

~/.bashrc / ~/.zshrc
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:

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.spectra.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}

Выбор моделей

По умолчанию Claude Code сам выбирает модели. Вы можете переопределить их:

~/.bashrc / ~/.zshrc
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"

Проверка подключения

1

Перезагрузите терминал

Или выполните source ~/.bashrc

2

Запустите Claude Code

Выполните claude в каталоге вашего проекта

3

Проверьте статус

Введите команду /status — вы увидите подключение к Spectra API

МодельModel IDРекомендация
Claude Opus 4anthropic/claude-opus-4Сложные задачи, глубокий анализ
Claude Opus 4.8anthropic/claude-opus-4.8Основная работа с кодом
Claude Haiku 3.5anthropic/claude-haiku-3-5Быстрые задачи, субагенты
C

Cline

Автономный AI-агент для VS Code

Cline — расширение VS Code для автономной работы с кодом. Создаёт и редактирует файлы, запускает команды, работает с браузером. Поддерживает OpenAI-совместимые провайдеры.

Установка и настройка

1

Установите Cline из VS Code Marketplace

Откройте Extensions (Ctrl+Shift+X) и найдите Cline

2

Откройте настройки Cline

Нажмите на иконку Cline в боковой панели, затем откройте настройки провайдера

3

Выберите провайдер

В выпадающем списке выберите OpenAI Compatible

4

Введите параметры

Base URL: https://api.spectra.ai/v1

API Key: ваш Spectra API-ключ

Model ID: например, anthropic/claude-opus-4.8

i
Base URL должен быть без завершающего слэша: https://api.spectra.ai/v1, а не https://api.spectra.ai/v1/

Рекомендуемые модели

МодельModel IDРекомендация
Claude Opus 4anthropic/claude-opus-4Сложные задачи, архитектура
Claude Opus 4.8anthropic/claude-opus-4.8Основная разработка, код-ревью
Claude Haiku 3.5anthropic/claude-haiku-3-5Быстрые задачи, автодополнение
GPT-5.5openai/gpt-5.5Универсальный, мультимодальный
GPT-5 miniopenai/gpt-5-miniЭкономичный, лёгкие задачи
Gemini 3.5google/gemini-3.5-flashМультимодальный, длинный контекст
DeepSeek V3deepseek/deepseek-v3Экономичный, код и рассуждения
R

Roo Code

AI-ассистент с режимами для VS Code

Roo Code — форк Cline с дополнительными режимами работы (Code, Architect, Ask, Debug). Полностью поддерживает OpenAI-совместимые провайдеры.

Установка и настройка

1

Установите Roo Code из VS Code Marketplace

Откройте Extensions (Ctrl+Shift+X) и найдите Roo Code

2

Откройте настройки провайдера

В боковой панели Roo Code нажмите на иконку настроек и перейдите на вкладку Providers

3

Выберите OpenAI Compatible

В выпадающем списке провайдеров выберите OpenAI Compatible

4

Введите параметры

Base URL: https://api.spectra.ai/v1

API Key: ваш Spectra API-ключ

5

Выберите модель

Укажите Model ID из таблицы ниже и сохраните настройки

Рекомендуемые модели по режимам

МодельModel IDРекомендация
Claude Opus 4anthropic/claude-opus-4Architect, сложный рефакторинг
Claude Opus 4.8anthropic/claude-opus-4.8Code, основная разработка
Claude Haiku 3.5anthropic/claude-haiku-3-5Ask, быстрые вопросы
GPT-5.5openai/gpt-5.5Debug, универсальные задачи
DeepSeek V3deepseek/deepseek-v3Экономичный режим
$

OpenCode

AI-агент для терминала на Go

OpenCode — терминальный AI-ассистент с TUI-интерфейсом. Работает с кодом через LSP, поддерживает OpenAI-совместимые провайдеры через пакет @ai-sdk/openai-compatible.

Настройка

Создайте или отредактируйте файл конфигурации OpenCode:

opencode.json
{
  "provider": {
    "spectra": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.spectra.ai/v1",
        "apiKey": "sk-ваш-ключ"
      }
    }
  }
}

Использование

1

Перейдите в директорию проекта

cd /path/to/your/project

2

Запустите OpenCode

opencode

3

Выберите модель

Используйте команду /models для выбора модели Spectra

МодельModel IDРекомендация
Claude Opus 4anthropic/claude-opus-4Сложные задачи, архитектура
Claude Opus 4.8anthropic/claude-opus-4.8Основная разработка, код-ревью
Claude Haiku 3.5anthropic/claude-haiku-3-5Быстрые задачи, автодополнение
GPT-5.5openai/gpt-5.5Универсальный, мультимодальный
GPT-5 miniopenai/gpt-5-miniЭкономичный, лёгкие задачи
Gemini 3.5google/gemini-3.5-flashМультимодальный, длинный контекст
DeepSeek V3deepseek/deepseek-v3Экономичный, код и рассуждения
n

n8n

Платформа автоматизации workflow

n8n — платформа для построения автоматизаций с визуальным интерфейсом. Spectra API подключается через стандартный узел OpenAI Chat Model.

Настройка

1

Добавьте узел OpenAI Chat Model

Перетащите узел OpenAI Chat Model на canvas вашего workflow

2

Создайте учётные данные

В настройках узла нажмите Create New Credential и заполните:

API Key: ваш Spectra API-ключ

Base URL: https://api.spectra.ai/v1

3

Укажите модель

В поле Model введите ID модели, например anthropic/claude-opus-4.8

4

Настройте параметры (опционально)

ПараметрОписание
TemperatureКреативность ответа (0–2)
Max TokensЛимит длины ответа
Top PNucleus sampling (0–1)
МодельModel IDРекомендация
Claude Opus 4.8anthropic/claude-opus-4.8Генерация контента, анализ
GPT-5.5openai/gpt-5.5Универсальные автоматизации
Gemini 3.5google/gemini-3.5-flashМультимодальные workflow
DeepSeek V3deepseek/deepseek-v3Экономичные автоматизации
J

JetBrains IDEs

PyCharm, WebStorm, IntelliJ IDEA, GoLand

Для интеграции Spectra API в JetBrains IDE используется плагин ProxyAI. Он поддерживает чат-ассистента и автодополнение кода через OpenAI-совместимые провайдеры.

Установка и настройка

1

Установите плагин ProxyAI

Откройте Settings → Plugins → Marketplace и найдите ProxyAI

2

Перезапустите IDE

После установки перезагрузите IDE для активации плагина

3

Откройте ProxyAI Chat

Через правую панель или Ctrl+Shift+AProxyAI Chat

4

Настройте провайдер

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 с настройками модели:

ProxyAI Body Config
{
  "model": "anthropic/claude-opus-4.8",
  "temperature": 0.3,
  "max_tokens": 2048
}

Рекомендуемые модели по задачам

МодельModel IDРекомендация
Claude Haiku 3.5anthropic/claude-haiku-3-5Автодополнение кода (быстрый)
Claude Opus 4.8anthropic/claude-opus-4.8Чат, объяснение кода
Claude Opus 4anthropic/claude-opus-4Сложные задачи, рефакторинг
GPT-5.5openai/gpt-5.5Универсальный вариант
DeepSeek V3deepseek/deepseek-v3Бюджетный вариант
~

OpenClaw

AI-агент для терминала с плагинами

OpenClaw — терминальный AI-ассистент с системой плагинов и gateway-архитектурой. Требует Node.js 22+ и поддерживает OpenAI-совместимые провайдеры.

Настройка

Отредактируйте конфигурацию OpenClaw или используйте интерактивную команду:

Терминал
# Интерактивная настройка
openclaw configure

# Или редактируйте напрямую
nano ~/.openclaw/openclaw.json

Укажите следующие параметры:

~/.openclaw/openclaw.json
{
  "baseUrl": "https://api.spectra.ai/v1",
  "apiKey": "sk-ваш-ключ",
  "api": "openai-completions"
}
Для безопасности храните API-ключ в файле окружения ~/.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.8spectra/anthropic/claude-opus-4.8Генерация и рефакторинг кода
GPT-5.5spectra/openai/gpt-5.5Универсальные задачи
DeepSeek V3spectra/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 без / в конце.

Нужна помощь?

Если у вас возникли вопросы по интеграции, обратитесь к нашей команде поддержки.