ข้ามไปยังเนื้อหา
เอกสาร V1
การกำหนดค่า

การรองรับ ACP

OpenCode รองรับ Agent Client Protocol (ACP) ซึ่งช่วยให้สามารถทำงานร่วมกับ editor และ IDE ต่างๆ ได้โดยตรง

ACP เป็นมาตรฐานเปิดสำหรับการสื่อสารระหว่างโปรแกรมแก้ไขโค้ดและ AI agent


ในการใช้ OpenCode ผ่าน ACP ให้กำหนดค่าโปรแกรมแก้ไขของคุณให้รันคำสั่ง opencode acp

คำสั่งนี้จะเริ่ม OpenCode เป็น process ย่อยที่รองรับ ACP ซึ่งสื่อสารกับโปรแกรมแก้ไขของคุณผ่าน JSON-RPC ทาง stdio

นี่คือตัวอย่างสำหรับโปรแกรมแก้ไขยอดนิยมที่รองรับ ACP


ติดตั้ง OpenCode จาก รีจิสทรี ACP ของ Zed โดยเรียกใช้ zed: acp registry ใน Command Palette

หากต้องการใช้ไฟล์ปฏิบัติการ OpenCode แบบกำหนดเอง ให้เพิ่มลงในการตั้งค่า Zed (~/.config/zed/settings.json):

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

สิ่งนี้จะเปิดใช้ agent: new thread ใน Command Palette

คุณต้องตั้งค่า keybinding ใน keymap.json ของคุณ:

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

เพิ่มลงใน acp.json ของ JetBrains IDE ของคุณตาม เอกสาร:

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

นี่เป็นการเปิดให้ตัวแทน ‘OpenCode’ ในเนื้อหาของตัวแทน AI Chat


ยังคงมี Avante.nvim ของคุณ:

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

หากคุณต้องการส่งผ่าน environment variables (เช่น OPENCODE_API_KEY) คุณต้องระบุใน env:

{
  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 agent สำหรับแชท

หากคุณต้องส่ง environment variables (เช่น OPENCODE_API_KEY) โปรดดู Configuring Adapters: Environment Variables ในเอกสารของ CodeCompanion.nvim สำหรับรายละเอียดทั้งหมด

opencode ทำงานผ่าน ACP เหมือนกับใน terminal และรองรับฟีเจอร์ทั้งหมด:

  • เครื่องมือใน (ไฟล์ไฟล์คำสั่งอื่นๆ)
  • คำอธิบายและคำสั่งสแลช
  • MCP แขกที่นี่คือข้อมูลเพิ่มเติมของ OpenCode ของคุณ
  • กฎเฉพาะโครงการจาก AGENTS.md
  • คนจัดรูปแบบและ linters เวียนนา
  • ระบบตัวแทนและระบบ