models.mdx 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  1. ---
  2. title: Модели
  3. description: Настройка поставщика и модели LLM.
  4. ---
  5. opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](https://models.dev) для поддержки **более 75 поставщиков LLM** и поддерживает запуск локальных моделей.
  6. ---
  7. ## Провайдеры
  8. Большинство популярных провайдеров предварительно загружены по умолчанию. Если вы добавили учетные данные для поставщика с помощью команды `/connect`, они будут доступны при запуске opencode.
  9. Узнайте больше о [providers](/docs/providers).
  10. ---
  11. ## Выберите модель
  12. После того, как вы настроили своего провайдера, вы можете выбрать нужную модель, введя:
  13. ```bash frame="none"
  14. /models
  15. ```
  16. ---
  17. ## Рекомендуемые модели
  18. Моделей очень много, новые выходят каждую неделю.
  19. :::tip
  20. Рассмотрите возможность использования одной из моделей, которые мы рекомендуем.
  21. :::
  22. Однако лишь немногие из них хороши как в генерации кода, так и в вызове инструментов.
  23. Вот несколько моделей, которые хорошо работают с opencode (в произвольном порядке). (Это не исчерпывающий список и не обязательно актуальный):
  24. - GPT 5.2
  25. - Кодекс GPT 5.1
  26. - Claude Opus 4.5
  27. - Claude Sonnet 4.5
  28. - MiniMax M2.1
  29. - Gemini 3 Pro
  30. ---
  31. ## Установить значение по умолчанию
  32. Чтобы установить одну из них в качестве модели по умолчанию, вы можете установить ключ `model` в вашем
  33. Конфигурация opencode.
  34. ```json title="opencode.json" {3}
  35. {
  36. "$schema": "https://opencode.ai/config.json",
  37. "model": "lmstudio/google/gemma-3n-e4b"
  38. }
  39. ```
  40. Здесь полный идентификатор `provider_id/model_id`. Например, если вы используете [OpenCode Zen](/docs/zen), вы должны использовать `opencode/gpt-5.1-codex` для кодекса GPT 5.1.
  41. Если вы настроили [пользовательский поставщик](/docs/providers#custom), `provider_id` — это ключ из части `provider` вашей конфигурации, а `model_id` — это ключ из `provider.models`.
  42. ---
  43. ## Настройка моделей
  44. Вы можете глобально настроить параметры модели через файл config.
  45. ```jsonc title="opencode.jsonc" {7-12,19-24}
  46. {
  47. "$schema": "https://opencode.ai/config.json",
  48. "provider": {
  49. "openai": {
  50. "models": {
  51. "gpt-5": {
  52. "options": {
  53. "reasoningEffort": "high",
  54. "textVerbosity": "low",
  55. "reasoningSummary": "auto",
  56. "include": ["reasoning.encrypted_content"],
  57. },
  58. },
  59. },
  60. },
  61. "anthropic": {
  62. "models": {
  63. "claude-sonnet-4-5-20250929": {
  64. "options": {
  65. "thinking": {
  66. "type": "enabled",
  67. "budgetTokens": 16000,
  68. },
  69. },
  70. },
  71. },
  72. },
  73. },
  74. }
  75. ```
  76. Здесь мы настраиваем глобальные параметры для двух встроенных моделей: `gpt-5` при доступе через поставщика `openai` и `claude-sonnet-4-20250514` при доступе через поставщика `anthropic`.
  77. Названия встроенных поставщиков и моделей можно найти на сайте [Models.dev](https://models.dev).
  78. Вы также можете настроить эти параметры для любых используемых вами агентов. Конфигурация агента переопределяет любые глобальные параметры здесь. [Подробнее](/docs/agents/#additional).
  79. Вы также можете определить собственные варианты, расширяющие встроенные. Варианты позволяют настраивать разные параметры для одной и той же модели без создания повторяющихся записей:
  80. ```jsonc title="opencode.jsonc" {6-21}
  81. {
  82. "$schema": "https://opencode.ai/config.json",
  83. "provider": {
  84. "opencode": {
  85. "models": {
  86. "gpt-5": {
  87. "variants": {
  88. "high": {
  89. "reasoningEffort": "high",
  90. "textVerbosity": "low",
  91. "reasoningSummary": "auto",
  92. },
  93. "low": {
  94. "reasoningEffort": "low",
  95. "textVerbosity": "low",
  96. "reasoningSummary": "auto",
  97. },
  98. },
  99. },
  100. },
  101. },
  102. },
  103. }
  104. ```
  105. ---
  106. ## Варианты
  107. Многие модели поддерживают несколько вариантов с разными конфигурациями. opencode поставляется со встроенными вариантами по умолчанию для популярных провайдеров.
  108. ### Встроенные варианты
  109. opencode поставляется с вариантами по умолчанию для многих провайдеров:
  110. **Anthropic**:
  111. - `high` — Бюджет рассуждений: высокий (по умолчанию)
  112. - `max` — Максимальный бюджет рассуждений
  113. **OpenAI**:
  114. Зависит от модели, но примерно:
  115. - `none` — Без рассуждений.
  116. - `minimal` — Минимальные усилия для рассуждений
  117. - `low` — Низкие усилия для рассуждений.
  118. - `medium` — Средние усилия для рассуждений.
  119. - `high` — Высокие усилия для рассуждений.
  120. - `xhigh` — Сверхвысокие усилия для рассуждений.
  121. **Google**:
  122. - `low` – меньший бюджет усилий/токенов.
  123. - `high` — более высокий бюджет усилий/токенов
  124. :::tip
  125. Этот список не является исчерпывающим. Многие другие провайдеры также имеют встроенные настройки по умолчанию.
  126. :::
  127. ### Пользовательские варианты
  128. Вы можете переопределить существующие варианты или добавить свои собственные:
  129. ```jsonc title="opencode.jsonc" {7-18}
  130. {
  131. "$schema": "https://opencode.ai/config.json",
  132. "provider": {
  133. "openai": {
  134. "models": {
  135. "gpt-5": {
  136. "variants": {
  137. "thinking": {
  138. "reasoningEffort": "high",
  139. "textVerbosity": "low",
  140. },
  141. "fast": {
  142. "disabled": true,
  143. },
  144. },
  145. },
  146. },
  147. },
  148. },
  149. }
  150. ```
  151. ### Переключение вариантов
  152. Используйте сочетание клавиш `variant_cycle` для быстрого переключения между вариантами. [Подробнее ](/docs/keybinds).
  153. ---
  154. ## Загрузка моделей
  155. Когда opencode запускается, он проверяет модели в следующем порядке приоритета:
  156. 1. CLI-флаг `--model` или `-m`. Формат тот же, что и в файле конфигурации: `provider_id/model_id`.
  157. 2. Список моделей в конфигурации opencode.
  158. ```json title="opencode.json"
  159. {
  160. "$schema": "https://opencode.ai/config.json",
  161. "model": "anthropic/claude-sonnet-4-20250514"
  162. }
  163. ```
  164. Здесь используется формат `provider/model`.
  165. 3. Последняя использованная модель.
  166. 4. Первая модель, использующая внутренний приоритет.