IDE и клиенты
Как подключить CLODEx к Cursor
Если вы уже работаете в Cursor, менять редактор ради CLODEx необязательно. Для совместимых функций можно указать свой API-ключ и адрес провайдера. Сначала проверьте доступность этих настроек в вашей версии Cursor и нужный режим работы.
Внешний ключ не равен подписке Cursor. В частности, документация Cursor отделяет BYOK для чат-моделей от Tab completion, использующего встроенные модели Cursor. Не считайте, что изменение Base URL автоматически переводит все функции редактора на CLODEx.
Что подготовить в кабинете
В API-ключах создайте отдельный ключ для Cursor. В каталоге выберите модель и проверьте тариф; в кошельке — средства. Откройте мастер CLODEx и выберите Open IDE → Cursor.
| Поле в клиенте | Значение |
|---|---|
| OpenAI API Key | Ваш ключ CLODEx |
| Override OpenAI Base URL | https://clodex.xyz/v1 |
| Custom model / Model ID | Точный ID доступной модели |
Название поля OpenAI API Key не означает, что нужен ключ с platform.openai.com. В этой конфигурации используется ключ CLODEx.
Настройка через интерфейс
- Откройте Settings → Models или соответствующий раздел API в вашей версии Cursor.
- Включите использование собственного ключа и укажите ключ CLODEx.
- Найдите Override OpenAI Base URL и установите
https://clodex.xyz/v1. - Добавьте или выберите точный ID модели из каталога.
- Сохраните настройки и выполните Verify, если эта кнопка доступна.
- Выберите настроенную модель в чате. Начните с короткого вопроса о тестовом файле, без команд и правок рабочего проекта.
Если нужного поля нет, сверьте актуальную инструкцию в /docs и документацию Cursor. Не используйте неизвестные скрипты для изменения приложения и не отключайте проверку TLS.
Как убедиться, что запрос идёт в CLODEx
После теста откройте журнал запросов и расходов. Сравните время, модель и списание. Успешная проверка ключа не заменяет реальный запрос выбранной моделью, а ответ в чате не доказывает, что другие режимы Cursor используют тот же маршрут.
Затем отдельно проверьте нужные функции: чтение контекста, инструменты, применение правок и передачу изображений, если они требуются. Поддержка обычного текста не гарантирует совместимость всего агентского цикла.
Частые проблемы
| Симптом | Следующий шаг |
|---|---|
| 401 | Проверить ключ, пробелы, срок действия и настройки авторизации |
| Модель не найдена | Сверить точный ID и доступ модели этому ключу |
| 404 / HTML | Проверить Base URL с /v1, без добавленного /chat/completions |
| Нет записи в журнале | Проверить активную модель и провайдера в конкретном режиме Cursor |
| Chat работает, Agent нет | Проверить поддерживаемые tool calls и ограничения клиента |
| Tab работает иначе | Не приравнивать Tab completion к запросам через внешний ключ |
Как управлять расходами
Одна агентская задача может вызвать несколько запросов с большим контекстом. Для первого теста выделите небольшой проект и ограничьте объём задания. Фактическую цену смотрите в кабинете CLODEx; встроенная оценка стороннего редактора может не знать тариф вашего маршрута.
Для команды лучше разделять ключи по пользователям или приложениям, а не передавать один общий секрет всем участникам. Не сохраняйте ключ в правилах проекта, Git, скриншотах и публичных issue.
Если clodex.xyz доступен из вашей сети напрямую, API-запросам не нужен отдельный VPN. Авторизация самого Cursor, обновления и его собственные облачные функции остаются отдельными сетевыми зависимостями.
Открыть инструкцию Cursor · Создать ключ · Настроить Cline, Roo Code или OpenCode.