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

관련 논문

• OpenKnowledge – Obsidian/Notion의 오픈소스 AI-first 대안

  Git 기반 동기화와 Claude/Codex/Cursor 연동을 내장한 로컬 우선 마크다운 에디터로, AI 에이전트의 두 번째 뇌(LLM Wiki)로 활용할 수 있는 오픈소스 도구다.

• Unfireable Safety Kernel: AI 에이전트를 위한 Execution-Time AI Alignment

  AI 에이전트가 자신의 안전장치를 우회할 수 없도록, 에이전트 프로세스 바깥에 수학적으로 증명된 강제 통제 게이트를 배치하는 아키텍처

• RubyLLM: 주요 AI 프로바이더를 모두 지원하는 Ruby 프레임워크

  OpenAI, Claude, Gemini 등 주요 AI 프로바이더를 단일 인터페이스로 통합한 Ruby 프레임워크로, Rails 통합과 에이전트 기능까지 지원해 Ruby 개발자가 AI 기능을 빠르게 붙일 수 있다.

• Qwen-AgentWorld: 범용 에이전트를 위한 Language World Model

  Alibaba Qwen 팀이 AI 에이전트가 행동 결과를 미리 시뮬레이션할 수 있는 'Language World Model'을 공개했다. 에이전트 훈련과 실행 경로 검증에 새로운 패러다임을 제시하는 연구다.

• SHERLOC: Code Repair Agent를 위한 구조화된 Diagnostic Localization 프레임워크

  버그 위치만 알려주는 게 아니라 '왜, 어떻게 고쳐야 하는지'까지 진단 리포트를 생성해서 코드 수정 에이전트의 성능을 높이는 training-free 프레임워크

• peerd – 브라우저에서 완전히 실행되는 AI Agent Harness

  백엔드 서버 없이 Chrome/Firefox 확장 프로그램으로만 동작하는 AI 에이전트 실행 환경으로, 브라우저 탭을 직접 조작하고 WASM Linux VM까지 구동할 수 있어 프라이버시와 보안을 동시에 챙길 수 있다.

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