Um arquivo,
todo o contrato.

O maxvision-code.json declara como o agente se comporta: modelos, permissões, ferramentas, agentes e integrações. Versionável, mesclável por escopo e validado por schema.

01Formato

JSON ou JSONC (com comentários). O schema dá validação e autocomplete no editor:

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

Ajustes visuais da TUI vivem em um arquivo separado, tui.json — veja TUI.

02Onde a config mora

As fontes são mescladas, não substituídas: chaves em conflito seguem a precedência; o resto convive. Da base para o topo:

Na inicialização, o MVCode procura config no diretório atual e sobe até o repositório Git mais próximo. MVCODE_CONFIG_DIR aponta um diretório extra com a mesma estrutura de .maxvision-code/. Config gerenciada e MDM estão detalhadas em enterprise.

03Mapa de chaves

As chaves do runtime, com a página que aprofunda cada uma:

Comportamento do runtime

04Variáveis na config

Dois mecanismos de substituição mantêm segredo fora do arquivo:

{
  "model": "{env:MVCODE_MODEL}",
  "provider": {
    "anthropic": { "options": { "apiKey": "{env:ANTHROPIC_API_KEY}" } },
    "openai": { "options": { "apiKey": "{file:~/.secrets/openai-key}" } }
  }
}

• {env:VAR} — variável de ambiente; ausente vira string vazia.
• {file:caminho} — conteúdo de arquivo, relativo à config ou absoluto — chaves em arquivos separados, instruções longas fora do JSON.

05Depurando a config resolvida

mvcode debug config
→ imprime a config final, com todas as fontes mescladas

É a resposta definitiva para "de onde veio essa chave?" — inclusive para configuração gerenciada.