文档
Documentação em Português
Configuração

Configuração

O OpenCode utiliza um sistema de configuração JSON para personalização. O esquema de configuração é definido em opencode.ai/config.json, permitindo validação do editor e suporte a autocompletar.

Suporte a Formato

O OpenCode aceita tanto formatos JSON quanto JSONC (JSON com Comentários).

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

Locais de Configuração e Precedência

As configurações são mescladas em vez de substituídas. A ordem de carregamento (fontes posteriores substituem conflitos):

  1. Configuração remota – Padrões organizacionais de .well-known/opencode
  2. Configuração global – Preferências do usuário em ~/.config/opencode/opencode.json
  3. Configuração personalizada – Variável de ambiente OPENCODE_CONFIG
  4. Configuração do projeto – opencode.json na raiz do projeto
  5. Diretórios .opencode – Agentes, comandos, plugins
  6. Configuração inline – Variável de ambiente OPENCODE_CONFIG_CONTENT

Configuração Global

Coloque preferências do usuário em ~/.config/opencode/opencode.json:

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

Configuração do Projeto

Adicione opencode.json à raiz do seu projeto para configurações específicas do projeto.

Caminho Personalizado

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

Esquema de Configuração

Configurações TUI

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

Configurações do Servidor

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

Configuração de Ferramentas

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

Modelos e Provedores

{
  "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"
    }
  }
}

Permissões

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

Compactação de Contexto

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

Servidores MCP

{
  "mcp": {}
}

Plugins

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

Substituição de Variáveis

Variáveis de Ambiente

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

Conteúdo de Arquivos

{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{file:~/.secrets/openai-key}"
      }
    }
  }
}
IntroduçãoProvedores