ACP 지원
ACP 호환 에디터에서 OpenCode를 사용하세요.
OpenCode는 Agent Client Protocol (opens in a new tab) (ACP)을 지원하여 호환되는 에디터와 IDE에서 직접 사용할 수 있습니다.
ACP를 지원하는 에디터와 도구 목록은 ACP 진행 보고서 (opens in a new tab)를 확인하세요.
ACP는 코드 에디터와 AI 코딩 에이전트 간의 통신을 표준화하는 개방형 프로토콜입니다.
설정
ACP를 통해 OpenCode를 사용하려면 에디터에서 opencode acp 명령을 실행하도록 설정하세요.
이 명령은 OpenCode를 ACP 호환 서브프로세스로 시작하여 stdio를 통해 JSON-RPC로 에디터와 통신합니다.
아래는 ACP를 지원하는 인기 에디터의 설정 예시입니다.
Zed
Zed (opens in a new tab) 설정(~/.config/zed/settings.json)에 추가:
{
"agent_servers": {
"OpenCode": {
"command": "opencode",
"args": ["acp"]
}
}
}열려면 명령 팔레트에서 agent: new thread 액션을 사용하세요.
keymap.json을 편집하여 키보드 단축키를 바인딩할 수도 있습니다:
[
{
"bindings": {
"cmd-alt-o": [
"agent::NewExternalAgentThread",
{
"agent": {
"custom": {
"name": "OpenCode",
"command": {
"command": "opencode",
"args": ["acp"]
}
}
}
}
]
}
}
]JetBrains IDE
문서 (opens in a new tab)에 따라 JetBrains IDE (opens in a new tab) acp.json에 추가:
{
"agent_servers": {
"OpenCode": {
"command": "/absolute/path/bin/opencode",
"args": ["acp"]
}
}
}열려면 AI Chat 에이전트 선택기에서 새 'OpenCode' 에이전트를 사용하세요.
Avante.nvim
Avante.nvim (opens in a new tab) 설정에 추가:
{
acp_providers = {
["opencode"] = {
command = "opencode",
args = { "acp" }
}
}
}환경 변수를 전달해야 하는 경우:
{
acp_providers = {
["opencode"] = {
command = "opencode",
args = { "acp" },
env = {
OPENCODE_API_KEY = os.getenv("OPENCODE_API_KEY")
}
}
}
}CodeCompanion.nvim
CodeCompanion.nvim (opens in a new tab)에서 OpenCode를 ACP 에이전트로 사용하려면 Neovim 설정에 다음을 추가하세요:
require("codecompanion").setup({
interactions = {
chat = {
adapter = {
name = "opencode",
model = "claude-sonnet-4",
},
},
},
})이 설정은 CodeCompanion이 채팅용 ACP 에이전트로 OpenCode를 사용하도록 설정합니다.
환경 변수(예: OPENCODE_API_KEY)를 전달해야 하는 경우 CodeCompanion.nvim 문서의 어댑터 설정: 환경 변수 (opens in a new tab)를 참조하세요.
지원
OpenCode는 ACP를 통해 터미널에서와 동일하게 작동합니다. 모든 기능이 지원됩니다:
/undo 및 /redo와 같은 일부 내장 슬래시 명령어는 현재 지원되지 않습니다.
- 내장 도구 (파일 작업, 터미널 명령어 등)
- 사용자 정의 도구 및 슬래시 명령어
- OpenCode 설정에 구성된 MCP 서버
AGENTS.md의 프로젝트별 규칙- 사용자 정의 포매터 및 린터
- 에이전트 및 권한 시스템