Claude Code, Zed 에디터에 베타 통합 — Agent Client Protocol(ACP)로 네이티브 실행

Who Should Read

Claude Code를 자주 쓰는데 터미널 전환이 번거로웠던 개발자, 또는 Cursor 대신 Zed로 갈아타려고 Claude Code 지원만 기다렸던 개발자에게 적합하다.

Core Mechanics

• Zed가 ACP(Agent Client Protocol)라는 오픈 표준을 만들었다. 특정 에이전트에 종속된 통합이 아니라, 어떤 AI 에이전트든 이 프로토콜만 구현하면 Zed(및 ACP 호환 에디터)에 연결할 수 있게 설계했다.
• Claude Code를 Zed 에디터 내에서 네이티브로 실행할 수 있다. 터미널 인터페이스에서만 쓰던 Claude Code가 이제 Zed의 Agent Panel에 통합돼, 멀티파일 편집 시 변경 내역을 실시간으로 확인하고 개별 코드 헝크(hunk) 단위로 수락/거절할 수 있다.
• ACP는 Claude Code SDK를 래핑한 어댑터 방식으로 구현했다. Claude Code가 독립 프로세스로 실행되고, 어댑터가 Claude Code의 동작을 ACP의 JSON RPC 형식으로 변환해 Zed UI에 전달하는 구조다.
• Claude Code 어댑터 소스를 Apache 라이선스로 오픈소스화했다. 이미 Neovim의 CodeCompanion 플러그인이 ACP를 채택해서 Neovim에서도 같은 방식으로 Claude Code를 쓸 수 있게 됐다.
• Zed 사이드바에 Claude Code의 태스크 목록이 고정된다. 에이전트가 현재 무엇을 하고 있는지 항상 볼 수 있고, 커스텀 슬래시 명령도 정의해서 반복 작업을 자동화할 수 있다.
• Gemini CLI도 동일하게 ACP로 통합됐다. 사용자는 Claude Code, Gemini CLI, 기타 ACP 호환 에이전트를 Agent Panel에서 나란히 사용할 수 있다.
• GitHub 유저 Xuanwo가 ACP 런치 직후 Claude Code용 ACP 구현을 먼저 만들어서 Zed 팀이 참고했다고 공개적으로 감사를 표했다. 커뮤니티 기여가 프로토콜 채택을 앞당겼다는 사례다.

Evidence

• 첫 댓글부터 '급하게 만든 티가 난다'는 혹평이 있었다. /compact 슬래시 명령이 지원 안 돼서 컨텍스트가 꽉 차면 'Prompt too long' 에러가 나는데 해결 방법이 없고, Plan 모드 전환도 안 되고, 모델 변경도 불가능하다는 점이 현재 실사용 시 치명적 제한으로 꼽혔다.
• 여러 댓글에서 'Plan Mode가 없다', '/clear·/new 같은 기본 명령이 안 된다', '모델 변경 방법을 모르겠다', '자동수락이 진짜로 자동수락이 안 된다' 등 CLI 대비 기능 누락이 집중적으로 지적됐다. 지금 시점에는 Zed 내에 터미널 띄워서 CLI로 쓰는 게 낫다는 의견도 있었다.
• SSH 리모트 개발 환경에서는 작동하지 않는다는 한계도 댓글에서 언급됐다. 리모트 환경을 주로 쓰는 개발자에게는 현 시점에서 실용적이지 않다.
• ACP 표준화 시도 자체를 긍정적으로 평가하는 시각도 있었다. 'TLS·OAuth 2.0·ECMAScript처럼 여러 플레이어가 모여 공통 표준을 만들어야 에코시스템이 성숙한다'는 관점에서, Cursor/Windsurf식 독자 통합보다 ACP가 장기적으로 옳은 방향이라는 주장이다.
• Anthropic Max 구독($200/월)으로 Opus 4.1을 쓰는 사용자는 API 키 방식으로는 비용이 너무 많이 나온다는 현실적 문제를 제기했다. Zed 통합이 이 구독 사용자에게 실용적인 경로를 제공하는지 여부가 불분명하다는 지적이었다.

How to Apply

• Claude Code를 쓰는데 멀티파일 리팩토링 시 변경 범위를 시각적으로 확인하고 싶다면, Zed 최신 버전으로 업데이트 후 Agent Panel의 Plus 메뉴에서 Claude Code를 선택해 볼 수 있다. 단, Plan Mode·/compact 등 필수 기능이 빠져 있으니 프로덕션 작업보다 간단한 작업부터 테스트 권장.
• Neovim을 주로 쓰는데 Claude Code 에디터 통합이 필요하다면, CodeCompanion 플러그인이 ACP를 이미 채택했으므로 별도 작업 없이 Claude Code를 Neovim에서 사용할 수 있다. Zed와 동일한 오픈소스 어댑터를 활용하는 구조다.
• 자체 AI 에이전트나 도구를 개발 중이고 에디터 통합까지 고려하고 있다면, ACP 스펙과 오픈소스 Claude Code 어댑터 코드를 참고해서 자신의 에이전트를 ACP 호환으로 만들면 Zed·Neovim 등 ACP 채택 에디터에 자동으로 연결할 수 있다.

Terminology

관련 논문

• 프로덕션 AI 에이전트를 GPT-5.6으로 마이그레이션: 2.2배 빠르고 27% 저렴

  마케팅 웹사이트를 자동 생성하는 프로덕션 AI 에이전트를 Claude Opus 4.8에서 GPT-5.6 Sol로 전환한 실전 경험담으로, 단순 모델 교체가 아니라 eval 하네스, 툴 스키마, 캐싱, 추론 리플레이까지 손봐야 했던 과정을 구체적인 수치와 함께 정리했다.

• xAI Grok Build CLI가 xAI 서버로 전송하는 데이터: 네트워크 레벨 분석

  xAI의 공식 코딩 CLI 도구 Grok Build가 사용자 동의 없이 전체 Git 저장소와 .env 시크릿 파일을 xAI 서버로 업로드한다는 사실이 네트워크 트래픽 분석으로 밝혀졌다.

• 중요할 때 기억하라: Long-Horizon 에이전트를 위한 Proactive Memory Agent

  LLM 에이전트가 긴 작업 중 중요한 정보를 잊어버리는 문제를 별도의 메모리 에이전트가 '적절한 타이밍에' 끼어들어 해결하는 방법

• WebSwarm: 깊고 넓은 웹 검색을 위한 재귀적 Multi-Agent Orchestration

  복잡한 웹 검색을 재귀적으로 분해하고 각 노드에 적합한 검색 모드를 동적으로 할당하는 멀티에이전트 프레임워크

• 웹 앱을 리버스 엔지니어링해서 AI Agent 도구로 자동 변환하기

  로그인된 웹 앱의 API 호출을 브라우저에서 감시해 자동으로 MCP 도구로 변환하는 에이전트를 만들었다. 소스 코드나 공식 API 문서 없이도 Jira, Spotify 같은 서비스에 AI 어시스턴트를 붙일 수 있다.

• FableCut – AI 에이전트가 조작할 수 있는 브라우저 기반 비디오 에디터 (zero deps)

  타임라인 전체를 JSON 파일 하나로 표현하고 MCP/REST로 AI 에이전트가 직접 편집할 수 있는 브라우저 비디오 에디터로, Claude 같은 AI가 프롬프트 하나로 영상을 자동 컷편집하고 결과를 실시간으로 UI에 반영해준다.

Related Resources

• https://zed.dev/blog/claude-code-via-acp
• https://zed.dev/blog/sequoia-backs-zed
• https://benswift.me/blog/2025/07/23/running-claude-code-with-zed