RU ▾
API, совместимый с OpenAI, альтернатива Claude Codehttps://api.claudecodeapikey.com/v1
Получить API-ключ

ГлавнаяГайд

API для Claude Code в Cursor: настройка пользовательского эндпоинта

Ищете настройку API Claude Code для Cursor, не зависящую от одного поставщика? Cursor может работать с любым эндпоинтом, совместимым с OpenAI, и это руководство покажет все необходимые настройки.

Обновлено

Изометрическая иллюстрация редактора кода, подключенного к API-серверу, показывающая настройку пользовательского эндпоинта

Что вы настраиваете

Cursor — редактор со встроенными функциями ИИ. В настройках моделей есть поле, позволяющее заменить базовый URL OpenAI на свой, а также место для ввода своего ключа. Это позволяет отправлять запросы к чату любому сервису, поддерживающему формат OpenAI chat-completions. Этот сервис поддерживает его, поэтому Cursor может использовать его как модель для чата и встроенных правок.

Значения, которые вы введете, фиксированы. Базовый URL: https://api.claudecodeapikey.com/v1. Имя модели: uncensored. Ключ: тот, что из вашего аккаунта, отправляется как Bearer-токен. На стороне сервера ничего настраивать не нужно.

Четко понимайте, что это такое. Модель за эндпоинтом — это модель с открытыми весами от независимого провайдера. Это не модель Claude и не официальный API Anthropic или кого-либо еще. Если вы ожидали увидеть именно Claude внутри Cursor, то это другое, и в заключительных разделах объясняется, как оценить, достаточно ли она хороша для вашей работы.

Перед открытием Cursor

Подготовьте это заранее, чтобы не остановиться на полпути.

  1. Создайте аккаунт с помощью Google или email и пароля.
  2. Откройте страницу API-ключа и создайте ключ. Руководство по ключам показывает, где находится каждая кнопка.
  3. Получите пробный баланс $0,50, если хотите протестировать без оплаты. Это один клик, не требует карты и действует 7 дней.
  4. Выполните быструю проверку из терминала, чтобы подтвердить работоспособность ключа, прежде чем винить редактор.
curl https://api.claudecodeapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'

Ответ в формате JSON с сообщением означает, что ключ и URL корректны. HTTP 401 означает, что ключ неверен или содержит лишний пробел. Исправьте это здесь, так как сообщения об ошибках Cursor менее конкретны, чем curl.

Пошаговая конфигурация в Cursor

Названия меню меняются в разных версиях Cursor, поэтому воспринимайте приведенные ниже метки как руководство и ищите наиболее близкое совпадение.

  1. Откройте настройки Cursor и перейдите в раздел моделей.
  2. Найдите поле для ключа API OpenAI и вставьте свой ключ из этого сервиса.
  3. Включите опцию переопределения базового URL OpenAI и введите https://api.claudecodeapikey.com/v1. Укажите /v1 в конце и не добавляйте никаких дополнительных путей, таких как /chat/completions.
  4. Используйте опцию добавления пользовательской модели и введите uncensored точно, строчными буквами.
  5. Нажмите кнопку проверки или сохранения рядом с полем ключа. Cursor отправляет небольшой тестовый запрос.
  6. Откройте панель чата, выберите uncensored в выпадающем списке моделей и отправьте короткий промпт.

Если шаг проверки не прошел, но проверка curl прошла успешно, проверьте, что вы ввели URL в поле базового URL, а не в поле ключа, и что версия Cursor не сбросила переопределение после обновления. Быстрый старт содержит актуальные шаги для этого редактора.

Одна деталь, которую стоит знать: одно переопределение применяется к слоту провайдера OpenAI. Если вы также используете настоящие модели OpenAI через этот слот, они теперь также будут направляться на этот эндпоинт. Многие пользователи создают отдельный профиль Cursor или отключают переопределение, когда хотят вернуться обратно.

Тестирование с реальным промптом для кода

Приветствие мало о чем говорит. Используйте промпт, который задействует контекст и инструкции. Выберите функцию в вашем проекте, откройте чат и попросите что-то конкретное, например, добавить проверку ввода и модульный тест. Обратите внимание на три вещи.

  • Потоковая передача. Ответ должен появляться токен за токеном. Эндпоинт использует потоковую передачу через SSE, поэтому долгая задержка с последующим блоком текста указывает на то, что прокси или настройка буферизует данные.
  • Использование контекста. Прикрепите два или три файла и задайте вопрос, требующий их всех. Контекстное окно составляет 100 000 токенов, что вмещает много исходного кода, но редактор решает, сколько именно он отправляет.
  • Следование инструкциям. Попросите ответ только в виде diff или в строгом формате вывода и посмотрите, придерживается ли ему модель. Модели с открытыми весами различаются в этом аспекте, и вам стоит изучить это с первого дня.

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

Исправление распространённых ошибок

401 или неверный ключ

Ключ неверный, истёк с момента копирования в буфер обмена или содержит пробелы вокруг. Вставьте его снова. Убедитесь, что схема авторизации — Bearer; Cursor автоматически использует её при вводе ключа в поле OpenAI.

404 или модель не найдена

Почти всегда проблема с базовым URL. Отсутствующий /v1 или лишний /chat/completions нарушает путь. Имя модели также должно быть uncensored, без заглавных букв или пробелов.

429 с rate_limited или concurrency

Вы достигли лимита. Пробный ключ позволяет 2 параллельных запроса и 60 в минуту, полный ключ — 8 параллельных и 300 в минуту. Редактор может отправлять несколько запросов одновременно, например, чат и фоновые правки, а потоковая передача удерживает слот до завершения. Код ошибки указывает на лимит: rate_limited — запросы в минуту, concurrency — слишком много одновременно. Временная перегрузка также возвращает 429 с Retry-After: 5, поэтому ожидание пяти секунд и повторная попытка — правильное решение.

Ответ обрезается

Окно составляет 100 000 токенов, включая промпт и ответ. Очень большое вложение оставляет мало места для ответа. Отправьте меньше файлов или начните новый чат.

Функции, которые ничего не делают

API работает только с текстом и не предоставляет эмбеддинги. Если функция Cursor требует модель эмбеддингов или ввод изображений, она не будет работать через этот эндпоинт.

Что стоит донастроить после запуска

После первого успешного чата несколько настроек сделают ежедневное использование более плавным.

Снизьте температуру для задач редактирования. Если редактор позволяет, значение около 0,2 обеспечивает более стабильный код. Для мозгового штурма повысьте её. Далее следите за объёмом контекста, который вы прикрепляете. Окно большое, но каждый прикреплённый файл оплачивается как входные данные, поэтому закрывайте ненужные вкладки и исключайте папки сборки, чтобы снизить стоимость и сделать ответы более сфокусированными.

Если вы используете режимы агента или многошаговые сценарии, помните о поддержке вызова функций: эндпоинт принимает tools и tool_choice и потоково передаёт tool_calls. Использует ли конкретная функция Cursor эти возможности, зависит от версии, поэтому выполните небольшую задачу агента и посмотрите, что произойдёт, прежде чем доверять ей крупное изменение. Наконец, время от времени проверяйте заголовок X-Balance-USD в терминальном тесте, чтобы низкий баланс не застал вас врасплох в разгар работы.

Использование того же ключа в скриптах

Преимущество эндпоинта, совместимого с OpenAI, заключается в том, что ключ, настроенный в Cursor, работает и в коде. Вот пример на Node, удобный для скриптов сборки или инструментов коммит-сообщений.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.claudecodeapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const out = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
  ],
});

console.log(out.choices[0].message.content);

Сохраните ключ в переменной окружения, а не в файле, который вы фиксируете. Каждый ответ включает заголовок X-Balance-USD, поэтому скрипт может предупредить вас, когда кредиты на исходе.

Стоимость и когда оставить всё как есть

Использование редактора требует больших затрат на входные данные, так как каждый запрос содержит контекст файлов. При цене $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов запрос с 15 000 входными токенами и 1 000 выходными токенами стоит 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Сто таких запросов обойдутся в $0,275. На странице цен указаны суммы для пополнения, начиная с $20, с бонусами от $50.

Сохраните текущую настройку, если вы зависите от модели конкретного поставщика для сложных рефакторингов или если ваш рабочий процесс опирается на функции, которые не может предоставить обычный чат-эндпоинт. Используйте этот, когда вам нужна низкая цена за токен, простой API и меньше отказов в ответе на законные запросы. Многие разработчики настраивают оба варианта и переключаются в зависимости от задачи.

Вопросы и ответы

Какой базовый URL ввести в Cursor?

Введите https://api.claudecodeapikey.com/v1, включая /v1. Не добавляйте /chat/completions в конец.

Какое имя модели добавить?

Добавьте пользовательскую модель с именем uncensored, строчными буквами. Это единственный идентификатор модели, который предоставляет API.

Получу ли я модели Claude в Cursor?

Нет. Эндпоинт предоставляет одну модель с открытыми весами от независимого провайдера. Это не официальный API Anthropic или любого другого поставщика.

Почему в редакторе возникают ошибки 429?

Вы превысили лимит запросов в минуту или отправили слишком много запросов одновременно. Пробный ключ позволяет 2 одновременных запроса и 60 в минуту, полный ключ — 8 и 300.

Могу ли я попробовать без оплаты?

Да. Новые пользователи могут получить $0,50 пробного баланса на странице API-ключа. Для этого не нужна карта, а средства действительны в течение 7 дней.

Ваш ключ — всего в одной форме

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ