Continue + NeuroAPI: config.yaml и ключ API

Настройка Continue состоит из двух независимых частей: ключ и модель на стороне NeuroAPI и конфигурация на стороне расширения. Сначала создайте API-ключ в разделе «Токены» личного кабинета и выберите тариф при создании. Затем откройте /price и найдите модель, с которой будете работать: скопируйте её точное имя.

Для Continue важны не только название модели, но и её возможности: поддержка вызова инструментов нужна для агентного режима, приём изображений — для скриншотов и макетов, а размер контекста влияет на то, какие файлы расширение сможет передать в одном запросе. Все эти флаги есть в карточке модели, и их стоит проверить до первой задачи.

• API-ключ NeuroAPI лучше выпустить отдельно под Continue: расход будет виден отдельной строкой.
• Скопируйте точный Model ID из /price или из GET /v1/models.
• Проверьте в карточке модели поддержку tools, изображений и размер контекста.
• Не храните ключ в репозитории: для конфигурации используйте секреты Continue.

Современная документация Continue описывает config.yaml со схемой v1. Файл начинается с name, version и schema, а нужная модель добавляется в массив models. Обязательные поля для подключения — name (произвольная подпись), provider: openai, model (точный Model ID) и apiBase с адресом NeuroAPI. Ключ передаётся через apiKey или ссылку на секрет вида ${{ secrets.NEUROAPI_API_KEY }}.

Дополнительные поля стоит добавлять осознанно. roles определяет, где модель используется: chat, edit, apply, autocomplete. capabilities принудительно включает возможности — tool_use для агентного режима, image_input для изображений. defaultCompletionOptions задаёт contextLength и maxTokens, а requestOptions.timeout ограничивает время ожидания. Если включить слишком длинный контекст для модели, которая его не поддерживает, запрос вернёт ошибку.

• name — подпись модели в интерфейсе Continue.
• provider: openai — обязательный OpenAI-совместимый адаптер.
• model — точный ID из каталога, а не «GPT» или «Claude».
• apiBase — https://neuroapi.host/v1.
• apiKey — ключ NeuroAPI или ссылка на секрет.
• capabilities — tool_use и image_input по необходимости.

Начните с короткого вопроса в чате. Если ответ получен, ключ, адрес и модель настроены верно. Затем попросите Continue выполнить простое действие с файлом: это проверит режим редактирования. Агентный режим проверяется отдельно — задачей, где расширение должно прочитать файл или вызвать инструмент.

Роль autocomplete требует, чтобы модель поддерживала соответствующий режим дополнения кода. Если вы не уверены в этом, оставьте в roles только chat и edit: так вы точно не потратите время на отладку автодополнения, которое модель не поддерживает. Для проверки адреса и ключа вне Continue удобно запросить список моделей через GET /v1/models.

• Короткий вопрос в чате — проверка авторизации и модели.
• Изменение файла — проверка режима edit.
• Задача с инструментом — проверка tool_use и агентного режима.
• GET /v1/models — проверка, что ключ видит нужные модели.

Ответ 401 означает, что ключ не принят: проверьте, что в apiKey указан ключ NeuroAPI, а не другого сервиса, и что он не отозван. Ошибка 404 по модели — почти всегда опечатка в Model ID или недоступность модели на выбранном тарифе. Ответ 429 говорит о превышении лимита запросов: повторите позже и проверьте настройки повторов.

Если запрос обрывается на длинной задаче, вероятны две причины: контекст превышает возможности модели или запрос упирается в таймаут. Уменьшите набор файлов, снизьте contextLength в конфигурации и увеличьте timeout для медленных моделей. При ошибках 5xx повторы допустимы, но не стоит пересылать один и тот же дорогой агентный запрос бесконечно — следите за расходом.

• 401 — сверьте ключ и заголовок Authorization: Bearer.
• 404 — проверьте Model ID и тариф ключа.
• 429 — сбавьте темп и повторите позже.
• Таймаут — сократите контекст и увеличьте requestOptions.timeout.

Тариф выбирается при создании ключа и определяет маршрут запроса. Пилот использует экономичные каналы и допускает перебои, Смарт делает одну попытку Пилота и при безопасной ошибке переходит к цепочке Оптимального, Оптимальный работает через официальные каналы. Разные ключи одного аккаунта могут иметь разные тарифы, поэтому для экспериментов и для production разумно держать отдельные ключи.

Агентные задачи расходуют больше, чем чат: каждый шаг отправляет расширенный контекст заново. Начните с ограниченного набора файлов и явной формулировки задачи, а длинные исследования и массовые правки планируйте отдельно. Баланс предоплаченный, списание идёт по фактическому использованию, а история расхода видна в кабинете.

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

• Отдельный ключ под Continue — прозрачный бюджет.
• Пилот дешевле, Оптимальный стабильнее, Смарт — компромисс.
• Агентные цепочки дороже коротких вопросов.
• Ограничивайте контекст и число файлов в задаче.