Как подключить Claude API к Windsurf

Подключение занимает несколько минут. Windsurf будет отправлять запросы через OpenAI-совместимый endpoint Claude API Tech, а расходы появятся в вашем личном кабинете.

Windsurf, ранее Codeium, это AI IDE с агентом Cascade. Инструкция подходит для версии, в которой доступен OpenAI Compatible или Custom Provider.

Официальный сайт Windsurf ↗

Время

2-3 минуты

Провайдер

OpenAI Compatible

Авторизация

API-ключ

Перед началом

Создайте API-ключ Claude API Tech или откройте уже существующий ключ.
Обновите Windsurf, если в настройках нет OpenAI Compatible или Custom Provider.
Не добавляйте API-ключ в проект, settings.json репозитория или публичный скриншот.

Создать API-ключ →

Настройка

Откройте Settings

На macOS нажмите Cmd + ,. На Windows или Linux нажмите Ctrl + ,. Настройки также открываются через шестерёнку в левом нижнем углу.

macOS ⌘ ,Windows / Linux Ctrl ,

Найдите AI provider

Введите AI или API в поиске настроек. Откройте раздел провайдера и выберите OpenAI Compatible. Если такого пункта нет, найдите Custom Provider с полями Base URL и API Key.

Вставьте endpoint и ключ

Скопируйте Base URL без изменений. В поле API Key вставьте ключ из личного кабинета. Пробел в начале или конце ключа приведёт к ошибке авторизации.

Значения для Windsurf

Windsurf

OpenAI API

ПровайдерOpenAI Compatible

Base URLhttps://api.llm-gate.tech/v1

API Keysk-cs2-YOUR_API_KEYПолучить ключ →

Сохраните и проверьте

Примените настройки и полностью перезапустите Windsurf. Откройте Cascade в любом проекте и отправьте короткий тестовый запрос.

Альтернативный вариант: settings.json

Windsurf также можно настроить вручную через файл settings.json:

settings.json

{
  "ai.provider": "openai-compatible",
  "ai.baseUrl": "https://api.llm-gate.tech/v1",
  "ai.apiKey": "sk-cs2-YOUR_API_KEY"
}

Как понять, что всё работает

Подключение готово, если выполняются все три условия:

✓

Cascade отвечает

Тестовый запрос завершается без ошибки провайдера.

✓

Появился usage

Запрос виден в личном кабинете Claude API Tech.

✓

Выбрана нужная модель

В ответе нет ошибки unknown model или model not found.

Если подключение не заработало

Симптом	Что проверить
401 или 403	Скопируйте API-ключ заново и удалите пробелы.
404 или ошибка endpoint	Base URL должен быть ровно https://api.llm-gate.tech/v1.
Unknown model	Выберите точный ID из списка поддерживаемых моделей.
Настройки не применились	Полностью закройте Windsurf и откройте его снова.
Нет Custom Provider	Обновите Windsurf и проверьте доступность этой настройки для вашей версии или аккаунта.

Справочник ошибок →Поддерживаемые модели →

← Roo Code