Deutsch
Dokumentation
ACP-Unterstützung

ACP-Unterstützung

Verwenden Sie OpenCode in jedem ACP-kompatiblen Editor.

OpenCode unterstützt das Agent Client Protocol (opens in a new tab) (ACP), das Ihnen ermöglicht, es direkt in kompatiblen Editoren und IDEs zu verwenden.

Eine Liste der Editoren und Tools, die ACP unterstützen, finden Sie im ACP-Fortschrittsbericht (opens in a new tab).

ACP ist ein offenes Protokoll, das die Kommunikation zwischen Code-Editoren und KI-Codierungsagenten standardisiert.


Konfiguration

Um OpenCode über ACP zu verwenden, konfigurieren Sie Ihren Editor so, dass er den Befehl opencode acp ausführt.

Der Befehl startet OpenCode als ACP-kompatiblen Subprozess, der über JSON-RPC via stdio mit Ihrem Editor kommuniziert.

Nachfolgend finden Sie Beispiele für beliebte Editoren, die ACP unterstützen.


Zed

Fügen Sie zu Ihrer Zed (opens in a new tab)-Konfiguration (~/.config/zed/settings.json) hinzu:

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

Zum Öffnen verwenden Sie die Aktion agent: new thread in der Befehlspalette.

Sie können auch eine Tastenkombination binden, indem Sie Ihre keymap.json bearbeiten:

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

JetBrains IDEs

Fügen Sie gemäß der Dokumentation (opens in a new tab) zu Ihrer JetBrains IDE (opens in a new tab) acp.json hinzu:

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

Zum Öffnen verwenden Sie den neuen 'OpenCode'-Agenten im AI-Chat-Agenten-Selektor.


Avante.nvim

Fügen Sie zu Ihrer Avante.nvim (opens in a new tab)-Konfiguration hinzu:

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

Wenn Sie Umgebungsvariablen übergeben müssen:

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

CodeCompanion.nvim

Um OpenCode als ACP-Agent in CodeCompanion.nvim (opens in a new tab) zu verwenden, fügen Sie Folgendes zu Ihrer Neovim-Konfiguration hinzu:

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

Diese Konfiguration richtet CodeCompanion ein, um OpenCode als ACP-Agent für Chat zu verwenden.

Wenn Sie Umgebungsvariablen (wie OPENCODE_API_KEY) übergeben müssen, lesen Sie Adapter konfigurieren: Umgebungsvariablen (opens in a new tab) in der CodeCompanion.nvim-Dokumentation für vollständige Details.

Unterstützung

OpenCode funktioniert über ACP genauso wie im Terminal. Alle Funktionen werden unterstützt:

⚠️

Einige integrierte Slash-Befehle wie /undo und /redo werden derzeit nicht unterstützt.

  • Integrierte Werkzeuge (Dateioperationen, Terminalbefehle usw.)
  • Benutzerdefinierte Werkzeuge und Slash-Befehle
  • In Ihrer OpenCode-Konfiguration konfigurierte MCP-Server
  • Projektspezifische Regeln aus AGENTS.md
  • Benutzerdefinierte Formatierer und Linter
  • Agenten- und Berechtigungssystem