Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Руководство по настройке OpenCode

Руководство по установке OpenCode и переключению моделей для терминальной и настольной версий.

Для каких сценариев подходит: OpenCode — инструмент программирования с ИИ с открытым исходным кодом, доступный в терминальной и настольной версиях. Материал изложен в следующем порядке: «установка OpenCode → настройка модели с LLM API Gateway → переключение модели в терминальной/настольной версии → проверка».

ПараметрРекомендуемое значениеПояснение
Base URLhttps://api.llm-token.cn/v1Сначала используйте корневой путь с /v1; при ошибке удалите его.
API Keysk-xxxxxxxxУкажите полный ключ LLM API Gateway.
Model IDПолное имя модели из списка моделейДолжно совпадать посимвольно.

I. Установка OpenCode

Выберите любой способ установки. После установки достаточно убедиться, что команда opencode запускает программу в терминале.

Система / способКоманда
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
Скрипт установки
curl -fsSL https://opencode.ai/install | bash

Настольную версию рекомендуется скачать и установить с официального сайта: https://opencode.ai/. Терминальная и настольная версии могут использовать одну и ту же конфигурацию моделей.

II. Добавление провайдера LLM API Gateway через CC Switch

Если вы привыкли работать с CC Switch, добавьте собственного провайдера по приведённым ниже снимкам экрана.

  1. Откройте CC Switch, найдите нужный пункт и выберите добавление собственного провайдера.
  2. Укажите имя поставщика услуг, например «LLM API Gateway».
  3. В поле Base URL укажите https://api.llm-token.cn/v1.
  4. В поле API Key укажите полный ключ.
  5. В поле Model ID укажите полное имя модели из списка моделей.

На изображении показан интерфейс CC Switch в терминале OpenCode. В верхней части находятся надпись «CC Switch» и несколько значков. В центре отображается сообщение о том, что поставщики ещё не добавлены, а также кнопки импорта текущей конфигурации и добавления поставщика. Красная стрелка указывает на значок «+» в правом верхнем углу. Изображение относится к разделу о переключении модели в терминале и соответствует шагу 4: после перехода к списку собственных моделей нужно выбрать только что настроенную модель. Оно наглядно показывает, где в терминальном интерфейсе находится пункт добавления поставщика.На изображении показан интерфейс CC Switch в терминале OpenCode. В верхн…

На изображении показан экран добавления нового поставщика при переключении модели в терминале OpenCode. Здесь есть несколько полей ввода, включая имя поставщика, API Key и Base URL; красные стрелки указывают на данные, которые нужно ввести согласно шагу добавления нового поставщика: «my - provider», API Key, Base URL и другие. В нижней части также находится кнопка добавления модели, позволяющая добавить нужную модель. Изображение наглядно демонстрирует экран добавления нового поставщика при переключении модели в терминале и основные поля ввода.На изображении показан экран добавления нового поставщика при переключен…

III. Переключение модели в терминале

  1. Откройте терминал и выполните opencode.
  2. После запуска OpenCode нажмите Ctrl + P.
  3. Найдите Switch Model и нажмите Enter.
  4. Перейдите к списку собственных моделей и выберите только что настроенную модель.
opencode

Это снимок терминального интерфейса OpenCode. В верхней части показано обозначение «OpenCode», в поле ввода — подсказка «Ask anything... 'Fix a TODO in the codebase'». Текущей моделью явно указана «GPT-5.5 OpenAI». Также видна подсказка «Tip:/themes or Ctrl+X T to switch between 33 built-in themes», а в правом нижнем углу — номер версии «1.14.30». Этот экран соответствует этапу переключения модели в терминале: здесь пользователь может выбрать другую модель после запуска OpenCode.Это снимок терминального интерфейса OpenCode. В верхней части показано о…

Ctrl + P

На изображении показан терминальный интерфейс OpenCode с командной строкой и фрагментом кода. Открыто меню команд, в котором команда «Switch model» выделена оранжевым, а справа от неё указано сочетание клавиш «ctrl+x m». Изображение относится к разделу «III. Переключение модели в терминале» и наглядно показывает, как найти команду «Switch Model» и нажать Enter.На изображении показан терминальный интерфейс OpenCode с командной строк…

На изображении показан терминальный интерфейс OpenCode со страницей выбора модели «Select model». На странице представлены несколько встроенных моделей, ниже — вариант «custom» и собственная модель «gpt-5.5», выделенная оранжевым как выбранная. Внизу также указаны сочетания клавиш, например ctrl+a для Connect provider и ctrl+f для Favorite. Изображение соответствует этапу выбора ранее настроенной модели из списка собственных моделей в терминале.На изображении показан терминальный интерфейс OpenCode со страницей выбо…

IV. Использование настольной версии

Откройте настольную версию OpenCode, найдите в области выбора модель, настроенную в CC Switch, выберите её и приступайте к работе.

На изображении показан интерфейс настольной версии OpenCode в тёмной теме. Слева отображается раздел о создании чего угодно; красная стрелка выделяет расположенный внизу вариант «Big Pickle» и указывает прямо на него. Справа находится функция создания репозитория Git. Изображение относится к разделу об использовании настольной версии и показывает расположение ключевого элемента интерфейса для настройки.На изображении показан интерфейс настольной версии OpenCode в тёмной тем…

На изображении показан интерфейс настольной версии OpenCode для добавления собственной модели. Слева раскрыто меню выбора модели с вариантами GPT-4 nano, GPT-4.5 и другими; красная стрелка указывает на пункт «gpt-5.5». В центре синим текстом выделена подсказка: далее можно нажать соответствующую область, чтобы добавить большую языковую модель, выбрав при добавлении собственную модель. Изображение относится к работе в настольной версии и помогает выполнить ключевой шаг добавления модели.На изображении показан интерфейс настольной версии OpenCode для добавлен…

V. Проверка и распространённые проблемы

СимптомРешение
opencode не запускаетсяСнова откройте терминал и убедитесь, что путь установки npm / brew добавлен в PATH.
В списке моделей нет собственной моделиУбедитесь, что конфигурация сохранена в CC Switch, и перезапустите OpenCode.
Запрос завершается ошибкойПроверьте Base URL, API Key и ID модели; сначала используйте https://api.llm-token.cn/v1.
Модель отвечает медленноПроверьте работу с моделью, обеспечивающей быстрый отклик, например claude-sonnet-4-6 или MiniMax-M3-highspeed.