요약 (TL;DR)
Cursor의 새로운 에이전트 컴퓨터 사용 기능은 AI 클라우드 에이전트가 자체 가상 머신을 제어하여 코드를 자율적으로 빌드, 테스트 및 검증할 수 있도록 지원합니다. 에이전트는 완전한 개발 환경을 갖춘 격리된 VM에서 실행되며, 브라우저를 열고 로컬 호스트를 탐색할 수 있고, 비디오 및 로그를 포함한 병합 준비 완료 풀 리퀘스트를 생성합니다. Cursor 데스크톱, 웹, Slack, GitHub 또는 API를 통해 액세스할 수 있습니다. Cursor 내부 코드 변경 사항의 30% 이상이 이제 이러한 자율 에이전트에 의해 생성됩니다.
소개
개발자들이 코드를 작성하는 방식이 빠르게 변화하고 있습니다. 수년간 Cursor와 같은 AI 코딩 도우미는 다음 줄을 제안하고, 코드를 설명하거나, 기존 작업을 리팩토링하는 데 도움을 주는 지능형 자동 완성 도구 역할을 해왔습니다. 그러나 지금 큰 변화가 일어나고 있습니다.
Cursor는 "탭 자동 완성에서 에이전트와 동기적으로 작업하는 것으로의 전환 이후 소프트웨어 구축 방식에 있어 가장 큰 변화"라고 불리는 것을 발표했습니다. 그들의 클라우드 에이전트는 이제 자체 가상 머신을 제어하여 작동하는 코드를 빌드, 테스트 및 시연할 수 있습니다.
이것은 단순히 점진적인 개선이 아닙니다. Cursor의 발표에 따르면, 이제 병합된 풀 리퀘스트의 30-35%가 자율 클라우드 에이전트에 의해 생성됩니다.
이 가이드에서는 Cursor의 에이전트 컴퓨터 사용 기능이 무엇인지, 어떻게 작동하는지, 그리고 정확히 어떻게 설정하는지 알아볼 것입니다.
Cursor 에이전트 컴퓨터 사용이란 무엇인가요?
Cursor 에이전트 컴퓨터 사용은 AI 에이전트가 로컬 개발 환경과 상호작용하는 것을 넘어, 자체 격리된 가상 머신에서 작동하도록 하는 기능입니다. 클라우드 에이전트를 실행하면 클라우드에서 완전한 개발 환경, 즉 소프트웨어를 빌드, 테스트 및 검증하는 데 필요한 모든 것을 갖춘 격리된 VM이 시작됩니다.
이것이 중요한 이유
기존 AI 코딩 도우미는 다음과 같이 작동합니다:
- IDE에서 코드 완성 제안
- 코드베이스에 대한 질문에 답변
- 기존 코드 리팩토링 또는 설명 지원
Cursor의 클라우드 에이전트는 실제로 작업을 수행함으로써 이를 더욱 발전시킵니다:
- 격리된 클라우드 환경에서 실행
- 종속성 설치 및 프로젝트 빌드
- 브라우저 열기 및 UI 테스트
- 보고하기 전에 변경 사항이 작동하는지 확인
- 증거를 포함한 병합 준비 완료 풀 리퀘스트 생성
이 기술의 배경
각 클라우드 에이전트는 자체 격리된 가상 머신에서 실행됩니다. 이는 여러 가지 중요한 이점을 제공합니다:
- 격리: 에이전트가 로컬 리소스를 놓고 경쟁하지 않습니다.
- 병렬 처리: 여러 에이전트가 동시에 작업할 수 있습니다.
- 검증: 에이전트가 실제로 변경 사항을 테스트할 수 있습니다.
- 증거: 각 PR에는 비디오, 스크린샷 및 로그가 포함됩니다.
클라우드 에이전트 vs. 기존 IDE AI 지원
클라우드 에이전트와 기존 IDE 기반 AI의 차이점을 이해하면 현실적인 기대를 설정하는 데 도움이 됩니다:
기존 AI 코딩 (Cursor Classic 모드):
- 입력하는 동안 IDE에 제안이 표시됩니다.
- 각 변경 사항을 검토하고 수락해야 합니다.
- 로컬 머신의 리소스에 제한됩니다.
- 테스트를 실행하거나 기능을 검증할 수 없습니다.
- 항상 모든 제어권과 컨텍스트를 유지합니다.
클라우드 에이전트 (자율):
- 에이전트가 지속적인 감독 없이 독립적으로 작업합니다.
- 변경 사항은 사용자에게 표시되기 전에 테스트되고 검증됩니다.
- 빌드 및 테스트에 사용할 수 있는 전체 VM 리소스.
- 수행된 작업을 보여주는 검토 가능한 아티팩트를 생성합니다.
- PR 검토 단계에서만 개입합니다.
주요 전환은 "AI가 나를 돕는다"에서 "AI가 나를 위해 해준다"로 바뀝니다. 이것은 개발자를 대체하는 것이 아니라, 구현에서 검토 및 지시로 역할을 전환시키는 것입니다.
기술 요구 사항 설명
내부에서 어떤 일이 일어나는지 이해하는 것은 문제 해결에 도움이 됩니다:
- VM 환경: 각 에이전트는 일반적인 개발 도구가 사전 설치된 최신 Ubuntu 기반 VM을 받습니다.
- 저장소 복제: 에이전트는 실제 코드베이스와 작업하기 위해 모든 서브모듈을 포함하여 저장소를 복제합니다.
- 종속성 관리: 에이전트는 필요에 따라 npm 패키지, pip 요구 사항 또는 기타 종속성을 설치할 수 있습니다.
- 네트워크 액세스: 에이전트는 패키지를 복제하고, curl 명령을 실행하거나, 로컬 호스트 서버로 이동하기 위해 인터넷에 액세스할 수 있습니다.
- 아티팩트 저장: 비디오 및 스크린샷은 생성된 PR에 저장되고 연결됩니다.
이러한 투명성은 코드가 어떤 환경에서 빌드되고 테스트되었는지 항상 알 수 있음을 의미합니다.
Cursor 클라우드 에이전트 작동 방식
아키텍처 개요
Cursor 클라우드 에이전트를 시작하면 다음과 같은 일이 발생합니다:
- VM 프로비저닝: Cursor는 완전한 개발 환경을 갖춘 격리된 가상 머신을 시작합니다.
- 저장소 액세스: 에이전트가 저장소 및 모든 종속성을 복제합니다.
- 작업 실행: 에이전트가 요구 사항을 읽고, 변경하고, 테스트를 실행합니다.
- 검증: 에이전트가 브라우저를 열고, 로컬 호스트로 이동하고, UI를 클릭하여 모든 것이 작동하는지 확인합니다.
- 아티팩트 생성: 에이전트가 수행된 작업을 보여주는 비디오, 스크린샷 및 로그를 기록합니다.
- PR 생성: 에이전트가 모든 증거를 포함한 풀 리퀘스트를 생성합니다.
에이전트를 실행할 수 있는 곳
Cursor 클라우드 에이전트는 여러 플랫폼에서 액세스할 수 있습니다:
| 플랫폼 | 실행 방법 |
|---|---|
| Cursor 데스크톱 | 에이전트 입력 아래 드롭다운에서 "Cloud"를 선택합니다. |
| Cursor 웹 | cursor.com/agents 방문 |
| Slack | @cursor 명령 사용 |
| GitHub | PR 또는 이슈에 @cursor 댓글 달기 |
| API | Cursor API를 사용하여 에이전트 시작 |
| Linear | @cursor 명령 사용 |
요구 사항
클라우드 에이전트를 사용하기 전에 다음 사항을 확인하십시오:
- Max 모드 호환 모델이 활성화되어 있어야 합니다 (이 모델만 클라우드 에이전트를 지원합니다).
- 저장소에 대한 읽기-쓰기 권한.
- 모든 종속 저장소 또는 서브모듈에 액세스 가능.
현재 클라우드 에이전트는 GitHub 및 GitLab 저장소를 지원합니다.
단계별 설정 가이드
1단계: 온보딩 액세스
시작하려면 cursor.com/onboard로 이동하십시오. 이 페이지는 초기 에이전트 구성을 안내하며 에이전트가 자체적으로 설정되는 과정을 볼 수 있게 해줍니다.
2단계: 실행 플랫폼 선택
여러 가지 옵션이 있습니다:
옵션 A: Cursor 데스크톱
- Cursor IDE 열기
- 하단에서 에이전트 입력 찾기
- 드롭다운을 클릭하고 "Cloud" 선택
- 구축하려는 내용 설명
옵션 B: Cursor 웹
- cursor.com/agents로 이동
- 계정으로 로그인
- 저장소 선택
- 작업 설명
옵션 C: GitHub 통합
- 저장소로 이동
- 이슈 또는 PR 열기
@cursor build a feature that...댓글 달기- 에이전트가 작업을 수행합니다.
3단계: 에이전트 권한 구성
클라우드 에이전트를 처음 사용할 때 다음을 부여해야 합니다:
- 저장소 읽기/쓰기 액세스
- 모든 종속 저장소에 대한 액세스
- 해당하는 경우 서브모듈에 대한 액세스
4단계: 작업 정의
에이전트가 달성하고자 하는 바를 구체적으로 명시하십시오. 예를 들면 다음과 같습니다:
- "이메일 및 비밀번호 필드를 포함한 로그인 페이지 구축"
- "설정 페이지에 다크 모드 토글 추가"
- "잘못된 입력 시 API가 500을 반환하는 버그 수정"
더 많은 컨텍스트를 제공할수록 에이전트가 더 나은 결과를 제공할 수 있습니다.
5단계: 모니터링 및 검토
에이전트는 자율적으로 작동하지만, 다음을 수행할 수 있습니다:
- 에이전트의 원격 데스크톱을 실시간으로 확인
- 생성된 아티팩트 (비디오, 스크린샷) 검토
- 세션을 인계받아 직접 변경 사항 시도
- PR 승인 또는 변경 요청
주요 기능 및 역량
자가 테스트 및 반복
아마도 가장 강력한 기능: 에이전트는 실제로 자신의 작업을 검증할 수 있습니다. 에이전트는 다음을 수행할 수 있습니다:
- 개발 서버 시작
- 브라우저를 열고 로컬 호스트로 이동
- UI 요소 클릭
- 자동화된 테스트 실행
- 기능이 예상대로 작동하는지 확인
에이전트는 커서 문서 사이트를 45분 동안 완전히 탐색했습니다. 사이드바, 상단 탐색, 검색, 페이지 복사 버튼, 피드백 공유 대화 상자, 목차 및 테마 전환을 포함하여 테스트한 모든 기능에 대한 요약을 제공했습니다.
아티팩트 기록
모든 에이전트 실행은 풍부한 아티팩트를 생성합니다:
- 기능 작동 모습을 보여주는 비디오
- 주요 순간의 스크린샷
- 빌드 및 테스트 프로세스의 로그
- 모든 코드 변경 사항의 Diff
이를 통해 검토가 빨라집니다. 브랜치를 체크아웃하지 않고도 어떤 작업이 수행되었는지 정확히 확인할 수 있습니다.
원격 데스크톱 제어
변경 사항을 직접 시도하고 싶으신가요? 에이전트의 원격 데스크톱을 직접 제어할 수 있습니다. 이를 통해 다음을 수행할 수 있습니다:
- 에이전트 환경에서 기능 테스트
- 병합 전에 작동하는지 확인
- 필요한 경우 추가 변경 수행
- 로컬에서 브랜치 체크아웃 방지
다중 플랫폼 액세스
클라우드 에이전트는 어디에서나 작동합니다:
- 데스크톱: 완전한 IDE 통합
- 웹: 브라우저 기반 에이전트 관리
- 모바일: 이동 중 모니터링
- Slack: 빠른 에이전트 명령
- GitHub: 이슈 및 PR 통합
실제 사용 사례
새로운 기능 구축
필요한 기능을 설명하면 에이전트가 스캐폴딩, 구현, 테스트 및 검증을 포함하여 엔드 투 엔드로 구축합니다.
버그 재현
에이전트에게 버그를 재현하도록 지시하면 다음을 수행할 수 있습니다:
- 환경 설정
- 버그 조건 트리거
- 근본 원인 조사
- 수정 제안 및 테스트
빠른 수정
작은 변경 사항의 경우 컨텍스트 전환 없이 에이전트에게 전적으로 위임할 수 있습니다.
UI 테스트
에이전트는 인터페이스를 클릭하여 다음을 확인할 수 있습니다:
- 사용자 흐름이 올바르게 작동하는지
- 반응형 디자인이 적절하게 렌더링되는지
- 대화형 요소가 예상대로 응답하는지
API 통합 작업
API 통합을 구축할 때 에이전트는 다음을 수행할 수 있습니다:
- 모의 서버 설정
- API 엔드포인트 테스트
- 응답 처리 확인
- 문서 생성
이것이 바로 Apidog와 같은 도구가 Cursor 에이전트를 아름답게 보완하는 지점입니다. Apidog를 사용하여 API를 설계하고 테스트한 다음, Cursor 에이전트가 프론트엔드 구현 및 통합을 처리하도록 할 수 있습니다. 예를 들어, 웹훅 서비스를 사용하여 로컬 호스트 API를 테스트하여 배포 전에 API 통합이 올바르게 작동하는지 확인할 수 있습니다.
제한 사항 및 고려 사항
현재 제한 사항
- 저장소 지원: 현재 GitHub 및 GitLab만 지원
- 모델 제한: Max 모드 호환 모델만 작동
- 권한 요구 사항: 전체 읽기-쓰기 액세스 필요
- 새로운 기능: 아직 발전 중이며 일부 엣지 케이스 발생 가능
사용 시점과 사용하지 않을 시점
가장 적합한 경우:
- 잘 범위가 정해진 기능 요청
- 버그 재현 및 수정
- 보일러플레이트 및 스캐폴딩
- 테스트 및 검증 작업
이상적이지 않을 수 있는 경우:
- 보안에 매우 민감한 코드 (권한을 신중하게 검토)
- 복잡한 아키텍처 결정 (인간의 판단 필요)
- 특정 로컬 환경 설정이 필요한 작업
보안 고려 사항
에이전트에게 저장소 액세스 권한을 부여할 때 다음 보안 모범 사례를 염두에 두십시오:
- 범위가 지정된 토큰 사용: 전체 저장소 액세스 권한을 부여하는 대신, 최소한의 필수 권한을 가진 토큰을 사용하십시오.
- 에이전트 작업 검토: 병합하기 전에 항상 PR을 철저히 검토하십시오. 특히 프로덕션 코드의 경우 더욱 그렇습니다.
- 환경 분리: 초기에는 비프로덕션 브랜치에서만 에이전트를 사용하는 것을 고려하십시오.
- 감사 로그: Cursor의 아티팩트 기록을 활용하여 에이전트가 수행한 작업을 감사하십시오.
- 작게 시작: 중요한 기능을 다루기 전에 낮은 위험 작업부터 시작하여 신뢰를 구축하십시오.
Cursor의 격리된 VM 접근 방식은 에이전트에게 직접적인 로컬 액세스를 제공하는 것보다 본질적으로 더 안전하지만, 책임감 있는 사용은 여전히 주의를 요합니다.
자율 코딩 에이전트의 미래
클라우드 에이전트를 최대한 활용하기 위한 모범 사례
Cursor의 자율 에이전트로 생산성을 극대화하려면 다음 검증된 실천 방법을 따르십시오:
1. 명확하고 구체적인 프롬프트 작성
에이전트 출력의 품질은 프롬프트의 명확성과 직접적으로 관련이 있습니다. "로그인 버그 수정"과 같은 모호한 요청 대신, "사용자가 유효한 자격 증명으로 로그인 양식을 제출하면 /dashboard로 리디렉션되어야 하지만 401 오류가 표시됩니다. 서버는 응답에 올바른 토큰을 반환합니다."와 같이 구체적으로 명시하십시오.
2. 조기에 컨텍스트 제공
에이전트에게 파일 경로, 관련 코드 스니펫, 오류 메시지 또는 관련 이슈 링크와 같은 관련 컨텍스트를 미리 제공하십시오. 에이전트는 자신이 아는 것만으로 작업할 수 있습니다.
3. 반복적인 개선 사용
에이전트가 모든 것을 한 번에 구축하도록 시도하지 마십시오. 최소 실행 가능한 버전으로 시작하고, 결과를 검토한 다음, 확장하십시오. 이것은 하나의 프롬프트에 방대한 요구 사항을 쏟아붓는 것보다 더 나은 결과를 생성합니다.
4. 여러 에이전트를 병렬로 활용
에이전트가 격리된 VM에서 실행되므로, 새로운 기능 하나, 버그 수정 하나, 문서 업데이트 하나와 같이 여러 에이전트를 동시에 다른 작업에 대해 시작할 수 있습니다.
5. 아티팩트 철저히 검토
비디오 및 스크린샷 아티팩트는 단순히 있으면 좋은 것이 아니라, 에이전트가 실제로 수행한 작업을 볼 수 있는 창입니다. 코드 검토에서 놓칠 수 있는 문제를 파악하기 위해 이를 시청하십시오.
기존 워크플로우와의 통합
Cursor 에이전트는 일반적인 개발 워크플로우와 원활하게 통합됩니다:
- CI/CD: 에이전트는 기존 CI 파이프라인을 트리거하는 PR을 생성할 수 있습니다.
- 코드 검토: 표준 PR 검토 프로세스가 적용되며, 특별한 도구가 필요하지 않습니다.
- 테스트: 에이전트는 테스트 스위트를 실행하고 결과를 PR에 포함할 수 있습니다.
- 문서화: 에이전트는 README 파일, API 문서 또는 인라인 주석을 업데이트할 수 있습니다.
핵심 통찰은 에이전트가 워크플로우를 대체하는 것이 아니라 보강한다는 점입니다. 여전히 검토하고, 테스트하고, 승인하지만, 반복적인 작업은 자동으로 처리됩니다.
Cursor의 발표는 더 넓은 추세를 나타냅니다. AI 코딩 분야는 뜨거워지고 있습니다:
- Anthropic은 에이전트 기능을 갖춘 Claude Code를 출시했습니다.
- OpenAI는 자율 코딩을 위한 Codex를 소개했습니다.
- Microsoft는 GitHub Copilot 기능을 계속 확장하고 있습니다.
- Google은 AI 에이전트를 개발 워크플로우에 통합하고 있습니다.
Cursor의 30-35% 자율 PR 생성 비율은 이 모델이 작동한다는 것을 시사합니다. 기술이 성숙함에 따라 더 많은 도구가 유사한 접근 방식을 채택할 것으로 예상됩니다.
특히 API 개발의 경우, 자율 에이전트와 전용 API 도구를 결합하면 강력한 워크플로우를 생성합니다. 에이전트가 구현 및 테스트를 처리하는 동안, Apidog와 같은 전문 도구는 API 설계, 문서화 및 종합 테스트를 관리합니다.
결론
Cursor의 에이전트 컴퓨터 사용 기능은 소프트웨어 구축 방식의 근본적인 변화를 나타냅니다. AI 에이전트가 자체 가상 머신에서 작동하고, 변경 사항을 테스트하며, 검증되고 아티팩트가 풍부한 풀 리퀘스트를 생성하도록 함으로써, Cursor는 자율 코딩이 대규모로 작동함을 입증하고 있습니다.
설정은 간단합니다. 플랫폼을 선택하고, 작업을 정의한 다음, 에이전트가 작동하도록 하십시오. 이제 Cursor 자체 코드의 30% 이상이 에이전트에 의해 작성되면서 이 기술은 스스로를 입증했습니다.
다음 단계:
- cursor.com/onboard에서 온보딩을 시도해 보세요.
- 작고 범위가 잘 정해진 작업부터 시작하십시오.
- 생성된 아티팩트를 검토하여 에이전트의 역량을 이해하십시오.
- 자율 에이전트가 개발 워크플로우를 어떻게 보강할 수 있는지 고려하십시오.
Apidog 시작하기: Apidog를 무료로 사용하여 API를 설계, 테스트 및 문서화하고, Cursor와 같은 AI 기반 코딩 도우미를 활용하여 구현하십시오.