Español
Documentación
Soporte ACP

Soporte ACP

Utilice OpenCode en cualquier editor compatible con ACP.

OpenCode admite el Agent Client Protocol (opens in a new tab) o (ACP), lo que le permite usarlo directamente en editores e IDE compatibles.

Tip: Para obtener una lista de editores y herramientas compatibles con ACP, consulte el informe de progreso de ACP (opens in a new tab).

ACP es un protocolo abierto que estandariza la comunicación entre editores de código y agentes de codificación de IA.


Configuración

Para usar OpenCode a través de ACP, configure su editor para ejecutar el comando opencode acp.

El comando inicia OpenCode como un subproceso compatible con ACP que se comunica con su editor a través de JSON-RPC a través de stdio.

A continuación se muestran ejemplos de editores populares que admiten ACP.


Zed

Instale OpenCode desde el registro ACP de Zed (opens in a new tab) ejecutando zed: acp registry en la paleta de comandos.

Para usar un ejecutable personalizado de OpenCode, agréguelo a su configuración de Zed (opens in a new tab) (~/.config/zed/settings.json):

~/.config/zed/settings.json
{
  "agent_servers": {
    "OpenCode": {
      "type": "custom",
      "command": "opencode",
      "args": ["acp"]
    }
  }
}

Para abrirlo, use la acción agent: new thread en la Paleta de comandos.

También puedes vincular un atajo de teclado editando tu keymap.json:

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

JetBrains IDEs

Agregue a su JetBrains IDE (opens in a new tab) acp.json de acuerdo con la documentación (opens in a new tab):

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

Para abrirlo, use el nuevo agente 'OpenCode' en el selector de agentes de AI Chat.


Avante.nvim

Agregue a su configuración Avante.nvim (opens in a new tab):

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

Si necesita pasar variables de entorno:

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

CodeCompanion.nvim

Para usar OpenCode como agente ACP en CodeCompanion.nvim (opens in a new tab), agregue lo siguiente a su configuración de Neovim:

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

Esta configuración configura CodeCompanion para usar OpenCode como agente ACP para el chat.

Si necesita pasar variables de entorno (como OPENCODE_API_KEY), consulte Configuración de adaptadores: variables de entorno (opens in a new tab) en la documentación de CodeCompanion.nvim para obtener detalles completos.

Soporte

OpenCode funciona igual a través de ACP que en la terminal. Todas las funciones son compatibles:

Note: Algunos comandos de barra integrados como /undo y /redo no son compatibles actualmente.

  • Herramientas integradas (operaciones de archivos, comandos de terminal, etc.)
  • Herramientas personalizadas y comandos de barra
  • Servidores MCP configurados en su configuración OpenCode
  • Reglas específicas del proyecto de AGENTS.md
  • Formateadores y linters personalizados
  • Sistema de agentes y permisos.

Fuente de la documentación (MIT)