Как использовать GPT-5.2 в Windsurf

Windsurf — один из самых быстрых AI-native редакторов, и его агент Cascade раскрывается во всю силу, когда за ним стоит сильная модель рассуждений. GPT-5.2 отлично подходит на эту роль. В этом руководстве показано, как подключить GPT-5.2 к Windsurf через единый OpenAI-совместимый эндпоинт, чтобы вы сохранили привычный рабочий процесс и могли менять модели когда угодно.

Зачем направлять GPT-5.2 через AnyModel

Windsurf умеет работать с любым OpenAI-совместимым API. AnyModel даёт ровно это: один base_url, один API-ключ и доступ к GPT-5.2 наряду с Claude, Gemini, DeepSeek, GLM, Kimi, Qwen и Grok. Чтобы переключить модель, достаточно изменить одну строку — идентификатор model — и больше ничего в конфиге.

Несколько практических причин, почему это важно для пользователей Windsurf:

• Никаких отдельных аккаунтов под каждого провайдера. Один ключ открывает доступ к каждой модели из списка моделей.
• Бесплатный старт. При регистрации вы получаете 1 000 000 токенов, а всего 6 000 000, если привяжете Telegram — без банковской карты.
• Дальше — оплата за токены. Без подписки, без минимальных сумм. Вы платите за то, что Cascade реально потребляет.

Если вы взвешиваете GPT-5.2 против других вариантов для агентного программирования, страница сравнения моделей — быстрый способ проверить задержку и цены, прежде чем на что-то решиться.

Шаг 1: получите API-ключ

Создайте аккаунт, затем скопируйте ключ из панели управления. Стартовых токенов хватит, чтобы провести реальные сессии Cascade ещё до того, как вы что-то потратите.

Шаг 2: добавьте AnyModel как кастомного провайдера в Windsurf

Windsurf не входит в число четырёх инструментов, которые поддерживает наш установщик в одну строку (это codex, claude, opencode и hermes), поэтому вы воспользуетесь стандартной OpenAI-совместимой настройкой. Это занимает около минуты.

1. Откройте настройки Windsurf и перейдите в настройки Cascade / модели.
2. Найдите опцию добавления кастомного OpenAI-совместимого провайдера (иногда она называется «OpenAI API key» с настраиваемым base URL).
3. Задайте эти два значения:

4. Добавьте gpt-5.2 в качестве идентификатора модели.

На этом всё подключение завершено. Поскольку эндпоинт OpenAI-совместимый, Windsurf воспринимает его как нативного провайдера.

Шаг 3: проверьте подключение

Прежде чем полагаться на эндпоинт внутри редактора, убедитесь, что он отвечает. Выполните в терминале:

curl https://anymodel.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "messages": [{"role": "user", "content": "Reply with: Windsurf connected"}]
  }'

Если вы получили JSON-ответ с репликой модели, то и Windsurf заработает. Если видите 401 — ключ неверный; 404 обычно означает, что в base URL не хватает /v1.

Шаг 4: используйте модель в Cascade

Выберите GPT-5.2 в селекторе моделей Cascade и начинайте писать запросы. GPT-5.2 хорошо подходит для рефакторинга нескольких файлов сразу, планирования перед редактированием и разбора причин падающих тестов — то есть для тех задач, где агентный цикл Windsurf по-настоящему окупается.

Переключение моделей на лету

Хотите сравнить GPT-5.2 с Claude или Gemini на одной и той же задаче? Добавьте ещё один идентификатор модели (например, модель Claude или Gemini), указывающий на тот же base URL и ключ. Никаких новых аккаунтов, никаких новых учётных данных. Это самый быстрый способ провести A/B-тест и понять, какая модель лучше справляется с вашей кодовой базой.

Пара слов о приватности

Если ваш репозиторий чувствительный, включите Ghost Mode — opt-in API-ключи с нулевым хранением (zero-retention), при которых запросы и ответы не сохраняются на нашей стороне (работает только счётчик токенов). Но смотрите на это трезво: провайдер базовой модели всё равно получает ваш запрос, поэтому это не «100% приватность». Так устраняется наша копия, а не их.

Советы по устранению неполадок

• Модель не найдена: перепроверьте точный идентификатор gpt-5.2 и убедитесь, что в конце нет лишнего пробела.
• Проблемы со стримингом (streaming): убедитесь, что запись провайдера в Windsurf использует путь chat completions, а не устаревший эндпоинт completions.
• Ошибки лимита или баланса: проверьте остаток токенов в панели управления.

Больше пошаговых руководств по настройке для разных редакторов и CLI — в блоге.

Начните бесплатно

GPT-5.2 заработает в Windsurf за то время, которое нужно, чтобы вставить base URL и ключ. Создайте бесплатный аккаунт AnyModel, возьмите ключ и начните с лимитом до 6 000 000 токенов — без банковской карты.