3SELLER Journal 3SELLER →

Как настроить прокси в Cursor: 5 рабочих схем для локали, SSH и офисной сети

18.11.2026

Cursor - отличный AI-редактор, пока вы работаете из дома с прямым доступом к API. В офисе с жесткой сетевой политикой или на удаленном сервере он замолкает: чат не отвечает, автодополнение не появляется. Я прошел через это трижды - на локальном Mac, на Windows в корпоративной сети и на удаленном Ubuntu-сервере через SSH. Каждый раз настройка прокси в Cursor требовала своего подхода. Ниже - пять схем, которые реально работают.

Настройка прокси в Cursor

Cursor и прокси: где именно ломается

Cursor построен на форке VS Code и наследует его механизмы работы с прокси. Нюанс в том, что не весь трафик идет через одни и те же настройки. Запросы к AI-моделям (чат, автодополнение, Composer) уходят на разные эндпоинты. http.proxy в settings.json может повлиять на одни запросы и не повлиять на другие. Плюс удаленный режим: часть настроек живет на клиенте, а не на сервере.

В офисе я добавил http.proxy первым делом. Чат заработал, а Tab-автодополнение висело еще сутки. Часть трафика шла мимо прокси. Разбирать пришлось по частям - и это нормальный сценарий, а не баг.

Локальная настройка: http.proxy и переменные окружения

Пропишите прокси в пользовательских настройках Cursor. Откройте Command Palette (Ctrl+Shift+P или Cmd+Shift+P), наберите 'Preferences: Open User Settings (JSON)' и добавьте строки:

{
  "http.proxy": "http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ",
  "http.proxySupport": "on",
  "http.proxyStrictSSL": false,
  "http.proxyAuthorization": null
}

http.proxySupport включает поддержку прокси для всех сетевых запросов. http.proxyStrictSSL: false отключает строгую проверку SSL-сертификата - это нужно для корпоративного прокси с самоподписанным сертификатом. http.proxyAuthorization оставьте null, если логин и пароль уже в URL.

Второй путь - запустить Cursor с переменными окружения. В терминале:

export http_proxy=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ
export https_proxy=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ
cursor .

Такой вариант не трогает настройки редактора. Если Cursor стартует из докера или ярлыка, переменные придется прописать в системе. На Windows - через 'Переменные среды', на macOS - через launchctl или ~/.zshrc.

После правок перезапустите Cursor. Иногда виноват битый файл настроек - у коллеги чат ожил только после чистой переустановки.

Удаленный SSH: почему remote.SSH.httpProxy в локальном окне

При подключении к удаленному серверу через Remote SSH настройки прокси для самого SSH-соединения хранятся на клиенте. В локальном окне Cursor (не в удаленном) откройте настройки и добавьте:

{
  "remote.SSH.httpProxy": "http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ",
  "remote.SSH.httpsProxy": "http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ"
}

Оба параметра говорят Cursor, какой прокси использовать при установке SSH-соединения. Если прокси доступен только с удаленной машины, а локально его нет, SSH не подключится. Варианта два: другой прокси или проброс портов.

Прописывать http.proxy в remote settings.json на сервере бесполезно - для SSH-соединения это не работает. В обсуждениях на форуме Cursor разработчики подтверждают: remote.SSH.httpProxy и remote.SSH.httpsProxy задаются только на клиенте. На Ubuntu 22.04 у меня заработало сразу: две строки в локальном settings.json, и соединение прошло через корпоративный прокси.

Переменные окружения на сервере: /etc/environment и не только

Когда SSH-соединение установлено, cursor-server на сервере может ходить в интернет напрямую или через прокси. Если прямого доступа к API нет, задайте переменные окружения для процесса. Простой способ - /etc/environment:

HTTP_PROXY=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ
HTTPS_PROXY=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ
http_proxy=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ
https_proxy=http://ЛОГИН:ПАРОЛЬ@АДРЕС_ПРОКСИ:ПОРТ

Подвох в том, что cursor-server часто стартует отдельным процессом и переменные не подхватывает. На Reddit разработчики описывают хак: правка скрипта запуска в ~/.cursor-server/bin/<hash>/bin/cursor-server, где перед вызовом node добавлены нужные export. Способ рабочий, но хрупкий - при обновлении Cursor хеш меняется, и правку придется повторять.

Надежнее - systemd-юнит для cursor-server с Environment=... Но это для тех, кто дружит с Linux. Если задача - просто заставить Cursor работать через прокси на удаленном сервере, начните с remote.SSH.httpProxy на клиенте. Для чата и индексации этого часто достаточно.

Подключение через BYOK и ProxyAPI

Cursor поддерживает BYOK (Bring Your Own Key): можно подставить свой ключ от OpenAI-совместимого сервиса. Схема не совсем прокси, но задачу решает - запросы идут через сторонний шлюз. Я настроил так:

  1. Settings -> Models, включите тумблер 'OpenAI API Key' и вставьте ключ ProxyAPI.
  2. Включите 'Override OpenAI Base URL' и укажите адрес шлюза. Обязательно с /v1 на конце.
  3. В 'Add or search model' добавьте модели в формате вендор/название: moonshotai/kimi-k2, qwen/qwen3-coder, deepseek/deepseek-v3.2.

Модели появятся в списке, чат пойдет через ProxyAPI. Важный нюанс: в режиме BYOK ключ работает только в Ask и Chat. Tab-автодополнение, Apply и фирменные модели Composer остаются на инфраструктуре Cursor. Полностью перевести весь трафик на свой прокси через BYOK не получится - но для чата и агентских запросов хватает.

Частая ошибка - забыть Override OpenAI Base URL или указать адрес без /v1. Чат молчит, хотя ключ введен. Я потерял на этом полчаса. Вторая ошибка - не добавить модель вручную: без этого она не появится в списке.

HTTP или SOCKS5: что выбрать для Cursor

HTTP-прокси работает на прикладном уровне. Его проще настроить, и для веб-запросов он подходит лучше всего. Cursor общается с AI-сервисами по HTTP/HTTPS, так что HTTP-прокси - очевидный выбор. SOCKS5 работает на сессионном уровне, поддерживает TCP и UDP, не модифицирует заголовки. Для Cursor он тоже годится, но требует настройки на стороне прокси-сервера. Корпоративный прокси почти всегда HTTP/HTTPS с авторизацией.

MTProto - протокол Telegram, к Cursor отношения не имеет. Упоминаю для ясности: если параллельно настраиваете узел для команды, MTProto шифрует пакеты на транспортном уровне и снижает задержки за счет мультиплексирования. Для бизнес-парсинга и балансировки нагрузки чаще берут SOCKS5 с ротацией. Для доступа к AI-моделям из Cursor достаточно HTTP/HTTPS.

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

Откройте терминал и выполните curl ifconfig.me. Вернулся IP прокси, а не ваш реальный - значит трафик идет куда надо. В Cursor откройте нижнюю панель Output, выберите Cursor или Network. Там видны ошибки соединения, если прокси не отвечает.

Второй тест - запрос в чат. Ответ приходит с задержкой? Прокси медленный, попробуйте другой узел. Ошибки ETIMEDOUT или ECONNREFUSED означают, что прокси недоступен или неверный порт.

Особенности настройки на Windows и macOS

На Windows settings.json лежит в %APPDATA%\Cursor\User\settings.json. Переменные окружения - через 'Система' -> 'Дополнительные параметры системы' -> 'Переменные среды'. После правок перезапустите Cursor. На macOS настройки находятся в ~/Library/Application Support/Cursor/User/settings.json. Переменные из ~/.zshrc не подхватятся, если Cursor запускается из Dock - нужен launchctl setenv.

Я держу прокси-настройки в отдельном профиле Cursor, чтобы не мешать основной работе. Копия settings.json плюс переключение через Command Palette - и переезд между офисной и домашней сетью занимает минуту.

Корпоративный прокси с авторизацией: как не спалить пароль

Если настройки Cursor синхронизируются через Git, пароль от прокси в открытом виде хранить нельзя. Используйте переменные окружения или http.proxyAuthorization с токеном. Логин и пароль можно держать в системном keychain: на macOS это Keychain Access, на Windows - Credential Manager.

Второй вариант - прокси с IP-авторизацией. Пароль не нужен, но IP должен быть статическим. В каталоге 3seller.com/proxy можно выбрать прокси с авторизацией по IP или по логину и паролю. Для корпоративного шлюза я советую второй вариант - он безопаснее.

Защита трафика в публичном Wi-Fi

Из кафе или аэропорта я работаю только через прокси или VPN. Публичные сети не шифруют трафик, и перехватить данные может кто угодно. Прокси с поддержкой HTTPS добавляет слой защиты. Для Cursor это критично: в запросах к AI-моделям уходит код и куски конфиденциальных данных. Настройте http.proxy с HTTPS-прокси и включите http.proxyStrictSSL: true, если у прокси валидный сертификат.

Бесплатные публичные прокси для работы с кодом не берите. Они часто логируют трафик и бывают скомпрометированы. Выделенный прокси в проверенном каталоге стоит дешевле, чем утекший репозиторий.

Прокси для парсинга и бизнеса

Если вы разрабатываете парсеры, Cursor - лишь инструмент. Ему самому прокси нужен для доступа к AI. Для сбора данных нужен отдельный пул с ротацией. В каталоге 3seller.com/proxy есть прокси под разные задачи: сбор данных, проверка рекламы, мониторинг цен. Я беру там пул для проекта, который собирает данные о конкурентах. Ротация IP спасает от бана, гео-привязка дает корректные данные по регионам.

Для бизнеса важна стабильность и скорость. Дешевые публичные прокси экономят деньги, но съедают время на переподключения. В каталоге 3seller прокси фильтруются по скорости и типу - это удобно, когда пул нужен за десять минут.

Мой рабочий сетап

Дома Cursor работает напрямую, без прокси. В офисе в локальном settings.json прописаны http.proxy и http.proxySupport: on, плюс remote.SSH.httpProxy для удаленных серверов. На удаленном Ubuntu cursor-server стартует с переменными окружения через systemd, а для чата я использую BYOK с ProxyAPI. Для парсинга и корпоративных задач держу пул прокси из каталога 3seller. Схема закрывает локальную разработку, удаленную работу и доступ к AI-моделям через прокси.

Начните с простого: добавьте http.proxy в настройки Cursor, перезапустите редактор, проверьте чат. Не заработало - смотрите remote.SSH.httpProxy. Не помогло и это - пробуйте BYOK. В 90% случаев хватает первых двух шагов. Остальное - нюансы корпоративных сетей.

← Вернуться к блогу

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