Как подключить OpenRouter к OpenCode: 4 шага и выбор модели

Коротко

• OpenCode — AI-агент для терминала; чтобы он заработал, ему нужен ключ доступа к моделям, и самый простой вариант — ключ OpenRouter (агрегатор доступа к множеству моделей по API).
• Ключ подключается командой /connect внутри OpenCode или opencode auth login из терминала — выбираете провайдера OpenRouter и вставляете ключ вида sk-or-v1-....
• Ключ хранится только локально, в файле ~/.local/share/opencode/auth.json, и никуда не отправляется, кроме самого OpenRouter.
• Переключение модели — командой /models: для рутинных задач достаточно экономичной модели, для тяжёлых (длинный контекст, сложный код, ревью) — переключайтесь на более мощную.
• Ключ — это секрет: не показывайте его на экране, не вставляйте в слайды, чаты и репозитории.

Что нужно заранее

• Аккаунт в сервисе, к которому вы обычно обращаетесь напрямую (например, ChatGPT) — если ключ OpenRouter используется как дополнение, а не замена.
• Ключ OpenRouter — персональный, с установленным лимитом расходов; выглядит как sk-or-v1-....

Ключ — секрет: не показывайте его на экране, не вставляйте в слайды, чат и репозиторий.

Приватность

Если ключ выдан через общий аккаунт OpenRouter организации (например, для группового обучения), настройки приватности (запрет обучения на запросах, выключенное логирование) обычно уже включены централизованно на уровне аккаунта — заходить в настройки OpenRouter не требуется, если у вас на руках только ключ. Для личного аккаунта эти настройки стоит проверить самостоятельно в кабинете OpenRouter.

Шаг 1. Откройте OpenCode

OpenCode — это AI-агент для терминала. Если он ещё не установлен — ставится по инструкции с opencode.ai.

Шаг 2. Вставьте ключ

Самый простой путь — внутри OpenCode выполнить команду подключения:

/connect

Выберите провайдера OpenRouter и вставьте свой ключ sk-or-v1-....

Альтернатива из терминала:

opencode auth login

→ выбрать OpenRouter → вставить ключ. Ключ сохранится локально в файле ~/.local/share/opencode/auth.json (никуда не отправляется, кроме OpenRouter).

Шаг 3. Выберите модель

Переключение модели — командой:

/models

• Для повседневной практики (по умолчанию) — берите экономичную модель, её хватает для базовых задач и она бережёт кредит.
• Для тяжёлых задач (длинный контекст, сложный код, ревью) — переключитесь на более мощную модель.

Точный идентификатор модели имеет формат openrouter/<провайдер>/<модель>. Если видите ошибку «Model Not Found» — сверьте slug на openrouter.ai/models.

Шаг 4. Проверьте, что всё работает

Задайте короткий тестовый запрос, например: «Привет, ответь одним словом: готов». Если ответ пришёл — подключение работает.

Правила по данным

• Работайте только с учебным кодом и тестовыми данными, если ключ выдан для обучения или пробного периода.
• Не вставляйте в OpenCode рабочий код, внутренние документы, реальные журналы и секреты, если это не согласовано отдельно для вашей задачи.
• Реальные рабочие кейсы обсуждайте в обезличенной форме.

Если что-то не работает

• Кредит закончился или ключ не отвечает дольше ~10 минут — не тратьте на это время, проверьте баланс и лимит ключа на OpenRouter.
• Ассистент/агент должен запрашивать ваше согласие на действия и не вводить за вас ключи и пароли самостоятельно.

Что почитать дальше

• Честно про AI: агенты, скиллы и MCP для руководителя — в базе сообщества
• Персональный ИИ-агент 24/7: разворачиваем Hermes на своём сервере

Частые вопросы

Что такое OpenRouter и зачем он нужен для OpenCode?

OpenRouter — агрегатор доступа к множеству моделей по единому API. Ключ OpenRouter даёт OpenCode доступ к моделям без отдельной интеграции под каждого провайдера.

Как подключить ключ OpenRouter в OpenCode?

Командой /connect внутри OpenCode или opencode auth login из терминала — выбрать провайдера OpenRouter и вставить ключ вида sk-or-v1-....

Где хранится ключ после подключения?

Локально, в файле ~/.local/share/opencode/auth.json. Никуда, кроме самого OpenRouter, ключ не отправляется.

Какую модель выбрать по умолчанию?

Экономичную — её хватает для базовых задач и она бережёт лимит ключа. Для тяжёлых задач (длинный контекст, сложный код, ревью) переключайтесь на более мощную модель командой /models.

Что делать при ошибке «Model Not Found»?

Сверить точный идентификатор модели (формат openrouter/<провайдер>/<модель>) со списком на openrouter.ai/models.