文档
Documentación en Español
Configuración

Configuración

OpenCode utiliza un sistema de configuración JSON para personalización. El esquema de configuración está definido en opencode.ai/config.json, permitiendo validación del editor y soporte de autocompletado.

Soporte de Formato

OpenCode acepta tanto formatos JSON como JSONC (JSON con Comentarios).

{
  "$schema": "https://opencode.ai/config.json",
  "theme": "opencode",
  "model": "anthropic/claude-sonnet-4-5",
  "autoupdate": true
}

Ubicaciones de Configuración y Precedencia

Los ajustes se fusionan en lugar de reemplazarse. El orden de carga (fuentes posteriores anulan conflictos):

  1. Configuración remota – Valores predeterminados organizacionales de .well-known/opencode
  2. Configuración global – Preferencias del usuario en ~/.config/opencode/opencode.json
  3. Configuración personalizada – Variable de entorno OPENCODE_CONFIG
  4. Configuración del proyecto – opencode.json en la raíz del proyecto
  5. Directorios .opencode – Agentes, comandos, plugins
  6. Configuración inline – Variable de entorno OPENCODE_CONFIG_CONTENT

Configuración Global

Coloca preferencias de usuario en ~/.config/opencode/opencode.json:

{
  "theme": "catppuccin",
  "model": "anthropic/claude-sonnet-4-5"
}

Configuración del Proyecto

Agrega opencode.json a la raíz de tu proyecto para ajustes específicos del proyecto.

Ruta Personalizada

export OPENCODE_CONFIG=/path/to/config.json
opencode run "Hello world"

Esquema de Configuración

Ajustes TUI

{
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    },
    "diff_style": "auto"
  }
}

Ajustes del Servidor

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["http://localhost:5173"]
  }
}

Configuración de Herramientas

{
  "tools": {
    "write": false,
    "bash": false
  }
}

Modelos y Proveedores

{
  "provider": {},
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

Agentes

{
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "model": "anthropic/claude-sonnet-4-5",
      "prompt": "You are a code reviewer...",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Comandos Personalizados

{
  "command": {
    "test": {
      "template": "Run full test suite with coverage report.",
      "description": "Run tests with coverage",
      "agent": "build"
    }
  }
}

Permisos

{
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Compactación de Contexto

{
  "compaction": {
    "auto": true,
    "prune": true
  }
}

Servidores MCP

{
  "mcp": {}
}

Plugins

{
  "plugin": ["opencode-helicone-session", "@my-org/custom-plugin"]
}

Sustitución de Variables

Variables de Entorno

{
  "model": "{env:OPENCODE_MODEL}",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

Contenido de Archivos

{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{file:~/.secrets/openai-key}"
      }
    }
  }
}
IntroducciónProveedores