본문으로 건너뛰기

마켓플레이스 변경 후 Cursor에 VSIX 확장 프로그램 설치

Cursor VSIX Extensions

Microsoft는 최근 VS Code Marketplace 웹사이트에서 직접 VSIX 다운로드 옵션을 제거했습니다. 이 변경 사항은 확장 프로그램을 수동으로 설치해야 하는 Cursor 사용자에게 영향을 미칩니다. 이 가이드는 VS Code 확장 프로그램을 Cursor에 설치하기 위한 현재 해결 방법을 보여줍니다.

VSIX 파일을 설치하는 이유​

다음과 같은 경우 수동 VSIX 설치가 필요할 수 있습니다:

  • 확장 프로그램이 Cursor의 내장 마켓플레이스에서 사용할 수 없는 경우
  • 특정 버전의 확장 프로그램이 필요한 경우
  • 오프라인이나 기업 방화벽 뒤에서 작업하는 경우
  • 확장 프로그램이 마켓플레이스에서 제거된 경우
  • 프리릴리스 또는 베타 버전을 설치하려는 경우

방법 1: VS Code에서 다운로드(권장)​

VSIX 파일을 얻는 가장 쉬운 방법은 VS Code 자체를 통해 다운로드하는 것입니다.

1단계: VS Code 설치(아직 설치하지 않은 경우)​

code.visualstudio.com에서 다운로드

2단계: 확장 프로그램 다운로드​

  1. VS Code 열기
  2. 확장 프로그램 보기로 이동(Cmd/Ctrl + Shift + X)
  3. 필요한 확장 프로그램 검색
  4. 확장 프로그램 옆의 톱니바퀴 아이콘(⚙️) 클릭
  5. "VSIX 다운로드" 선택

VS Code Download VSIX

3단계: Cursor에 설치​

  1. Cursor 열기
  2. 확장 프로그램 보기로 이동(Cmd/Ctrl + Shift + X)
  3. ... 메뉴(추가 작업) 클릭
  4. "VSIX에서 설치" 선택
  5. 다운로드한 .vsix 파일 선택
  6. 메시지가 표시되면 Cursor 다시 시작

방법 2: 명령줄 사용​

고급 사용자를 위해 명령줄을 사용하여 다운로드 및 설치합니다.

VS Code CLI를 통해 다운로드​

# 사용 가능한 버전 나열
vscode --list-extensions --show-versions

# 특정 확장 프로그램 다운로드
# (안정적인 다운로드를 위해 위의 VS Code GUI 방법 사용)

Cursor CLI를 통해 설치​

# 터미널에서 Cursor 열기
cursor --install-extension /path/to/extension.vsix

# 또는 전체 경로 사용
"/Applications/Cursor.app/Contents/MacOS/Cursor" --install-extension extension.vsix

방법 3: 직접 마켓플레이스 API(고급)​

자동 다운로드를 위해 VS Code Marketplace API를 직접 사용합니다.

curl 사용​

# 확장 프로그램 세부 정보 가져오기
EXTENSION="publisher.extension-name"
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${EXTENSION%%.*}/vsextensions/${EXTENSION#*.}/latest/vspackage" \
  -H "Accept: application/json;api-version=7.2-preview.1" \
  -o extension.vsix

PowerShell 사용​

$Publisher = "esbenp"
$Name = "prettier-vscode"
$Url = "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/$Publisher/vsextensions/$Name/latest/vspackage"
Invoke-WebRequest -Uri $Url -OutFile "$Name.vsix"

Python 스크립트 사용​

import requests

def download_vsix(publisher, name, version="latest"):
    url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
    response = requests.get(url)
    if response.status_code == 200:
        with open(f"{name}.vsix", "wb") as f:
            f.write(response.content)
        print(f"Downloaded {name}.vsix")
    else:
        print(f"Failed: {response.status_code}")

download_vsix("esbenp", "prettier-vscode")

방법 4: Open VSX Registry에서​

Open VSX는 VS Code Marketplace의 오픈소스 대안입니다.

웹사이트 다운로드​

  1. open-vsx.org 방문
  2. 확장 프로그램 검색
  3. "다운로드" 클릭
  4. Cursor에 VSIX 설치

Open VSX CLI 사용​

# ovsx 설치
npm install -g ovsx

# 확장 프로그램 검색
ovsx search prettier

# 다운로드(레지스트리에서 지원하는 경우)
# 대부분의 확장 프로그램은 웹사이트에서 수동 다운로드가 필요함

방법 5: 소스에서 빌드​

오픈소스 확장 프로그램의 경우 직접 VSIX를 빌드합니다.

클론 및 빌드​

# 확장 프로그램 리포지토리 클론
git clone https://github.com/publisher/extension-name.git
cd extension-name

# 종속성 설치
npm install

# 확장 프로그램 빌드
npm run compile

# VSIX로 패키징
npx vsce package

# .vsix 파일은 현재 디렉토리에 있음

Cursor에 설치​

cursor --install-extension ./extension-name-1.0.0.vsix

인기 확장 프로그램 및 VSIX 소스​

확장 프로그램게시자대체 소스
PrettieresbenpOpen VSX, VS Code GUI
ESLintMicrosoftVS Code GUI only
GitLenseamodioOpen VSX, VS Code GUI
DockerMicrosoftVS Code GUI only
PythonMicrosoftVS Code GUI only
Live ShareMicrosoftVS Code GUI only

설치 문제 해결​

"Corrupt ZIP" 오류​

원인: 불완전한 다운로드

해결:

# VSIX 파일 확인
unzip -t extension.vsix

# 손상된 경우 다시 다운로드

"Extension Not Compatible" 오류​

원인: VS Code와 Cursor 간 버전 불일치

해결:

  1. 도움말 > 정보에서 Cursor의 VS Code 버전 확인
  2. 호환되는 확장 프로그램 버전 다운로드
  3. 또는 VSIX의 engines.vscode 필드 수정

확장 프로그램이 Cursor에 표시되지 않음​

해결:

# 설치된 확장 프로그램 나열
cursor --list-extensions

# 오류 확인
cursor --verbose --install-extension extension.vsix

모범 사례​

버전 관리​

VSIX 파일을 추적합니다:

extensions/
  prettier-vscode-10.1.0.vsix
  eslint-2.4.4.vsix
  gitlens-14.4.1.vsix

자동 설정​

새 컴퓨터용 설정 스크립트를 만듭니다:

#!/bin/bash
# setup-cursor-extensions.sh

EXTENSIONS=(
  "./extensions/prettier-vscode.vsix"
  "./extensions/eslint.vsix"
  "./extensions/gitlens.vsix"
)

for ext in "${EXTENSIONS[@]}"; do
  if [ -f "$ext" ]; then
    cursor --install-extension "$ext"
  else
    echo "Missing: $ext"
  fi
done

백업 전략​

확장 프로그램 목록을 정기적으로 내보냅니다:

# 설치된 확장 프로그램 저장
cursor --list-extensions > extensions.txt

# 나중에 재설치
cat extensions.txt | xargs -L1 cursor --install-extension

빠른 참조​

작업명령
VSIX 설치cursor --install-extension file.vsix
확장 프로그램 나열cursor --list-extensions
확장 프로그램 제거cursor --uninstall-extension publisher.name
확장 프로그램 비활성화cursor --disable-extension publisher.name
확장 프로그램 활성화cursor --enable-extension publisher.name

관련 리소스​