Cursor 최신 버전에 Unity Extension 설치하기

최근 AI Code Editor로써 애용중이던 Cursor.

2개월 전인가, Cursor를 재설치해야 할 일이 생겨서 재설치를 진행했는데, 문제가 하나 생겼다.

 

▲ Unity extension... 너 어디갔니?

---

알아 보니, Cursor의 Extension Marketplace Service가, Visual Studio에서 OpenVSX로 변경되었다고 한다. [관련 포럼]

Extension Marketplace Changes - Transition to OpenVSX

 

아래는 이 사태가 발생한 이유에 대해 짤막하게나마 정리한 글입니다.

궁금하신 분들은 읽어보세요.

Cursor는 VSCode를 기반으로 만들어졌다.

그리고 VSCode는 오픈 소스이며, MIT Lisence를 따르지만...

 

Marketplace의 경우에는 그렇지 않다. [약관 링크]

License Agreement | Visual Studio Marketplace

 

일부 발췌:

INSTALLATION AND USE RIGHTS. a) General. You may install and use any number of copies of the software only with Microsoft Visual Studio, Visual Studio for Mac, Visual Studio Code, Azure DevOps, Team Foundation Server, and successor Microsoft products and services to develop and test your applications.

 

이를 해석하면 아래와 같다.

설치 및 사용 권한
a) 일반. Microsoft Visual Studio, Visual Studio for Mac, Visual Studio Code, Azure DevOps, Team Foundation Server, 그리고 그 후속 Microsoft 제품 및 서비스를 사용하여 귀하의 애플리케이션을 개발하고 테스트하는 경우에만, 귀하는 소프트웨어의 복사본을 원하는 만큼 설치하고 사용할 수 있습니다.

 

요약하면, Microsoft의 공식 제품이나 서비스를 통하지 않은 환경에서는, Marketplace를 이용할 수 없다는 것이다.
이러한 Visual Studio Marketplace의 약관 때문에 생겨난 서비스가, 바로 OpenVSX이다.

 

애초에 Cursor에서 Visual Studio Marketplace의 Extensions을 설치할 수 있었던 과거가, 약관 위반이었으며,
Cursor 또한 뒤늦게나마 기본적으로 OpenVSX를 Extension Marketplace Service로 채택하게 된 것이다.

 

그런데 여기서 한 가지 문제점이 생긴다.

OpenVSX에는, Unity Extension이 존재하지 않는다.

OpenVSX의 C# Extension 을 이용하면 C# 코드 작성에 문제는 없지만,

(Cursor의 개발사에서 `anysphere.csharp`라는 id로 C# Extension을 게시 해 두었다)

 

Unity 확장이 없으면 생기는 가장 큰 문제가, Debugger를 붙일 수 없다는 것이다.
이제 뭐 디버깅하려면 Unity Debugger가 불안정하던 -틀- 시절로 돌아가서 죄다 Log찍어서 확인해야되는 대참사

 

하지만 언제나 그렇듯, 우린 답을 찾고야 맙니다.

---

해결 방법

---

1. VSIX 다운로드

간단하게 설명하면, VSIX 파일을 통해 Unity Extension을 직접 설치해주면 된다 !

설치해야 할 Extension은 총 3가지이다.

1. C#
2. C# Dev Kit  ("1.18.21 이전" 버전)
3. Unity

(이는 Unity → C# Dev Kit → C# 의 종속성 관계 때문이다)

 

C# Dev Kit의 경우, 1.18.21 이전 버전을 설치해야 하는데,

이는 해당 버전에서 Microsoft의 제품군이 아닌 앱에서의 사용을 막는 패치가 진행되었기 때문이다.

▲ 1.18.21 이상의 버전을 설치하게 되면, 위와 같은 에러가 발생할 것이다.

 

현재 공식적으로 Marketplace에서 VSIX를 직접 다운로드 받는 기능은 숨겨졌음으로,

VSIX를 다운로드 받는 가장 쉬운 방법은, 아래 사이트를 이용하는 것이다.
https://vsix.2i.gs/

VSIX Downloader

 

혹은 동일한 개발자가 개발한 크롬 확장 플러그인 VSIX Downloader 를 이용해도 되지만,

C# Dev Kit의 경우, 버전을 명시해서 다운로드해야 하기에, 위 사이트를 이용하는 것이 편할 것이다.

▲ 본인 PC의 Platform을 선택하는 것을 잊지 말자!

Unity를 이용한 개발 중이라면 일반적으로는 Windows x64환경일 것이다.

---

 

참고로, C# Dev Kit의 1.18.21 이전의 가장 최신 버전은 1.18.16이다.

(C# Dev Kit의 Change Log에서 확인하였다.)

그러니 특수한 상황이 아니라면, 1.18.16을 받으시면 되겠다.

▲ 위와 같이 버전을 명시할 것.

혹은 이전 버전의 Vsix가 업로드되는 VsixHub 이라는 사이트 또한 존재하는데, 여기서 대응하는 버전을 받아도 된다.
하지만 여긴 1.18.16버전이 존재하지 않으며, (1.17.64가 대응하는 최신 버전)
공식 Visual Studio Marketplace를 경유해서 받는 게 아니기에 찜찜할 수도 있으니, 일반적으론 추천하지 않는 방법이다.
혹여 1.18.21이전 버전들이 Visual Studio Marketplace DB에서 아예 내려가버릴 경우를 대비해 일단 일람만 해 둔다.

 

위 방법을 통해, 3개의 Vsix파일을 모두 다운로드 받는다.

 

---

 

직접 다운로드 받으시는 것을 추천드리는 바이지만,

혹여 이해가 안 되시는 분들을 위해, 본인이 다운로드해둔 Visx파일들을 여기에 첨부해 두겠습니다.
글 작성 시점인 2025.09.01기준 대응되는 최신 Vsix 입니다.

자신에게 맞는 플랫폼의 Visx를 다운로드 해 주세요

(예외적으로 Unity extension의 경우, 플랫폼 구분이 따로 없습니다.)

https://drive.google.com/drive/folders/1oiJ6M75B_KAcdIFUjaSIh320Ji-fLhlt?usp=sharing

Unity - Google Drive

---

2. VSIX 설치

먼저, C#과 .Net 관련 확장이 이미 설치되어 있다면, 제거해주도록 하자.

▲ 예: Cursor 개발사에서 OpenVSX에 업로드한 anysphere.csharp

---

 

종속성에 따른 설치 순서는, 앞서 언급했듯 아래와 같다.

1. C# (ms-dotnettools.csharp)
2. C# Dev Kit  (ms-dotnettools.csdevkit)
3. Unity (VisualStudioToolsForUnity.vstuc)

설치 방법은 다음과 같다.

1. Cursor에서 `Ctrl+Shift+P` 단축키를 입력하여 `Command Palette`를 엽니다.
   (혹은 상단 `View / Command Palette...` 메뉴 이용)
2. "vsix"를 입력하여 명령 `Extensions: Install from VSIX...`를 선택합니다.
   
3. Vsix 파일 선택 창이 열리면, 위 순서대로 Vsix 파일을 열어 설치를 진행합니다.
   

---

 

설치가 완료되고 나면, Extension탭의 Installed 항목에 아래와 같은 확장들이 추가되어있을 것이다.

▲ C#, C# Dev Kit, Unity가 설치된 모습
(.Net Install Tool은 C# / C# Dev Kit 확장 설치 시 자동으로 설치됨)

---

 

이렇게 Unity와 그 종속성 확장 (C# / C# Dev Kit)이 정상적으로 설치되고 나면,

이제 최신 Cursor에서도 Unity에 Debugger를 사용할 수 있게 된다.

그럼 다들 즐거운 개발 되시길!