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

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

Зачем направлять всё через один эндпоинт

AnyModel даёт вам один базовый URL и один API-ключ, которые открывают доступ ко всем крупным моделям — GPT, Claude, Gemini, DeepSeek, GLM, Kimi, Qwen и Grok. Переключение с GPT-5.2 Codex на, скажем, Claude или Gemini сводится к замене одной строки — идентификатора model. Больше в вашей настройке ничего не меняется.

В Windsurf это особенно важно: для тяжёлых рефакторингов вам может пригодиться модель Codex, а для быстрых правок в стиле автодополнения — модель подешевле. Всё доступное можно посмотреть на странице моделей, а если вы взвешиваете компромиссы по цене или возможностям, инструмент сравнения выложит их рядом.

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

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

Держите ключ под рукой — через минуту вы вставите его в Windsurf.

Шаг 2: Добавьте кастомный OpenAI-совместимый провайдер в Windsurf

Windsurf поддерживает кастомные OpenAI-совместимые эндпоинты. Откройте настройки Windsurf и найдите конфигурацию модели/провайдера (в настройках Cascade или AI provider, в зависимости от вашей версии). Добавьте новый провайдер со следующими значениями:

Базовый URL — это OpenAI-совместимый корень. Windsurf автоматически добавляет стандартный путь /chat/completions, поэтому вам нужно указать только базовый URL выше.

Примечание: Windsurf настраивается вручную, как Cursor, Zed, Cline, Aider и Continue. Установщик в одну строку работает только для CLI codex, claude, opencode и hermes — но не для расширений IDE.

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

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

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

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

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

Откройте панель Cascade, выберите свой кастомный провайдер и укажите gpt-5.2-codex. Теперь вы можете:

• Просить о рефакторингах сразу нескольких файлов и позволять агенту вносить правки по всему репозиторию.
• Вставить стектрейс и запросить исправление в виде диффа.
• Генерировать тесты для функции или модуля.
• Запрашивать ревью застейдженных изменений перед коммитом.

Поскольку с конкретной моделью связан только идентификатор модели, вы можете держать настроенными сразу несколько провайдеров — один для Codex, другой для модели полегче — и переключаться под задачу.

Переключение моделей в дальнейшем

Хотите попробовать на той же задаче другую модель? Продублируйте запись провайдера и поменяйте идентификатор model. Несколько идентификаторов, которые стоит знать:

• gpt-5.2-codex — агентное программирование, рефакторинги, ревью
• подставьте идентификатор Claude, Gemini или DeepSeek для сравнения

Ваш базовый URL и ключ при этом не меняются. В этом и весь смысл единого шлюза.

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

По умолчанию промпты и ответы проходят к провайдеру модели как обычно. Если вам нужно нулевое хранение (zero retention) на нашей стороне, включите Ghost Mode — опциональную настройку, при которой мы не храним ваши промпты и ответы, только счётчик токенов. Будьте честны с собой насчёт того, что это значит: провайдер модели всё равно получает ваш промпт, чтобы сгенерировать ответ. Ghost Mode закрывает нашу сторону, но не их.

Быстрые подсказки по устранению неполадок

• Модель не найдена — перепроверьте точный идентификатор model; опечатки в строке версии — обычное дело.
• Пустые ответы — убедитесь, что Windsurf нацелен на ваш кастомный провайдер, а не откатывается на встроенный.
• Медленный первый токен — большие агентные промпты требуют времени; для моделей класса Codex это нормально.

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

Старт за две минуты

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