Zed External Agents: 하나의 에디터에서 모든 AI 에이전트를 사용하는 방법

Zed External Agents

Zed가 외부 AI 에이전트를 직접 지원하기 시작했습니다. Gemini CLI, Claude Agent, Codex를 Zed 안에서 실행할 수 있습니다. 별도의 터미널 창 없이, 동일한 인터페이스로.

이것이 가능한 이유는 Agent Client Protocol (ACP) 덕분입니다. LSP가 언어 서버 통합을 표준화한 것처럼, ACP는 에이전트-에디터 통신을 표준화합니다.

Agent Client Protocol (ACP)이란?

ACP는 코드 에디터/IDE와 코딩 에이전트 간의 통신을 표준화하는 프로토콜입니다.

왜 필요한가?

AI 코딩 에이전트와 에디터는 밀접하게 연결되어 있지만, 상호 운용성은 기본이 아니었습니다:

각 에디터는 지원하고 싶은 모든 에이전트에 대해 커스텀 통합을 구축해야 함
에이전트는 사용자에게 도달하기 위해 에디터별 API를 구현해야 함
개발자는 특정 에이전트를 선택하면 그 에이전트가 지원하는 인터페이스만 사용 가능

ACP는 이 문제를 해결합니다. LSP가 언어 서버 통합을 표준화한 것처럼, ACP는 에이전트-에디터 통신을 표준화합니다.

ACP를 구현한 에이전트는 모든 호환 에디터에서 작동합니다

ACP를 지원하는 에디터는 전체 ACP 호환 에이전트 생태계에 접근할 수 있습니다. 이 디커플링은 양측이 독립적으로 혁신할 수 있게 하면서, 개발자에게는 워크플로우에 가장 적합한 도구를 선택할 자유를 줍니다.

지원되는 에이전트

Gemini CLI

Google의 Gemini CLI는 ACP의 참조 구현입니다.

설정:

에이전트 패널 열기 (Cmd+? / Ctrl+?)
- 버튼 클릭 → Gemini CLI 스레드 시작
Google 계정 또는 Vertex AI로 인증

특징:

Zed가 자동으로 설치 및 업데이트
@-mention으로 파일, 스레드, 심볼 추가
코드 생성, 리팩토링, 디버깅, Q&A 지원

Claude Agent

Anthropic의 Claude Agent SDK를 통한 Claude Code 실행.

설정:

에이전트 패널에서 + 버튼 → Claude Agent 스레드
/login으로 인증 (API 키 또는 Claude Pro/Max 구독)

지원 기능:

커스텀 슬래시 커맨드 (스킬과 병합됨)
서브에이전트
CLAUDE.md 자동 인식

미지원: 에이전트 팀, 훅

Codex CLI

OpenAI의 Codex를 Zed에서 직접 실행.

인증 방법:

ChatGPT 구독으로 로그인
CODEX_API_KEY 환경 변수
OPENAI_API_KEY 환경 변수

특징:

Zed가 관리하는 버전 자동 설치
서드파티 프로바이더 설정 가능

ACP Registry: 에이전트 앱 스토어

v0.221.x부터 ACP Registry가 외부 에이전트 설치의 권장 방법입니다.

사용 방법

zed: acp registry 커맨드 실행
또는 에이전트 패널의 “Add Agent” 버튼 클릭
원하는 에이전트 선택 → 즉시 사용 가능

장점

자동 업데이트
인증 방식 지원 에이전트만 큐레이션
확장보다 우선순위

커스텀 에이전트 추가

ACP를 구현한 자체 에이전트를 개발 중이라면, settings.json에 추가할 수 있습니다:

{
  "agent_servers": {
    "My Custom Agent": {
      "type": "custom",
      "command": "node",
      "args": ["~/projects/agent/index.js", "--acp"],
      "env": {}
    }
  }
}

디버깅

외부 에이전트 문제 발생 시:

dev: open acp logs 커맨드 실행
Zed와 에이전트 간 메시지 확인
이슈 리포트에 로그 첨부

MCP 서버 지원

외부 에이전트의 MCP 서버 접근은 ACP 구현에 따라 다릅니다:

에이전트	MCP 지원
Claude Agent	✅
Codex	✅
Gemini CLI	❌ (아직 미지원)

마치며: 에이전트 중립적 에디터의 시대

Zed의 외부 에이전트 지원은 중요한 변화입니다. 특정 AI 제공자에 종속되지 않고, 원하는 에이전트를 선택할 수 있는 자유.

ACP는 이 생태계의 기반입니다. LSP가 언어 서버를 표준화했듯, ACP는 AI 에이전트를 표준화합니다.

하나의 에디터에서 Gemini, Claude, Codex를 오가며 작업할 수 있는 세상. 그게 바로 지금입니다.