Paseo с моделями PlusVibe

Пошаговая настройка Paseo с PlusVibeAPI: установка CLI, готовый config.json, защита от OAuth-переключения и проверка расходов.

Paseo — графическая программа для Windows и macOS. Установите приложение, затем подключите готовый набор из трёх провайдеров PlusVibe: Codex, Claude Code и OpenCode. Командная строка нужна только для установки этих трёх исполнительных CLI, а не для установки или обычного запуска Paseo.

1. Скачайте и установите Paseo Desktop

Откройте официальную страницу paseo.sh/download и скачайте версию для своей системы:

Параметр	Тип	Описание
`Windows`	установщик	Обычно нужен Intel / x64. Запустите скачанный Paseo-Setup-…-x64.exe и пройдите установку.
`macOS`	DMG	Apple Silicon — для Mac с чипом M1/M2/M3/M4 и новее; Intel — для старых Mac. Откройте DMG и перенесите Paseo в «Программы» (Applications).

Запустите Paseo из меню «Пуск» на Windows или из папки «Программы» на Mac. При первом запуске приложение само запускает локальный daemon — отдельно ставить Paseo через npm и вводить команду paseo не нужно.

На странице загрузки также показан npm-вариант, но он предназначен для серверов и работы без графического приложения. Для этой инструкции выбирайте блок Desktop.

2. Установите CLI для нужных провайдеров

Paseo Desktop управляет агентами, но сами Codex, Claude Code и OpenCode должны быть установлены в системе. Сначала установите актуальную LTS-версию Node.js с nodejs.org и после установки заново откройте терминал.

Как открыть терминал

Терминал — это окно, куда команды вводятся текстом. Открывается так:

Параметр	Тип	Описание
`Windows`	PowerShell	Нажмите Win + X → «Терминал» (или «Windows PowerShell»). Либо: Win + R, введите powershell, Enter.
`macOS`	Terminal	Нажмите Cmd + Пробел, наберите Терминал (или Terminal) и нажмите Enter.

Откроется окно с мигающим курсором. Команды ниже вставляйте по одной и после каждой нажимайте Enter. Вставка: на Windows — правая кнопка мыши или Ctrl + V, на macOS — Cmd + V. Установка занимает 1–3 минуты; пока идёт, окно закрывать нельзя.

Если нужен только один провайдер, можно установить только его CLI. Node.js нужен для команд ниже, но не для уже установленного Paseo Desktop.

Установите три CLI:

npm install -g @openai/codex @anthropic-ai/claude-code opencode-ai

Проверьте, что команды доступны:

codex --version
claude --version
opencode --version

3. Подключите готовый config.json

Скачать paseo-plusvibe-config.json. Переименуйте его в config.json и положите:

Параметр	Тип	Описание
`macOS / Linux`	путь	~/.paseo/config.json
`Windows`	путь	%USERPROFILE%\.paseo\config.json

Папка .paseo начинается с точки, поэтому по умолчанию она скрыта. Если её не видно — не создавайте новую, а покажите скрытые файлы:

Параметр	Тип	Описание
`Windows`	Проводник	Вставьте %USERPROFILE%\.paseo в адресную строку Проводника и нажмите Enter — папка откроется, даже если скрыта.
`macOS`	Finder	В Finder нажмите Cmd + Shift + G, введите ~/.paseo и нажмите Enter. Показать скрытые файлы: Cmd + Shift + . (точка).

Если папки .paseo ещё нет — запустите Paseo один раз и закройте: он создаст её сам. Так надёжнее, чем создавать вручную.

В текущем Paseo Desktop нет отдельной подтверждённой кнопки «Import config». Размещение файла под точным именем config.json в этой папке — штатный способ загрузить готовые custom providers.

Windows может сохранить файл как config.json.txt — расширение при этом не видно. Включите в Проводнике «Вид → Показать → Расширения имён файлов» и проверьте, что имя ровно config.json. Это самая частая причина, по которой Paseo «не видит» конфиг.

Скачиваемый файл — полный минимальный конфиг. Если Paseo уже настроен, сначала сохраните резервную копию и перенесите только три объекта из agents.providersв существующий файл. Не затирайте свои настройки и провайдеры.

4. Вставьте API-ключ

Откройте файл обычным текстовым редактором: на Windows — «Блокнот» (правой кнопкой по файлу → «Открыть с помощью» → «Блокнот»), на macOS — «TextEdit» (правой кнопкой → «Открыть в программе» → TextEdit). Не открывайте в Word или Pages — они добавят форматирование, и файл перестанет читаться.

Замените все три вхождения PASTE-YOUR-PLUSVIBE-API-KEY-HERE своим ключом из кабинета PlusVibe и сохраните (Ctrl + S на Windows, Cmd + S на macOS). Ключ вставляйте между кавычками, сами кавычки не удаляйте. Не публикуйте готовый файл и не добавляйте его в Git.

На macOS в TextEdit перед правкой выберите «Формат → Преобразовать в текстовый формат», если пункт доступен. Иначе файл сохранится как RTF и Paseo его не прочитает.

5. Обязательно удалите старые входы

Codex может повторно использовать сохранённый вход «Sign in with ChatGPT». Тогда запрос способен незаметно уйти прямо в OpenAI. Claude Code при заданном токене PlusVibe выбирает его раньше сохранённой подписки, но выход также исключает старую Apps Gateway-сессию. Выполните обе команды один раз:

codex logout
claude auth logout

Для OpenCode выход не нужен: авторизация хранится отдельно для каждого provider ID, а конфиг явно выбирает plusvibe, его адрес и ключ. Не выполняйте codex login --with-api-key с ключом PlusVibe.

6. Перезапустите и проверьте всё в Paseo

Не выбирайте Auto-review для Codex (PlusVibe), пока не обновили Codex CLI. При несовместимых версиях агент падает ещё до запуска с ошибкой unknown variant auto_review, expected user or guardian_subagent. Основное исправление: в терминале выполните npm install -g @openai/codex@latest, затем полностью закройте Paseo Desktop и откройте его заново. Одного Restart daemon для обновления уже запущенного приложения может быть недостаточно.

Снова откройте Paseo Desktop.
Откройте Настройки (Settings) → Host → Обзор (Overview) и нажмите Перезапустить демон (Restart daemon).
Откройте Настройки (Settings) → Host → Провайдеры (Providers). В списке должны появиться Codex (PlusVibe), Claude Code (PlusVibe) и OpenCode (PlusVibe).
Вернитесь в рабочее пространство и создайте агента. В нижнем выпадающем списке режима / разрешений на форме нового агента выберите Default Permissions («Разрешения по умолчанию» в переведённом интерфейсе). Это безопасный временный выбор для новичка. Не выбирайте Auto-review. Пункт Full Access даёт агенту выполнение без обычных запросов подтверждения и для решения этой ошибки не нужен.
Отправьте короткий тест: Ответь одним словом: готово.

Кнопка Refresh в карточке провайдера обновляет список моделей, но не заменяет Перезапустить демон (Restart daemon) после ручной замены всего config.json.

7. Проверьте, куда ушёл запрос

До теста откройте Расходы и запросы в кабинете PlusVibe.
Отправьте один тест из Paseo и дождитесь ответа.
Обновите страницу: должна появиться новая строка с выбранной моделью и списанием.

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

Решение частых проблем

«Command not found»

Закройте и заново откройте терминал. Если отсутствует только один CLI, повторите его команду установки из шага 2. Paseo Desktop переустанавливать не нужно.

Auto-review: unknown variant auto_review

Обновите Codex командой npm install -g @openai/codex@latest, полностью закройте Paseo Desktop и откройте снова. До исправления совместимости выбирайте в нижнем списке режима Default Permissions. Если уже упавшая сессия не применяет новый режим, создайте нового агента или новую вкладку и выберите его до отправки сообщения.

401 или в файле осталась заглушка

Найдите и замените все три вхождения заглушки, проверьте запятые и кавычки, затем в Paseo откройте Настройки (Settings) → Host → Обзор (Overview) → Перезапустить демон (Restart daemon).

Codex отвечает, но расхода PlusVibe нет

Снова выполните codex logout, проверьте codex login status, перезапустите daemon через Settings и выбирайте только Codex (PlusVibe).

Claude просит войти или показывает Gateway

Выполните claude auth logout, проверьте ключ и заново запустите провайдер claude-plusvibe.

OpenCode: «Provider not found: plusvibe»

Убедитесь, что в provider env есть OPENCODE_CONFIG_CONTENT, файл сохранился как настоящий JSON, и перезапустите daemon через Settings.

Qwen3.8 не появился или запускается со старой ошибкой

Снова скачайте актуальный paseo-plusvibe-config.json: ранее сохранённая копия сама не обновляется.
Полностью закройте Paseo Desktop. Замените старый config.json в папке .paseo новым файлом и снова вставьте свой ключ во все три заглушки. Не отправляйте этот файл в поддержку.
Откройте Paseo, выполните Settings → Host → Overview → Restart daemon и создайте нового агента: старая вкладка может продолжать использовать прежнюю модель.
Выберите именно OpenCode (PlusVibe), затем Qwen3.8 Max Preview. Qwen не относится к провайдеру Codex (PlusVibe).

Если ошибка повторяется, сделайте снимок только области с названием провайдера, моделью и полным текстом ошибки. Ключ и содержимое config.json закройте или обрежьте. Также можно скопировать одну строку ошибки из окна агента — без сообщений задачи, ключа и переменных окружения.

Официальные источники

← ПредыдущийАгенты и IDE Следующий →Pi Agent