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

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

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: Интерфейс настроек

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

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

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

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

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

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

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

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

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

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

Рекомендуемые модели OpenAI для 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

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

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

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

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

Рекомендуемые модели Anthropic для Cursor

Модель	Лучше всего для	Цена (за 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 выход

Для большинства задач по коду Claude Sonnet 4.5 предлагает лучший баланс качества и цены.

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

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

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

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

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

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

Рекомендуемые модели Google для Cursor

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

Бесплатный тариф Gemini 2.0 Flash особенно удобен — вы получаете значительное бесплатное использование до начала оплаты.

Шаг 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:

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

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

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

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

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

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

1. Перейдите на console.groq.com и создайте аккаунт.
2. Сгенерируйте API-ключ.
3. В Cursor установите OpenAI Base URL: https://api.groq.com/openai/v1.
4. Вставьте Groq API-ключ.
5. Используйте модели вроде 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-ключ простой задачей:

1. Тест чата: Нажмите Cmd+L, выберите свою кастомную модель и попросите "Write a hello world function in Python."
2. Тест встроенного редактирования: Выделите блок кода, нажмите Cmd+K и попросите "Add error handling to this function."
3. Тест агентного режима: Запустите агентный режим и попросите "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 или любом другом редакторе.