개발자가 에디터 안에서 지능형 Agent와 직접 작업할 수 있게 되면서 AI 코딩은 점점 더 쉬워지고 있습니다. Zed ACP는 AI 코딩 Agent를 Zed와 연결해 이를 가능하게 하며, 이를 통해 여러 도구를 계속 오가지 않고도 도움을 받을 수 있습니다. 코드를 작성하고 작업을 관리하며 AI와 함께 일하는 방식을 스스로 선택할 수 있는 더 큰 유연함을 제공합니다. 이 가이드에서는 Zed ACP가 어떻게 작동하는지, 그리고 에디터 안에서 이를 어떻게 사용할 수 있는지 설명합니다.
Zed ACP란 무엇인가요?
Zed ACP는 Agent Client Protocol의 줄임말로, AI 코딩 Agent가 Zed 에디터에 직접 연결될 수 있게 해주는 개방형 프로토콜입니다. AI 코딩 Agent가 에디터와 통신할 수 있는 표준화된 방식을 제공하며, 이를 통해 Agent는 에디터 인터페이스를 거쳐 프로젝트 컨텍스트에 접근하고, 변경 사항을 제안하고, 코딩 작업을 지원할 수 있습니다. 별도의 도구를 사용하는 대신 같은 인터페이스 안에서 AI Agent와 함께 작업할 수 있습니다. 이를 통해 개발자는 필요에 따라 Agent를 자유롭게 선택하고 전환할 수 있습니다.
Agent Client Protocol(ACP)은 어떻게 작동하나요?
AI Agent는 작업을 이해하고, 적절한 컨텍스트에 접근하며, 필요할 때 변경을 수행하기 위해 에디터와 명확하게 통신할 방법이 필요합니다. ACP는 표준화된 통신 과정을 통해 이러한 연결을 제공하여 AI Agent와 에디터가 정보를 교환하고 함께 작업하기 쉽게 만듭니다. Agent Client Protocol이 작동하는 방식은 다음과 같습니다.
ACP는 AI Agent와 코딩 환경을 연결합니다
ACP 아키텍처는 ACP 프로토콜을 통해 개발자, Zed Editor, AI 코딩 Agent 사이의 연결을 만듭니다. Zed는 클라이언트 역할을 하며 작업과 컨텍스트를 Agent에 전달하고, Agent는 이를 바탕으로 LLM, 도구, 코드베이스를 활용해 작업을 완료합니다. 이 구조는 에디터와 Agent 간 통신을 체계적으로 유지해 한곳에서 코딩 작업을 더 쉽게 처리할 수 있게 해줍니다.
Developer
↓
Zed Editor (ACP Client)
↓
ACP Protocol
↓
AI Coding Agent
↓
LLM + Tools + CodebaseACP와 MCP: 차이점은 무엇인가요?
ACP와 MCP는 둘 다 AI 시스템이 다른 구성 요소와 상호작용하도록 돕는다는 점에서 비슷해 보일 수 있지만, 서로 다른 역할을 합니다. ACP는 AI 코딩 Agent를 에디터 및 개발 환경과 연결하는 데 초점을 맞추고, MCP는 AI 애플리케이션을 외부 도구, 데이터 소스, 서비스와 연결합니다. 두 프로토콜의 차이는 다음과 같습니다.
| 프로토콜 | 주요 목적 |
|---|---|
| ACP | AI Agent를 코딩 환경과 연결 |
| MCP | AI 모델/Agent를 외부 도구 및 데이터 소스와 연결 |
왜 Zed에서 ACP를 사용해야 하나요?
ACP는 AI Agent를 개발자가 이미 사용하는 도구와 파일에 더 가깝게 만들어 코딩 경험을 더 유연하게 해줄 수 있습니다. Agent가 에디터와 상호작용하는 방식을 단순화하고 여러 애플리케이션을 오갈 필요를 줄여줄 수 있습니다. Zed에서 ACP를 사용해야 하는 주요 이유는 다음과 같습니다.
하나의 에디터에서 다양한 AI 코딩 Agent 사용
ACP를 사용하면 Zed는 동일한 프로토콜을 통해 여러 AI 코딩 Agent와 함께 작동할 수 있습니다. 개발자는 더 이상 특정 에디터에 내장된 AI 기능에만 제한되거나 서로 다른 코딩 환경 사이를 옮겨 다닐 필요가 없습니다.
ACP 호환 Agent를 사용하면 개발자는 다음을 할 수 있습니다.
코딩 작업에 따라 AI Agent 선택하기
에디터 워크플로를 바꾸지 않고 에이전트 간 전환하기
새로 나오는 AI 코딩 도구를 바로 테스트하기
예를 들어 개발자는 ACP를 통해 Kimi Code CLI를 Zed에 연결하여 Kimi Code CLI의 코딩 기능을 Zed 환경 안에서 직접 사용할 수 있습니다.
AI 지원을 코딩 워크플로 안에 두기
ACP의 가장 큰 장점 중 하나는 AI 에이전트를 개발 프로세스에 더 가깝게 만들어 준다는 점입니다. 챗봇과 에디터 사이에서 코드를 복사해 옮기는 대신, 개발자는 Zed 안에서 AI 에이전트와 직접 상호작용할 수 있습니다.
ACP를 통해 AI 에이전트는 다음과 상호작용할 수 있습니다:
에디터가 제공하는 프로젝트 컨텍스트
열려 있는 파일과 코드 정보
에디터에서 전달되는 개발자 지시사항
이를 통해 다음과 같은 작업이 더 매끄러워집니다:
낯선 코드 설명하기
새 기능 생성하기
기존 파일 리팩터링하기
프로젝트 전체의 문제 디버깅하기
에디터와 AI 에이전트를 분리하기
ACP는 코딩 환경과 에이전트를 구동하는 AI 모델을 명확하게 분리합니다.
이 아키텍처에서는:
Zed는 빠르고 효율적인 개발 인터페이스를 제공하는 데 집중합니다
AI 에이전트는 추론, 코드 생성, 작업 실행을 담당합니다
개발자는 에디터를 바꾸지 않고 에이전트를 교체하거나 추가할 수 있습니다
이러한 유연성은 개발자가 하나의 AI 코딩 솔루션에 고정되는 것을 막아주며, 더 개방적인 AI 개발 생태계를 지원합니다.
더 유연한 에이전트 기반 개발 워크플로 구축하기
현대의 AI 코딩은 단순한 코드 완성에서 벗어나, 프로젝트를 이해하고 작업을 계획하며 여러 단계의 변경을 실행할 수 있는 자율 에이전트로 나아가고 있습니다.
ACP는 Zed에서 이러한 워크플로에 필요한 연결 계층을 제공합니다. MCP(Model Context Protocol)와 같은 도구와 결합하면, AI 에이전트는 에디터 워크플로와의 연결을 유지하면서도 추가적인 도구, 외부 리소스, 개발 서비스에 접근할 수 있습니다.
개발자에게 이는 Zed가 여러 AI 에이전트가 코드, 도구, 프로젝트 컨텍스트와 협업하는 중심 작업 공간이 될 수 있다는 의미입니다.
Zed는 ACP 호환 에이전트와 어떻게 작동하나요?
Zed는 ACP(Agent Client Protocol)를 사용해 표준화된 인터페이스로 외부 AI 코딩 에이전트를 연결합니다. 이 구조에서 Zed는 ACP 클라이언트 역할을 하고, 연결된 AI 코딩 도구는 ACP 에이전트로 작동합니다.
개발자가 Zed에서 AI 코딩 세션을 시작하면, 에디터는 ACP를 통해 에이전트와 통신합니다. 이를 통해 에이전트는 코딩 요청을 받고 관련 프로젝트 컨텍스트에 접근하며, 응답이나 코드 변경 사항을 에디터로 다시 전송할 수 있습니다.
이 아키텍처는 에디터와 AI 에이전트를 분리된 상태로 유지하여, 각 도구마다 별도의 커스텀 통합 없이도 다양한 ACP 호환 에이전트를 Zed에 연결할 수 있게 합니다.
ACP 지원을 통해 개발자는 Kimi Code CLI와 같은 AI 코딩 에이전트를 Zed에 연결하여, 기존 개발 워크플로 안에서 AI 기반 코딩 지원을 바로 사용할 수 있습니다.
ACP로 Kimi Code CLI를 Zed에 연결하는 방법
Kimi Code CLI는 ACP 통합을 지원하므로 개발자는 Zed 안에서 바로 Kimi의 AI 코딩 기능을 사용할 수 있습니다. Kimi Code CLI를 설치하고 인증을 완료한 다음 Zed에 ACP 에이전트 설정을 추가하기만 하면 됩니다.
사전 준비 사항
Kimi Code CLI를 Zed에 연결하기 전에 다음을 준비했는지 확인하세요:
Kimi Code CLI 설치 완료
Kimi Code CLI 로그인 설정 완료
ACP를 지원하는 최신 버전의 Zed 설치
Kimi Code CLI는 kimi acp 명령을 제공하며, 이 명령을 실행하면 CLI가 ACP 모드로 시작됩니다. Zed는 이 명령을 ACP 에이전트로 실행하고 해당 프로토콜을 통해 통신합니다.
1단계: Kimi Code CLI 경로 찾기 (선택 사항)
대부분의 경우 설정에서 kimi를 그대로 사용할 수 있습니다. Zed가 명령을 찾지 못한다면 설치 경로를 확인하세요:
which kimi나중에 사용할 수 있도록 반환된 경로를 복사해 두세요.
특히 macOS에서는 데스크톱에서 실행한 애플리케이션이 터미널의 PATH 환경 변수를 상속받지 않을 수 있으므로 이 방법이 유용합니다.
2단계: Zed에서 Kimi Code CLI 설정하기
Zed 설정 파일을 여세요:
~/.config/zed/settings.json다음 agent_servers 설정을 추가하세요:
{
"agent_servers": {
"Kimi Code CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}설정 세부 정보:
type: 사용자 지정 ACP 에이전트인 경우"custom"으로 설정command: Kimi Code CLI 실행 파일 경로args:acp를 사용해 Kimi Code CLI를 ACP 모드로 시작env: 선택적 환경 변수로, 보통 빈 값으로 둡니다
시스템 PATH에 kimi가 없다면 전체 경로로 교체하세요:
"command": "/your/path/to/kimi""command": "/your/path/to/kimi"3단계: Zed에서 Kimi Code CLI 시작하기
설정을 저장한 후:
Zed를 엽니다
에이전트 패널을 엽니다
새 대화를 생성합니다
에이전트로 Kimi Code CLI를 선택합니다
Zed는 Kimi Code CLI를 ACP 하위 프로세스로 자동 실행하고 연결을 설정합니다. 터미널에서 직접 kimi acp를 실행할 필요는 없습니다.
4단계: Zed에서 Kimi로 코딩 시작하기
연결이 완료되면 Zed 안에서 다음과 같은 작업에 Kimi Code CLI를 사용할 수 있습니다:
프로젝트 코드 이해하기
새 기능 생성하기
파일 리팩터링하기
문제 디버깅하기
프로젝트 컨텍스트를 활용해 여러 파일 다루기
ACP를 사용하면 Kimi Code CLI가 Zed 내부에서 통합 코딩 에이전트로 실행되어, Zed의 편집 경험과 Kimi의 AI 기반 개발 기능을 결합합니다.
Zed에서 Kimi Code를 사용할 때의 장점
Kimi Code는 코딩 환경을 벗어나지 않고 AI의 도움을 받고 싶은 개발자에게 Zed를 더 유용하게 만들어 줄 수 있습니다. ACP를 통해 에이전트를 연결하면 개발자는 코딩 작업을 처리하고, 기존 프로젝트를 다루고, 자연어로 도움을 받을 수 있습니다. Zed에서 Kimi Code를 사용할 때의 주요 장점은 다음과 같습니다.
대규모 코드베이스 이해 및 탐색
Kimi Code는 프로젝트 파일을 분석하고 코드베이스의 각 부분이 어떻게 연결되어 있는지 파악할 수 있습니다. 이를 통해 개발자는 관련 파일, 함수, 로직을 더 빠르게 찾을 수 있습니다. 특히 규모가 크거나 익숙하지 않은 프로젝트를 다룰 때 유용합니다.
자연어로 코드 생성 및 수정
개발자는 모든 변경 사항을 직접 작성하는 대신 원하는 내용을 간단한 언어로 설명할 수 있습니다. Kimi Code는 주어진 지시에 따라 새 코드를 생성하거나 기존 코드를 수정할 수 있습니다. 이를 통해 일반적인 개발 작업을 더 빠르고 쉽게 처리할 수 있습니다.
여러 파일에 걸친 코딩 작업 지원
많은 개발 작업은 한 곳이 아니라 여러 파일에 걸친 변경을 필요로 합니다. Kimi Code는 작업의 전체적인 맥락을 파악하고 관련된 파일들에서 필요한 업데이트를 수행할 수 있습니다. 이를 통해 프로젝트 전체에서 관련 변경 사항의 일관성을 유지할 수 있습니다.
기존 코드 디버깅 및 개선
Kimi Code는 기존 코드를 검토해 잠재적인 문제를 파악하고 원인을 설명하는 데 도움을 줄 수 있습니다. 또한 수정 방법을 제안하고, 코드 구조를 개선하고, 개발자의 지시에 따라 변경할 수도 있습니다. 이를 통해 오류를 직접 찾고 해결하는 데 드는 시간을 줄일 수 있습니다.
에이전트 기반 개발 워크플로 구축
Zed와 함께 Kimi Code를 사용하면 개발자는 일상적인 개발 과정에 AI 에이전트를 포함시킬 수 있습니다. 에이전트는 편집기 안에서 코딩 및 프로젝트 변경과 같은 작업을 지원할 수 있습니다. 이를 통해 개발자가 AI 에이전트를 별도의 도구가 아니라 함께 작업하는 파트너로 활용하는 유연한 워크플로를 만들 수 있습니다.
Zed ACP 통합 문제 해결하기
몇 가지 설정 또는 구성 문제로 인해 Zed에서 ACP 에이전트가 제대로 작동하지 않을 수 있습니다. 대부분의 문제는 에이전트 구성, 명령 경로, 인증 또는 연결과 관련이 있으며, 몇 가지 간단한 확인으로 해결할 수 있습니다. 흔히 발생하는 문제와 해결 방법은 다음과 같습니다.
| 문제 | 추정 원인 | 해결 방법 |
|---|---|---|
| Zed에 Kimi Code CLI가 표시되지 않음 | agent_servers 구성이 없거나 구문 오류가 있음 | settings.json 파일을 확인하고 Kimi Code CLI 구성이 올바르게 추가되었는지 확인하세요 |
| Zed가 kimi 명령을 찾지 못함 | 시스템 PATH에 Kimi Code CLI가 없음 | which kimi 명령을 실행해 실행 파일 경로를 확인한 뒤, "command": "kimi"를 전체 경로로 바꾸세요 |
| ACP 에이전트가 시작된 후 즉시 종료됨 | Kimi Code CLI 설치 또는 인증이 완료되지 않았습니다 | 터미널에서 kimi acp를 실행해 ACP 모드가 정상적으로 시작되는지 확인한 다음, 필요하면 로그인 절차를 완료하세요 |
| 에이전트를 시작할 때 인증 오류가 발생하는 경우 | Kimi Code CLI 계정 인증이 만료되었거나 설정되지 않았습니다 | Kimi Code CLI에 다시 로그인한 후 Zed를 재시작하세요 |
| settings.json을 변경해도 적용되지 않는 경우 | Zed가 업데이트된 구성을 다시 불러오지 않았습니다 | 구성 파일을 수정한 후 Zed를 재시작하세요 |
| 코딩 작업 중 에이전트 응답이 느리거나 실패하는 경우 | 네트워크 연결 문제 또는 큰 프로젝트 컨텍스트 | 네트워크 연결 상태를 확인하고 더 작은 프로젝트 범위로 작업해 보세요 |
결론
Zed ACP는 개발자가 일상적인 코딩 워크플로우에 AI 지원을 유연하게 도입할 수 있는 방법을 제공합니다. 또한 에디터를 개발의 중심에 두면서도 다양한 에이전트를 손쉽게 활용할 수 있게 해줍니다. AI 코딩이 계속 발전함에 따라, 이러한 방식은 개발을 더 효율적이고 유연하게 만드는 데 도움이 될 수 있습니다. 이 워크플로우를 직접 살펴보고 싶다면 Zed에서 Kimi Code를 사용해 보고 자신의 코딩 방식에 잘 맞는지 확인해 보세요. 지금 Kimi를 사용해 보고 더 자연스러운 AI 지원 개발 워크플로우를 경험해 보세요.