Zed 에디터의 AI 기능

코드를 작성하다 보면 AI의 도움이 필요한 순간이 자주 찾아옵니다. 복잡한 알고리즘을 짜야 할 때라든가 에러 메시지가 도통 이해가 안 될 때 말이죠. 이럴 때 에디터를 떠나서 ChatGPT나 클로드 코드를 따로 실행하면 작업 흐름이 끊기기 쉬운데요.

Zed 에디터는 AI 기능을 에디터 깊숙이 통합해서 이런 컨텍스트 전환을 줄여줍니다. 에이전트 패널에서 AI와 대화하면서 코드를 수정하거나 인라인 어시스턴트로 선택한 코드를 즉석에서 바꾸는 것도 됩니다. 편집 예측은 다음에 칠 코드를 알아서 제안해주고요. 거기에 클로드 코드까지 에디터 안에서 바로 돌릴 수 있습니다.

이 글에서는 Zed의 AI 기능을 하나씩 살펴보면서 특히 클로드 코드와 어떻게 연동하는지 자세히 다뤄보겠습니다.

에이전트 패널

Zed의 AI 기능 중 핵심은 에이전트 패널(Agent Panel)이에요. 단순한 챗봇이 아니라 AI가 프로젝트 파일을 읽고 코드를 수정하고 터미널 명령어까지 실행하는 풀스택 코딩 에이전트예요.

커맨드 팔레트에서 agent: new thread를 실행하거나 상태 바의 ✨ 아이콘을 눌러도 돼요. 단축키도 있는데, macOS는 Cmd+?, Windows/Linux는 Ctrl+?예요.

에이전트에게 프롬프트를 보내면 코드베이스를 검색하고 파일을 편집하고 터미널 명령어도 실행합니다. 웹 콘텐츠를 가져오는 것도 돼요. 변경된 파일은 diff로 보여주기 때문에 AI가 뭘 바꿨는지 한눈에 확인할 수 있어요. Ctrl+Shift+R을 누르면 멀티 버퍼 리뷰 탭이 열려서 변경 사항을 hunk 단위로 수락하거나 거부할 수 있습니다.

에이전트 프로필

에이전트 패널에는 세 가지 기본 프로필이 있어서 상황에 맞게 AI의 권한을 조절할 수 있어요.

Write 프로필은 모든 도구가 켜져 있어서 파일 쓰기와 터미널 명령어 실행이 가능합니다. 새 기능을 구현하거나 리팩토링처럼 AI가 직접 코드를 건드려야 할 때 쓰면 돼요.

Ask 프로필은 읽기 전용 도구만 활성화됩니다. 코드에 대해 질문하거나 설명을 들을 때 유용한데, 실수로 파일이 변경될 걱정이 없어서 안심이에요.

Minimal 프로필은 도구 없이 순수하게 대화만 합니다. 일반적인 프로그래밍 질문이나 아이디어 브레인스토밍에 적합하죠.

Cmd+Alt+P(macOS) 또는 Ctrl+Alt+P(Windows/Linux)로 프로필 관리 화면을 열 수 있고, 커스텀 프로필을 만들어서 특정 도구만 활성화하는 것도 가능해요.

컨텍스트 전달하기

AI에게 좋은 답변을 받으려면 적절한 컨텍스트를 넘겨주는 게 중요해요. Zed에서는 여러 가지 방법으로 에이전트에게 컨텍스트를 전달할 수 있어요.

가장 많이 쓰게 될 방법은 @ 멘션입니다. 에이전트 패널의 메시지 입력 영역에서 @를 치면 파일, 디렉토리, 심볼, 이전 스레드, 진단 정보 등을 컨텍스트로 넘겨줄 수 있어요. @src/utils/auth.ts처럼 파일을 지정하면 AI가 해당 파일 내용을 읽고 답변에 반영합니다.

코드를 선택한 상태에서 Cmd+>(macOS) 또는 Ctrl+>(Windows/Linux)를 누르면 선택 영역이 자동으로 에이전트 스레드에 추가됩니다. 이 기능이 정말 편한 게, 에러가 나는 코드를 드래그해서 선택한 다음 “이거 왜 에러가 나?” 하고 물어보면 AI가 바로 해당 코드를 보고 답변해주거든요.

터미널 패널에서도 동일하게 작동합니다. 테스트 실행 결과나 에러 로그를 선택해서 Cmd+>를 누르면 AI에게 바로 전달돼요. 에러 메시지를 일일이 복사해서 붙여넣을 필요가 없어요.

Zed v0.217.1부터는 버퍼에서 텍스트를 복사한 뒤 에이전트 패널의 메시지 박스에 붙여넣으면 자동으로 파일 컨텍스트가 포함된 @ 멘션으로 변환됩니다. 일반 텍스트로 붙여넣고 싶다면 Cmd+Shift+V(macOS) 또는 Ctrl+Shift+V(Windows/Linux)를 쓰면 돼요.

이미지도 바로 붙여넣기로 컨텍스트에 추가할 수 있어서 디자인 목업이나 UI 스크린샷을 보여주면서 “이렇게 구현해줘”라고 요청하는 것도 됩니다.

인라인 어시스턴트

에이전트 패널이 대화 형식의 AI라면, 인라인 어시스턴트는 코드 위에서 바로 동작하는 AI입니다.

코드를 선택하고 Ctrl+Enter를 누르면 인라인 프롬프트 입력 영역이 나타나요. 여기에 “이 함수를 async/await로 변환해줘”라고 입력하면 AI가 선택한 코드를 즉석에서 수정합니다. 에이전트 패널을 열 필요 없이 코드를 보면서 바로 수정할 수 있어서 간단한 변환 작업에 정말 좋아요.

멀티 커서와 함께 사용하면 여러 위치의 코드를 한 번에 바꿀 수도 있습니다. 예를 들어 여러 함수의 시그니처를 동시에 선택해서 타입을 변경하는 식으로요.

인라인 어시스턴트에서도 @ 멘션으로 추가 컨텍스트를 넘겨줄 수 있습니다. “@types.ts에 정의된 타입을 참고해서 이 함수의 리턴 타입을 고쳐줘” 같은 프롬프트가 가능하죠.

여러 모델의 결과를 비교하고 싶다면 inline_alternatives 설정으로 대체 모델을 추가하면 됩니다.

settings.json

{
  "agent": {
    "default_model": {
      "provider": "zed.dev",
      "model": "claude-sonnet-4-5"
    },
    "inline_alternatives": [{ "provider": "zed.dev", "model": "gpt-4o" }]
  }
}

이렇게 설정하면 인라인 어시스턴트를 실행했을 때 두 모델의 결과를 비교해서 더 나은 쪽을 선택할 수 있어요.

편집 예측

편집 예측(Edit Prediction)은 타이핑하는 동안 AI가 다음에 작성할 코드를 예측해서 제안하는 기능이에요. GitHub Copilot의 자동완성과 비슷하지만 좀 더 넓은 범위를 커버해요. 단순히 한 줄을 완성하는 게 아니라 여러 줄에 걸친 편집 패턴을 예측합니다.

기본 예측 모델은 Zed가 자체 개발한 Zeta입니다. 오픈소스 데이터로 학습된 모델이라 라이선스 걱정 없이 쓸 수 있어요. Copilot Next-Edit나 Ollama 같은 다른 모델도 선택할 수 있습니다.

제안이 마음에 들면 Tab을 눌러서 수락하면 됩니다. 인라인 어시스턴트와는 다르게 프롬프트 없이 자동으로 동작하기 때문에 코딩 흐름을 전혀 방해하지 않아요.

도구 권한 관리

AI가 파일을 수정하거나 터미널 명령어를 실행할 때 보안이 걱정될 수 있죠. Zed에서는 AI가 뭘 할 수 있고 없는지를 꽤 세세하게 설정할 수 있어요.

기본 모드는 confirm으로, AI가 뭔가를 실행하려 할 때마다 사용자에게 허가를 구합니다. 신뢰할 수 있는 작업이라면 allow로 바꿔서 자동 승인해도 되고, 특정 명령어는 항상 차단하거나 항상 확인하도록 규칙을 걸 수도 있어요.

settings.json

{
  "agent": {
    "tool_permissions": {
      "default": "confirm",
      "tools": {
        "terminal": {
          "always_allow": [
            { "pattern": "^cargo\\s+(build|test|check)" },
            { "pattern": "^bun\\s+(run|test)" },
            { "pattern": "^git\\s+(status|log|diff)" }
          ],
          "always_deny": [{ "pattern": "rm\\s+-rf\\s+(/|~)" }]
        }
      }
    }
  }
}

이 예시에서는 cargo build, bun run, git status 같은 안전한 명령어는 자동으로 허용하면서 rm -rf / 같은 위험한 명령어는 차단합니다. 정규식 패턴으로 규칙을 쓰니까 프로젝트 성격에 맞게 조정하기도 좋아요.

모델 설정

Zed에서 사용할 AI 모델은 설정에서 자유롭게 바꿀 수 있습니다. 기본적으로 Zed 자체 프록시 서비스(zed.dev)를 통해 여러 모델에 접근할 수 있고 Anthropic, OpenAI, Google 같은 제공자의 API 키를 직접 입력해서 쓸 수도 있어요.

settings.json

{
  "agent": {
    "default_model": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-5"
    }
  }
}

에이전트 패널에서 모델을 바꾸려면 메시지 입력 영역의 모델 선택기를 클릭하거나 Cmd+Alt+/(macOS) 또는 Ctrl+Alt+/(Windows/Linux)를 누르면 됩니다. 자주 쓰는 모델을 즐겨찾기에 등록해두면 Alt+Tab으로 빠르게 전환할 수 있어요.

용도별로 다른 모델을 지정하는 것도 가능합니다. 예를 들어 에이전트 패널은 Claude Sonnet을 쓰고, 커밋 메시지 생성은 가벼운 Haiku를 쓰는 식이에요.

settings.json

{
  "agent": {
    "default_model": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-5"
    },
    "commit_message_model": {
      "provider": "anthropic",
      "model": "claude-haiku-4-5-20251001"
    }
  }
}

클로드 코드 연동

여기서부터가 이 글의 핵심입니다. Zed에서는 에이전트 패널을 통해 클로드 코드를 에디터 안에서 직접 실행할 수 있어요.

클로드 코드는 Anthropic이 만든 터미널 기반 코딩 에이전트인데, 독립적인 프로세스로 실행되면서 프로젝트 파일을 읽고 수정하고 터미널 명령어를 실행합니다. Zed는 ACP(Agent Client Protocol)라는 개방형 프로토콜을 통해 이 클로드 코드를 에이전트 패널의 UI에 연결해줍니다.

클로드 코드 시작하기

에이전트 패널을 열고(Cmd+? 또는 Ctrl+?) 오른쪽 상단의 + 버튼을 클릭하면 에이전트 목록이 나타납니다. 여기서 “Claude Code”를 선택하면 새 스레드가 열려요.

처음 사용할 때는 인증이 필요합니다. 스레드에서 /login을 입력하면 인증 방법을 선택할 수 있어요. Anthropic API 키를 직접 입력하거나 Claude Pro/Max 구독이 있다면 “Log in with Claude Code”를 선택해서 인증하면 됩니다.

중요한 점은 Zed 자체의 AI 인증과 클로드 코드의 인증이 완전히 별개라는 거예요. Zed 설정에 Anthropic API 키를 넣어뒀더라도 클로드 코드를 쓰려면 /login으로 따로 인증해야 합니다.

에디터 선택 영역을 클로드 코드에 전달하기

클로드 코드 스레드가 열려 있을 때 코드를 선택하고 Cmd+>(macOS) 또는 Ctrl+>(Windows/Linux)를 누르면 선택 영역이 클로드 코드 스레드에 컨텍스트로 추가됩니다.

이게 바로 “에디터에서 특정 영역을 선택했을 때 클로드 코드가 알 수 있도록 하는 방법”인데요. 구체적인 워크플로우를 정리하면 이렇습니다.

에이전트 패널에서 클로드 코드 스레드를 엽니다
에디터에서 궁금하거나 수정하고 싶은 코드를 선택합니다
Cmd+>(macOS) 또는 Ctrl+>(Windows/Linux)를 누릅니다
선택한 코드가 스레드의 메시지 입력 영역에 파일 경로와 함께 추가됩니다
프롬프트를 입력하고 전송합니다

예를 들어 테스트가 실패하는 코드를 선택해서 클로드 코드에 보내면서 “이 테스트가 왜 실패하는지 확인하고 고쳐줘”라고 요청할 수 있어요. 클로드 코드가 해당 코드와 관련 파일을 분석한 다음 수정 사항을 제안하거나 직접 코드를 고쳐줍니다.

터미널 출력도 마찬가지로 선택해서 보낼 수 있습니다. 테스트 실행 결과에서 실패한 부분을 드래그해서 Cmd+>를 누르고 “이 에러를 해결해줘”라고 요청하면 클로드 코드가 에러 원인을 파악하고 수정해줍니다.

커맨드 팔레트에서 agent: add selection to thread를 실행하거나 에이전트 패널 메시지 입력 영역의 + 버튼에서 “Selection”을 선택해도 같은 결과를 얻을 수 있어요.

한 가지 주의할 점은, Zed의 터미널 패널에서 claude 명령어로 클로드 코드를 직접 실행하는 경우에는 에디터 선택 영역을 인식하지 못한다는 거예요. VS Code는 확장 프로그램이 터미널에서 실행 중인 클로드 코드에 에디터 컨텍스트를 자동으로 전달하고, JetBrains도 플러그인이 같은 역할을 합니다. 하지만 Zed는 아직 터미널용 IDE 연동을 제공하지 않기 때문에 터미널에서 실행한 클로드 코드는 일반 외부 터미널과 동일하게 동작해요.

따라서 Zed에서 에디터의 선택 영역을 클로드 코드에 전달하려면 반드시 에이전트 패널(ACP)을 통해 실행해야 합니다. 터미널에서 직접 claude를 실행하는 것보다 에이전트 패널을 쓰는 게 Zed에서는 더 나은 선택이에요.

클로드 코드 전용 단축키 설정

클로드 코드를 자주 쓴다면 전용 단축키를 만들어두면 편해요. 단축키 설정 파일(Cmd+K Cmd+S로 열기)에 다음을 추가하면 Cmd+Alt+C로 바로 클로드 코드 스레드를 열 수 있어요.

keymap.json

[
  {
    "bindings": {
      "cmd-alt-c": [
        "agent::NewExternalAgentThread",
        { "agent": { "custom": { "name": "claude-acp" } } }
      ]
    }
  }
]

클로드 코드의 CLAUDE.md 연동

클로드 코드는 프로젝트 루트에 있는 CLAUDE.md 파일이나 .claude/ 디렉토리의 설정을 자동으로 읽습니다. Zed 안에서 실행할 때도 마찬가지예요.

프로젝트에 CLAUDE.md를 만들어두면 클로드 코드가 프로젝트 구조, 코딩 컨벤션, 자주 쓰는 명령어 등을 이해한 상태에서 작업을 시작합니다. CLAUDE.md 작성법을 참고해서 프로젝트에 맞는 설정 파일을 만들어두면 클로드 코드의 답변 품질이 확연히 올라갑니다.

클로드 코드 실행 파일 경로 설정

Zed는 클로드 코드 ACP 어댑터를 자동으로 설치하고 관리합니다. 별도 설정 없이 바로 쓸 수 있지만, 특정 버전의 클로드 코드를 사용하고 싶다면 설정에서 실행 파일 경로를 직접 지정할 수 있어요.

settings.json

{
  "agent_servers": {
    "claude-acp": {
      "type": "registry",
      "env": {
        "CLAUDE_CODE_EXECUTABLE": "/usr/local/bin/claude"
      }
    }
  }
}

Zed 자체 에이전트 vs 클로드 코드

Zed 에이전트 패널에서 Zed 자체 에이전트와 클로드 코드 둘 다 쓸 수 있는데, 어떤 걸 써야 할까요?

Zed 자체 에이전트는 에디터와의 통합이 더 깊습니다. 스레드 히스토리 복원, 체크포인트 자동 생성, 토큰 사용량 표시 같은 기능이 완전히 지원돼요. 모델도 자유롭게 고를 수 있어서 Claude, GPT, Gemini 등을 상황에 맞게 바꿔 쓸 수 있고요.

클로드 코드는 Claude에 최적화된 도구입니다. 클로드 코드의 기억 기능, 서브 에이전트, 플랜 모드 같은 고유 기능이 있고 터미널에서 쓰던 것과 동일한 경험을 에디터 안에서 누릴 수 있어요. 다만 ACP를 통한 연동이 아직 베타이기 때문에 일부 기능(슬래시 커맨드, 과거 메시지 편집, SSH 프로젝트 지원 등)이 제한될 수 있습니다.

가볍게 질문하거나 코드 한 조각을 고칠 때는 Zed 자체 에이전트로도 충분하고, 프로젝트 규모의 리팩토링은 클로드 코드가 더 잘 맞아요.

MCP 서버 연동

Zed는 MCP(Model Context Protocol) 호스트로도 동작합니다. 에이전트에게 외부 도구의 기능을 연결해주는 건데요, 데이터베이스 쿼리나 API 호출 같은 확장 기능을 에이전트가 쓸 수 있게 해줘요.

MCP 서버 설정은 Zed의 settings.json에서 context_servers 키로 관리합니다. 설정하고 나면 에이전트 프로필에서 특정 MCP 도구만 활성화하거나 빌트인 도구를 비활성화하는 것도 됩니다.

예를 들어 GitHub MCP 서버를 연결하면 에이전트가 GitHub 이슈를 읽거나 PR을 만드는 작업까지 할 수 있어요.

주요 단축키 정리

Zed의 AI 관련 단축키를 한곳에 모아봤습니다.

기능	macOS	Windows/Linux
에이전트 패널 열기	`Cmd+?`	`Ctrl+?`
선택 영역을 에이전트에 전달	`Cmd+>`	`Ctrl+>`
인라인 어시스턴트	`Ctrl+Enter`	`Ctrl+Enter`
프로필 관리	`Cmd+Alt+P`	`Ctrl+Alt+P`
모델 전환	`Cmd+Alt+/`	`Ctrl+Alt+/`
최근 스레드 이동	`Cmd+Shift+J`	`Ctrl+Shift+J`
리뷰 탭 열기	`Ctrl+Shift+R`	`Ctrl+Shift+R`

커맨드 팔레트에서 agent를 검색하면 사용 가능한 모든 AI 관련 명령어를 찾을 수 있으니 단축키를 전부 외울 필요는 없어요.

마치며

Zed의 AI 기능은 에디터 안에서 코딩의 거의 모든 단계를 AI와 함께 할 수 있게 해줍니다. 에이전트 패널로 복잡한 작업을 맡기거나 인라인 어시스턴트로 코드를 즉석에서 바꾸는 것도 되고, 편집 예측은 타이핑하면서 자연스럽게 쓰게 됩니다.

특히 클로드 코드 연동은 터미널에서 따로 실행하는 것보다 훨씬 편해요. 코드를 선택해서 Cmd+>로 바로 클로드 코드에 전달하는 워크플로우는 한번 익숙해지면 다른 방식으로 돌아가기 어려울 정도예요.

Zed 에디터 소개나 Zed의 Git 통합 기능도 함께 읽어보시면 Zed를 더 깊이 활용하는 데 도움이 될 거예요. 더 자세한 내용은 Zed AI 공식 문서와 클로드 코드 연동 블로그 글에서 확인해보세요.

This work is licensed under CC BY 4.0

에이전트 패널

에이전트 프로필

컨텍스트 전달하기

인라인 어시스턴트

편집 예측

도구 권한 관리

모델 설정

클로드 코드 연동

클로드 코드 시작하기

에디터 선택 영역을 클로드 코드에 전달하기

클로드 코드 전용 단축키 설정

클로드 코드의 CLAUDE.md 연동

클로드 코드 실행 파일 경로 설정

Zed 자체 에이전트 vs 클로드 코드

MCP 서버 연동

주요 단축키 정리

마치며

개발자를 위한 뉴스레터

관련 포스트

클로드 코드: 터미널 기반 코딩 에이전트

Zed: Atom 창시자가 만든 차세대 코드 에디터

CLAUDE.md 작성 가이드: 프로젝트 규칙을 AI에게 알려주는 법

클로드 코드 자동 메모리: AI가 스스로 기억하는 법