명령줄 인터페이스 (CLI)
Visual Studio Code에는 편집기를 시작하는 방법을 제어할 수 있는 강력한 명령줄 인터페이스가 내장되어 있습니다. 명령줄 옵션(스위치)을 통해 파일을 열고, 확장 프로그램을 설치하고, 표시 언어를 변경하고, 진단 정보를 출력할 수 있습니다.
VS Code 내에서 명령줄 도구를 실행하는 방법에 대한 내용은 통합 터미널을 참조하세요.
명령줄 도움말
VS Code 명령줄 인터페이스에 대한 개요를 보려면 터미널 또는 명령 프롬프트를 열고 code --help를 입력하세요. 버전, 사용 예, 명령줄 옵션 목록을 볼 수 있습니다.
명령줄에서 시작하기
빠르게 파일, 폴더 또는 프로젝트를 열기 위해 명령줄에서 VS Code를 시작할 수 있습니다. 일반적으로 폴더의 컨텍스트에서 VS Code를 엽니다. 이렇게 하려면 열려 있는 터미널 또는 명령 프롬프트에서 프로젝트 폴더로 이동하여 code .를 입력하세요.
macOS 사용자는 VS Code 실행 파일을 PATH 환경 변수에 추가하기 위해 먼저 (셸 명령: PATH에 'code' 명령 설치) 명령을 실행해야 합니다. 도움이 필요하면 macOS 설정 가이드를 읽어보세요.
Windows 및 Linux 설치는 VS Code 바이너리 위치를 시스템 경로에 추가해야 합니다. 그렇지 않은 경우 수동으로 Path 환경 변수(Linux에서는 $PATH)에 위치를 추가할 수 있습니다. 예를 들어 Windows에서는 기본 VS Code 바이너리 위치가 AppData\Local\Programs\Microsoft VS Code\bin입니다. 플랫폼별 설정 지침을 검토하려면 설정을 참조하세요.
Insiders 미리 보기 버전을 사용하는 경우 code-insiders로 Insiders 빌드를 시작합니다.
핵심 CLI 옵션
code를 통해 명령줄에서 VS Code를 시작할 때 사용할 수 있는 선택적 인수는 다음과 같습니다.
| 인수 | 설명 |
|---|---|
-h 또는 --help |
사용법 출력 |
-v 또는 --version |
VS Code 버전(예: 1.22.2), GitHub 커밋 ID 및 아키텍처(예: x64)를 출력합니다. |
-n 또는 --new-window |
이전 세션을 복원하는 대신 VS Code의 새 세션을 엽니다 (기본값). |
-r 또는 --reuse-window |
마지막 활성 창에서 파일 또는 폴더를 강제로 엽니다. |
- |
표준 입력(stdin)에서 읽어 VS Code에서 엽니다 (예: 'echo Hello World |
-g 또는 --goto |
file:line{:character}와 함께 사용하면 특정 줄과 선택적 문자 위치에서 파일을 엽니다. 일부 운영 체제에서 파일 이름에 :를 허용하므로 이 인수가 제공됩니다. |
-d 또는 --diff <file1> <file2> |
파일 차이점 편집기를 엽니다. 인수로 두 파일 경로가 필요합니다. |
-m 또는 --merge <path1> <path2> <base> <result> |
두 개의 수정된 파일 버전, 두 수정본의 공통 원본 및 병합 결과를 저장할 출력 파일의 경로를 제공하여 3방향 병합을 수행합니다. |
-w 또는 --wait |
반환하기 전에 파일이 닫힐 때까지 기다립니다. |
--locale <locale> |
VS Code 세션의 표시 언어(로케일)를 설정합니다. (예: en-US 또는 zh-TW) |
파일 및 폴더 열기
때때로 파일 열기 또는 만들기를 원할 것입니다. 지정된 파일이 존재하지 않으면 VS Code가 새로운 중간 폴더와 함께 파일을 생성합니다.
code index.html style.css documentation\readme.md
파일 및 폴더 모두에 대해 절대 경로 또는 상대 경로를 사용할 수 있습니다. 상대 경로는 code를 실행하는 명령 프롬프트의 현재 디렉터리에 상대적입니다.
명령줄에서 둘 이상의 파일을 지정하면 VS Code는 단일 인스턴스만 엽니다.
명령줄에서 둘 이상의 폴더를 지정하면 VS Code는 각 폴더를 포함하는 다중 루트 워크스페이스를 만듭니다.
| 인수 | 설명 |
|---|---|
file |
열 파일 이름. 파일이 존재하지 않으면 생성되고 수정된 것으로 표시됩니다. 각 파일 이름을 공백으로 구분하여 여러 파일을 지정할 수 있습니다. |
file:line[:character] |
-g 인수와 함께 사용됩니다. 지정된 줄 및 선택적 문자 위치에서 열 파일 이름. |
folder |
열 폴더 이름. 여러 폴더를 지정할 수 있으며 새 다중 루트 워크스페이스가 생성됩니다. |
--skip-add-to-recently-opened |
열린 파일 및 폴더가 최근에 연 목록에 추가되는 것을 방지합니다. |
프로필 선택
--profile 명령줄 인터페이스 옵션을 사용하여 특정 프로필로 VS Code를 시작할 수 있습니다. --profile 인수 뒤에 프로필 이름을 전달하고 해당 프로필을 사용하여 폴더 또는 워크스페이스를 엽니다. 아래 명령줄은 "웹 개발" 프로필로 web-sample 폴더를 엽니다.
code ~/projects/web-sample --profile "Web Development"
지정된 프로필이 존재하지 않으면 주어진 이름으로 새 빈 프로필이 생성됩니다.
확장 프로그램 작업
명령줄에서 VS Code 확장 프로그램을 설치하고 관리할 수 있습니다.
| 인수 | 설명 |
|---|---|
--install-extension <extension-id> | <extension-vsix-path> |
확장 프로그램을 설치하거나 업데이트합니다. 전체 확장 프로그램 이름 publisher.extension 또는 VSIX 파일의 경로를 인수로 제공합니다. 특정 버전을 설치하려면 @{version}을 추가하세요. 예: vscode.csharp@1.2.3. 프롬프트를 피하려면 --force 인수를 사용하세요. 특정 프로필에 설치하려면 --profile 인수를 사용하세요. |
--uninstall-extension <extension-id> |
확장 프로그램을 제거합니다. 전체 확장 프로그램 이름 publisher.extension을 인수로 제공합니다. 특정 프로필에 제거하려면 --profile 인수를 사용하세요. |
--disable-extensions |
설치된 모든 확장 프로그램을 비활성화합니다. 확장 프로그램은 확장 프로그램 보기의 **비활성화됨** 섹션에 계속 표시되지만 활성화되지는 않습니다. |
--list-extensions |
설치된 확장 프로그램을 나열합니다. 특정 프로필에 나열하려면 --profile 인수를 사용할 수 있습니다. |
--show-versions |
--list-extensions를 사용할 때 설치된 확장 프로그램의 버전을 표시합니다. |
--enable-proposed-api <ext> |
확장 프로그램에 대해 제안된 API 기능을 활성화합니다. 전체 확장 프로그램 이름 publisher.extension을 인수로 제공합니다. |
--update-extensions |
설치된 확장 프로그램을 업데이트하고 종료합니다. |
명령줄에서 채팅 시작
VS Code CLI에서 chat 하위 명령을 사용하여 명령줄에서 직접 채팅 세션을 시작할 수 있습니다. 이를 통해 현재 작업 디렉터리에 대해 제공된 프롬프트로 채팅 세션을 열 수 있습니다.
예를 들어 다음 명령은 현재 디렉터리에 대한 채팅을 열고 "입력되지 않은 모든 변수 찾기 및 수정"이라고 묻습니다.
code chat Find and fix all untyped variables
chat 하위 명령에는 다음과 같은 명령줄 옵션이 있습니다.
-m,--mode <mode>: 채팅 세션에 사용할 사용자 지정 에이전트입니다. 사용 가능한 옵션:ask,edit,agent또는 사용자 지정 에이전트의 식별자입니다. 기본값은agent입니다.-a,--add-file <path>: 채팅 세션에 컨텍스트로 파일을 추가합니다.--maximize: 채팅 세션 보기를 최대화합니다.-r,--reuse-window: 채팅 세션에 마지막 활성 창을 사용합니다.-n,--new-window: 채팅 세션을 위해 빈 창을 엽니다.
chat 하위 명령은 -를 명령 끝에 전달하여 stdin에서 입력을 파이핑하는 것도 지원합니다. 예:
python app.py | code chat why does it fail -
고급 CLI 옵션
오류 재현 및 고급 설정을 지원하는 여러 CLI 옵션이 있습니다.
| 인수 | 설명 |
|---|---|
--extensions-dir <dir> |
확장 프로그램의 루트 경로를 설정합니다.data 폴더에 의해 휴대용 모드에서 재정의됩니다. |
--user-data-dir <dir> |
사용자 데이터가 유지되는 디렉터리를 지정합니다. 별도의 환경, 설정 및 확장 프로그램을 가진 VS Code의 여러 격리된 인스턴스를 실행하는 데 사용할 수 있습니다. 루트로 실행할 때도 유용합니다.data 폴더에 의해 휴대용 모드에서 재정의됩니다. |
-s, --status |
프로세스 사용량 및 진단 정보를 출력합니다. |
-p, --performance |
개발자: 시작 성능 명령을 활성화한 상태로 시작합니다. |
--disable-gpu |
GPU 하드웨어 가속을 비활성화합니다. |
--verbose |
자세한 출력을 인쇄합니다 (--wait를 의미함). |
--prof-startup |
시작 중에 CPU 프로파일러를 실행합니다. |
--upload-logs |
현재 세션의 로그를 안전한 엔드포인트로 업로드합니다. |
--remote <authority> |
원격 개발 환경에 연결합니다. 권한은 WSL (wsl+<distro name> <path in WSL>) 또는 SSH (ssh-remote+<remote_server> <path on remote>)의 원격 연결을 지정합니다. |
| 다중 루트 | |
--add <dir> |
다중 루트 워크스페이스의 마지막 활성 창에 폴더를 추가합니다. |
--remove <dir> |
다중 루트 워크스페이스의 마지막 활성 창에서 폴더를 제거합니다. |
VS Code 인스턴스 격리
기본적으로 VS Code 인스턴스는 다음과 같은 방식으로 환경 변수를 공유합니다.
- 첫 번째 VS Code 인스턴스인 경우 환경 변수는 부모 프로세스에서 상속됩니다.
- 첫 번째 VS Code 인스턴스가 아닌 경우 환경 변수는 이미 실행 중인 VS Code 인스턴스에서 상속됩니다.
이 동작은 다른 프로젝트 또는 빌드 구성을 위해 다른 환경 변수가 필요한 경우 문제를 일으킬 수 있습니다. 예를 들어 Node.js의 다른 버전 또는 다른 PATH 설정이 필요한 두 프로젝트에서 작업하는 경우입니다.
각 인스턴스에 대해 고유한 사용자 데이터 디렉터리를 지정하기 위해 --user-data-dir 옵션을 사용하여 별도의 환경 변수로 VS Code 인스턴스를 실행해야 합니다.
# First instance with its own environment
code ~/project1 --user-data-dir ~/vscode-data-project1
# Second instance with different environment
code ~/project2 --user-data-dir ~/vscode-data-project2
각각 다른 --user-data-dir를 가진 인스턴스는 자체적으로 유지 관리합니다.
- 환경 변수
- 설정 및 기본 설정
- 설치된 확장 프로그램
- UI 상태 및 레이아웃
--user-data-dir를 사용할 때는 확장 프로그램이 별도로 저장되므로 각 사용자 데이터 디렉터리에 대해 확장 프로그램을 다시 설치해야 합니다.
원격 터널 생성
VS Code는 더욱 강력하고 유연해지기 위해 다른 원격 환경과 통합됩니다. 목표는 로컬 및 원격 머신을 모두 단일 통합 CLI에서 관리할 수 있는 응집력 있는 경험을 제공하는 것입니다.
Visual Studio Code Remote - Tunnels 확장 프로그램을 사용하면 안전한 터널을 통해 데스크톱 PC 또는 VM과 같은 원격 컴퓨터에 연결할 수 있습니다. 터널링은 한 네트워크에서 다른 네트워크로 데이터를 안전하게 전송합니다. 그런 다음 SSH 없이도 어디서든 해당 컴퓨터에 안전하게 연결할 수 있습니다.
원격 머신에서 터널을 시작하는 기능이 code CLI에 내장되어 있습니다. 다음을 실행할 수 있습니다.
code tunnel
원격 머신에서 터널을 생성합니다. 웹 또는 데스크톱 VS Code 클라이언트를 통해 이 컴퓨터에 연결할 수 있습니다.
code tunnel -help를 실행하여 다른 터널링 명령을 검토할 수 있습니다.
VS Code 데스크톱을 설치할 수 없는 원격 머신에서 CLI를 실행해야 할 수도 있으므로 CLI는 VS Code 다운로드 페이지에서 독립적으로 설치할 수도 있습니다.
원격 터널에 대한 자세한 내용은 원격 터널 문서를 참조하세요.
URL로 VS Code 열기
플랫폼의 URL 처리 메커니즘을 사용하여 프로젝트 및 파일을 열 수도 있습니다. 다음 URL 형식을 사용하여 다음을 수행합니다.
프로젝트 열기
vscode://file/{full path to project}/
vscode://file/c:/myProject/
파일 열기
vscode://file/{full path to file}
vscode://file/c:/myProject/package.json
줄 및 열에서 파일 열기
vscode://file/{full path to file}:line:column
vscode://file/c:/myProject/package.json:5:10
설정 편집기 열기
vscode://settings/setting.name
vscode://settings/editor.wordWrap
브라우저 또는 파일 탐색기와 같이 URL을 구문 분석하고 리디렉션할 수 있는 애플리케이션에서 URL을 사용할 수 있습니다. 예를 들어 Windows에서는 vscode:// URL을 Windows 탐색기 또는 명령줄에 start vscode://{full path to file}로 직접 전달할 수 있습니다.
Insiders 미리 보기 빌드를 사용하는 경우 URL 접두사는 vscode-insiders://입니다.
다음 단계
자세한 내용은 계속 읽어보세요.
- 통합 터미널 - VS Code 내에서 명령줄 도구를 실행합니다.
- 기본 편집 - VS Code 편집기의 기본 사항을 배웁니다.
- 코드 탐색 - VS Code를 사용하면 소스 코드를 빠르게 이해하고 이동할 수 있습니다.
자주 묻는 질문
'code'이(가) 내부 또는 외부 명령으로 인식되지 않습니다.
운영 체제에서 경로에 VS Code 실행 파일 code를 찾을 수 없습니다. VS Code Windows 및 Linux 설치는 경로에 VS Code를 설치해야 합니다. VS Code를 제거하고 다시 설치해 보세요. code를 여전히 찾을 수 없으면 Windows 및 Linux의 플랫폼별 설정 항목을 참조하세요.
macOS에서는 셸 명령: PATH에 'code' 명령 설치 명령 (명령 팔레트 ⇧⌘P (Windows, Linux Ctrl+Shift+P)를 통해 사용 가능)을 수동으로 실행해야 합니다. 자세한 내용은 macOS 관련 설정 항목을 참조하세요.
VS Code 내에서 명령줄(터미널)에 어떻게 접근하나요?
VS Code에는 VS Code 내에서 명령줄 도구를 실행할 수 있는 통합 터미널이 있습니다.
휴대용 버전을 위해 VS Code의 설정 위치를 지정할 수 있나요?
명령줄을 통해 직접적으로는 불가능하지만, VS Code에는 설치 위치와 같은 장소에 설정 및 데이터를 유지할 수 있는 휴대용 모드가 있습니다 (예: USB 드라이브).
VS Code에 의해 셸이 시작되었는지 어떻게 감지할 수 있나요?
VS Code가 시작될 때 도구를 설정하는 데 도움이 되는 "셸 환경"을 소싱하기 위해 셸을 시작할 수 있습니다. 이렇게 하면 **대화형 로그인** 셸이 시작되고 해당 환경을 가져옵니다. 셸 설정에 따라 문제가 발생할 수 있습니다. 예를 들어, VS Code가 사용자 생성 터미널의 $PATH 값을 정확하게 일치시키기 위해 대화형 세션으로 셸을 시작하는 것은 예상치 못한 일일 수 있습니다.
VS Code가 이 초기 셸을 시작할 때마다 VS Code는 VSCODE_RESOLVING_ENVIRONMENT 변수를 1로 설정합니다. 셸 또는 사용자 스크립트가 이 셸의 컨텍스트에서 실행 중인지 알아야 하는 경우 VSCODE_RESOLVING_ENVIRONMENT 값을 확인할 수 있습니다.