models.mdx 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224
  1. ---
  2. title: Modelos
  3. description: Configuración de un proveedor y modelo LLM.
  4. ---
  5. OpenCode usa el [AI SDK](https://ai-sdk.dev/) y [Models.dev](https://models.dev) para admitir **75+ proveedores LLM** y admite la ejecución de modelos locales.
  6. ---
  7. ## Proveedores
  8. Los proveedores más populares están precargados de forma predeterminada. Si agregó las credenciales de un proveedor mediante el comando `/connect`, estarán disponibles cuando inicie OpenCode.
  9. Obtenga más información sobre [proveedores](/docs/providers).
  10. ---
  11. ## Selecciona un modelo
  12. Una vez que hayas configurado tu proveedor podrás seleccionar el modelo que desees escribiendo:
  13. ```bash frame="none"
  14. /models
  15. ```
  16. ---
  17. ## Modelos recomendados
  18. Hay muchos modelos disponibles y cada semana salen nuevos modelos.
  19. :::tip
  20. Considere utilizar uno de los modelos que recomendamos.
  21. :::
  22. Sin embargo, sólo unos pocos de ellos son buenos tanto para generar código como para llamar a herramientas.
  23. Aquí hay varios modelos que funcionan bien con OpenCode, sin ningún orden en particular. (Esta no es una lista exhaustiva ni necesariamente actualizada):
  24. -GPT 5.2
  25. - Códice GPT 5.1
  26. - Claude Opus 4.5
  27. - Claude Soneto 4.5
  28. -Minimax M2.1
  29. - Géminis 3 Pro
  30. ---
  31. ## Establecer un valor predeterminado
  32. Para configurar uno de estos como modelo predeterminado, puede configurar la tecla `model` en su
  33. OpenCode configuración.
  34. ```json title="opencode.json" {3}
  35. {
  36. "$schema": "https://opencode.ai/config.json",
  37. "model": "lmstudio/google/gemma-3n-e4b"
  38. }
  39. ```
  40. Aquí el ID completo es `provider_id/model_id`. Por ejemplo, si usa [OpenCode Zen](/docs/zen), usaría `opencode/gpt-5.1-codex` para GPT 5.1 Codex.
  41. Si ha configurado un [proveedor personalizado](/docs/providers#custom), `provider_id` es la clave de la parte `provider` de su configuración y `model_id` es la clave de `provider.models`.
  42. ---
  43. ## Configurar modelos
  44. Puede configurar globalmente las opciones de un modelo a través de la configuración.
  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. Aquí estamos configurando ajustes globales para dos modelos integrados: `gpt-5` cuando se accede a través del proveedor `openai` y `claude-sonnet-4-20250514` cuando se accede a través del proveedor `anthropic`.
  77. Los nombres de modelo y proveedor integrados se pueden encontrar en [Models.dev](https://models.dev).
  78. También puede configurar estas opciones para cualquier agente que esté utilizando. La configuración del agente anula cualquier opción global aquí. [Más información](/docs/agents/#additional).
  79. También puede definir variantes personalizadas que amplíen las integradas. Las variantes le permiten configurar diferentes ajustes para el mismo modelo sin crear entradas duplicadas:
  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. ## Variantes
  107. Muchos modelos admiten múltiples variantes con diferentes configuraciones. OpenCode se envía con variantes predeterminadas integradas para proveedores populares.
  108. ### Variantes integradas
  109. OpenCode se envía con variantes predeterminadas para muchos proveedores:
  110. **Anthropic**:
  111. - `high` - Presupuesto de pensamiento alto (predeterminado)
  112. - `max` - Presupuesto de pensamiento máximo
  113. **OpenAI**:
  114. Varía según el modelo, pero aproximadamente:
  115. - `none` - Sin razonamiento
  116. - `minimal` - Mínimo esfuerzo de razonamiento
  117. - `low` - Bajo esfuerzo de razonamiento
  118. - `medium` - Esfuerzo de razonamiento medio
  119. - `high` - Alto esfuerzo de razonamiento
  120. - `xhigh` - Esfuerzo de razonamiento extra alto
  121. **Google**:
  122. - `low` - Menor esfuerzo/presupuesto simbólico
  123. - `high` - Mayor esfuerzo/presupuesto simbólico
  124. :::tip
  125. Esta lista no es exhaustiva. Muchos otros proveedores también tienen valores predeterminados integrados.
  126. :::
  127. ### Variantes personalizadas
  128. Puede anular las variantes existentes o agregar las suyas propias:
  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. ### Variantes de ciclo
  152. Utilice la combinación de teclas `variant_cycle` para cambiar rápidamente entre variantes. [Más información](/docs/keybinds).
  153. ---
  154. ## Cargando modelos
  155. Cuando se inicia OpenCode, busca modelos en el siguiente orden de prioridad:
  156. 1. El indicador de línea de comando `--model` o `-m`. El formato es el mismo que en el archivo de configuración: `provider_id/model_id`.
  157. 2. La lista de modelos en la configuración OpenCode.
  158. ```json title="opencode.json"
  159. {
  160. "$schema": "https://opencode.ai/config.json",
  161. "model": "anthropic/claude-sonnet-4-20250514"
  162. }
  163. ```
  164. El formato aquí es `provider/model`.
  165. 3. El último modelo utilizado.
  166. 4. El primer modelo que utiliza una prioridad interna.