Как добавить собственные API-ключи в Cursor: полное руководство (2026)

⚠️ Внимание — BYOK для GPT-5.5 в Cursor сейчас не работает. Валидатор BYOK в Cursor отклоняет gpt-5.5 независимо от провайдера — подтверждено в теме форума Cursor. Пока Cursor не выпустит исправление, в Cursor BYOK используйте gpt-5.4 (работает безотказно) или любую модель Claude / Gemini. Сам gpt-5.5 по-прежнему работает в Codex CLI, OpenCode и при прямых вызовах API — затронут только Cursor BYOK.

Cursor — один из самых популярных AI-редакторов кода, но встроенное использование AI имеет месячные ограничения. Добавив собственные API-ключи, вы обходите эти лимиты, выбираете предпочтительные модели и напрямую контролируете расходы. В этом руководстве разберём добавление ключей от OpenAI, Anthropic, Google и других провайдеров в Cursor.

Зачем добавлять собственные API-ключи?

Есть несколько причин использовать свои API-ключи в Cursor:

Преимущество	Cursor по умолчанию	Собственные API-ключи
Быстрые запросы в месяц	50 (бесплатно) / 500 (Pro)	Неограниченно (оплата за токены)
Выбор модели	Доступные модели Cursor	Любая модель от вашего провайдера
Контроль расходов	Фиксированная подписка	Платите только за использованное
Rate limits	Общие с другими пользователями	Собственные API rate limits
Приватность	Cursor обрабатывает запросы	Напрямую к провайдеру

Если у вас уже есть API-кредиты от OpenAI, Anthropic или Google, их использование в Cursor означает отсутствие необходимости в подписке Cursor Pro для AI-функций.

Шаг 1: Откройте настройки Cursor

Есть два способа получить доступ к настройкам API-ключей в Cursor:

Способ 1: Интерфейс настроек

Откройте Cursor.
Нажмите Cmd + , (macOS) или Ctrl + , (Windows/Linux), чтобы открыть Настройки.
Нажмите "Models" в левой боковой панели.

Способ 2: Командная палитра

Нажмите Cmd + Shift + P (macOS) или Ctrl + Shift + P (Windows/Linux).
Введите "Cursor Settings" и выберите "Cursor: Open Cursor Settings."
Перейдите в раздел "Models."

Вы увидите список AI-провайдеров с полями для API-ключей.

Шаг 2: Добавьте API-ключ OpenAI

Получите ключ API OpenAI

Перейдите на platform.openai.com/api-keys.
Нажмите "Create new secret key."
Дайте ключу название, например "Cursor IDE", для удобной идентификации.
Скопируйте ключ (начинается с sk-).

Добавьте его в Cursor

В Cursor Settings > Models найдите поле "OpenAI API Key."
Вставьте API-ключ.
Нажмите "Verify" для проверки подключения.

После добавления вы сможете использовать модели OpenAI — GPT-4o, GPT-4o-mini, o4-mini и o3 — в чате, встроенном редактировании и агентном режиме Cursor.

Модель	Лучше всего для	Цена (за 1М токенов)
gpt-4o	Общее программирование, сложные задачи	$2.50 вход / $10 выход
gpt-4o-mini	Быстрые дополнения, простые задачи	$0.15 вход / $0.60 выход
o4-mini	Рассуждения, отладка	$1.10 вход / $4.40 выход
o3	Сложные архитектурные решения	$2.00 вход / $8.00 выход

Шаг 3: Добавьте API-ключ Anthropic

Получите ключ API Anthropic

Перейдите на console.anthropic.com.
Войдите или создайте аккаунт.
Перейдите в "API Keys" и нажмите "Create Key."
Скопируйте ключ (начинается с sk-ant-).

Добавьте его в Cursor

В Cursor Settings > Models найдите поле "Anthropic API Key."
Вставьте API-ключ.
Нажмите "Verify."

Теперь вы получите доступ к моделям Claude напрямую через собственный API-ключ.

Модель	Лучше всего для	Цена (за 1М токенов)
claude-sonnet-4-5-20250514	Лучший универсальный вариант для кода	$3.00 вход / $15.00 выход
claude-haiku-3-5-20241022	Быстрые дополнения, лёгкие задачи	$0.80 вход / $4.00 выход
claude-opus-4-20250514	Сложные рассуждения, архитектура	$15.00 вход / $75.00 выход

Шаг 4: Добавьте API-ключ Google Gemini

Получите ключ API Google AI

Перейдите на aistudio.google.com/apikey.
Нажмите "Create API Key."
Выберите или создайте проект Google Cloud.
Скопируйте сгенерированный ключ.

Google предлагает щедрый бесплатный тариф для моделей Gemini, что делает этот вариант экономически выгодным.

Добавьте его в Cursor

В Cursor Settings > Models найдите поле "Google AI API Key."
Вставьте API-ключ.
Нажмите "Verify."

Модель	Лучше всего для	Цена (за 1М токенов)
gemini-2.0-flash	Быстрое, экономичное программирование	Есть бесплатный тариф
gemini-3-pro-preview	Сложные многофайловые задачи	$1.25 вход / $10.00 выход
gemini-2.5-flash	Баланс скорости и качества	$0.15 вход / $0.60 выход

Шаг 5: Добавьте пользовательский OpenAI-совместимый эндпоинт

Cursor поддерживает любой API, следующий формату OpenAI. Это позволяет подключиться к:

Локальным моделям через Ollama
Together AI
Groq
Fireworks AI
OpenRouter
Любому OpenAI-совместимому серверу

Подключение Ollama (локальные модели)

Сначала установите и запустите Ollama:

# Установка Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Загрузка модели для кода
ollama pull qwen2.5-coder:14b

# Ollama работает на localhost:11434 по умолчанию

Затем в Cursor:

Перейдите в Settings > Models.
Найдите "OpenAI API Base URL" или "Override OpenAI Base URL."
Установите base URL: http://localhost:11434/v1.
Установите API-ключ: ollama (подойдёт любая непустая строка).
Добавьте имя модели qwen2.5-coder:14b в список моделей.

Подключение OpenRouter (доступ к 100+ моделям)

OpenRouter даёт доступ к сотням моделей через единый API-ключ.

Перейдите на openrouter.ai и создайте аккаунт.
Сгенерируйте API-ключ.
В Cursor установите OpenAI Base URL: https://openrouter.ai/api/v1.
Вставьте OpenRouter API-ключ в поле OpenAI API Key.
Используйте идентификаторы моделей вроде anthropic/claude-sonnet-4-5, google/gemini-3-pro-preview и т.д.

Подключение Groq (быстрый инференс)

Groq обеспечивает чрезвычайно быстрый инференс для open-source моделей.

Перейдите на console.groq.com и создайте аккаунт.
Сгенерируйте API-ключ.
В Cursor установите OpenAI Base URL: https://api.groq.com/openai/v1.
Вставьте Groq API-ключ.
Используйте модели вроде llama-3.3-70b-versatile или mixtral-8x7b-32768.

Шаг 6: Настройте предпочтения моделей

После добавления API-ключей настройте, какую модель Cursor использует для разных задач.

Установите модели по умолчанию

В Cursor Settings > Models можно назначить модели для конкретных функций:

Chat: Модель для Cursor Chat (Cmd+L). Рекомендуется: Claude Sonnet 4.5 или GPT-4o.
Inline Edit: Модель для встроенного редактирования кода (Cmd+K). Рекомендуется: Claude Sonnet 4.5 или GPT-4o.
Agent: Модель для агентного режима. Рекомендуется: Claude Sonnet 4.5.
Tab Completion: Модель для автодополнения. Рекомендуется: быстрая модель — GPT-4o-mini или Gemini Flash.

Пример конфигурации для оптимизации расходов

Используйте более дешёвые модели для частых простых задач и премиальные для сложных:

Функция	Модель	Почему
Tab completion	gpt-4o-mini	Быстро, дёшево, большой объём
Встроенное редактирование	claude-sonnet-4-5	Хорошее качество для точечных правок
Chat	claude-sonnet-4-5	Лучший для обсуждений и планирования
Агентный режим	claude-sonnet-4-5	Силён в многошаговых задачах

Шаг 7: Убедитесь, что всё работает

Протестируйте каждый API-ключ простой задачей:

Тест чата: Нажмите Cmd+L, выберите свою кастомную модель и попросите "Write a hello world function in Python."
Тест встроенного редактирования: Выделите блок кода, нажмите Cmd+K и попросите "Add error handling to this function."
Тест агентного режима: Запустите агентный режим и попросите "Create a new file called test.py with a function that calculates factorial."

Если какой-либо тест не проходит, проверьте:

API-ключ введён правильно (без лишних пробелов).
На API-аккаунте есть кредиты или активный способ оплаты.
Base URL указан правильно (особенно для кастомных эндпоинтов).
Название модели соответствует соглашению об именовании провайдера.

Устранение распространённых проблем

Проблема	Причина	Решение
"Invalid API key"	Неверный или истёкший ключ	Перегенерируйте ключ у провайдера
"Model not found"	Неверное имя модели	Проверьте точные ID моделей в документации провайдера
"Rate limit exceeded"	Слишком много запросов	Подождите и повторите, или обновите API-тариф
"Connection refused" (Ollama)	Ollama не запущен	Запустите Ollama командой `ollama serve`
Медленные ответы	Расположение сервера	Выберите провайдера с ближайшими к вам серверами
"Insufficient credits"	Нет баланса	Пополните API-аккаунт

Часто задаваемые вопросы

Нужна ли мне подписка Cursor Pro, если я добавлю собственные API-ключи? Нет. С собственными API-ключами вы пользуетесь AI-функциями без подписки Cursor Pro. Однако некоторые специфические функции Cursor, например продвинутое tab completion, могут всё равно требовать Pro.

Какой API-ключ наиболее экономически выгоден? Google Gemini предлагает самый щедрый бесплатный тариф. Для платного использования GPT-4o-mini и Gemini Flash — самые доступные качественные варианты.

Можно ли использовать несколько API-ключей одновременно? Да. Вы можете добавить ключи от нескольких провайдеров и переключаться между моделями по необходимости. Cursor будет использовать соответствующий ключ в зависимости от выбранной модели.

Надёжно ли хранятся API-ключи? Cursor хранит API-ключи локально на вашем устройстве. При использовании собственных ключей они не загружаются на серверы Cursor — запросы идут напрямую к провайдеру.

Влияет ли использование кастомных API-ключей на встроенные лимиты Cursor? Да. При использовании собственного API-ключа эти запросы не засчитываются в бесплатные или Pro-лимиты Cursor. Счёт выставляется напрямую провайдером API.

Заключение

Добавление собственных API-ключей в Cursor даёт полный контроль над AI-кодингом. Вы выбираете модели под задачи, точно управляете расходами и избегаете встроенных лимитов Cursor. Настройка занимает менее пяти минут на провайдера.

Если вы создаёте приложения, которым наряду с кодом нужны AI-медиа, попробуйте Hypereal AI бесплатно — 35 кредитов, карта не нужна. API легко интегрируется в проекты, которые вы создаёте в Cursor или любом другом редакторе.