간단한 답변
Claude Code는 Windsurf로의 네이티브 푸시 기능이 없습니다. CLAUDE.md를 .windsurfrules로 복사하고, 사용자 전역 지침을 Windsurf의 전역 규칙으로 이동하며, 슬래시 명령어를 Cascade 기억 또는 .windsurfrules 섹션으로 변환하고, Windsurf의 MCP 구성에서 MCP 서버를 다시 추가합니다. 각 리포당 15-30분을 계획하세요. MemoryLake와 같은 공유 MCP 기반 기억 레이어는 두 도구가 동일한 소스를 읽을 수 있게 합니다.
사람들이 Claude Code에서 Windsurf로 전환하는 이유
2026년의 세 가지 동인:
- Cascade 에이전트 워크플로우. 다중 파일 변경을 배포하는 팀은 종종 IDE에서 Windsurf의 Cascade 루프를 선호합니다.
- 비주얼 차이 및 검토. 인라인 비주얼 검토는 고급 리팩토링을 위한 터미널 패치 읽기보다 우수합니다.
- 편집기 안정성. 일부 팀은 플러그인 지원 및 편집기 설정 동등성을 위해 IDE 래퍼를 원합니다.
"기억"이 Claude Code와 Windsurf에서 의미하는 것
다른 형태, 관련된 의도.
Claude Code 기억은 리포 루트의 `CLAUDE.md`, `~/.claude/CLAUDE.md` (사용자 전역), `.claude/commands/` 아래의 사용자 정의 슬래시 명령어, 그리고 Claude Code 설정의 MCP 서버에 중점을 둡니다.
Windsurf 기억은 `.windsurfrules` (프로젝트 규칙), 전역 규칙 (사용자 수준), 그리고 Cascade 기억 (에이전틱 작업 중 저장된 지속적인 기억)을 포함합니다.
CLAUDE.md는 .windsurfrules가 됩니다. 사용자 전역 지침은 Windsurf의 전역 규칙이 됩니다. 슬래시 명령어는 Cascade 기억 또는 .windsurfrules의 정적 섹션이 됩니다.
1단계: Claude Code 기억 내보내기
Claude Code는 모든 것을 일반 파일로 저장합니다.
- 리포의 `CLAUDE.md`를 읽습니다. 내용을 작업 텍스트 파일에 복사합니다.
- `~/.claude/CLAUDE.md`를 읽습니다. 전역 지침을
user-guidance.txt에 복사합니다. - *`.claude/commands/.md
를 나열합니다.** 각 파일은 Cascade 기억 또는.windsurfrules` 섹션이 됩니다. - MCP 서버를 문서화합니다. Claude Code 설정을 열고 각 MCP 서버의 엔드포인트 URL 및 인증 정보를 기록합니다.
최종 상태: 각 리포당 claude-code-export/ 폴더에 CLAUDE.md, user-guidance.txt, commands/, 및 mcp-list.md가 포함됩니다.
2단계: Windsurf로 가져오기
Windsurf는 재구성된 동등한 자료를 수용합니다.
- 리포 루트에 `.windsurfrules`를 생성합니다.
CLAUDE.md내용을 붙여넣습니다. - 전역 규칙을 설정합니다. Windsurf 설정을 열고
~/.claude/CLAUDE.md내용을 전역 규칙 영역에 붙여넣습니다. - 슬래시 명령어를 변환합니다. 정적 지침(스타일, 규칙)은
.windsurfrules에 통합됩니다. 재사용 가능한 프롬프트는 Cascade 세션 중 Memories 패널을 통해 Cascade 기억으로 저장됩니다. - MCP 서버를 다시 추가합니다. Windsurf의 MCP 구성에서 mcp-list.md의 각 MCP 서버를 엔드포인트 URL 및 Bearer 토큰과 함께 추가합니다.
- 테스트합니다. Cascade를 열고 이동된 규칙에 의존하는 작은 작업을 실행합니다.
마이그레이션 후 여전히 잃는 것
- 슬래시 명령어 호출 패턴.
/<name>단축키는 Cascade의 일대일 대응이 없습니다. - 터미널 네이티브 다단계 흐름. 장기 실행 CLI 작업은 Cascade 실행으로 재구성됩니다.
- 도구별 채팅 기록. Claude Code 세션은 터미널에 남아 있습니다.
- 지속적인 동기화. 다음 주의 새로운
CLAUDE.md편집은 복사를 다시 하지 않는 한.windsurfrules에 나타나지 않습니다.
더 나은 방법: 하나의 기억 레이어, 모든 도구
Claude Code와 Windsurf 간에 전환하면 도구별 파일이 분산됩니다. 크로스 리포 표준은 두 곳에 존재하게 됩니다.
MemoryLake는 이러한 규칙을 한 번 저장하고 MCP를 통해 노출합니다. Claude Code와 Windsurf 모두 MCP를 지원하므로 동일한 프로젝트 컨텍스트가 단일 엔드포인트에서 두 곳으로 흐릅니다.
- 진실의 단일 출처. 한 번 업데이트하면 두 도구가 변경 사항을 확인합니다.
- 크로스 리포 표준. 팀 규칙은 단일 리포 위에 존재합니다.
- 다음 도구에 대한 드롭인. Cursor 또는 향후 에이전트를 구성 변경으로 추가합니다.
MemoryLake에 연결하는 3단계
1단계: 프로젝트 생성 및 컨텍스트 로드
MemoryLake에 로그인하고 프로젝트 관리로 이동하여 프로젝트 생성 버튼을 클릭합니다. 이름을 "Claude Code ↔ Windsurf 공유 규칙"으로 지정합니다. 참조 문서(스타일 가이드, ADR을 PDF, Word, Markdown 또는 이미지 형식으로) 를 내 공간의 문서 드라이브에 드래그한 후, 문서 탭을 열고 문서 추가 버튼을 클릭합니다. CLAUDE.md, 사용자 지침 및 슬래시 명령어 본문을 기억 탭의 기억 추가를 통해 붙여넣습니다.
2단계: MCP 서버 엔드포인트 생성
프로젝트 내 MCP 서버 탭을 열고 MCP 서버 추가 버튼을 클릭한 후 설명(예: "공유 개발 규칙")을 입력하고 생성 버튼을 클릭합니다. MemoryLake는 키 ID, 비밀 및 엔드포인트 URL을 반환합니다. 비밀은 한 번만 표시되므로 즉시 복사합니다.
3단계: 두 도구를 엔드포인트에 연결
Claude Code의 설정에서 엔드포인트 URL과 비밀을 Bearer 토큰으로 사용하여 MemoryLake MCP 서버를 추가합니다. Windsurf의 MCP 구성에서도 동일한 항목을 추가합니다. 두 클라이언트를 재시작합니다.
네이티브 마이그레이션 vs MemoryLake
| 차원 | 네이티브 Claude Code → Windsurf | MemoryLake 브리지 |
|---|---|---|
| 필요한 단계 | 7-10 수동 | 3 일회성 |
| 예상 시간 | 리포당 15-30분 | 설정 약 5분 |
| 슬래시 명령어 패턴 보존 | 아니요 (Cascade 기억 재구성) | 기억이 그대로 유지됨 |
| 크로스 리포 표준 | 리포별만 | 한 번 공유됨 |
| 지속적인 변경 사항 동기화 | 아니요 | 예 |
| 나중에 세 번째 도구와 작동 | 아니요 (재구성) | 예 (MCP 추가) |