Saltearse al contenido

Soporte ACP

Usa OpenCode en cualquier editor compatible con ACP.

OpenCode es compatible con el Agent Client Protocol o (ACP), lo que te permite usarlo directamente en editores e IDE compatibles.

ACP es un protocolo abierto que estandariza la comunicacion entre editores de codigo y agentes de codificacion de IA.


Configurar

Para usar OpenCode a traves de ACP, configura tu editor para ejecutar el comando opencode acp.

El comando inicia OpenCode como un subproceso compatible con ACP que se comunica con tu editor a traves de JSON-RPC via stdio.

A continuacion se muestran ejemplos para editores populares que admiten ACP.


Zed

Agrega a tu configuracion de Zed (~/.config/zed/settings.json):

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

Para abrirlo, usa la accion agent: new thread en la Paleta de comandos.

Tambien 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 IDE

Agrega a tu IDE JetBrains acp.json segun la documentacion:

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

Para abrirlo, usa el nuevo agente ‘OpenCode’ en el selector de agentes de chat de IA.


Avante.nvim

Agrega a tu configuracion de Avante.nvim:

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

Si necesitas 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 un agente ACP en CodeCompanion.nvim, agrega lo siguiente a tu configuracion de Neovim:

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

Esta configuracion configura CodeCompanion para usar OpenCode como el agente ACP para el chat.

Si necesitas pasar variables de entorno (como OPENCODE_API_KEY), consulta Configuración de adaptadores: Variables de entorno en la documentacion de CodeCompanion.nvim para mas detalles.

Soporte

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

  • Herramientas integradas (operaciones de archivo, comandos de terminal, etc.)
  • Herramientas personalizadas y comandos slash
  • Servidores MCP configurados en tu configuracion de OpenCode
  • Reglas especificas del proyecto desde AGENTS.md
  • Formateadores y linters personalizados
  • Sistema de agentes y permisos