Настройка Continue.dev OpenAI compatible provider — это не просто переключение поставщика модели. Для ассистента по программированию маршрут должен доказать четыре вещи: Continue читает нужный config.yaml, Flatkey является базовым URL за OpenAI provider, псевдоним модели включён для вашего ключа, а выбранная модель может поддерживать роль Continue, которую вы ей назначаете.
Это руководство написано для разработчиков, команд по AI-продуктам, создателей автоматизаций, platform engineers, финансовых операторов и специалистов по закупкам, которым нужен один проверяемый OpenAI-compatible маршрут для Continue и остального их AI-инструментария. Оно охватывает актуальную документацию Continue, проверки базового URL Flatkey, роли моделей, возможность использования инструментов, fallback endpoint, видимость использования и rollback.
Source note: это было проверено 29 июня 2026 года по официальной главной странице Continue, официальной документации Continue по OpenAI provider, официальной справке Continue по config.yaml, официальному руководству Continue по model-capabilities и публичным страницам Flatkey в реальном времени. На главной странице Continue сейчас указано, что Continue был приобретён Cursor, поэтому перед новым решением о развёртывании для всей команды проверьте желаемое расширение Continue, CLI и путь поддержки.
Быстрый ответ: настройка Continue.dev OpenAI compatible provider
Для настройки Continue.dev OpenAI compatible provider с Flatkey настройте модель в config.yaml Continue с provider: openai, укажите apiBase на текущий базовый URL провайдера Flatkey, используйте ключ API Flatkey и задайте model в точности как псевдоним модели Flatkey. Затем протестируйте тот же базовый URL и псевдоним модели вне Continue, прежде чем полагаться на них в рабочем кодовом пространстве.
| Поле Continue | Значение Flatkey | Проверка при ревью |
|---|---|---|
provider |
openai |
Документация провайдера OpenAI в Continue показывает этот провайдер для OpenAI-compatible endpoints, когда переопределён apiBase. |
apiBase |
Текущий базовый URL Flatkey из вашей консоли или документации, например https://console.flatkey.ai/v1, если он подтверждён для вашей учётной записи |
Используйте только базовый URL. Не вставляйте полный endpoint /chat/completions в apiBase. |
apiKey |
Ключ Flatkey, принадлежащий нужному пользователю, команде или окружению | Используйте секрет или поток через переменную окружения, поддерживаемый вашей версией Continue. Не коммитьте ключ в открытом виде. |
model |
Точный alias модели Flatkey, включённый для этого ключа | Не используйте имя семейства вендора, если только Flatkey не предоставляет именно такой alias. |
roles and capabilities |
Назначайте только те роли, которые должна обслуживать модель, и добавляйте tool_use только после подтверждения поддержки инструментов/функций |
В документации Continue по capabilities tool_use связан с tools и functions, что важно для workflows Agent. |
Безопасная последовательность такая: скопируйте текущий базовый URL Flatkey, выберите видимый для аккаунта alias модели, протестируйте OpenAI-compatible endpoint, добавьте модель в Continue, выполните один запрос с низким риском и проверьте использование в Flatkey. Остальная часть этого руководства по Continue.dev OpenAI compatible provider превращает это в повторяемый рабочий сценарий.
Что подтверждают текущие документы Continue
Сейчас Continue документирует конфигурацию через config.yaml. В руководстве по конфигурации сказано, что локальная конфигурация хранится в ~/.continue/config.yaml на macOS/Linux и в %USERPROFILE%\.continue\config.yaml на Windows. Также указано, что Continue перезагружает конфигурацию при сохранении файла, что делает небольшое изменение провайдера простым для тестирования и отката.
Страница провайдера OpenAI показывает важный для Flatkey шаблон: запись модели может использовать provider: openai, имя модели, совместимое с OpenAI, переопределение apiBase и API-ключ. Это делает путь Continue.dev OpenAI compatible provider задачей настройки базового URL и alias модели, а не задачей реализации собственного провайдера.
Справочник config.yaml добавляет операционные детали. Модели Continue могут указывать роли, такие как chat, edit и autocomplete. Continue также может переопределять capabilities модели, включая tool_use и image_input, когда автоопределения недостаточно. Используйте эти поля осознанно. Модель, подходящая для autocomplete, может быть неправильным выбором для agent-style tool use.
Еще одна деталь конечной точки имеет значение: в документации Continue по провайдеру OpenAI описаны настройки endpoint, включая поведение legacy completions и отключение Responses API, когда маршруту модели нужен /chat/completions. На публичной странице цен Flatkey, которую я проверил для этой статьи, перечислены семейства endpoint, включая /v1/chat/completions и /v1/responses, но выбранный вами alias модели и разрешения аккаунта по-прежнему нужно проверить.
Значения Flatkey, которые нужно подтвердить перед редактированием Continue
Главная страница Flatkey, проверенная 29 июня 2026 года, имеет заголовок One API gateway for production AI teams и описывает единый доступ к моделям, маршрутизацию, биллинг, аналитику использования и операционные инструменты управления. В текущем примере кода на публичной странице используется https://console.flatkey.ai/v1/chat/completions, поэтому соответствующий базовый URL для конфигурации Continue будет https://console.flatkey.ai/v1, если именно это значение подтверждено в вашем аккаунте.
На странице цен Flatkey, проверенной в тот же день, указано, что сейчас на сайте доступно 635 включенных моделей от 23 провайдеров. Там также перечислены семейства endpoint для chat completions, responses, messages, images и video. Это факты каталога и публичных маршрутов, а не обещание, что каждый ключ может вызывать каждую модель. Перед сохранением маршрута Continue.dev OpenAI compatible provider убедитесь, что alias модели виден тому ключу Flatkey, который будет использовать Continue.
Если у вашей команды есть старые документы Flatkey, скрипты или посты в блоге, где упоминается другой базовый URL, не копируйте их вслепую. Считайте источником истины Flatkey Console или актуальную документацию аккаунта, а затем выполните предварительную проверку ниже с той же машины, где будет запущен Continue.
Пошагово: настройка Continue с Flatkey
- Подтвердите поверхность Continue. Решите, настраиваете ли вы расширение для IDE, CLI или существующую локальную установку. Поскольку на главной странице Continue теперь указано, что он был приобретён Cursor, перед новым развёртыванием проверьте поддержку и путь установки.
- Откройте активный
config.yaml. Используйте селектор конфигурации Continue и значок шестерёнки или откройте~/.continue/config.yamlна macOS/Linux либо%USERPROFILE%\.continue\config.yamlв Windows. - Запишите предыдущую запись модели. Сохраните старый provider, model, roles и endpoint flags, чтобы откат выполнялся простым копированием и вставкой.
- Скопируйте базовый URL Flatkey. Используйте базовый URL провайдера, например
https://console.flatkey.ai/v1, если он подтверждён для вашей учётной записи. Не включайте/chat/completionsвapiBase. - Выберите по одному псевдониму модели на каждую роль. Начните с модели для chat/edit и добавьте autocomplete только если у вас есть модель, настроенная для этой роли.
- Надёжно сохраните ключ Flatkey. Используйте шаблон с секретом, переменной окружения или локальными учётными данными, который поддерживается вашей версией Continue. Не добавляйте необработанный ключ в общую конфигурацию.
- Добавьте запись модели. Используйте
provider: openai,apiBaseFlatkey, псевдоним модели Flatkey и узкие роли. - Запустите предварительную проверку curl. Протестируйте тот же базовый URL, ключ и модель, прежде чем оценивать сам Continue.
- Выполните один безопасный запрос Continue. Используйте одноразовую ветку или неразрушающую задачу, затем проверьте использование Flatkey на наличие времени, модели, токенов и стоимости.
- Документируйте ответственность. Зафиксируйте, кто владеет ключом, кто может его ротировать, какой псевдоним модели утверждён и когда следует пересмотреть маршрут.
Шаблон config.yaml для Flatkey
Это шаблон, а не универсальная вставка без изменений. Замените заполнители значениями, подтверждёнными в вашей учётной записи Flatkey и в вашей текущей версии Continue.
name: Flatkey Continue Config
version: 0.0.1
schema: v1
models:
- name: Flatkey chat and edit
provider: openai
model: <flatkey-chat-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
roles:
- chat
- edit
- apply
capabilities:
- tool_use
defaultCompletionOptions:
maxTokens: 2000
- name: Flatkey autocomplete
provider: openai
model: <flatkey-autocomplete-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
roles:
- autocomplete
autocompleteOptions:
debounceDelay: 350
maxPromptTokens: 1024
Если выбранный вами маршрут модели испытывает проблемы с /responses, в документации Continue по провайдеру OpenAI описана опция useResponsesApi: false. Используйте её только после того, как у вас появятся основания считать, что модели, семейству endpoint или маршруту учётной записи для этой задачи нужен /chat/completions.
models:
- name: Flatkey chat completions only
provider: openai
model: <flatkey-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
useResponsesApi: false
roles:
- chat
- edit
Проверьте маршрут вне Continue
Небольшой тест с curl помогает отделить проблемы маршрутизации Flatkey от проблем конфигурации Continue. Используйте тот же базовый URL, ключ и псевдоним модели, которые вы планируете указать в config.yaml.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_CONTINUE_MODEL="replace-with-flatkey-model-alias"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_CONTINUE_MODEL"'",
"messages": [
{
"role": "user",
"content": "Return the word ok."
}
],
"max_tokens": 16
}'Для маршрута в стиле агента Continue.dev OpenAI compatible provider добавьте вторую проверку перед запуском с tool schema, если выбранной роли Continue нужен доступ к инструментам. Обычный ответ чата подтверждает транспорт, но не подтверждает поведение функций/инструментов.
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_CONTINUE_MODEL"'",
"messages": [
{
"role": "user",
"content": "Call route_check with status ok and no prose."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Return the route status.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Исправный ответ на использование инструментов должен включать структуру tool_calls в стиле OpenAI. Если этот запрос не проходит, исправьте ключ Flatkey, базовый URL, псевдоним модели, семейство endpoint или возможности модели, прежде чем снова менять Continue.
Контрольный список возможностей, роли и endpoint
| Решение | Что проверить | Почему это важно |
|---|---|---|
| Модель для chat/edit | Псевдоним модели может отвечать на вопросы по коду через выбранный endpoint Flatkey. | Это минимальное подтверждение для ориентированных на разработчиков ролей chat и edit. |
| Использование инструментов | Модель возвращает вызовы инструментов в стиле OpenAI в проверке через curl. | Документация Continue по возможностям модели связывает tool_use с tools и functions. |
| Autocomplete | Отдельная роль, более короткие подсказки, приемлемая задержка с машины разработчика. | У autocomplete другие ожидания по UX, чем у chat. |
| Responses API | Выбранный маршрут модели поддерживает endpoint, к которому обращается Continue. | Для некоторых комбинаций модели и шлюза требуется useResponsesApi: false. |
| Проверка использования | Flatkey показывает запрос под ожидаемым ключом, с временной меткой, моделью и стоимостью. | Финансовым и платформенным владельцам нужен один источник для сверки использования. |
Сначала отладьте такие режимы отказа
Большинство сбоев Continue.dev OpenAI compatible provider возникают из-за небольшого набора несоответствий. Проверьте их, прежде чем предполагать, что Continue или Flatkey недоступны.
| Симптом | Вероятная причина | Исправление |
|---|---|---|
| Конфигурация не загружается | Неверный файл, ошибка отступов YAML или в IDE выбрана устаревшая конфигурация. | Откройте конфигурацию через селектор Continue, проверьте YAML, сохраните и дождитесь перезагрузки. |
| Недействительный API key | Key был скопирован неверно, ротирован, ограничен другим окружением или принадлежит upstream provider. | Сгенерируйте или выберите правильный Flatkey key и повторно проверьте с помощью curl перед обновлением Continue. |
| Ошибка соединения | apiBase включает полный путь endpoint, использует старый base URL или машине не удается достичь route. |
Используйте только текущий base URL provider и проверьте с той же машины. |
| Model not found | Значение model в Continue не соответствует alias Flatkey, включенному для key. |
Скопируйте точный model alias из Flatkey pricing, catalog или списка models, видимого в account. |
| Сбой Tools или режима Agent | Выбранная модель не может обеспечить поведение tool/function, ожидаемое ролью. | Используйте модель с поддержкой tools и повторно выполните preflight tool-call перед установкой tool_use. |
| Ошибки, специфичные для endpoint | Continue вызывает /responses, хотя выбранный route должен использовать chat completions, или наоборот. |
Проверьте поддержку Flatkey endpoint и используйте флаги endpoint Continue только при необходимости. |
| Не удается сопоставить usage | Команда не записала владельца key, model alias, developer, environment или timestamp. | Добавьте строку в runbook, прежде чем расширять настройку на большее число developers. |
Production runbook для Continue plus Flatkey
Прежде чем больше developers начнут использовать route Continue.dev OpenAI compatible provider, зафиксируйте operational facts, которые делают возможными support и cost review.
| Поле runbook | Что записать |
|---|---|
| Owner | Team, developer group и человек, который может ротировать Flatkey key. |
| Поверхность Continue | IDE extension или CLI, версия, если доступна, и расположение config. |
| Flatkey base URL | Текущий approved base URL аккаунта и дата проверки. |
| Model aliases | Один alias на роль: chat/edit, apply, autocomplete или tool-use agent path. |
| Endpoint policy | Должен ли route использовать responses, chat completions или документированный fallback. |
| Cost review | Где в Flatkey будут просматриваться usage, token count, request status и cost. |
| Rollback | Предыдущая запись provider, старый model alias и approval owner для отката. |
Где это место в кластере инструментов Flatkey
Если ваша команда уже направляет другие инструменты через Flatkey, сохраните тот же рабочий подход для Continue. Руководство Cherry Studio API setup полезно для простых проверок base URL в десктоп-клиенте. Руководство CC Switch Claude Code Flatkey полезно для дисциплины маршрутизации developer-инструментов. Более широкий playbook OpenAI-compatible API migration — это место, где стоит стандартизировать изменения base URL, проверку alias модели и откат.
Ценность единого маршрутизатора — не только в меньшем числе ключей провайдеров. Она в возможности видеть, какой инструмент, модель, владелец ключа и workflow создали использование. Именно поэтому миграция Continue.dev OpenAI compatible provider должна завершаться проверкой использования в Flatkey, а не только работающим запросом.
Часто задаваемые вопросы
Continue по-прежнему поддерживает маршрутизацию, совместимую с OpenAI?
В текущей документации Continue для провайдера OpenAI показан паттерн конфигурации, совместимый с OpenAI, с использованием provider: openai, model, apiBase и apiKey. На главной странице также указано, что Continue был приобретён Cursor, поэтому перед новым развёртыванием проверьте вашу точную extension, CLI и путь поддержки.
Какой base URL Flatkey мне использовать?
Используйте текущий base URL провайдера из вашей учётной записи Flatkey. На публичной главной странице, проверенной для этой статьи, был указан https://console.flatkey.ai/v1/chat/completions, что соответствует https://console.flatkey.ai/v1 как base URL. Если в документации или консоли вашей учётной записи указано другое значение, приоритет за ним.
Один модель должна обрабатывать каждую роль Continue?
Не автоматически. Chat, edit, apply, autocomplete и agent-подобное использование инструментов могут иметь разные требования к задержке, контексту и возможностям. Начните с самой узкой роли и добавляйте новые роли после тестирования.
Нужен ли мне tool_use?
Только если для роли требуется поведение инструментов/функций и выбранная модель действительно может возвращать tool calls в стиле OpenAI. Continue может автоматически определять многие возможности, но его документация допускает overrides для пользовательских развёртываний или случаев, когда автодетект не работает.
Как следует обращаться с API key?
Не храните ключ Flatkey в файлах репозитория, скриншотах и общих комментариях к issue. Используйте локальный secret или паттерн переменной окружения, поддерживаемый вашей версией Continue, а затем зафиксируйте, кто владеет ключом и может его ротировать.
Итоговый чеклист
- Текущий интерфейс Continue проверен после уведомления о приобретении Cursor.
- Активный
config.yamlнайден и сохранён в резервной копии. - Base URL Flatkey скопирован из текущего источника учётной записи.
- Alias модели подтверждён для ключа Flatkey.
- Проверено поведение endpoint chat completions или responses.
- Проведён preflight для использования инструментов, когда роль требует tools.
- Использование просмотрено в Flatkey после первого безопасного запроса Continue.
- Зафиксированы ответственный за откат и предыдущая конфигурация.
Когда эти проверки завершены, маршрут Continue.dev OpenAI compatible provider превращается в управляемую интеграцию Flatkey, а не в ещё одни неуправляемые учётные данные разработчика. Если вы стандартизируете больше инструментов, сравните псевдонимы моделей и политику использования на странице тарифов Flatkey, затем получите ключ для рабочей области, которая будет владеть первым развёртыванием.
