Zed AI(제드)로 코드 리뷰를 자동화하는 3단계【2026년판·초보자용】
機械翻訳 / Machine-translated
A
AI Friends
10時間前・8分で読める
機械翻訳 / Machine-translated
@aifriends
AI Friends（https://aifriends.jp）のクロスポスト公式アカウント。AIツールの紹介・使い方・できることを、中学生でもわかるやさしい日本語で届けます。
프로그래밍을 막 배우기 시작한 분이나 팀에서 코드를 작성하는 분에게 코드 리뷰（다른 사람이 작성한 코드를 확인하는 것）는 매우 중요한 작업입니다. 하지만 매번 수작업으로 확인하는 것은 시간이 많이 걸리죠.
이 글에서는 초고속으로 동작하는 AI 코드 에디터 「Zed AI（제드）」를 사용해 코드 리뷰를 자동화하는 방법을 초보자도 알기 쉽게 3단계로 설명합니다.
코드 리뷰는 버그（프로그램의 오류）를 찾거나 더 나은 작성법을 배우기 위해 빠질 수 없는 과정입니다. 다만 사람이 직접 수행하면 파일 하나를 확인하는 데 30분 이상 걸리는 경우도 드물지 않습니다.
Zed AI（제드）는 Rust（러스트）라는 고속 언어로 만들어진 에디터로, GPU（그래픽 처리를 빠르게 하는 부품）를 활용해 120fps（1초에 120번 화면을 갱신하는 부드러움）로 동작합니다. 또한 Claude（클로드）나 GPT（지피티）와 같은 최신 AI（사람처럼 문장을 이해하고 답변하는 컴퓨터）가 내장되어 있어, 코드의 문제점을 몇 초 만에 지적해 줍니다.
무료 플랜에서도 월 2,000회까지 AI 예측 기능（Edit Predictions）을 사용할 수 있어, 개인 개발이나 학습 목적이라면 충분합니다. 유료 플랜（Zed Pro）은 월 10달러로 무제한 이용할 수 있으며, 자신의 API 키（AI 서비스를 이용하기 위한 비밀번호 같은 것）를 가져오면 추가 비용 없이 사용할 수 있습니다.
먼저 Zed AI를 사용할 수 있는 상태로 만들어 봅시다. 공식 사이트（zed.dev）에 접속해 자신의 컴퓨터 OS（Windows, Mac, Linux 등）에 맞는 버전을 다운로드합니다.
설치 절차：
다음으로 AI 기능을 활성화합니다. 화면 우측 상단의 설정 아이콘（⚙ 마크）을 클릭하고 「Assistant」 탭을 엽니다. 여기서 「Provider」（AI 서비스 제공처）를 선택합니다. Claude, OpenAI, Gemini, 로컬에서 동작하는 Ollama（올라마） 등에서 선택할 수 있습니다. 처음 사용하는 분에게는 무료 사용량이 있는 Claude를 추천합니다.
API 키 설정이 필요한 경우, 선택한 AI 서비스의 공식 사이트에서 무료 계정을 만들고, 발급된 키를 Zed 설정 화면에 붙여 넣으면 됩니다. 이것으로 준비가 완료됩니다.
실제로 코드 리뷰를 자동화하는 설정을 해보겠습니다. Zed AI에는 3가지 주요 AI 기능이 있습니다.
1. Agent Panel（에이전트 패널）
화면 오른쪽에 채팅 형식으로 AI와 대화할 수 있는 패널입니다. 「Cmd+Shift+A」（Mac의 경우）또는 「Ctrl+Shift+A」（Windows의 경우）로 열 수 있습니다. 여기에 리뷰받고 싶은 파일을 드래그 앤 드롭하거나, 파일을 열어 둔 상태에서 「이 코드를 리뷰해 줘」라고 입력하면 AI가 문제점이나 개선안을 한국어로 알려줍니다.
2. Inline Assistant（인라인 어시스턴트）
코드의 특정 부분만 확인하고 싶을 때 편리합니다. 리뷰받고 싶은 행을 선택하고 우클릭해서 「Inline Assistant」를 선택하거나, 「Cmd+I」（Mac）또는 「Ctrl+I」（Windows）를 누릅니다. 「에러 핸들링을 추가해 줘」, 「이 함수의 문제점을 알려줘」 등 구체적인 지시를 내리면 바로 수정안을 표시해 줍니다.
3. Edit Predictions（편집 예측）
코드를 작성하는 도중에 다음에 써야 할 내용을 AI가 예측해 회색 글자로 제안해 줍니다. Tab 키를 누르면 제안을 채택할 수 있습니다. 이를 통해 오탈자나 구문 오류（코드 작성법의 실수）를 사전에 방지할 수 있습니다.
코드 리뷰를 자동화하려면, Agent Panel을 열어 둔 상태에서 프로젝트 폴더 전체를 불러온 뒤, 「모든 파일을 리뷰해서 버그와 보안 문제를 목록으로 만들어 줘」라고 지시하는 것이 효율적입니다.
실제로 코드 리뷰를 실행해 봅시다. 예시로 JavaScript 샘플 코드（간단한 함수가 작성된 파일）를 준비합니다.
Agent Panel에 다음과 같이 입력합니다：
「이 코드를 리뷰해서 다음 사항을 확인해 주세요. 1. 에러 처리가 적절한지 2. 변수명이 이해하기 쉬운지 3. 보안 리스크가 없는지」
몇 초 기다리면 AI가 목록 형태로 결과를 반환해 줍니다. 예를 들어 「14번째 줄：try-catch로 에러를 캐치하고 있지만 에러 메시지를 로그에 출력하지 않습니다」, 「23번째 줄：변수명 'x'는 의미가 불분명합니다. 'userId' 등으로 변경하는 것을 권장합니다」와 같은 구체적인 지적이 표시됩니다.
지적된 부분을 클릭하면 해당 코드 행으로 이동합니다. Inline Assistant를 사용하면 그 자리에서 「권장 수정을 적용해 줘」라고 지시하는 것만으로 AI가 자동으로 코드를 수정해 줍니다. 변경 내용은 diff（변경 전후의 차이）로 표시되므로, 문제가 없으면 「Accept」 버튼을 눌러 확정합니다.
여러 파일을 한 번에 리뷰하는 경우 병렬 에이전트 기능（2026년 6월 업데이트로 추가）을 사용합니다. Agent Panel에서 「새 스레드 열기」를 선택해 별개의 파일을 동시에 리뷰시키면 시간을 크게 단축할 수 있습니다.
문제 1: AI가 한국어로 답변하지 않는 경우
기본 설정에서는 영어로 답변되는 경우가 있습니다. Agent Panel에 「한국어로 답변해 주세요」라고 먼저 지시하거나, 설정 화면의 「Assistant」 탭의 「Custom Instructions」에 「항상 한국어로 답변할 것」이라고 적어 두면 해결됩니다.
문제 2: API 키 오류가 발생하는 경우
「API key invalid」라는 오류가 표시될 경우, 키의 유효 기간이 만료되었거나 복사할 때 공백이 포함되었을 가능성이 있습니다. AI 서비스 관리 화면에서 새로운 키를 발급받아 다시 붙여 넣으세요.
문제 3: 리뷰 결과가 엉뚱한 경우
AI에게 충분한 정보를 제공하지 않으면 정확한 리뷰를 할 수 없습니다. 「이 프로젝트는 Node.js로 작성된 웹 앱입니다」, 「초보자용 튜토리얼 코드입니다」 등 컨텍스트（상황과 배경）를 전달하면 정확도가 올라갑니다.
문제 4: 동작이 느린 경우
많은 파일을 한 번에 불러오면 처리가 느려집니다. 폴더 전체가 아닌 변경이 있는 파일만 선택해 리뷰시키세요. 또한 로컬 모델（Ollama）을 사용할 경우 컴퓨터 사양（성능）이 낮으면 느려질 수 있으므로 클라우드형 Claude나 GPT로 전환하는 것을 권장합니다.
커스텀 리뷰 템플릿 만들기
매번 같은 지시를 입력하는 것은 번거롭습니다. 자주 사용하는 리뷰 항목（「명명 규칙 확인」, 「성능 문제 지적」 등）을 텍스트 파일에 저장해 두고 Agent Panel에 붙여 넣으면 효율적입니다.
다른 도구와의 연계
Zed AI는 Git（버전 관리 도구）과 통합되어 있어, 커밋 전에 「git diff」（변경 부분의 차이）를 AI에게 리뷰시킬 수도 있습니다. 커밋 메시지（변경 내용 설명문）도 자동으로 생성해 주므로 작업이 한층 편해집니다.
여러 AI 모델 구분해서 사용하기
복잡한 로직（처리 흐름）의 리뷰에는 Claude Opus, 간단한 구문 확인에는 경량 Haiku나 Gemini, 비용을 중시한다면 로컬의 Ollama처럼 작업에 따라 모델을 전환하면 효율과 비용의 균형을 맞출 수 있습니다. 설정 화면에서 간단하게 변경할 수 있습니다.
실시간 협업
팀에서 코드를 작성하는 경우, Zed의 실시간 공동 편집 기능을 활용하면 여러 명이 같은 파일을 동시에 편집하면서 AI의 리뷰를 받을 수 있습니다. 화면에 다른 멤버의 커서（입력 위치）가 표시되므로 누가 어디를 편집하는지 한눈에 알 수 있습니다.
Zed AI（제드）를 사용하면 코드 리뷰를 몇 초 만에 자동화할 수 있으며, 초보자도 쉽게 프로 수준의 검토를 할 수 있습니다. 이 글에서 소개한 3단계를 다시 정리해 봅시다.
2026년판 Zed AI는 Fast 모드（고속 응답）나 병렬 에이전트 기능 등 더욱 진화했습니다. 무료 플랜으로도 충분히 사용할 수 있으니, 먼저 사용해 보고 여러분의 코딩 작업을 더욱 쾌적하게 만들어 보세요.
이 글은 AI Friends 에서 크로스포스트한 글입니다.
