Suporte a ACP

Use o OpenCode em qualquer editor compatível com ACP.

O OpenCode oferece suporte ao Agent Client Protocol (opens in a new tab) (ou ACP), permitindo que você o use diretamente em editores e IDEs compatíveis.

Dica: Para uma lista de editores e ferramentas que suportam ACP, confira o relatório de progresso do ACP (opens in a new tab).

O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de IA.

Configurar

Para usar o OpenCode via ACP, configure seu editor para executar o comando opencode acp.

O comando inicia o OpenCode como um subprocesso compatível com ACP que se comunica com seu editor por JSON-RPC via stdio.

Abaixo estão exemplos para editores populares que suportam ACP.

Zed

Adicione à sua configuração do Zed (opens in a new tab) (~/.config/zed/settings.json):

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

Para abri-lo, use a ação agent: new thread na Command Palette.

Você também pode vincular um atalho de teclado editando seu keymap.json:

[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "OpenCode",
              "command": {
                "command": "opencode",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

IDEs JetBrains

Adicione ao acp.json do seu IDE JetBrains (opens in a new tab) conforme a documentação (opens in a new tab):

{
  "agent_servers": {
    "OpenCode": {
      "command": "/absolute/path/bin/opencode",
      "args": ["acp"]
    }
  }
}

Para abri-lo, use o novo agente 'OpenCode' no seletor de agentes do AI Chat.

Avante.nvim

Adicione à sua configuração do Avante.nvim (opens in a new tab):

{
  acp_providers = {
    ["opencode"] = {
      command = "opencode",
      args = { "acp" }
    }
  }
}

Se você precisar passar variáveis de ambiente:

{
  acp_providers = {
    ["opencode"] = {
      command = "opencode",
      args = { "acp" },
      env = {
        OPENCODE_API_KEY = os.getenv("OPENCODE_API_KEY")
      }
    }
  }
}

CodeCompanion.nvim

Para usar o OpenCode como agente ACP no CodeCompanion.nvim (opens in a new tab), adicione o seguinte à sua config do Neovim:

require("codecompanion").setup({
  interactions = {
    chat = {
      adapter = {
        name = "opencode",
        model = "claude-sonnet-4",
      },
    },
  },
})

Essa config faz o CodeCompanion usar o OpenCode como o agente ACP para chat.

Se você precisar passar variáveis de ambiente (como OPENCODE_API_KEY), consulte Configuring Adapters: Environment Variables (opens in a new tab) na documentação do CodeCompanion.nvim para todos os detalhes.

Suporte

O OpenCode funciona da mesma forma via ACP que no terminal. Todos os recursos são suportados:

Nota: Alguns comandos de barra integrados, como /undo e /redo, não são suportados no momento.

• Ferramentas integradas (operações de arquivo, comandos de terminal, etc.)
• Ferramentas personalizadas e comandos de barra
• Servidores MCP configurados na sua config do OpenCode
• Regras específicas do projeto a partir de AGENTS.md
• Formatadores e linters personalizados
• Sistema de agentes e permissões