OpenCode: Personalizando o Agente Open Source de IA

Configuração inicial no Windows 11

Antes de personalizar, instale o OpenCode no Windows 11. Você pode fazer isso via npm, winget ou compilando diretamente do código fonte.

# Instalação via npm
npm install -g @opencode/cli

# Verificar instalação
opencode --version

# Configurar provedor de IA
opencode config set provider claude
opencode config set api_key $ANTHROPIC_API_KEY

Custom instructions: o coração da personalização

O OpenCode permite definir instruções personalizadas que guiam o comportamento do agente. Essas instruções são o equivalente ao system prompt e definem como o OpenCode interage com seu projeto.

# .opencode/instructions.md
## Estilo de código
- Seguir ESLint configurado no projeto
- Usar TypeScript estrito
- Comentários apenas quando necessário

## Preferências
- Preferir composição sobre herança
- Testes com Vitest
- Documentação em português (pt-BR)

Configuração de múltiplos provedores

Uma das maiores vantagens do OpenCode é a flexibilidade de provedores de IA. Você pode configurar múltiplos provedores e alternar entre eles conforme a tarefa:

• Claude da Anthropic: Ideal para tarefas que exigem análise profunda e contexto amplo
• GPT da OpenAI: Excelente para geração rápida de código e automação
• Modelos locais via Ollama: Para desenvolvimento offline ou ambientes sem internet
• Mistral: Boa alternativa open source com bom custo-benefício

Plugins e integração MCP

O OpenCode suporta o protocolo MCP (Model Context Protocol), permitindo integrar ferramentas externas como bancos de dados, APIs e serviços cloud.

Para configurar um servidor MCP no OpenCode, você adiciona as configurações no arquivo de configuração do agente:

{
  "mcpServers": {
    "database": {
      "command": "node",
      "args": ["mcp-postgres"],
      "env": { "DATABASE_URL": "..." }
    },
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem"]
    }
  }
}

Personalização com Orquestra no Windows 11

Combinar OpenCode personalizado com o Orquestra leva sua produtividade a outro patamar. Você pode criar workspaces no Orquestra com diferentes configurações de OpenCode para diferentes contextos:

• Workspace Backend: OpenCode com Claude + instruções para Node.js/TypeScript
• Workspace Frontend: OpenCode com GPT + instruções para React/Next.js
• Workspace DevOps: OpenCode com Ollama local + instruções para Docker/Kubernetes
• Workspace Review: OpenCode dedicado a code review, revisando os demais workspaces

Criando templates de personalização

Uma prática recomendada é criar templates de personalização para diferentes tipos de projeto. O OpenCode permite salvar e reutilizar configurações completas:

~/.opencode/templates/
  web-app/
    instructions.md
    config.json
    mcp-servers.json
  cli-tool/
    instructions.md
    config.json
  library/
    instructions.md
    config.json

Perguntas frequentes