ACP Desteği

opencode'u ACP uyumlu herhangi bir editörde kullanın.

opencode, Agent Client Protocol veya (ACP) dosyalarını destekleyerek onu doğrudan uyumlu editörlerde ve IDE’lerde kullanmanızı sağlar.

ACP, kod editörleri ile AI kodlama ajanları arasındaki iletişimi standartlaştıran açık bir protokoldür.

Yapılandırma

opencode’u ACP aracılığıyla kullanmak için düzenleyicinizi opencode acp komutunu çalıştıracak şekilde yapılandırın.

Komut, opencode’u, editörünüzle stdio aracılığıyla JSON-RPC üzerinden iletişim kuran ACP uyumlu bir alt süreç olarak başlatır.

Aşağıda ACP’yi destekleyen popüler düzenleyicilere ilişkin örnekler verilmiştir.

Zed

Zed yapılandırmanıza (~/.config/zed/settings.json) ekleyin:

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

Açmak için Komut Paleti’ndeki agent: new thread eylemini kullanın.

keymap.json dosyanızı düzenleyerek de bir klavye kısayolunu bağlayabilirsiniz:

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

JetBrains IDEs

documentation uyarınca JetBrains IDE acp.json dosyanıza ekleyin:

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

Açmak için AI Chat agent seçicisindeki yeni ‘OpenCode’ ajanını kullanın.

Avante.nvim

Avante.nvim yapılandırmanıza ekleyin:

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

Ortam değişkenlerini iletmeniz gerekiyor:

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

CodeCompanion.nvim

opencode’u CodeCompanion.nvim’de ACP ajanı olarak kullanmak için Neovim yapılandırmanıza aşağıdakileri ekleyin:

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

Bu yapılandırma, CodeCompanion’ı opencode’u sohbet için ACP ajanı olarak kullanacak şekilde ayarlar.

Ortam değişkenlerini (OPENCODE_API_KEY gibi) iletmeniz gerekiyorsa, tüm ayrıntılar için CodeCompanion.nvim belgelerindeki Configuring Adapters: Environment Variables’ye bakın.

Destek

opencode, terminalde olduğu gibi ACP aracılığıyla aynı şekilde çalışır. Tüm özellikler desteklenir:

Yerleşik araçlar (dosya işlemleri, terminal komutları vb.)
Özel araçlar ve slash komutları
opencode yapılandırmanızda yapılandırılmış MCP sunucuları
AGENTS.md’dan projeye özel kurallar
Özel biçimlendiriciler ve linter’lar
Aracılar ve izin sistemi