Подключение инструментов разработки
Настройка Cline, Roo Code, Kilo Code, Continue, Aider, Zed и Cursor для API provod.ai.
Обновлено
Проверьте совместимость
В этих инструментах поставщик — это сохранённое подключение с адресом API, ключом и параметрами моделей.
| Инструмент | Интерфейс или путь к настройкам | Статус и важная особенность |
|---|---|---|
| Cline | OpenAI Compatible в настройках VS Code | Совместимо; точный идентификатор из каталога вводится вручную. |
| Roo Code | Settings → Providers → OpenAI Compatible | Совместимо; удалите старый выбор встроенной модели. |
| Kilo Code | Providers → OpenAI Compatible | Совместимо; явно выберите пользовательское подключение. |
| Continue | Локальный config.yaml, поставщик openai | Только Chat Completions; оставьте useResponsesApi: false. |
| Aider | Переменные окружения оболочки | Совместимо; передавайте идентификатор из каталога как openai/<catalog-id>. |
| Zed | settings.json и системное хранилище ключей | Совместимо; создавайте идентификатор и лимит модели из актуального каталога. |
| Cursor | Override OpenAI Base URL | Зависит от версии; продолжайте, только если поле доступно. |
| Claude Code | Отдельное руководство | Совместимо через Anthropic Messages; базовый URL указывается без /v1. |
| OpenCode | Отдельное руководство | Совместимо через установщик или ручное подключение. |
| Codex CLI | Статус поддержки | Не поддерживается, пока отсутствует необходимый адрес /v1/responses. |
Сначала выберите и проверьте модель
Совместимые с OpenAI инструменты на этой странице используют общие значения:
| Значение | Настройка |
|---|---|
| Базовый URL | https://api.provod.ai/v1 |
| Ключ API | Ключ, созданный в кабинете |
| Идентификатор модели | Доступный точный id из текущего каталога |
Выполните команду в оболочке с установленными curl и jq. Проверка требует доступную текстовую модель с поддержкой tools и используемого в запросе параметра max_tokens, а также исключает записи для графических адресов:
set -euo pipefail
export PROVOD_API_KEY="sk_..."
if ! MODELS_JSON="$(
curl --fail-with-body --silent --show-error "https://api.provod.ai/v1/models?output_modalities=text&supported_parameters=tools,max_tokens" \
-H "Authorization: Bearer $PROVOD_API_KEY"
)"; then
printf '%s\n' "$MODELS_JSON" >&2
exit 1
fi
if ! PROVOD_MODEL="$(
jq -er '
first(
.data[]
| select(
.available == true
and ((.architecture.output_modalities // []) | index("text"))
and ((.supported_parameters // []) | index("tools"))
and ((.supported_parameters // []) | index("max_tokens"))
and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
)
| .id
)
' <<<"$MODELS_JSON"
)"; then
printf 'No available tool-capable text model found in /v1/models.\n' >&2
exit 1
fi
export PROVOD_MODEL
jq -n --arg model "$PROVOD_MODEL" '{
model: $model,
messages: [{role: "user", content: "Reply with ok"}],
max_tokens: 64
}' | curl --fail-with-body --silent --show-error https://api.provod.ai/v1/chat/completions \
-H "Authorization: Bearer $PROVOD_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @-Если запрос не проходит, исправьте ключ, выбор по каталогу или тело запроса до настройки инструмента. Если он успешен, сравните итоговый URL, протокол, точный идентификатор модели и источник ключа в инструменте с проверенными значениями.
Защищайте ключ API
Храните ключ в переменной окружения, системном хранилище ключей, защищённых локальных настройках инструмента или на доверенном сервере. Не помещайте его в код для браузера и не добавляйте в репозиторий. Если локальные настройки раскрыты, отзовите ключ в кабинете.
Настройте инструменты Chat Completions
Cline, Roo Code и Kilo Code
Откройте указанный в таблице интерфейс и введите https://api.provod.ai/v1, значение переменной PROVOD_API_KEY и точный PROVOD_MODEL, выбранный выше. Выполните одну короткую задачу до включения инструментов и длинных агентских заданий. Если прямой запрос успешен, а расширение не работает, снова выберите пользовательское подключение и удалите старую встроенную модель, которая его перекрывает.
Continue
Добавьте запись модели OpenAI в защищённый локальный файл настроек Continue. Вставьте текущее значение PROVOD_API_KEY в apiKey, замените значение модели на PROVOD_MODEL и оставьте useResponsesApi: false:
name: provod.ai
version: 1.0.0
schema: v1
models:
- name: provod.ai
provider: openai
model: model-id-from-PROVOD_MODEL
apiBase: https://api.provod.ai/v1
apiKey: paste-value-from-PROVOD_API_KEY
useResponsesApi: false
roles:
- chat
- edit
- applyВыберите эту запись и убедитесь, что клиент вызывает /v1/chat/completions, а не /v1/responses.
Aider
После выбора модели по инструкции выше задайте совместимые с OpenAI переменные Aider и добавьте префикс openai/ к точному идентификатору из каталога:
export OPENAI_API_KEY="$PROVOD_API_KEY"
export OPENAI_API_BASE="https://api.provod.ai/v1"
aider --model "openai/$PROVOD_MODEL"До разрешения изменений файлов проверьте модель в сообщении Aider. Если она отличается, сравните окружение процесса Aider с оболочкой, где прошёл прямой запрос.
Zed
Используйте сохранённый при выборе модели объект MODELS_JSON, чтобы создать полный объект language_models по актуальной доступной текстовой модели с поддержкой инструментов и её текущему context_length. Добавленная возможность заставляет Zed отправлять опубликованный для модели параметр max_tokens вместо стандартного max_completion_tokens:
if ! ZED_SETTINGS="$(
jq -er '
first(
.data[]
| select(
.available == true
and ((.architecture.output_modalities // []) | index("text"))
and ((.supported_parameters // []) | index("tools"))
and (.context_length | type == "number" and . > 0)
and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
)
) as $model
| {
language_models: {
openai_compatible: {
"provod.ai": {
api_url: "https://api.provod.ai/v1",
available_models: [
{
name: $model.id,
display_name: ($model.name // $model.id),
max_tokens: $model.context_length,
capabilities: {
tools: true,
images: false,
parallel_tool_calls: false,
prompt_cache_key: false,
chat_completions: true,
interleaved_reasoning: false,
max_tokens_parameter: true
}
}
]
}
}
}
}
' <<<"$MODELS_JSON"
)"; then
printf 'No available Zed-compatible model found in /v1/models.\n' >&2
exit 1
fi
printf '%s\n' "$ZED_SETTINGS"Объедините выведенный объект с settings.json. Введите значение PROVOD_API_KEY через настройки подключения Zed, чтобы ключ сохранился в системном хранилище; не добавляйте его в settings.json. Затем выберите пользовательскую модель и отправьте один короткий запрос.
Cursor
Продолжайте только в версии Cursor с полем Override OpenAI Base URL. Укажите https://api.provod.ai/v1, значение PROVOD_API_KEY и точный PROVOD_MODEL. По доступным диагностическим данным Cursor убедитесь, что запрос использует переопределённый адрес. Если поля нет или Cursor отправляет другой протокол, не передавайте ключ по непроверенному пути.
Подробные руководства
Claude Code
OpenCode
Codex CLI
Создание и замена ключей описаны в авторизации API. Актуальные идентификаторы моделей, лимиты и поддерживаемые опции получайте через каталог моделей.
Публичный код ошибки — это предназначенное для клиента значение error.code, которое вернул API. Сохраните его вместе с HTTP-статусом, версией инструмента, итоговым адресом, точным идентификатором модели, временем и маскированным префиксом ключа; не прикладывайте полный ключ.