Cursor Voice Chat·Build Live Apps·Agent SDK 사용법: 2026년 11월 신기능 실습

공식 변경 로그 기준으로 정리한 세 기능의 동작 방식과 음성 지시부터 공유 링크까지의 흐름

Cursor 음성·Live Apps 썸네일

핵심 요약

  1. Voice Chat with Agents(11월 6일)는 Grok Voice 기반의 양방향 음성 대화를 지원해, 개발자가 키보드 입력 없이 diff를 눈으로 보면서 에이전트에게 실시간 코드 수정과 리뷰 지시를 내릴 수 있게 한다.
  2. Build Live Apps(11월 5일)는 호스팅, Postgres DB, Cursor SSO 인증과 보안 검사를 처리하며, 검사를 통과한 뒤 사용자가 게시해야 앱이 공개된다.
  3. Agent SDK GA(10월 20일)를 활용하면 마크다운 프롬프트와 TypeScript 도구, Eval 테스트를 코드로 묶어 CI/CD 파이프라인에 에이전트를 이식할 수 있다.
  4. 개인 플랜은 Plus($8), Premium($30), Super($100), Ultra($200)로 나뉘고 Plus는 Grok 모델만 쓸 수 있으므로 필요한 모델과 사용량을 기준으로 고른다.

2026년 10월 말부터 11월 첫째 주 사이 Cursor는 에이전트를 코드로 정의하는 Agent SDK GA(10월 20일), 에디터에서 바로 웹 앱을 배포해 공유하는 Build Live Apps(11월 5일), 그리고 에이전트와 실시간 양방향 음성으로 대화하며 코드를 고치는 **Voice Chat with Agents(11월 6일)**를 연달아 공개했다. 이 글은 프론트엔드 및 풀스택 개발자가 세 가지 신규 기능의 동작 구조와 개편된 요금제·모델 구성을 파악하고, 음성 지시로 Next.js 랜딩 페이지를 수정한 뒤 Live Apps 링크로 즉시 공유하는 엔드투엔드 절차를 다룬다.

Voice Chat with Agents (11월 6일): 키보드에서 손을 떼고 진행하는 양방향 코드 리뷰

Cursor 공식 변경 로그에 기록된 Voice Chat with Agents는 기존의 단방향 음성 받아쓰기(Dictation, Cmd+Shift+Space)와 달리, 에이전트와 실시간 양방향 음성 통화를 유지하며 작업을 지시하고 진행 상황을 귀로 듣는 기능이다.

  • 동작 방식과 인터페이스: 에이전트가 유휴(Idle) 상태이고 채팅 입력창이 비어 있을 때 전송 버튼 자리에 나타나는 파형(Waveform) 아이콘을 클릭하면 음성 세션이 시작된다. Agents Window, IDE, 웹, iOS용 Cursor에서 동작하며 iOS에서는 Siri 호출과 Live Activity를 함께 쓸 수 있다.
  • Grok Voice 기반 실시간 피드백: 설정에서 Ara, Eve, Leo, Rex, Sal 등의 음성을 선택할 수 있으며, 에이전트가 파일을 탐색하거나 빌드를 실행하는 동안 현재 진행 단계와 완료 요약을 음성으로 짧게 브리핑한다.
  • 멀티태스킹 리뷰 흐름: 에이전트가 백그라운드에서 코드를 수정하는 동안 개발자는 키보드 타이핑 없이 diff 뷰어를 스크롤하며 변경 사항을 눈으로 검토하고, "방금 바꾼 히어로 섹션 패딩은 모바일에서 너무 넓으니 절반으로 줄여줘"처럼 말로 즉각 후속 지시를 내릴 수 있다.
  • 프라이버시 모드: 설정에서 Privacy Mode를 활성화하면 음성 입력과 변환 텍스트에 대해 제로 데이터 보존(Zero Data Retention) 정책이 적용된다.

Build Live Apps (11월 5일): 에디터 안에서 앱을 빌드하고 공유 링크까지 발행하기

하루 앞선 11월 5일 공개된 Build Live Apps는 로컬호스트(localhost:3000)에서 만든 프로토타입을 외부 팀원이나 클라이언트에게 보여주기 위해 별도의 클라우드 호스팅·DB·인증을 수동 설정해야 했던 번거로움을 줄여주는 기능이다.

  • 인프라 자동 프로비저닝: 클라우드 에이전트 워크플로우에서 앱 생성을 요청하면 Cursor가 애플리케이션 코드 작성뿐 아니라 격리된 호스팅 런타임, 필요한 경우 Postgres 데이터베이스, 그리고 Cursor SSO 기반 접근 인증까지 자동으로 구성한다.
  • 배포 소스와 확장성: Cursor Origin 환경과 GitHub 저장소 연동을 통해 바로 배포할 수 있으며, GitLab 저장소 연동도 순차적으로 지원될 예정이다.
  • 보안 게이트(Security Gate): 외부에 접근 가능한 고유 URL을 열기 전에 결정론적 정적 검사와 에이전트 기반 보안 점검을 자동으로 수행한다. 공식 변경 로그에 따르면 검사를 통과하고 사용자가 명시적으로 게시(Publish)해야 앱이 공개된다.

클라우드 에이전트를 자체 인프라에서 격리해 실행하는 아키텍처가 궁금하다면 Cursor Self-Hosted Machines로 직접 관리하는 머신에서 클라우드 에이전트 실행하기를 함께 참고하면 전체 구조를 이해하기 쉽다.

Agent SDK GA (10월 20일): 에이전트를 코드로 정의하고 Eval로 검증하기

10월 20일 정식 출시(GA)된 Cursor Agent SDK는 Bugbot, Security Review 같은 Cursor의 관리형 에이전트가 쓰는 SDK 하네스를 바탕으로 에이전트를 프로젝트 단위로 만들게 해 준다.

  • Agents as Code: 에이전트 하나가 곧 프로젝트다. instructions.md가 프롬프트이고, 타입이 지정된 도구는 tools/ 폴더의 파일로 둔다.
  • CLI 중심 흐름: init으로 뼈대를 만들고 dev로 로컬에서 실행한 뒤 validate와 deploy로 배포한다.
  • 내장 평가(Evals): agent-sdk eval로 프롬프트나 도구를 바꿨을 때 회귀가 없는지 확인한다.
# 변경 로그에 안내된 뼈대 생성 명령
npx @cursor/agent-sdk init ./my-bot
cd my-bot

# instructions.md와 tools/를 수정한 뒤 로컬 실행 → 검증 → 평가 → 배포
agent-sdk dev
agent-sdk validate
agent-sdk eval
agent-sdk deploy

패키지 이름은 변경 로그(@cursor/agent-sdk)와 문서(@grok/agent-sdk, 이전 이름 @cursor/bdk)의 표기가 다르므로 설치 전에 문서의 최신 안내를 확인한다.

프로젝트 형태가 아니라 기존 스크립트나 CI 안에서 에이전트를 호출하려면 별도의 TypeScript SDK인 @cursor/sdk를 쓴다. Agent.create()로 에이전트를 만들고 send()가 돌려주는 실행 객체를 스트리밍한다.

// review.ts: @cursor/sdk로 로컬 저장소 대상 에이전트 실행
import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2.5" },
  local: { cwd: process.cwd() },
});

const run = await agent.send(
  "이번 PR에서 수정된 app/landing/page.tsx의 접근성 문제를 점검해 줘."
);

for await (const event of run.stream()) {
  console.log(event);
}

개편된 요금제 구조와 지원 모델 변화 정리

Cursor 요금 페이지는 플랜을 다음처럼 구분한다. 플랜별 사용량 한도는 바뀔 수 있으므로 예산을 잡을 때 요금 페이지에서 다시 확인한다.

티어월 요금요금 페이지에서 확인되는 특징
Free$0무료 플랜
Plus$8입문 플랜, Grok 모델만 사용 가능
Premium$30최신 Grok 모델 포함
Super$100상위 개인 플랜
Ultra$200최상위 개인 플랜
Teams사용자당 $30부터팀용 플랜
Enterprise별도 문의조직용 플랜

Plus에서는 Grok 모델만 쓸 수 있으므로, 특정 모델에 맞춰 둔 프롬프트나 워크플로가 있다면 플랜을 고르기 전에 사용 가능한 모델을 확인한다. 작업 복잡도에 따라 모델을 나누는 방식은 Cursor Router가 작업별로 모델을 자동 선택하는 원리에서 이어서 볼 수 있다.

실습: 음성으로 Next.js 랜딩 페이지 수정 요청하고 Live Apps로 공유하기

실제 프로젝트에서 Voice Chat과 Build Live Apps를 연결해 프로토타입을 수정하고 외부 공유 링크를 만드는 4단계 실습 절차다.

  1. 음성 세션 시작 및 컨텍스트 지정: Cursor 에디터에서 Next.js 프로젝트를 열고 에이전트 창의 파형(Waveform) 버튼을 눌러 Voice Chat을 켠다.
  2. 음성으로 컴포넌트 수정 지시: 아래와 같이 구체적인 파일이나 영역을 언급하며 변경 사항을 말한다.
    • "현재 열려 있는 랜딩 페이지 히어로 섹션 아래에 3단 요금제 비교 표를 추가해 줘. 모바일에서는 아코디언 형태로 접히게 만들고, 다크 모드 대비율을 맞춰줘."
  3. 실시간 Diff 확인 및 후속 피드백: 에이전트가 코드를 작성하며 진행 상황을 음성으로 알리면, 에디터에 표시되는 실시간 Diff를 눈으로 확인한다. 수정이 끝난 뒤 *"연간 결제 토글 버튼을 누르면 20% 할인된 금액이 바로 계산되게 상태를 추가해 줘"*라고 이어서 말한다.
  4. Build Live Apps로 배포 및 링크 공유: 로컬 미리보기에서 동작이 확인되면 에이전트에게 *"이 브랜치를 Live App으로 배포해서 팀원들이 테스트할 수 있는 프리뷰 링크를 만들어줘"*라고 요청한다. 보안 검사를 통과한 뒤 게시(Publish)해야 앱이 공개된다.

팀에 도입하기 전에 정할 세 가지

첫째, 음성 입력이 사내 규정에 맞는지 보고 Privacy Mode를 켠다. 변경 로그는 Privacy Mode에서 음성 채팅이 제로 데이터 보존으로 동작한다고 밝힌다. 둘째, Live App을 게시할 수 있는 사람과 Cursor SSO 뒤에 둘 범위를 정한다. 셋째, Agent SDK를 CI에 연결한다면 agent-sdk eval 통과를 배포 조건으로 두고 실행 시간과 호출 횟수 상한을 함께 정한다.

초보자가 자주 실수하는 포인트

  • 기존 Dictation(단순 음성 입력)과 Voice Chat을 혼동하는 실수: Cmd+Shift+Space는 말한 내용을 입력창 텍스트로 타이핑해 줄 뿐이지만, 파형 버튼으로 켜는 Voice Chat은 에이전트가 음성으로 응답하고 백그라운드 워커에 작업을 위임하는 별도의 양방향 세션이다.
  • Live Apps 배포 시 민감한 로컬 .env 값을 하드코딩하는 실수: 보안 게이트가 있어도 테스트용 API 키나 사내 내부 엔드포인트를 클라이언트 번들(NEXT_PUBLIC_*)에 넣은 채 외부 공유 링크로 발행하지 않도록 주의해야 한다.
  • 모델 변경 공지를 확인하지 않고 Agent SDK 스크립트에 지원 중단된 모델 ID를 고정하는 실수: SDK 코드에서 특정 모델명을 하드코딩하면 공급자 정책 변경 시 파이프라인이 멈출 수 있으므로 라우터 별칭이나 폴백 모델을 함께 지정해야 한다.

체크리스트

  • 사내 보안 규정에 맞춰 Cursor 설정에서 Privacy Mode(제로 데이터 보존)가 활성화되어 있는가?
  • Voice Chat 사용 전 오디오 입력 장치와 에이전트 음성 설정을 확인했는가?
  • Build Live Apps로 외부 링크를 활성화하기 전, 자동 보안 검사 리포트와 접근 권한(Cursor SSO 제한 여부)을 검토했는가?
  • Agent SDK를 CI에 연결할 때 무한 루프나 과도한 토큰 소모를 막기 위한 최대 턴 수(max steps)와 타임아웃을 설정했는가?

자주 묻는 질문

Voice Chat을 켜두면 주변 소음이나 혼잣말도 모두 에이전트 명령으로 들어가나요?

음성 인식은 주변 소음의 영향을 받을 수 있으므로 회의실처럼 소음이 많은 환경에서는 음성 세션을 계속 켜 두지 않는 편이 안전하다. 짧은 지시는 Cmd+Shift+Space 받아쓰기로 텍스트를 확인한 뒤 보내는 방법도 있다.

Build Live Apps로 배포한 앱을 정식 프로덕션 도메인으로 그대로 써도 되나요?

Build Live Apps는 앱을 빠르게 만들어 공유하는 흐름에 초점이 있다. 대규모 공개 트래픽을 받는 고객용 프로덕션 서비스는 GitHub 저장소로 내보낸 뒤 기존의 Vercel이나 자체 클라우드 CI/CD 파이프라인으로 이관해 운영하는 방식을 권장한다.

참고 자료 · 검증 기준

위 자료와 내용을 대조한 날짜: . 도구·서비스 정책은 이후 바뀔 수 있으므로 적용 전 공식 문서를 다시 확인하세요.

이 글은 실제 실무 환경 테스트 및 검증된 기술 자료를 바탕으로 작성되었으며, 환경 변화에 따라 지속적으로 갱신됩니다.