Cursor AI에서 파이썬 가상환경(venv) 설정 방법

Cursor AI로 바이브 코딩? 그냥 하면 안 되는 이유 (윈도우 완벽 가이드)

요즘 핫한 Cursor AI 에디터, 설치하고 바로 파이썬 코딩을 시작하셨나요? 아마 생각처럼 잘 안돼서 답답하셨을 겁니다. '바이브 코딩'은커녕, 패키지는 꼬이고 프로젝트마다 설정이 뒤죽박죽되기 십상이죠. 그 이유는 바로 '가상환경' 설정 없이 시작했기 때문입니다. 이 글 하나로 윈도우 환경에서 Cursor AI의 파이썬 개발 환경을 제대로 구축하는 법을 알려드릴게요.

1️⃣ 프로젝트 폴더 만들기

가장 먼저, 코드를 보관할 전용 폴더를 만들어야 합니다. 파일 탐색기에서 직접 만들거나, 터미널을 이용해 깔끔하게 시작할 수 있습니다.

• 🖥️터미널(CMD 또는 PowerShell)을 열고 아래 명령어를 순서대로 입력하세요.
• 📂mkdir my-project
• ➡️cd my-project

그다음 Cursor AI를 열고 'File > Open Folder...'를 통해 방금 만든 my-project 폴더를 열어주세요.

2️⃣ 파이썬 가상환경 생성하기

가상환경은 프로젝트마다 독립된 공간을 만들어주는 마법 같은 기능입니다. A 프로젝트와 B 프로젝트가 쓰는 파이썬 패키지 버전이 달라도 서로 충돌하지 않게 막아주죠.

• 🐍Cursor AI 터미널(Ctrl + `)에서 다음 명령어를 입력해 'venv'라는 이름의 가상환경을 만듭니다.
• 👉python -m venv venv

이제 왼쪽 파일 탐색기를 보면 'venv' 폴더가 생성된 것을 확인할 수 있습니다.

3️⃣ 가상환경 활성화하기

가상환경을 만들었다면, 이제 그 환경을 사용하겠다고 '활성화' 신호를 보내야 합니다. 사용하는 터미널 종류에 따라 명령어가 다르니 주의하세요.

• ⚫CMD (명령 프롬프트)
  venv\Scripts\activate.bat
• 🔵PowerShell
  venv\Scripts\Activate.ps1

만약 PowerShell에서 권한 오류가 발생한다면, Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process 명령어를 먼저 실행한 후 다시 활성화를 시도해 보세요. 활성화에 성공하면 터미널 프롬프트 앞에 (venv)가 표시됩니다.

4️⃣ Cursor AI에 가상환경 알려주기

이제 마지막 단계입니다. Cursor AI가 우리가 만든 가상환경의 파이썬을 사용하도록 직접 지정해줘야 합니다. 그래야 자동완성, 코드 실행, 디버깅 기능이 정상적으로 작동합니다.

• ⌨️단축키 Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
• 🔍"Python: Select Interpreter"를 검색하고 선택합니다.
• ✅나타나는 목록에서 './venv/Scripts/python.exe' 경로를 가진 인터프리터를 선택합니다.

이제 Cursor AI는 이 프로젝트 폴더 안에서만큼은 우리가 만든 venv 가상환경을 기준으로 움직입니다.

🚀 이제 진짜 바이브 코딩 시작!

모든 설정이 끝났습니다! 이제 가상환경이 활성화된 터미널에서 필요한 패키지를 마음껏 설치하고(pip install pandas), 나만의 파이썬 스크립트(.py)나 주피터 노트북(.ipynb)을 만들어 AI와 함께 '바이브 넘치는 코딩'을 즐겨보세요!