2026년 01월 28일
5

Deep-links: 팀 동료와 Cursor 프로젝트를 공유하는 가장 빠른 방법

Cursor
KKingmo

Changmo Oh

@KKingmo

전체 글 보기

웹사이트 주소를 클릭하면 특정 페이지로 바로 이동하듯이, Cursor에서도 특정 파일의 특정 줄, 심지어 특정 AI 채팅 맥락으로 바로 이동하게 해주는 주소가 있다. 이것을 Deep-links(딥링크)라고 부른다.

1. Deep-links란 무엇인가?

일반적인 링크가 웹 브라우저를 연다면, Cursor의 딥링크는 내 컴퓨터에 설치된 Cursor 에디터를 직접 실행시킨다.

  • 동작 원리: https:// 대신 cursor://로 시작하는 특수한 프로토콜을 사용한다.
  • 핵심 기능: 단순히 에디터를 켜는 것을 넘어, 동료가 보고 있는 파일의 정확한 위치(Line)와 AI가 답변했던 채팅 내용까지 그대로 전달할 수 있다.

관련 문서: Cursor Docs - Deep-links


2. 왜 딥링크가 협업의 핵심인가?

고등학생 수준의 팀 프로젝트에서도 딥링크는 소통의 질을 바꿔놓는다.

  • 설명의 생략: "비밀번호 검사하는 auth.js 파일 42번째 줄 좀 봐줘"라고 말할 필요가 없다. 그냥 링크를 던지면 된다.
  • AI 컨텍스트 공유: "내가 AI랑 이렇게 대화해서 이 로직을 짰어"라고 말하고 싶을 때, 대화 기록이 포함된 딥링크를 보내면 상대방도 내가 AI와 나눈 맥락을 그대로 이어받을 수 있다.
  • 리뷰 효율성: GitHub PR(Pull Request) 댓글에 딥링크를 남겨두면, 리뷰어가 즉시 에디터에서 해당 코드를 확인하고 수정할 수 있다.

3. 실전 사용법

딥링크를 생성하고 사용하는 방법은 매우 직관적이다.

  1. 링크 생성: 공유하고 싶은 코드 영역이나 채팅창에서 'Copy Link' 혹은 공유 아이콘을 클릭한다.
  2. 전달: 생성된 cursor://... 주소를 슬랙, 카톡, 혹은 깃허브에 붙여넣는다.
  3. 실행: 링크를 받은 상대방이 클릭하면, 브라우저가 "Cursor를 여시겠습니까?"라고 묻고, 확인을 누르면 에디터가 해당 위치로 즉시 점프한다.

4. 딥링크 활용 시나리오 (예시)

학교 축제 예약 시스템을 친구와 같이 만든다고 가정해 보자.

나: "야, @API_Logic 부분에서 데이터 안 넘어오는 버그 찾았어. [여기] 클릭해서 코드랑 내가 AI랑 분석한 내용 좀 봐봐."
(딥링크 전달)친구: (링크 클릭 후 에디터가 바로 열림) "오, 진짜네. 바로 수정할게!"

이렇게 되면 파일을 찾고 줄 번호를 대조하는 불필요한 시간이 0초로 수렴한다.


5. 요약: 소통의 속도가 개발의 속도다

딥링크는 단순한 URL이 아니라 "나의 작업 상태를 동료에게 그대로 복제해주는 포탈"이다.

  • 빠름: 경로 설명이 필요 없다.
  • 정확함: 엉뚱한 파일을 열 일이 없다.
  • 강력함: AI와 나눈 대화 맥락까지 공유된다.

다음 포스팅에서는?
이제 방향을 바꿔서 특정 프로그래밍 언어에 맞춘 최적화 전략을 알아보자. [[Web Dev] TypeScript/JavaScript 개발을 위한 Cursor 최적화 설정] 편으로 이어진다.


다음 단계로 무엇을 도와줄까?
  • 이제 시리즈 17번인 [Web Dev 최적화 설정] 포스팅을 작성해 볼까?
  • 아니면 딥링크 프로토콜(cursor://)을 직접 커스텀해서 사용하는 방법에 대해 더 깊이 알려줄까?