К содержимому
Настройка

Поддержка ACP

opencode поддерживает Agent Client Protocol (ACP), что позволяет использовать его непосредственно в совместимых редакторах и IDE.

ACP — это открытый протокол, который стандартизирует взаимодействие между редакторами кода и ИИ-агентами.

Чтобы использовать opencode через ACP, настройте свой редактор для запуска команды opencode acp.

Команда запускает opencode как ACP-совместимый подпроцесс, который взаимодействует с вашим редактором через JSON-RPC через stdio.

Ниже приведены примеры популярных редакторов, поддерживающих ACP.

Установите OpenCode из реестра ACP Zed, выполнив zed: acp registry в палитре команд.

Чтобы вместо этого использовать собственный исполняемый файл OpenCode, добавьте его в конфигурацию Zed (~/.config/zed/settings.json):

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

Чтобы открыть его, используйте действие agent: new thread в Палитре команд.

Вы также можете привязать сочетание клавиш, отредактировав свой keymap.json:

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

Добавьте в свою JetBrains IDE acp.json в соответствии с документацией:

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

Чтобы открыть его, используйте новый агент opencode в селекторе агентов AI Chat.

Добавьте в свою конфигурацию Avante.nvim:

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

Если вам нужно передать переменные среды:

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

Чтобы использовать opencode в качестве агента ACP в CodeCompanion.nvim, добавьте в конфигурацию Neovim следующее:

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

Эта конфигурация настраивает CodeCompanion для использования opencode в качестве агента ACP для чата.

Если вам нужно передать переменные среды (например, OPENCODE_API_KEY), обратитесь к разделу Настройка адаптеров: переменные среды в документации CodeCompanion.nvim для получения полной информации.

opencode через ACP работает так же, как и в терминале. Поддерживаются все функции:

  • Встроенные инструменты (файловые операции, команды терминала и т. д.)
  • Пользовательские инструменты и команды слэша
  • Серверы MCP, настроенные в вашей конфигурации opencode
  • Правила для конкретного проекта из AGENTS.md
  • Пользовательские форматтеры и линтеры
  • Агенты и система разрешений