O que é o ACP no OpenCode e para que serve?

Você abriu a doc do OpenCode, encontrou a sigla ACP e travou

Calma que é mais simples do que parece

ACP é um protocolo que liga o agente de IA ao seu editor de código

Antes de sair mexendo no settings.json e no comando, vale entender o que é essa ponte e para que ela serve, então bora do começo =)

O que significa ACP (Agent Client Protocol)

ACP é a sigla de Agent Client Protocol, um padrão aberto que define como agentes de IA de código conversam com editores e IDEs

A ideia por trás é simples: em vez de cada agente inventar o seu próprio jeito de se conectar a cada editor, todo mundo fala a mesma língua

É um padrão pra conectar QUALQUER agente a QUALQUER ambiente de edição, beleza?

Se você já viu como o NPM padroniza a instalação de pacotes pra qualquer projeto Node, a lógica aqui é parecida: um contrato comum que todo mundo respeita

O ACP foi criado e liberado como open source pela Zed Industries, a empresa por trás do editor Zed

Hoje o código e a governança ficam na comunidade, no repositório github.com/zed-industries/agent-client-protocol

E não é só a Zed nessa

Em outubro de 2025, a JetBrains firmou parceria com a Zed pra co-desenvolver o ACP e adotá-lo nas IDEs dela

Ou seja, o protocolo não é experimento de fundo de quintal: tem empresa grande apostando nele pra interoperabilidade de agentes dentro do editor

O que o ACP habilita na prática no OpenCode

O OpenCode é um agente de código open source mantido pela sst

O que o suporte a ACP muda pra você é o seguinte: o OpenCode expõe o loop de agente e as ferramentas dele via ACP

E o que isso significa na prática?

Significa que você usa o OpenCode DENTRO de um editor compatível, sem trocar de janela e sem abrir um terminal separado só pra conversar com a IA

Os editores compatíveis citados na doc são o Zed, o JetBrains e o Neovim

Pensa assim: o agente vira mais um recurso do seu editor, do lado do seu código, com acesso às ferramentas que ele já sabe usar

Em vez de copiar e colar código de um lado pro outro, tu chama o agente ali mesmo onde você programa

Como o OpenCode entra em modo ACP

Aqui vai a parte prática, só com o que dá pra afirmar com segurança

1. O comando que coloca o OpenCode em modo ACP é este

opencode acp

Só que você não roda ele na mão: esse é o comando que o EDITOR chama por baixo dos panos. Ele inicia o OpenCode como um subprocesso ACP, que fala JSON-RPC por stdio com o editor

Traduzindo o miudinho: o editor abre o OpenCode sozinho e os dois trocam mensagens por aquele canal padrão de entrada e saída, sem você ver

2. No Zed, faça a ligação adicionando o OpenCode como agent_server no arquivo ~/.config/zed/settings.json

{
  "agent_servers": {
    "OpenCode": {
      "command": "opencode",
      "args": ["acp"]
    }
  }
}

Repara que o command é opencode e os args são ["acp"]: é exatamente o comando de cima, só que declarado pro editor chamar sozinho

O erro comum aqui é bagunçar o JSON: uma vírgula sobrando ou uma chave fora do lugar e o Zed não carrega a config

Se algo não subir, confere primeiro se o arquivo settings.json está com a estrutura certinha antes de sair procurando culpa no OpenCode

Um empurrão pra começar do zero no OpenCode

Se você ainda está montando o ambiente e quer ver o OpenCode rodando na prática, este vídeo do canal mostra como usar modelos de graça no OpenCode via ZenMux

É um bom ponto de partida pra pegar familiaridade com a ferramenta antes de partir pra configuração do ACP

Conclusão

No fim das contas, ACP é a ponte entre o agente e o editor

O Agent Client Protocol padroniza essa conversa, a Zed criou e abriu o padrão, a JetBrains entrou na parceria, e o OpenCode surfa nisso expondo o agente dele pra editores compatíveis como Zed, JetBrains e Neovim

O próximo passo é escolher um editor compatível e configurar a conexão que aponta pro comando opencode acp

Aí é sentar na cadeira e deixar o agente trabalhar do lado do seu código =)