Прокси в Windsurf: настройка поля Http: Proxy и проверка

Чего прокси не меняет

Эта статья про настройку сети, а не про доступность сервиса. На страницах документации Windsurf, которые использованы здесь, нет описания региональной доступности моделей и условий использования, поэтому актуальные условия сервиса и провайдеров моделей прочитайте сами. Прокси меняет только то, откуда выходит ваш трафик. Он не делает сервис доступным там, где его нет, и не меняет условия сервиса, лимиты тарифа и правила провайдеров моделей.

Где задать прокси

Документация Windsurf теперь находится на docs.devin.ai/desktop и называет редактор Devin Desktop Editor; старый адрес docs.windsurf.com перенаправляет туда. Поэтому и в настройках названия такие: вы увидите Devin Settings, а не Windsurf Settings. По документации откройте выпадающее меню справа сверху и выберите Devin Settings либо откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P), выполните Open Devin User Settings и введите proxy в строке поиска настроек.

Локально есть два варианта. Detect proxy — переключатель, который берёт прокси из системных сетевых настроек или PAC-файла (небольшого файла, который подсказывает компьютеру, какой прокси использовать); включите его и перезапустите редактор, а если появятся проблемы, выключите и используйте ручную настройку. Http: Proxy — ручная: впишите адрес прокси с протоколом и портом, например http://proxy.company.com:8080. После этого закройте страницу настроек и перезапустите редактор.

Документация называет поле только по подписи Http: Proxy и не приводит его ключ в settings.json. Ключ приведён лишь для авторизации: http.proxyAuthorization. Так как редактор основан на VS Code, ручное поле, скорее всего, хранится как http.proxy, но пока проверка ниже не пройдена, считайте это неподтверждённым.

• Источники:
• Документация Windsurf (теперь Devin Desktop): Proxy Configuration

Где задать прокси: пример

http://USERNAME:PASSWORD@HOST:PORT

Это адрес для поля Http: Proxy. Замените HOST, PORT, USERNAME и PASSWORD значениями из «Мои активы».

Логин и пароль

В документации Windsurf сказано, что отдельных полей для логина и пароля в редакторе нет, и названо три способа. Первый, рекомендуемый: не писать данные в адресе и ввести их в окне входа для прокси, когда редактор спросит; отметка Remember my credentials сохранит их в зашифрованном виде на вашем компьютере. Второй: написать их в адресе, как http://USERNAME:PASSWORD@HOST:PORT; документация предупреждает, что символы вроде @, : или / могут разобраться неверно, поэтому окно входа надёжнее. Третий: поле Http: Proxy Authorization — нажмите Edit in settings.json и задайте значение заголовка, которое выдал поставщик прокси.

Ещё документация предупреждает: значения в Http: Proxy и Http: Proxy Authorization хранятся в settings.json открытым текстом и могут утечь через резервные копии или общие файлы настроек. Не коммитьте этот файл в репозиторий.

Если всё же пишете данные в адресе, закодируйте спецсимволы в процентном виде: @ превращается в %40, : в %3A, / в %2F, # в %23, % в %25.

• Источники:
• Документация Windsurf (теперь Devin Desktop): Proxy Configuration

HTTP или SOCKS5

Документация Windsurf не говорит, какие типы прокси поддерживаются, и не упоминает SOCKS5. В документации VS Code сказано, что прокси с аутентификацией поддерживаются (Basic, Digest, NTLM и Negotiate), а аутентификация SOCKS5 пока не реализована. Поэтому для прокси с логином и паролем берите HTTP.

• Источники:
• Документация Windsurf (теперь Devin Desktop): Proxy Configuration
• Документация Visual Studio Code: Network Connections

Удалённая разработка (SSH и dev-контейнеры)

У удалённой разработки свои поля, отдельные от локальных. В User → Extensions найдите Remote › Devin SSH: Http Proxy и Remote › Devin SSH: Https Proxy и впишите адрес прокси, обычно с протоколом и портом. Документация отмечает, что в некоторых средах нужны и локальные, и удалённые значения. После изменения закройте удалённое окно и подключитесь заново либо перезапустите dev-контейнер.

• Источники:
• Документация Windsurf (теперь Devin Desktop): Proxy Configuration

Как проверить, что прокси работает

1. Шаг 1

   Посмотрите на сам редактор. В документации Windsurf нет команды проверки; при неудачной операции она советует перезагрузить редактор или Cascade (его ИИ-чат) и повторить. Признаки рабочего подключения: редактор и Cascade загружаются, ошибки вроде Failed to connect пропадают, вход проходит.

2. Шаг 2

   Проверьте сам прокси в терминале командой ниже. Команда покажет IP, страну и сеть, которые видят сайты. Как читать поля ip, country, city и org, объясняет статья о проверке IP, страны и провайдера прокси.

   • проверке IP, страны и провайдера прокси

3. Шаг 3

   Если сеть фильтруют файрвол или VPN, разрешите домены со страницы устранения неполадок Windsurf. В списке: .codeiumdata.com, update.windsurf.com, .windsurf.com, .codeium.com, .googleapis.com и apis.google.com (для входа), а также static.devin.ai.

Как проверить, что прокси работает: пример

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

Замените HOST, PORT, USERNAME и PASSWORD значениями из «Мои активы».

Типичные ошибки

• 407 Proxy Authentication Required. Прокси отклонил логин или пароль. Вводите их в окне входа, а не в адресе, скопируйте данные заново из «Мои активы», а если оставляете их в адресе, проверьте процентное кодирование.

• Редактор остаётся пустым или пишет Failed to connect. Неверны адрес, порт или протокол прокси, либо закончилась аренда IP. Проверьте командой curl выше.

• После сохранения ничего не изменилось. Документация требует закрыть страницу настроек и перезапустить редактор, а удалённые окна подключить заново.

• Ошибки сертификатов. Использованные здесь страницы Windsurf о сертификатах не говорят. В документации VS Code лучшим вариантом названо добавление сертификата прокси в доверенные сертификаты операционной системы, а отключение проверки названо опасным.

• Источники:
• Документация Windsurf (теперь Devin Desktop): Proxy Configuration
• Документация Visual Studio Code: Network Connections

Как это сделать с Proxy302

Статический ISP-прокси подходит, когда нужен один постоянный адрес: IP закреплён на весь срок аренды и не меняется, а при покупке вы выбираете HTTP. Готового пресета для Windsurf на странице заказа нет, поэтому ссылка ниже открывает страницу статического ISP для ИИ-сервисов. Страница про прокси для Cursor объясняет тот же продукт на примере похожего редактора.

• страница про прокси для Cursor
• статические резидентные прокси

Как это сделать с Proxy302: шаги

1. Шаг 1

   Откройте страницу статического ISP, выберите страну, протокол HTTP, срок и количество IP, затем создайте прокси.

2. Шаг 2

   Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Подключение» есть готовый пример с вашими данными. У HTTP порт 2222.

3. Шаг 3

   Вставьте HTTP-адрес в поле Http: Proxy (или адрес без логина и пароля, а их введите в окне входа) и перезапустите Windsurf.

4. Шаг 4

   Убедитесь, что редактор загружается и вход проходит, и проверьте выход запросом curl.

Цены и ограничения

Статический ISP стоит $0,50 за сутки и $7,99 за 30 дней, около $0,27 в день, во всех странах одинаково. Наличие по странам меняется каждый день и показано на странице заказа. Бесплатного пробного периода нет, минимальная покупка один IP на один день.

• Источники:
• Факты о продуктах и прайс Proxy302

Смежные руководства

Такая же настройка на основе VS Code для другого редактора описана в руководстве по Cursor, а базовые шаги для самого VS Code — в руководстве по VS Code.

• прокси в Cursor
• прокси в VS Code

Частые вопросы

Читайте дальше

Прокси для Cursor

Прокси для Cursor: статический ISP-IP, настройка http.proxy и HTTP/1.1, выход в стране, где доступны модели. По данным СМИ, с сентября 2026 Cursor не работает в России.

Посмотреть параметры и цену

Прокси в Cursor: настройка

Прокси в Cursor через http.proxy, спецсимволы в пароле, переключение на HTTP/1.1, если зависает стриминг, и проверка через Run Diagnostics.

Прокси в VS Code: настройка

Прокси в VS Code: откуда его берут редактор и расширения, http.proxy, логин и пароль, терминал и проверка.

Как проверить прокси: IP, страна, провайдер

Как за 30 секунд проверить IP, страну и провайдера прокси, почему сервисы расходятся в городе и что значит «чистота» IP. С нашей проверкой трёх сервисов.