Como usar OpenCode no Zé Bot

O que é

O OpenCode é um provedor ACP do Zé Bot. Ele funciona com os modelos Free sem conta ou com a sua assinatura OpenCode Go. O Zé Bot organiza o workspace, as instruções, as ferramentas, as aprovações e o histórico em volta do CLI.

Antes de começar

• O OpenCode CLI instalado, ou o runtime gerenciado pelo Zé Bot.
• Uma pasta de trabalho para o agente.
• Conta OpenCode Go apenas se você quiser os modelos pagos; os Free não exigem login.
• O nível de aprovação definido para o tipo de tarefa.

Como conectar

1. Abra Configurações → Provedores.
2. Escolha OpenCode.
3. Confira o status. Os modelos Free funcionam sem autenticação.
4. Se você usa o OpenCode Go, conclua o login pelo fluxo oficial.
5. Volte para a lista de agentes.

Como criar um agente com OpenCode

1. Crie ou abra um agente.
2. Em Provedor, escolha OpenCode.
3. Escolha o modelo. A lista mostra os modelos Free e os modelos da sua assinatura, quando disponíveis.
4. Envie uma tarefa curta para validar.
5. Ajuste instruções, ferramentas e workspace.

Exemplo

Peça: “Leia estes três arquivos e proponha uma lista de melhorias, sem alterar nada”. O agente usa o OpenCode para ler o workspace e responde com a análise. Para editar, o cartão de aprovação aparece conforme o nível escolhido.

Limites e cuidados

• A disponibilidade dos modelos Free pode mudar com o OpenCode.
• Modelos pagos dependem da assinatura OpenCode Go.
• O Zé Bot não fornece o modelo nem intermedeia a cobrança.
• O nível de aprovação vale para o agente inteiro.
• O workspace não é um sandbox de shell.

Problemas comuns

O OpenCode não aparece ou não lista modelos

Confira se o CLI está instalado e no PATH. Atualize o OpenCode e reabra o seletor de provedores.

Os modelos Free pararam de responder

A disponibilidade dos modelos Free é do OpenCode. Tente outro modelo da lista ou use a assinatura OpenCode Go.

O agente pede aprovação demais

Ajuste o nível em Detalhes do agente → Comportamento. Aceitar edições de arquivo reduz interrupções sem liberar comandos.

Próximos passos

• Leia o lançamento em /blog/opencode.
• Veja os outros manuais em /manual.