Cursor - отличный AI-редактор, пока вы работаете из дома с прямым доступом к API. В офисе с жесткой сетевой политикой или на удаленном сервере он замолкает: чат не отвечает, автодополнение не появляется. Я прошел через это трижды - на локальном Mac, на Windows в корпоративной сети и на удаленном Ubuntu-сервере через SSH. Каждый раз настройка прокси в 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-совместимого сервиса. Схема не совсем прокси, но задачу решает - запросы идут через сторонний шлюз. Я настроил так:
- Settings -> Models, включите тумблер 'OpenAI API Key' и вставьте ключ ProxyAPI.
- Включите 'Override OpenAI Base URL' и укажите адрес шлюза. Обязательно с /v1 на конце.
- В '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% случаев хватает первых двух шагов. Остальное - нюансы корпоративных сетей.