Windsurf Cascade & Flows로 대규모 코드베이스 작업하기
Windsurf의 Cascade 에이전트는 코드베이스 전체를 이해하고 복잡한 리팩토링을 자율적으로 수행해요. MCP 통합으로 외부 도구도 AI가 직접 사용합니다.
따라 하기
1단계
Windsurf 설치 및 Cascade 패널 열기
- 1devin.ai/desktop 으로 들어가 내려받습니다.
- Windsurf는 Cognition에 인수된 뒤 Devin Desktop으로 이름이 바뀌었고, 옛 주소(codeium.com)는 이 페이지로 넘어옵니다.
- 설치 후 처음 실행하면 계정 로그인 또는 가입 화면이 나타납니다.
- 2Google 계정이나 이메일로 가입합니다.
- 로그인이 완료되면 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 # 공식 문서 참조
codeium.com/windsurf
누를 위치 devin.ai/desktop›설치›계정 로그인›Ctrl+L(Mac: Cmd+L)로 Cascade 패널 열기
팁 VS Code 확장과 달리 이 제품은 독립 IDE입니다. 기존 VS Code 프로젝트를 그대로 열어도 됩니다. 설정 파일, 확장 프로그램 대부분이 자동으로 가져와집니다.
처음이라 잘 모르겠다면
Windsurf의 Cascade는 단순 자동완성이 아닌 에이전트 방식입니다. 로그인 기능 전체를 JWT로 교체해줘처럼 큰 작업을 지시할 수 있어요.
막히면 볼 것
자주 하는 실수 3가지
- Agentic Mode에서 Accept All 무분별 사용 → 의도치 않은 파일 수정 — 변경 파일 목록 확인 후 중요 파일은 개별 승인
- 대규모 작업 전 Git commit 생략 → 문제 발생 시 되돌리기 불가 — 항상 작업 전 Git commit으로 체크포인트 확보
- MCP 토큰을 설정 파일에 평문 저장 → 보안 위험 — 환경변수로 분리하거나 OS 키체인에 저장
AI 없이 할 때와 뭐가 다른가요?
단일 파일 편집 → Cascade 에이전트 → 코드베이스 전체 이해 + 자율 작업
대형 코드베이스 리팩토링은 파일이 너무 많아서 어디서부터 건드려야 할지 모르겠어...
나
수백 개 파일로 구성된 코드베이스 전체 파악은 어렵습니다.
