Context Vault

claude-agent-acp — Claude Agent SDK를 ACP 클라이언트에서 사용하기

3 min read

claude-agent-acp — Claude Agent SDK를 ACP 클라이언트에서 사용하기

Claude Agent SDK를 ACP(Agent Client Protocol) 호환 에이전트로 변환하는 어댑터. Zed Industries 개발, Apache 2.0. ⭐ 1.5k

Key Points

  • Claude Agent SDK → ACP 브릿지 역할 (에디터/IDE ↔ 코딩 에이전트 표준 프로토콜)
  • Zed, VS Code, Neovim, JetBrains 등 모든 ACP 호환 클라이언트에서 Claude Agent 사용 가능
  • Context @-mentions, 이미지, Tool calls, Edit review, TODO, 터미널, Slash commands, Client MCP 서버 전체 지원
  • Gateway 인증으로 커스텀 모델 백엔드(OpenClaw, Ollama 등) 연동 가능
  • v0.25.0, TypeScript, @anthropic-ai/claude-agent-sdk 0.2.91 기반

Content

아키텍처

[ACP 클라이언트] ←── JSON-RPC (stdio) ──→ [claude-agent-acp] ←──→ [Claude Agent SDK]
   (Zed, VS Code,                         (이 프로젝트)              (Anthropic 공식)
    Neovim, JetBrains,
    acpx CLI, Telegram 봇...)

ACP는 에디터/IDE ↔ 코딩 에이전트 간 통신 표준 프로토콜. LSP(Language Server Protocol)의 에이전트 버전이라고 생각하면 된다. Zed Industries가 주도하고 JetBrains가 공동 참여 중.

설치 & 실행

npm:

npx @agentclientprotocol/claude-agent-acp
# 또는 전역 설치
npm install -g @agentclientprotocol/claude-agent-acp
claude-agent-acp

Claude CLI 직접 사용:

claude-agent-acp --cli auth login --claudeai    # Claude Subscription
claude-agent-acp --cli auth login --console     # Anthropic Console (API)

라이브러리로 사용:

import { ClaudeAcpAgent, runAcp } from "@agentclientprotocol/claude-agent-acp";
 
// 바로 ACP 에이전트로 실행
runAcp();
 
// 커스텀 Agent 클래스 구현 가능
// ClaudeAcpAgent implements Agent (ACP SDK 인터페이스)

인증 방법

방법설명
Claude SubscriptionClaude 유료 구독 사용
Anthropic ConsoleAPI usage billing
Custom GatewaybaseUrl + headers로 커스텀 엔드포인트 (OpenClaw, Ollama 등 가능)

지원 기능

  • Context @-mentions, 이미지 입력
  • Tool calls (권한 요청 포함), Edit review
  • Following, TODO lists
  • Interactive/Background terminals
  • Custom Slash commands, Client MCP servers
  • Session fork/resume/list/close
  • Claude Code 권한 모드: auto, default, acceptEdits, dontAsk, plan, bypassPermissions

호환 ACP 클라이언트

에디터: Zed, VS Code (ACP Client 확장), Neovim (CodeCompanion, avante.nvim, agentic.nvim), JetBrains

CLI/데스크탑: acpx, ACP UI, DeepChat, Minion Mind, Lody

모바일: Agmente (iOS), Happy (iOS/Android/Web), Mobvibe

메신저: OpenACP (Telegram/Discord/Slack), Juan (Slack), Telegram ACP Bot, WeChat ACP

프레임워크: LangChain/LangGraph (Deep Agents ACP), LlamaIndex, fast-agent

기술 스펙

  • 언어: TypeScript (ESM)
  • 핵심 의존: @agentclientprotocol/sdk 0.18.0, @anthropic-ai/claude-agent-sdk 0.2.91
  • 전송: stdio (JSON-RPC over stdin/stdout)
  • 라이선스: Apache 2.0
  • 개발자: Zed Industries

그래프 뷰