Claude Code와 Codex도 한 화면에서. AI 에디터 Zed 다운로드부터 ACP 연결, 실기 데모까지 핸즈온

이 기사에 대하여

최근 서서히 떠오르고 있는 **AI 네이티브 코드 에디터 「Zed」**를, 공식 사이트에서의 다운로드부터 ACP 연결, AI 에이전트 실기 데모까지 절차에 따라 핸즈온(Hands-on)한 기록이다.

Zed의 최대 특징은 ACP(Agent Client Protocol)를 통해 Claude Code · Codex · Gemini CLI와 같은 외부 AI 에이전트를 "꽂기만 하면" 연결할 수 있다는 점이다. 게다가 이를 Rust 제작 특유의 초경량 편집 환경에서 구동할 수 있다.

이 기사를 끝까지 읽으면 다음과 같은 것들을 재현할 수 있게 된다.

• Zed의 다운로드 ~ 설치 ~ 첫 온보딩(Onboarding)
• ACP 레지스트리에서 Claude Agent / Codex를 추가하여 연결하는 절차
• 스레드 사이드바(Thread Sidebar)에서 여러 AI 에이전트를 병렬·부감하며 사용하는 방법
• VS Code / Cursor와의 포지셔닝 차이
• 무료 플랜의 범위 · 프라이버시/학습 데이터 설정 · 현황의 과제

대상 독자: Cursor가 무겁다고 느끼는 사람, Claude Code나 Codex를 더 보기 쉽게 병렬로 구동하고 싶은 사람, AI 에디터를 한 번 제대로 만져보고 싶은 사람

검증 환경: macOS (Apple Silicon) / Zed Stable 1.8계열 (2026년 6월 시점)

Note: 화면은 전부 macOS에서 확인했다. Windows / Linux에서도 Zed 자체는 동작하지만, 다운로드 파일이나 키 바인딩(Keybinding)은 적절히 읽어주길 바란다.

우선 Zed의 무엇이 대단한가, 4가지 주목 포인트

핸즈온에 들어가기 전에, Zed가 "세일즈 포인트"로 내세우는 4가지만 짚고 넘어가자. 이곳을 알고 있으면 이후 절차의 의미가 쏙쏙 들어올 것이다.

1. ACP로 외부 AI 에이전트를 표준 연결할 수 있다

**ACP(Agent Client Protocol)**란 에디터와 코딩 에이전트(AI 에이전트) 간의 통신을 표준화하는 메커니즘이다. Zed는 내장된 AI 에이전트도 가지고 있지만, 가장 큰 장점은 이 ACP를 경유하여 Claude Code · Codex · Gemini CLI와 같은 외부 에이전트를 연결할 수 있다는 점이다.

에이전트마다 설정이 제각각이라 번거롭다...는 점을 ACP라는 공통 규격이 흡수해주기 때문에, 레지스트리에서 선택해서 꽂기만 하면 연결할 수 있다.

2. 스레드 사이드바에서 병렬 세션을 부감할 수 있다

여러 AI 에이전트를 병렬로 구동할 때, 왼쪽의 스레드 사이드바에 각 세션이 목록으로 나열된다. "지금 어떤 에이전트가 무슨 작업을 하고 있는지", "몇 개가 돌아가고 있는지"를 한눈에 알 수 있다. 사소해 보이지만 이것이 엄청나게 효과적인 포인트다 (이유는 후술).

3. 팔로우 모드(Follow mode)로 편집 중인 파일에 추종

에이전트에게 "README를 편집해줘"라고 부탁하면, 해당 파일이 녹색 테두리와 함께 자동으로 에디터에 열린다 (팔로우 모드). 여러 개라면 여러 개만큼 자동으로 탭이 열리며, "지금 이 파일을 만지고 있습니다"를 보여준다.

4. Rust 제작으로 초경량

베이스가 Rust 제작이라서 어쨌든 가볍다. 기동도 타이핑도 빠릿빠릿하다. 무겁다고 불리기 쉬운 Electron 계열 에디터를 사용한 뒤라면 체감상 확실히 다르다.

공식 사이트에서 다운로드하여 설치하자

그럼 실제로 설치해 보자. Zed는 공식 사이트에서 인스톨러를 받는다. Mac이라면 Apple Silicon 버전의 DMG다.

DMG를 받았다면, 마운트하여 Zed.app을 /Applications에 복사하기만 하면 된다.

# 예: 마운트된 DMG에서 앱을 배치 (GUI로 드래그해도 OK)
cp -R "/Volumes/Zed/Zed.app" /Applications/

최초 기동하면 테마나 키 바인딩을 선택하는 온보딩 화면이 나온다. 여기서 VS Code 스타일의 키 바인딩을 선택해두면, 나중에 Cmd+Shift+P (커맨드 팔레트)나 Cmd+, (설정)를 그대로 사용할 수 있어 편하다.

VS Code · Cursor와 무엇이 다른가

"그래서 결국 VS Code나 Cursor와 무엇이 다른 건데?"가 가장 궁금한 부분일 것이므로, Zed 공식 비교 문서의 수치도 섞어서 정리해 두겠다.

VS Code	Cursor	Zed
강점	확장 기능의 풍부함 + Copilot 통합	표준 AI 에이전트의 정밀도·완성도
AI 노선	확장을 통해 추가	자체 에이전트 강화
구동 속도	—	—
타이핑 지연	—	—

Cursor도 "AI에 강한 에디터"이지만, 노선이 조금 다르다. Cursor는 표준으로 탑재된 AI 에이전트를 내세우는 반면, Zed는 ACP를 통해 Claude Code나 Codex를 스트레스 없이 결합할 수 있다는 점을 내세운다. Rust로 제작된 고속 편집 성능을 토대로, 왼쪽의 스레드 사이드바(Thread Sidebar)에서 여러 세션을 조망하며 병렬로 작업하기 쉽다—이 점이 Zed의 개성이다.

Zed의 화면 구성 보기

프로젝트를 열면 대체로 다음과 같은 3컬럼 구성이 된다.

• 왼쪽: 스레드 사이드바 (Thread Sidebar)… AI 에이전트와의 채팅 세션이 병렬로 목록 표시된다. 이름 지정도 가능하다.
• 중앙: 에디터 / 채팅 패널 (Editor / Chat Panel)… 코드 편집과 에이전트와의 상호작용(입력창 + 대화 기록).
• 오른쪽: 파일 트리 / 터미널 (File Tree / Terminal)… 프로젝트 파일 표시와 내장 터미널.

이 왼쪽의 스레드 목록이 다른 에디터에는 별로 없던 강점이다. 예를 들어 Cursor에서 여러 AI를 본격적으로 사용하려고 하면, 유료 플랜의 제약 때문에 결국 "터미널을 열고 거기서 Claude Code나 Codex를 실행"하는 식의 방법으로 흐르기 쉽다. 하지만 터미널은 가로로 나열할 수 있는 개수에 한계가 있어 전체를 조망하기 어렵다. Zed의 스레드 목록을 사용하면 이러한 병렬 세션을 한눈에 훑어볼 수 있다.

ACP 레지스트리에서 Claude/Codex 추가하기

드디어 본론인 ACP 연결이다. 절차는 간단하다.

• Agent 패널의 + (Add more agents) 버튼을 누른다.
• ACP Registry가 열린다 (다양한 에이전트가 나열되어 있다).
• Claude Agent / Codex를 선택하고 Install을 누른다.

설치가 완료되면, 새 스레드를 열 때 External Agents에서 선택할 수 있게 된다. Codex를 선택하면 GPT 계열 모델이나 에포트 레벨(Effort level)을, Claude를 선택하면 Opus / Sonnet을 선택할 수 있으며, **권한 모드 (Auto 등)**도 정상적으로 사용할 수 있다.

설정의 번거로움을 ACP가 전부 흡수해 주기 때문에, 정말로 "골라서 끼우기만 하면" 된다.

ACP와 MCP의 차이점은 무엇인가? 자주 묻는 질문이지만, 계층이 다르다. ACP는 "에디터 ↔ 코딩 에이전트" 사이의 통신 표준이다. MCP는 "에이전트 ↔ 도구/데이터 소스"를 연결하는 표준이다. Zed는 둘 다 지원한다.

Skill · MCP도 사용할 수 있고, 기본적인 에디터 조작도 모두 가능

AI 네이티브를 표방하는 만큼, Agent Skills나 MCP도 제대로 사용할 수 있다. 설정 화면의 "Default" 부근에 생성된 스킬이나 Anthropic 공식 플러그인(feature-dev 등)에 포함된 스킬들이 나열된다.

물론 에디터로서의 기본적인 조작 기능도 모두 갖추고 있다.

• Markdown 미리보기 (분할 화면으로 파일과 미리보기를 비교하며 볼 수 있음)
• 터미널 패널 분할
• 커맨드 팔레트 (Command Palette) (Cmd+Shift+P) / 설정 파일 열기 (Cmd+,)

온보딩 과정에서 VS Code 스타일의 키 바인딩(Keybinding)을 선택했다면, 이러한 단축키들은 그대로 손에 익을 것이다.

요금제와 무료 범위, 로그인 없이 어디까지 가능한가?

이 부분이 꽤 놀라운 포인트였다.

• 무료 플랜, 심지어 로그인 없이도 외부 AI 에이전트를 연결하여 에디터 상에서 개발하는 단계까지 가능하다.
• 내장된 ZAI라는 에이전트가 있어, GPT / Claude / Gemini 모델을 선택할 수 있다.
• 로그인하면 ZAI에서 사용할 수 있는 14일간의 무료 트라이얼 (신용카드 등록 불필요 · $20 상당의 토큰)을 받을 수 있다.
• 유료 플랜의 주요 차이점은 공동 편집 기능 등이다.

"로그인 없이 ACP 연결까지 만져볼 수 있다"는 점은, 일단 시도해 보는 진입 장벽이 매우 낮다는 점에서 매우 고무적이다.

개인정보 및 학습 데이터 설정은 여기를 확인하세요

업무용으로 사용한다면, 입력 내용을 학습에 사용하지 않도록 설정하는 것을 가장 먼저 확인해야 합니다. 이 부분은 약간의 함정이 있으니 주의 깊게 살펴봅시다.

• 커맨드 팔레트(Command Palette) → 설정(Settings) → AI 섹션으로 이동
• Data Collection 설정을 확인합니다. 기본값은 Default로 되어 있습니다.

이 Default의 동작은 상태 표시줄(최상단 Z 표시 근처)의 "Training Data Collection" 온/오프 상태와 연동됩니다. 만약 이 설정이 'On' 상태라면, Data Collection이 Default인 경우 데이터 학습을 허용하는 쪽으로 기울게 됩니다.

즉, 확실하게 학습을 무효화하고 싶다면 Data Collection 측을 명시적으로 No로 설정해 두는 것이 안전합니다.

Default 상태로 방치하지 말고, 직접 명시적으로 설정해 두세요.

실기 데모: app.js와 README를 AI로 일본어 요약해 보기

그럼 실제로 작동시켜 보겠습니다. zed-task-board라는 작은 데모 프로젝트(index.html / styles.css / app.js / README.md)를 열고, Codex와 Claude Agent에게 동일한 프롬프트를 던져 보았습니다.

이 프로젝트의 app.js를 읽고, 처리 흐름을 일본어로 3가지 포인트로 요약해 주세요.
파일 편집은 하지 마세요.

먼저 Codex. 제대로 app.js를 읽으러 가서, 일본어로 3가지 포인트 요약을 해주었습니다 (파일은 편집하지 않았습니다).

이어서 Claude Agent에게도 동일한 프롬프트를 던집니다. 이쪽도 app.js를 검색하여 읽어 들인 뒤, 일본어로 요약합니다. 동일한 작업을 별도의 에이전트로 병렬로 실행하고, 왼쪽 사이드바에서 서로 비교할 수 있다는 점이 Zed다운 특징입니다.

터미널에서 직접 claude나 codex를 입력하는 것과 비교했을 때, 채팅창의 출력이 제대로 정렬되어 세로로 읽기 편하다는 점이 은근히 유용합니다. 굳이 HTML로 변환하지 않아도 보기 편하거든요.

덤으로 내장 터미널에서 로컬 서버를 실행하여 브라우저로 데모를 확인할 수도 있습니다.

python3 -m http.server 5177
# → http://localhost:5177 을 브라우저에서 열기

연결된 에이전트는 settings.json에 agent_servers로 기록됩니다. ACP를 통해 삽입한 것이 제대로 남아 있는 것을 확인할 수 있습니다 (아래 터미널에서는 방금 전 서버가 200을 반환하고 있습니다).

// settings.json (발췌)
"agent_servers": {
"claude-acp": { "type": "registry" },
...

키 바인딩(Keybinding)을 보고 싶을 때는 zed: open keymap file로 keymap.json을 열면, context / bindings 구조로 되어 있습니다.

사용해 보며 느낀 현재의 과제

가감 없이, 현시점에서 조금 아쉽다고 생각한 점도 적어 두겠습니다.

• 일본어 UI 미지원… 메뉴도 설정도 전부 영어입니다. 일본어 대응은 향후를 기대해 봅니다.
• 스레드 가로 나열 표시 기능 필요… 병렬 세션을 왼쪽 사이드바에서 조망할 수는 있지만, 내용을 가로로 나란히 놓고 비교하고 싶습니다. 표시 영역에 여유가 있는 것이 아니니 어렵겠지만, 터미널을 작게 줄여서라도 여러 스레드의 내용과 파일을 적절히 나열할 수 있다면 사용성이 한 단계 더 높아질 것 같습니다.
• 장시간·일과를 넘나드는 작업에서의 조망성… 여러 에이전트를 병렬로 실행하는 것이 이미 기본 사용법이 되어가고 있으므로, "어제 이 작업은 무엇을 하고 있었지?"를 쉽게 파악할 수 있게 되면 좋겠습니다.

이러한 병렬 작업 관련 경험이 개선된다면, Zed는 더욱 매력적인 도구가 될 것이라고 생각합니다.

그럼, 정리해 볼까요

Zed를 다운로드부터 ACP 연결, 실기 데모까지 한 번에 핸즈온해 보았습니다. 요점을 정리하면,

• ACP를 통해 Claude Code, Codex, Gemini CLI를 "꽂기만 하면" 연결할 수 있다는 점이 Zed의 가장 큰 강점

• 스레드 사이드바(Thread Sidebar)에서 병렬 세션(Parallel Session)을 조망하고, 팔로우 모드(Follow mode)로 편집 중인 파일을 추적

• Rust로 제작되어 초경량이며, 실행 시간 1초 미만, 타이핑 지연(Typing latency) 10ms 미만

• 무료 및 로그인 없이 외부 에이전트 연결까지 테스트 가능 (ZAI는 14일 트라이얼 제공, 신용카드 불필요) - 학습 데이터 보호를 위해 Data Collection을 명시적으로 No로 설정해 두는 것이 안전

• 과제는 일본어 UI 미지원과 병렬 스레드의 시각화 방식 —— 이 부분은 향후 업데이트를 기대

Cursor나 VS Code에서 완전히 갈아탄다기보다, "여러 AI 에이전트를 경쾌하게 나열하여 돌리는 모선(Mother ship)"으로서 한 번 만져볼 가치는 충분하다고 봐. 무료이며 로그인 없이 시작할 수 있으니, 이 글의 순서대로 DL → ACP로 에이전트 추가 → README를 한국어로 번역까지 한 번 따라 해 보길 바라.

참고 링크

Discussion