Zed 에디터 사용법, 설치부터 에이전트 설정까지

Zed 에디터 사용법을 설치와 첫 프로젝트 열기부터 AI 모델을 붙이는 세 가지 경로까지 공식 문서 기준으로 정리했습니다. 개인 플랜은 영구 무료이고 자기 API 키를 쓰면 제한이 없으며, 에이전트 샌드박스 설정도 함께 짚었습니다.

TL;DR

  • Zed 에디터 사용법의 출발점은 속도다. 러스트로 새로 쓰고 CPU 여러 코어와 GPU를 쓰도록 만들어서, 큰 파일에서도 입력이 밀리지 않는다.
  • 개인 플랜이 영구 무료다. 자기 API 키나 외부 에이전트를 붙이면 AI 기능도 제한 없이 쓴다.
  • 에이전트를 병렬로 돌린다. 터미널과 네트워크 접근을 제한하는 샌드박스 설정이 별도로 있다.

Zed 에디터 사용법을 알아보는 이유는 대개 두 가지다.
쓰던 에디터가 무거워졌거나, AI 기능이 붙으면서 응답이 느려진 게 거슬리거나.

Zed는 그 지점을 겨냥해 만들어졌다.
Atom과 Tree-sitter를 만든 팀이 처음부터 러스트로 다시 썼고, 여러 CPU 코어와 GPU를 활용하도록 설계했다.
여기에 협업과 에이전트를 얹었는데, 나중에 붙인 게 아니라 처음부터 같이 설계한 구조다.
깃허브 별이 8만 9천 개를 넘겼고 맥과 리눅스, 윈도우를 모두 지원한다.
아래는 설치부터 첫 프로젝트를 열고, AI를 어떻게 붙일지 정하는 데까지를 공식 문서와 요금표 기준으로 정리한 것이다.

에디터를 바꿀 만한 이유 세 가지

에디터를 바꾸는 건 비용이 큰 일이다.
단축키와 확장, 설정을 다시 맞춰야 한다.
그 비용을 감수할 이유가 있는지부터 보는 게 순서다.

속도가 첫째다.
러스트로 짜고 GPU를 쓰는 렌더링이라 스크롤과 입력 지연이 눈에 띄게 짧다.
큰 파일을 자주 여는 작업이라면 이 차이가 매일 쌓인다.

협업이 둘째다.
팀원과 채팅하고, 같은 파일을 함께 편집하고, 화면과 프로젝트를 공유하는 기능이 제품 안에 있다.
별도 확장을 깔지 않아도 된다.

에이전트가 셋째다.
여러 에이전트를 병렬로 돌려 파일을 고치고 코드를 탐색하고 도구를 실행한다.
공식 설명은 이 동작이 네이티브 속도로 이뤄진다고 표현한다.

Zed 에디터 사용법, 첫 프로젝트까지

  1. 공식 사이트에서 자기 운영체제용 빌드를 받아 설치합니다.
  2. 실행하면 환영 화면이 나옵니다. 폴더 열기, 저장소 복제, 문서 보기 같은 빠른 동작이 여기 있습니다.
  3. 프로젝트를 엽니다. 터미널에서 zed ~/projects/my-app 처럼 경로를 주거나, 에디터 안에서 단축키로 폴더를 엽니다.
  4. 폴더를 열면 환영 화면이 사라지고 편집 화면이 나옵니다.
  5. 명령 팔레트를 익힙니다. 대부분의 기능이 여기로 접근됩니다.
  6. AI를 쓸지 정합니다. 자기 API 키를 넣을지, 외부 에이전트를 붙일지, Zed 호스팅 모델을 쓸지 고릅니다.
  7. 에이전트에 터미널을 맡길 계획이면 샌드박스 설정을 먼저 확인합니다.

3번에서 헷갈리는 부분이 있다.
편집기를 여러 패널로 나눈 경우 환영 화면은 가운데 패널에만 나타난다.
다시 열려면 가운데 패널의 항목을 모두 닫거나 명령 팔레트에서 찾으면 된다.

요금제와 무료 범위

플랜요금핵심
Personal$0 영구 무료편집 예측 2,000회, 자기 API 키나 외부 에이전트로 무제한 사용
Pro월 $10편집 예측 무제한, 토큰 $5어치 포함, 초과분은 사용량 과금
Business좌석당 월 $30조직 단위 모델 정책, 데이터 거버넌스, 지출 가시성, 역할 기반 접근 제어

여기서 눈여겨볼 게 개인 플랜의 조건이다. “자기 키나 외부 에이전트로는 무제한”이라고 표기돼 있다.
이미 어딘가에서 모델 API를 쓰고 있거나 Claude Agent, Codex CLI 같은 외부 에이전트를 붙일 생각이라면 무료로 상당히 멀리 갈 수 있다는 뜻이다.

유료로 넘어가는 이유는 편의다.
Zed가 호스팅하는 모델을 바로 쓰고 편집 예측을 무제한으로 받는 구성이다.
조직용은 사용량이 아니라 통제가 이유다.
조직 전체에 모델 정책을 걸고 지출을 한곳에서 보는 항목들이 여기 있다.

25석 이상은 별도 계약서를 쓸 수 있다고 표기돼 있다.


에이전트에 샌드박스를 거는 이유

2026년 8월에 들어간 기능 중 실무에서 중요한 게 샌드박스다.
에이전트가 터미널과 네트워크 가져오기 도구를 쓸 때 무엇을 할 수 있는지 제한한다.

이게 필요한 이유는 분명하다.
코드를 고치는 것과 명령을 실행하는 것은 위험도가 다르다.
파일 수정은 되돌릴 수 있지만 삭제 명령이나 외부로 나가는 요청은 그렇지 않다.

에이전트를 여러 개 병렬로 돌리는 구조라면 이 설정이 더 중요해진다.
사람이 매 동작을 확인하지 못하는 상태에서 도는 것이기 때문이다.
에이전트에 터미널을 맡기기 전에 이 항목부터 정하는 순서를 권한다.

모델을 붙이는 세 가지 방법

Zed는 특정 모델에 묶여 있지 않다.
블로그에 각 경로를 다룬 글이 따로 올라와 있다.

자기 API 키를 넣는 방식이 가장 단순하다.
쓰던 제공사 키를 그대로 붙이면 비용이 그쪽으로 청구된다.

구독 연결도 가능하다.
이미 쓰고 있는 AI 구독을 에디터에 연결해 별도 결제 없이 쓰는 경로가 문서화돼 있다.

로컬 모델을 붙이는 방법도 안내돼 있다.
코드를 외부로 보내지 않아야 하는 상황이라면 이쪽이다.
다만 로컬 실행 환경은 따로 준비해야 한다.

세 경로 모두 개인 플랜에서 열려 있다.
그래서 “무료 플랜은 AI가 안 된다”는 통상적인 구조와 다르다.

한계와 안 맞는 경우

  • 확장 생태계가 필요한 경우. 오래된 에디터만큼 플러그인이 많지 않다.
  • 특정 언어의 깊은 지원이 필요한 경우. 언어별 도구 성숙도가 갈린다.
  • 기존 설정을 그대로 옮기려는 경우. 단축키와 설정 체계가 달라 다시 맞춰야 한다.
  • 원격 서버에서 직접 편집하는 작업. 로컬 애플리케이션이 전제다.

제품 만들 때 가져갈 설계

첫째는 성능을 제품의 정체성으로 삼은 점이다.
에디터는 기능으로 경쟁하기 쉬운 카테고리인데, 여기서는 “빠르다”를 앞세우고 그걸 위해 언어와 렌더링까지 새로 골랐다.
남과 같은 방식으로 만들면 남과 같은 결과가 나온다는 걸 보여주는 사례다.

둘째는 무료 플랜에서 AI를 막지 않은 결정이다.
대신 “누구 키로 쓰느냐”로 나눴다.
자기 키를 쓰면 무제한, 우리 모델을 쓰면 과금.
사용자가 납득하기 쉬운 경계다.

셋째는 위험한 동작에 별도 층을 만든 방식이다.
에이전트를 병렬로 돌리는 제품이면 통제 장치가 기능이 아니라 전제가 되어야 한다.

실행 체크리스트

  1. 자기 운영체제용 빌드를 받아 설치합니다.
  2. 프로젝트 폴더를 열어 편집 화면을 띄웁니다.
  3. 명령 팔레트로 주요 기능을 훑습니다.
  4. 자주 쓰는 단축키를 기존 에디터에 맞춰 조정합니다.
  5. AI를 쓸지, 쓴다면 어느 경로로 붙일지 정합니다.
  6. 자기 키가 있으면 개인 플랜 무료 범위 안에서 먼저 써봅니다.
  7. 에이전트에 터미널을 맡기기 전에 샌드박스 설정을 확인합니다.
  8. 팀으로 쓸 계획이면 모델 정책과 지출 가시성이 필요한지 판단합니다.
  9. 코드를 외부로 보낼 수 없으면 로컬 모델 연결 문서를 봅니다.

자주 묻는 질문

Zed는 무료인가요

개인 플랜이 영구 무료입니다.
편집 예측 2,000회가 포함되고, 자기 API 키나 외부 에이전트를 붙이면 제한 없이 쓸 수 있습니다.

Pro 플랜은 무엇이 다른가요

월 $10에 편집 예측이 무제한이 되고 토큰 $5어치가 포함됩니다.
그 이상은 사용량 기준으로 청구됩니다.

어떤 AI 모델을 쓸 수 있나요

자기 API 키를 넣거나, 쓰고 있는 AI 구독을 연결하거나, 로컬 모델을 붙이는 세 가지 경로가 문서화돼 있습니다.
Zed가 호스팅하는 모델은 Pro 플랜에 포함됩니다.

에이전트가 터미널 명령을 실행해도 안전한가요

샌드박스 기능으로 에이전트가 터미널과 네트워크 도구로 무엇을 할 수 있는지 제한할 수 있습니다.
에이전트를 병렬로 돌릴 계획이라면 이 설정을 먼저 잡는 것이 좋습니다.

참고한 곳