RS AI DESK | VS Code 설치 및 사용법: 플랫폼별 공식 설치부터 첫 프로젝트 실행까지

플랫폼별 공식 설치 파일과 실행 명령

Windows는 User Installer(x64/Arm64 .exe)를 내려받아 실행하면 PATH에 code 명령이 자동 등록니다. macOS는 Universal .dmg를 열어 Applications 폴더에 드래그한 뒤, 명령 팔레트(P)에서 'Shell Command: Install 'code' command in PATH'를 실행해야 터미널에서 code 명령이 작동합니다. Linux(Debian/Ubuntu)는 .deb 파일을 내려받아 sudo apt install ./<file>.deb로, Fedora/RHEL은 .rpm 파일을 sudo dnf install ./<file>.rpm으로 설치하면 apt/dnf 저장소가 함께 구성되어 자동 업데이트가 적용니다. 각 플랫폼별 설치 파일은 https://code.visualstudio.com/download 에서 최신 버전을 확인하십시오.

첫 프로젝트 폴더 열기와 터미널 확인

VS Code를 실행한 뒤 파일 메뉴에서 '폴더 열기'를 선택하거나 터미널에서 code .을 입력해 현재 디렉터리를 워크스페이스로 니다.
좌측 활동 막대의 탐색기 아이(또는 Ctrl+Shift+E)을 러 파일 트리가 표시되는지 확인합니다.
터미널 메뉴에서 '새 터미널'(`Ctrl+Shift+``)을 열어 프프트가 나타나는지 검증합니다.
탐색기에서 마우스 우클릭 → '새 파일'로 hello.py를 생성하고 print("Hello VS Code")를 입력한 뒤 Ctrl+S로 저장합니다.
터미널에서 python hello.py를 실행해 Hello VS Code가 출력되면 실행 환경이 정상입니다.

필수 확장 프로그램 설치와 설정 동기화

확장 프로그램 (Ctrl+Shift+X)에서 검색창에 python을 입력하고 Microsoft 공식 Python 확장(게시자: Microsoft, ID: ms-python.python)을 설치합니다. 이어서 GitLens(게시자: GitKraken, ID: eamodio.gitlens)를 설치하면 Git 이력·블레임·코드 즈가 에디터에 바로 표시니다. 설정 동기화를 려면 좌측 하단 계정 아이 → '설정 동기화 기'를 선택하고 GitHub 또는 Microsoft 계정으로 로그인하면 확장·설정·키바인딩이 기기 간 공유니다. 특정 확장을 동기화에서 제외하려면 확장 우클릭 → '설치(동기화 안 함)'을 선택합니다.

GitHub Copilot 무료 플랜 활성화 절차

제목 표시줄의 '로그인' 또는 상태 표시줄의 Copilot 아이을 클릭해 'AI 기능 사용'을 선택합니다. GitHub 계정으로 로그인하면 기존 Copilot 구독이 자동 적용되며, 구독이 없으면 Copilot Free 플랜에 가입되어 월간 인라인 제안과 AI 크레이 제공니다. Copilot Chat(Ctrl+Alt+I)에서 자연어로 작업을 설명하면 에이전트가 파일 생성·편집·터미널 명령 실행을 제안합니다. 자체 LLM API 키를 사용하려면 설정(Ctrl+,)에서 github.copilot.advanced 션의 '언어 모델 공급자'에 키를 등록하면 됩니다.

초보자가 놓치기 쉬운 두 가지 제한 사항

째, Windows에서 System Installer(관리자 권한 필요)를 선택하면 모든 사용자용으로 설치되지만 User Installer는 현재 사용자 프로필에만 설치되어 다중 사용자 환경에서 PATH 충돌이 발생할 수 있습니다. 둘째, 확장 프로그을 처음 설치할 때(버전 1.97부터) 서드파티 게시자 신뢰 확인 대화상자가 나타나며, '신뢰함'을 선택하지 않으면 확장이 비활성화 상태로 유지니다. 이 대화상자를 실수로 닫았다면 확장 관리 메뉴에서 '신뢰 및 다시 로드'를 실행해야 합니다.

설치 후 code 명령이 작동하지 않을 때 복구 절차

증상: 터미널에서 code . 입력 시 '명령을 찾을 수 없음' 또는 'code is not recognized' 오류가 표시니다. 원인 확인: Windows는 User Installer 설치 시 PATH 추가 션이 해제되었는지, macOS는 'Shell Command: Install 'code' command in PATH' 명령을 실행했는지 점검합니다. 복구: Windows는 설치 프로그램 재실행 → 'PATH에 추가' 체크 → 재부팅, macOS는 명령 팔레트에서 해당 명령을 다시 실행합니다. 그래도 해결되지 않으면 공식 문서의 '설치 후 code 명령 설정' 페이지를 참조해 수동으로 PATH를 편집하십시오.

완료 검증 체크리스트

VS Code 창이 열리고 탐색기·검색·소스 제어·확장·계정 아이 5개가 활동 막대에 모두 표시
터미널(Ctrl+Shift+``)에서 code --version` 실행 시 버전 번호(예: 1.97.0)가 출력
Python 확장 설치 후 hello.py 저장 시 하단 상태 표시줄에 'Python 3.x.x' 인터프리터가 감지
GitHub 계정 로그인 후 상태 표시줄 Copilot 아이이 활성화(회색→색상)되고 Chat 가 열림
설정 동기화 아이이 '동기화' 상태(구름에 체크 표시)로 표시

대안 경로와 상향 지원 기준

브라우저만 사용 가능한 환경이면 https://vscode.dev 에서 설치 없이 편집·Git 커·확장 일부를 이용할 수 있습니다. 최신 기능을 미리 테스트하려면 Insiders 빌드(매일 배포)를 별도 설치해 Stable과 병행 실행하십시오. 기업 환경에서 프록시·방화벽으로 마켓플레이스 접근이 차단되면 IT 관리자에게 https://marketplace.visualstudio.com 및 https://*.gallery.vsassets.io 허용을 요청하십시오. 공식 문서로 해결되지 않는 설치 오류는 https://github.com/microsoft/vscode/issues 에서 기존 이슈를 검색한 뒤 새로 등록하십시오.

결정표: 사용자 조건별 추천 설치 방식

사용자 조건	추천 설치 방식	다음 행동
Windows 다중 사용자, 관리자 권한 있음	System Installer(.exe)	관리자 권한으로 실행해 모든 사용자용 설치
macOS Apple Silicon/Intel 공용	Universal .dmg	Applications 폴더에 드래그 후 code 명령 PATH 등록
Ubuntu/Debian 자동 업데이트 필요	.deb + apt 저장소	`sudo apt install ./code_<version>.deb` 실행
Fedora/RHEL 자동 업데이트 필요	.rpm + dnf 저장소	`sudo dnf install ./code-<version>.rpm` 실행
설치 권한 없는 공용 PC/브라우저만	vscode.dev	브라우저에서 https://vscode.dev 접속

복사 가능한 최소 명령 세트


# Windows (PowerShell, User Installer 설치 후)

code .
code --version

# macOS (code 명령 PATH 등록 후)

code .
code --version

# Ubuntu/Debian

sudo apt update && sudo apt install ./code_*.deb
code .

# Fedora/RHEL

sudo dnf install ./code-*.rpm
code .

# 첫 Python 파일 생성 및 실행

echo 'print("Hello VS Code")' > hello.py
python hello.py

제외할 값·권한 체크리스트

GitHub Copilot 로그인 시 개인 액세스 토(PAT)을 설정 파일에 하드코딩하지 마십시오. OAuth 플로우만 사용합니다.
확장 프로그램 설치 시 서드파티 게시자 신뢰 대화상자에서 '신뢰함'을 선택하기 전 게시자 이름과 다운로드 수를 확인하십시오.
설정 동기화 시 settings.json에 API 키, 데이터베이스 비밀번호, 인증서 경로가 포함되지 않았는지 검토하십시오.
기업 기기에서는 조직 정책으로 확장 마켓플레이스 접근이 차단될 수 있으므로 설치 전 IT 관리자에게 확인하십시오.

FAQ

Q: Windows에서 User Installer와 System Installer 중 무엇을 선택해야 하나요? A: 관리자 권한이 없고 본인 계정만 사용하면 User Installer, 여러 사용자가 공유하거나 시스템 전체에 배포하려면 System Installer를 선택합니다. User Installer는 %LOCALAPPDATA%\Programs\Microsoft VS Code에, System Installer는 C:\Program Files\Microsoft VS Code에 설치니다.

Q: macOS에서 code 명령이 zsh/fish 에서 작동하지 않습니다. A: 명령 팔레트에서 'Shell Command: Install 'code' command in PATH'를 실행한 뒤 을 재시작(exec $SHELL)하거나 터미널을 다시 여십시오. fish 은 fish_add_path /Applications/Visual Studio Code.app/Contents/Resources/app/bin을 직접 실행해야 할 수 있습니다.

Q: 프록시 환경에서 확장 마켓플레이스가 열리지 않습니다. A: VS Code 설정(Ctrl+,)에서 http.proxy와 http.proxyStrictSSL을 구성하거나, 환경 변수 HTTP_PROXY/HTTPS_PROXY를 설정한 뒤 VS Code를 재시작하십시오. 공식 문서 'Proxy server support' 페이지를 참조하십시오.