文档
Documentación en Español
Modos

Modos

Los modos personalizan el comportamiento de opencode para diferentes flujos de trabajo. Te permiten configurar la selección de modelo, temperatura, prompts y acceso a herramientas para casos de uso específicos.

Modos Integrados

Modo Build

El modo predeterminado con acceso completo a herramientas para trabajo de desarrollo estándar. Todas las herramientas están habilitadas.

Modo Plan

Un modo restringido diseñado para planificación y análisis. Las siguientes herramientas están deshabilitadas por defecto:

  • write
  • edit
  • patch
  • bash

Cambia entre modos usando la tecla Tab durante una sesión.

Opciones de Configuración

OpciónPropósito
modelAnula el modelo de IA predeterminado
temperatureAleatoriedad de respuesta (0.0-1.0)
promptInstrucciones del sistema personalizadas mediante referencia de archivo
toolsHabilita/deshabilita capacidades específicas

Herramientas Disponibles

  • bash - Ejecutar comandos de shell
  • edit - Editar archivos existentes
  • write - Crear nuevos archivos
  • read - Leer contenido de archivos
  • grep - Buscar en contenido de archivos
  • glob - Encontrar archivos por patrón
  • list - Listar contenido de directorios
  • patch - Aplicar parches
  • todowrite - Escribir en lista de tareas
  • todoread - Leer lista de tareas
  • webfetch - Obtener contenido web

Métodos de Configuración

Configuración JSON

Agrega a opencode.json:

{
  "agent": {
    "debug": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4",
      "temperature": 0.2,
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Configuración Markdown

Crea archivos en .opencode/mode/ (proyecto) o ~/.config/opencode/mode/ (global):

---
description: Modo debug para investigación
mode: primary
temperature: 0.2
tools:
  write: false
  edit: false
---
Estás en modo debug. Concéntrate en investigar problemas sin hacer cambios.

Casos de Uso Comunes

Modo de Revisión de Código

{
  "agent": {
    "review": {
      "mode": "primary",
      "description": "Reviews code for quality and security",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    }
  }
}

Modo de Documentación

{
  "agent": {
    "docs": {
      "mode": "primary",
      "description": "Writes and updates documentation",
      "model": "anthropic/claude-sonnet-4",
      "temperature": 0.3
    }
  }
}

Modo de Refactorización

{
  "agent": {
    "refactor": {
      "mode": "primary",
      "description": "Refactors code with careful analysis",
      "temperature": 0.1
    }
  }
}

Cambiar Modos

  • Presiona Tab para alternar entre modos primarios
  • Usa atajos de teclado configurados para acceso directo
  • Los modos persisten dentro de una sesión hasta que se cambian