Windsurf Cascade & Flows로 대규모 코드베이스 작업하기

High class 약 20분활용 사례

Windsurf의 Cascade 에이전트는 코드베이스 전체를 이해하고 복잡한 리팩토링을 자율적으로 수행해요. MCP 통합으로 외부 도구도 AI가 직접 사용합니다.

Windsurf 없다면? 이걸로도 돼요

Cursor

GitHub Copilot

Codeium

Windsurf 열기

windsurf.com

실수 방지 체크리스트

1Agentic Mode에서 Accept All 무분별 사용 → 의도치 않은 파일 수정 — 변경 파일 목록 확인 후 중요 파일은 개별 승인
2대규모 작업 전 Git commit 생략 → 문제 발생 시 되돌리기 불가 — 항상 작업 전 Git commit으로 체크포인트 확보
3MCP 토큰을 설정 파일에 평문 저장 → 보안 위험 — 환경변수로 분리하거나 OS 키체인에 저장

STEP 1 / 4…

STEP 1. Windsurf 설치 및 Cascade 패널 열기

codeium.com/windsurf

Windsurf

AI Code Editor

AI가 함께 코딩하는 에디터

Codeium의 강력한 AI와 함께 더 빠르고 스마트하게 개발하세요.

무료 다운로드

여기를 클릭!

기능 보기

// Cascade AI 채팅
사용자
: 이 함수 리팩토링해줘
AI: 물론이죠! 먼저...
+ const result = data
+   .filter(Boolean)
+   .map(fn);

codeium.com/windsurf → 설치 → Codeium 계정 로그인 → Ctrl+L(Mac: Cmd+L)로 Cascade 패널 열기

codeium.com/windsurf에 접속해 'Download Windsurf' 버튼을 클릭합니다. Windows 또는 Mac용 설치 파일을 내려받아 실행합니다. 설치 후 Windsurf를 처음 실행하면 Codeium 계정 로그인 또는 가입 화면이 나타납니다. Google 계정이나 이메일로 가입합니다. 로그인이 완료되면 VS Code와 유사한 에디터 화면이 열립니다. 우측 하단 또는 상단 메뉴에서 AI 채팅 패널이 표시됩니다. 단축키 Ctrl+L(Mac: Cmd+L)을 누르면 Cascade 채팅 패널이 열립니다. Cascade는 Windsurf의 핵심 에이전트로 코드베이스 전체를 이해하고 자율적으로 작업합니다.

프롬프트

# Cascade 패널 열기
Ctrl+L (Mac: ⌘+L)  # Cascade 채팅 열기
Ctrl+I (Mac: ⌘+I)  # 인라인 편집 모드

# Cascade 모드
Chat Mode    # 질문·분석 (파일 수정 없음)
Write Mode   # 코드 작성·수정 (기본)
Agentic Mode # 자율 에이전트 (파일 탐색·실행 포함)

# Agentic Mode 작업 예시
'이 Python Flask 앱을 FastAPI로 마이그레이션해줘.
모든 라우트, 미들웨어, 에러 핸들러 포함'

'이 코드베이스에서 SQL 인젝션 취약점을 찾아
모두 파라미터화 쿼리로 수정해줘'

'테스트 커버리지 50% 미만인 파일을 찾아
Pytest 유닛 테스트를 작성해줘'

# 컨텍스트 추가
@파일명   # 특정 파일 참조
@폴더명   # 폴더 전체
@Web     # 웹 검색
@Docs    # 공식 문서 참조

VS Code 확장(Codeium)과 달리 Windsurf는 독립 IDE입니다. 기존 VS Code 프로젝트를 그대로 열어도 됩니다. 설정 파일, 확장 프로그램 대부분이 자동으로 가져와집니다.

이 단계를 완료했나요?