Modos

Os modos personalizam o comportamento do opencode para diferentes fluxos de trabalho. Eles permitem configurar a seleção de modelo, temperatura, prompts e acesso a ferramentas para casos de uso específicos.

Modos Integrados

Modo Build

O modo padrão com acesso completo às ferramentas para trabalho de desenvolvimento regular. Todas as ferramentas estão habilitadas.

Modo Plan

Um modo restrito projetado para planejamento e análise. As seguintes ferramentas estão desabilitadas por padrão:

• write
• edit
• patch
• bash

Alterne entre os modos usando a tecla Tab durante uma sessão.

Opções de Configuração

Ferramentas Disponíveis

• bash - Executar comandos de shell
• edit - Editar arquivos existentes
• write - Criar novos arquivos
• read - Ler conteúdo de arquivos
• grep - Pesquisar conteúdo de arquivos
• glob - Encontrar arquivos por padrão
• list - Listar conteúdo de diretórios
• patch - Aplicar patches
• todowrite - Escrever na lista de tarefas
• todoread - Ler lista de tarefas
• webfetch - Buscar conteúdo da web

Métodos de Configuração

Configuração JSON

Adicione ao opencode.json:

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

Configuração Markdown

Crie arquivos em .opencode/mode/ (projeto) ou ~/.config/opencode/mode/ (global):

---
description: Modo debug para investigação
mode: primary
temperature: 0.2
tools:
  write: false
  edit: false
---
Você está no modo debug. Concentre-se em investigar problemas sem fazer alterações.

Casos de Uso Comuns

Modo de Revisão de Código

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

Modo de Documentação

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

Modo de Refatoração

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

Alternar Modos

• Pressione Tab para alternar entre modos primários
• Use atalhos de teclado configurados para acesso direto
• Os modos persistem dentro de uma sessão até serem alterados