Voltar ao Blog
2026-03-27Atualizado em 2026-11-15
Toolsify Editorial Team
Developer Tools

OpenCode: configure um agente de programação para seu repositório

AI CodingOpen SourceDeveloper ToolsCode AssistantOpenCodeopencode the open source ai coding agent
Sponsored

OpenCode é um agente de programação de código aberto com interfaces de terminal, desktop e web. Sua utilidade depende do modelo conectado e do contexto do repositório fornecido. Este guia segue a documentação v2 verificada em 15 de novembro de 2026; tutoriais antigos podem usar campos diferentes. O guia de instalação descreve pacotes compatíveis e o comando /connect.

Conecte o repositório e o provedor

Instale uma versão apropriada ao sistema, abra o diretório do projeto e execute opencode. Use /connect para configurar um provedor disponível na sua conta. Um cliente funcionando não significa uso gratuito do modelo: a cobrança e as condições de tratamento de dados do provedor continuam válidas.

Crie opencode.jsonc no repositório com o esquema abaixo. A referência de configuração explica ajustes do projeto, globais e gerenciados. Confira essas camadas quando uma opção parecer não funcionar; configurações gerenciadas podem prevalecer. Mantenha credenciais fora dos arquivos versionados.

Defina limites para os comandos

Este exemplo v2 solicita confirmação para comandos de shell, bloqueia envios e pergunta antes de acessar diretórios externos ao projeto:

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "git push *", "effect": "deny" },
    { "action": "external_directory", "resource": "*", "effect": "ask" }
  ]
}

A última regra correspondente prevalece; confira também as substituições específicas do agente. São permissões de ferramentas, não uma sandbox do sistema operacional. A referência de permissões explica ações e correspondência de padrões.

Investigue um defeito concreto

Para um formulário enviado duas vezes, comece com Plan: “Rastreie o manipulador de envio e a requisição de rede. Explique por que um clique cria duas requisições e proponha a menor correção.” Plan evita editar arquivos comuns do projeto, mas seus comandos continuam sujeitos às permissões. Build implementa a alteração, conforme a referência de agentes.

Entregue ao Build os arquivos identificados e os critérios: uma requisição por clique, validação preservada e uma verificação de regressão para envio repetido. Peça que reutilize o framework de testes existente e apresente a saída real dos comandos. Uma explicação plausível não comprova a correção do código.

Revise antes de adotar

Inspecione git diff, execute o teste relevante e as verificações exigidas pelo repositório e examine mudanças inesperadas em dependências ou arquivos gerados. Preserve um ponto inicial limpo no Git: desfazer arquivos não reverte operações remotas nem alterações no banco de dados. Compare provedores nesse mesmo defeito, registrando tempo de revisão, falhas restantes e custos reais. Isso cria uma base útil para escolher, sem inventar pontuações nem presumir comportamento idêntico entre modelos.

Sponsored