Claude 3.5 Sonnet과 Cursor를 100% 활용하는 나만의 AI 페어 프로그래밍 워크플로우
최근 개발자들 사이에서 VS Code의 포크(Fork) 에디터인 **Cursor(커서)**가 뜨거운 열풍을 일으키고 있습니다. 단순한 코드 완성 비서 역할을 넘어, 에디터 깊숙이 통합된 AI 기능과 현존 최고의 코딩 성능을 자랑하는 Claude 3.5 Sonnet 모델이 결합되면서 개발 생산성의 한계를 깨부수고 있기 때문입니다.
저 역시 최근 몇 달 동안 이 조합을 메인 개발 도구로 안착시켰고, 코딩 속도와 품질이 비약적으로 증가했습니다. Claude 3.5 Sonnet과 Cursor를 100% 활용하여 하루 작업량을 단 몇 시간 만에 끝내는 나만의 AI 페어 프로그래밍 실전 워크플로우를 공유합니다.
1. 1단계: Cursor 단축키 체득 및 Claude 3.5 Sonnet 설정
Cursor 에디터는 단독 앱이지만, 기존 VS Code의 플러그인과 설정을 클릭 한 번으로 그대로 가져올 수 있습니다. 설치 후 가장 먼저 해야 할 일은 사용 모델을 Claude 3.5 Sonnet으로 고정하는 것입니다.
- 모델 설정:
- Cursor 설정(
Ctrl + Shift + J또는Cmd + Shift + J)에 진입하여 'Models' 탭에서claude-3-5-sonnet을 활성화하고 최우선 기본 모델로 지정해 줍니다.
- Cursor 설정(
- 지배해야 할 3대 단축키:
Cmd + K(또는Ctrl + K) - 인라인 코드 생성 및 편집: 코드 파일 내부에서 특정 라인을 선택하거나 빈 공간에 대고 바로 명령을 작성해 코드를 삽입/수정합니다.Cmd + L(또는Ctrl + L) - AI 채팅: 우측 사이드바에 채팅창을 열어 현재 활성화된 파일의 컨텍스트를 바탕으로 아키텍처 토론, 버그 디버깅, 라이브러리 사용법을 질문합니다.Cmd + I(또는Ctrl + I) - Composer (멀티 파일 편집): 단일 파일뿐 아니라 여러 파일에 걸친 변경 사항을 통째로 기획하고 코드베이스 전반에 멀티 드롭인 패치를 적용하게 해주는 최강의 기능입니다.
2. 2단계: 컨텍스트(@) 기능을 이용한 프롬프트 최적화
아무리 좋은 모델이라도 프로젝트의 전체 컨텍스트를 이해하지 못하면 엉뚱한 코드를 제안하게 됩니다. Cursor의 강점은 파일 및 코드 심볼을 자유자재로 첨부하는 '@' 트리거에 있습니다.
- @Files & @Folders:
Cmd + L이나Cmd + K를 누르고@를 치면 파일 목록이 뜹니다. 질문과 직접 관련이 있는 파일(@userController.ts,@types.d.ts등)을 수동으로 추가해 주면 Sonnet이 정확히 해당 파일의 코드 패턴을 반영해 줍니다.
- @Web (실시간 웹 검색 연동):
- 최근 업데이트된 라이브러리나 API의 버전을 사용해야 할 때 유용합니다.
@Web how to use react-query v5 optimistic updates라고 전송하면 AI가 실시간으로 웹 도큐먼트를 리서치하여 최신 문법에 맞는 코드를 출력합니다.
- 최근 업데이트된 라이브러리나 API의 버전을 사용해야 할 때 유용합니다.
- @Codebase (코드베이스 전체 검색):
- "이 에러 메시지가 발생하는 다른 모듈이 어디 있지?" 혹은 "프로젝트 전체에서 API 통신 예외 처리를 어떻게 공통으로 하는지 찾아줘"와 같이 광범위한 질문을 던질 때 유용하며, Cursor의 인덱싱 엔진이 알아서 연관 코드를 추려 Sonnet에게 제공합니다.
3. 3단계: 안전한 코드 Diff 검토 및 리팩토링 루틴
AI가 작성한 코드를 생각 없이 바로 수락(Accept)하면, 이전에 빌드해 둔 예외 처리나 세부 변수가 덮어씌워져 조용히 버그를 유발하게 됩니다.
- Diff 뷰어 꼼꼼히 확인하기 (
Cmd + K결과물):- 인라인 코드 편집을 실행하면 수정된 부분과 원래의 코드가 빨간색(삭제), 초록색(추가)으로 나란히(Diff) 노출됩니다.
- 변경된 라인을 세밀히 확인하고, 불필요하게 날아간 주석이나 훼손된 변수 명이 있는지 체크한 후 변경 사항을 받아들여야 합니다.
- 에러 발생 시 즉시 디버깅 팁:
- 터미널에서 컴파일 에러가 나거나 웹 브라우저 콘솔에 에러가 떴을 때, 에러 로그를 긁어서
Cmd + L창에 붙여넣고 질문해 보세요. 원인 분석부터 해결 코드 패치까지 최단 시간에 끝낼 수 있습니다. - Cursor 터미널의 경우, 에러 라인 옆에 나타나는
AddToChat버튼을 누르면 즉시 에러 로그가 채팅 컨텍스트에 들어가 훨씬 빠르게 진단받을 수 있습니다.
- 터미널에서 컴파일 에러가 나거나 웹 브라우저 콘솔에 에러가 떴을 때, 에러 로그를 긁어서
✍️ 글을 마치며
Cursor와 Claude 3.5 Sonnet은 더 이상 단순한 '자동 완성기'가 아닙니다. 이 도구들을 올바르게 다루고, 풍부한 프로젝트 컨텍스트를 @ 기능으로 친절히 짚어줄 때 비로소 1인 개발자가 시니어 개발자 2명분의 몫을 거뜬히 해낼 수 있게 됩니다.
생산성의 혁신을 경험하고 싶으시다면, 오늘 바로 작성 중인 프로젝트를 Cursor로 열고 Cmd + I 버튼을 눌러 첫 멀티 파일 편집 명령을 입력해 보시기 바랍니다!