Skip to main content
Windsurf는 Codeium이 만든 에이전트형 AI 코드 에디터입니다. 핵심 기능인 Cascade는 대화를 넘어 코드베이스를 스스로 탐색하고 멀티파일을 자율적으로 편집하는 에이전트로 동작합니다.

​
주요 특징

기능설명
Cascade코드베이스를 자율 탐색하며 멀티파일 편집하는 AI 에이전트
Flows개발자의 행동을 실시간 감지하여 선제적으로 제안
Tab 자동완성컨텍스트 기반 코드 예측 및 완성
인라인 편집선택 영역에 자연어 편집 지시
터미널 연동Cascade가 터미널 명령어를 직접 실행

​
Cursor 대비 차별점

항목CursorWindsurf
AI 방식도구형 (사용자가 지시)에이전트형 (자율 탐색 + 실행)
파일 탐색@ 참조로 수동 지정Cascade가 자동으로 관련 파일 탐색
컨텍스트사용자가 컨텍스트 관리Flows가 실시간으로 컨텍스트 추적
터미널사용자가 실행 후 결과 공유Cascade가 직접 명령어 실행
기반 에디터VS Code forkVS Code fork
간단한 편집은 Cursor의 Cmd+K가 빠르고, 복잡한 멀티파일 작업은 Windsurf의 Cascade가 효율적입니다. 프로젝트 성격에 따라 선택하세요.

​
설치 및 초기 설정

1

Windsurf 다운로드

windsurf.com에서 OS에 맞는 버전을 다운로드합니다.
2

기존 설정 마이그레이션

최초 실행 시 VS Code 또는 Cursor의 확장과 설정을 가져올 수 있습니다.
3

모델 설정

Settings에서 Cascade가 사용할 모델을 선택합니다. Claude Sonnet, GPT-4o 등 다양한 모델을 지원합니다.
4

프로젝트 열기

문서 저장소 루트(docs.json이 있는 디렉토리)를 엽니다.

​
Cascade 핵심 기능

​
Write 모드

코드 생성, 편집, 리팩토링을 수행하는 기본 모드입니다. 
"인증 미들웨어를 만들어줘. JWT 검증하고 만료되면 401 반환"
Cascade는 다음을 자동으로 수행합니다:
  1. 프로젝트 구조를 탐색하여 관련 파일 파악
  2. 기존 코드 패턴 분석
  3. 여러 파일에 걸쳐 코드 생성/수정
  4. 필요한 패키지 설치 명령 실행

​
Chat 모드

코드를 수정하지 않고 질문과 분석에 집중하는 모드입니다. 
"이 프로젝트의 인증 흐름을 설명해줘"

​
주요 키보드 단축키

동작macOS설명
Cascade 열기Cmd+LAI 에이전트 패널 열기
인라인 편집Cmd+I선택 영역에 AI 편집 지시
새 대화Cmd+NCascade 내 새 대화 시작
수락Cmd+Y제안된 변경사항 수락
거절Cmd+Backspace제안된 변경사항 거절

​
실무 활용

  • 목표와 제약조건을 함께 명시하세요
  • “Next.js App Router로 로그인 페이지 만들어줘. Tailwind CSS 사용하고 서버 컴포넌트로”
  • Cascade가 파일을 탐색할 때 관련 없는 파일을 수정하면 되돌릴 수 있습니다
Flows는 개발자의 행동을 실시간으로 감지합니다.
  • 코드를 작성하는 중에 다음 단계를 선제적으로 제안
  • 에러가 발생하면 자동으로 수정 방안 제시
  • 관련 파일을 열면 연관 변경사항 제안
큰 작업을 지시할 때는 단계를 나눠서 진행하세요.
  1. 먼저 구조와 계획을 Cascade에게 설명 요청
  2. 계획을 확인한 뒤 실행 지시
  3. 각 단계의 결과를 확인하며 진행
Cascade는 여러 파일을 동시에 수정합니다. Git 커밋으로 복원 지점을 만든 뒤 작업하세요.
Mintlify 스킬을 설치하면 Cascade가 문서 컴포넌트를 인식합니다.
npx skills add https://mintlify.com/docs
AGENTS.md에 프로젝트 용어와 스타일 가이드를 추가하세요.