한국어
Mac의 VS Code에서 마우스 버튼 쓰는 법
이 앱은 완전히 무료입니다. 계정을 만들 필요가 없습니다. 구독도, 번거로운 다운로드도 없고, 잠긴 기능도 없습니다. Apple 실리콘에 최적화되어 있습니다.
VS Code는 이미 옆면 버튼을 뒤로와 앞으로로 취급하고, Mac에서 그렇게 하는 기본 방법은 매퍼가 아니라 설정입니다. 매퍼가 더하는 역할은 실행, 빌드, 중지, 디버거 단계이고, 이것들은 버튼 하나에 두는 키입니다. 제가 만드는 무료 Mac 앱 InputConfig는 어떤 마우스 버튼이든 스캔해서 키나 단축키 전체를 보내고, VS Code가 맨 앞 앱일 때 따라갈 수도 있습니다. 이 앱은 완전히 무료이고 계정을 만들 필요가 없습니다.
키는 2026년 10월 21일에 읽은 Microsoft의 macOS 키보드 단축키 시트, 디버깅 페이지, 작업 페이지에서 가져왔습니다. 아래의 Xcode 섹션은 Apple 자체 목록을 씁니다.
InputConfig 1.7 버전(2026년 10월 출시 예정)부터 앱이 한국어를 완전히 지원합니다.
단계
- VS Code의 설정에서 mouse back forward를 검색해 Enables the use of mouse buttons four and five가 켜져 있는지 확인합니다.
- InputConfig를 설치하고 시스템 설정의 개인정보 보호 및 보안, 손쉬운 사용에서 손쉬운 사용 접근을 허용합니다.
- 행을 추가하고 입력을 마우스로 정한 다음 Scan을 누르고 엄지 버튼을 클릭한 뒤, 키보드 키와 실행이나 빌드의 단축키를 고릅니다.
- Command 왼쪽 대괄호나 Command 오른쪽 대괄호를 보내는 프리셋에는 VS Code를 넣지 마세요. 그 키는 줄을 들여쓰고 내어쓰기 때문입니다.
- Activate when these apps are in front 아래에 VS Code를 나열하고, Switch presets when the front app changes를 켠 다음 Activate를 클릭합니다.
VS Code와 macOS가 마우스에 주는 것
VS Code에는 소스에서 마우스 버튼 4와 5를 Go Back과 Go Forward 명령에 쓰도록 하는 것으로 설명된 workbench.editor.mouseBackForwardToNavigate 설정이 있고, 기본값은 켜짐입니다. 이것은 2026년 10월 21일에 읽은 GitHub의 VS Code 소스에서 가져왔습니다. 그러므로 옆면 버튼이 Button 4와 Button 5로 보고되는 마우스는 도움 없이도 이동해야 합니다.
키보드 대응 키는 Microsoft의 시트에 따르면 Go Back이 Control 마이너스이고 Go Forward가 Control Shift 마이너스입니다. 옆면 버튼이 VS Code에서 이미 이동한다면 그대로 두고, 아무 일도 하지 않는 버튼에 매퍼를 쓰세요.
각 버튼이 무엇을 보내는지 알아내기
마우스 버튼은 Mac에 왼쪽 클릭, 오른쪽 클릭, 가운데 클릭, Button 4 이상으로 도착합니다. Scan을 누르고 버튼을 클릭하세요. Scan이 마우스 버튼이 아니라 키의 이름을 보여 주면 마우스가 키를 보내고 있는 것이고, 해결 방법은 Mac의 F13부터 F19에 있습니다.
| 버튼 | 보통 전달되는 방식 | VS Code에서 좋은 역할 |
|---|---|---|
| 왼쪽 클릭과 오른쪽 클릭 | 왼쪽 클릭과 오른쪽 클릭 | 그대로 두세요. 막을 수 없습니다. |
| 휠 누르기 | 가운데 클릭 | 편집기 닫기인 Command W나 정의로 이동인 F12. |
| 옆면 버튼 | Button 4와 Button 5 | 뒤로와 앞으로이며 VS Code가 이미 할 수 있습니다. |
| 엄지 격자나 추가 버튼 | Button 6 이상 | 실행, 중지, 단계 건너뛰기, 단계 들어가기, 빌드. |
| 틸트 휠 | 가로 스크롤 | 이전과 다음 편집기 탭. |
| DPI나 프로필 버튼 | 대개 Mac이 읽을 수 있는 것이 없음 | 없음. Scan이 누름을 듣지 못하면 어떤 앱도 읽을 수 없습니다. |
Command 대괄호의 함정
InputConfig에는 옆면 버튼에 뒤로와 앞으로를 두는 내장 프리셋이 있고, 브라우저와 Finder가 이해하는 Command 왼쪽 대괄호와 Command 오른쪽 대괄호를 보냅니다. VS Code에서는 Microsoft의 시트가 같은 두 키를 줄 들여쓰기와 내어쓰기로 올려 두었습니다. 그 프리셋이 VS Code가 맨 앞일 때 실행되면 옆면 버튼을 누를 때 코드가 편집됩니다.
- 방법 하나. 옆면 버튼은 VS Code 자체 설정에 맡기고, 이 프리셋은 다른 앱에 쓰세요.
- 방법 둘. 같은 버튼에 Control 마이너스와 Control Shift 마이너스를 보내는 VS Code 프리셋을 만들고, Activate when these apps are in front 아래에 VS Code를 나열하세요.
- 방법 셋. VS Code와 프리셋이 모두 동작한다면 행에서 Block the button's own action을 체크해서 뒤로가 두 번 일어나지 않게 하세요.
한 번에 프리셋 하나만 실행되므로 VS Code 프리셋과 뒤로, 앞으로 프리셋에는 각자의 앱 목록이 필요합니다. 같은 버튼 두 개가 앱마다 다른 키를 보내야 하고, 앱별 프리셋이 바로 그 용도입니다.
실행, 빌드, 디버거를 버튼에 두기
1단계: 스캔하고 실행 주기
- 사용자: 행을 추가하고 기기를 이 Mac의 마우스나 트랙패드로, 입력을 마우스로, 종류를 버튼으로 정한 다음 Scan을 누르고 엄지 버튼을 클릭합니다. 출력을 키보드 키로 정하고 F5를 고릅니다.
- InputConfig: 버튼을 누를 때마다 F5를 누릅니다.
- 확인: 실행 설정이 있는 프로젝트를 열고 버튼을 누릅니다. 디버거가 시작되거나, 이미 실행 중이면 계속됩니다.
2단계: 빌드와 중지 더하기
- 사용자: 다음 버튼에서 출력을 키보드 키로 정하고 보조 키에서 Shift와 Command를 고른 다음 B를 더합니다. 또 다른 버튼에는 Shift와 F5를 둡니다.
- InputConfig: 빌드 작업 실행이 쓰는 Shift Command B와, 디버깅을 중지하는 Shift F5를 누릅니다.
- 확인: 빌드를 누르면 작업 선택기나 기본 작업이 실행됩니다. 중지를 누르면 디버거가 끝납니다.
| 역할 | Mac의 VS Code 키 | 알맞은 자리 |
|---|---|---|
| Go Back과 Go Forward | Control 마이너스와 Control Shift 마이너스 | Button 4와 Button 5 |
| 디버깅 시작 또는 계속 | F5 | 엄지 버튼 |
| 디버깅 중지 | Shift F5 | 그 버튼의 길게 누르기 |
| 디버깅 다시 시작 | Shift Command F5 | 두 번째 길게 누르기 |
| 빌드 작업 실행 | Shift Command B | 엄지 버튼 |
| 단계 건너뛰기, 들어가기, 나가기 | F10, F11, Shift F11 | 엄지 버튼 세 개 |
| 중단점 전환 | F9 | 엄지 버튼 |
| 정의로 이동과 정의 미리 보기 | F12와 Option F12 | 휠 누르기와 길게 누르기 |
| 빠른 열기와 명령 팔레트 | Command P와 Shift Command P | 엄지 버튼 두 개 |
| 통합 터미널 보기 | Control 백틱 | 엄지 버튼 |
| 편집기 닫기 | Command W | 휠 누르기 |
VS Code의 디버그 페이지는 F5를 계속 또는 일시정지로, Shift F5를 중지로 올려 두었습니다. 빌드 작업 실행은 작업 페이지에서 Shift Command B입니다.
매크로와 여러 단계의 일
매크로는 Run a sequence of steps를 체크한 행이고, 각 단계는 자기 대기 시간이 있는 키, 단축키, 클릭입니다. 코드에 알맞은 매크로 세 가지입니다.
- 저장하고 빌드. Command S, 짧은 대기, 그다음 Shift Command B. 지금 있는 파일을 저장하고 빌드를 시작합니다.
- 멈추고 다시 시작. Shift F5, 1초 대기, 그다음 F5. 버튼 하나로 다시 실행합니다.
- 터미널을 가까이. Control 백틱은 통합 터미널을 보여 주고, 그다음 Type Text 출력이 하루 종일 실행하는 명령을 입력할 수 있습니다. 먼저 확인할 수 있도록 Return은 빼겠습니다.
저는 이것들을 VS Code에서 직접 실행해 보지 않았고, 디버거를 멈추고 시작하는 매크로는 먼저 시험 삼아 돌려 볼 가치가 있습니다. 실수로 눌러도 실행되지 않도록 입력하는 명령에는 Return을 넣지 마세요.
길게 누르기, 반복, 두 번 누르기, 앱별 전환
- 한 번 누르기와 길게 누르기. 한 번 누르면 F5, 길게 누르면 Shift F5로 두면 버튼 하나가 시작하고 멈춥니다. 빠르게 탭하면 일반 출력을 보내고, 정한 시간을 넘겨 누르고 있으면 다른 것을 보냅니다.
- 누르는 동안 키 반복. F10으로 단계를 진행할 때, 버튼을 누르고 있는 동안 계속 진행합니다. 빌드에는 끄세요.
- 버튼 자체 동작 막기. 가운데 버튼과 옆면 버튼에서 쓸 수 있고, 프리셋이 실행되는 동안 앱이 그 버튼을 보지 못하게 합니다.
VS Code에서 배치를 유지하려면 프리셋의 Automation & Gaming Utilities 섹션을 열고 Activate when these apps are in front 아래에 Visual Studio Code를 추가한 다음, 설정의 Advanced에서 Switch presets when the front app changes를 켜세요. 긴급 정지는 Control Option Command 마침표입니다.
Mac의 Xcode
Xcode도 같은 발상이고 키만 다릅니다. Apple의 보관된 표가 Apple의 보관된 Xcode 메뉴 명령 단축키에 나열되어 있고, 2026년 10월 21일에 읽었습니다. 이전 Xcode를 설명하는 것이므로, 내 버전의 Product와 Navigate 메뉴를 열어 보세요. 각 명령에 현재 키가 표시됩니다.
| 역할 | Apple의 표에 나오는 Xcode 키 | 알맞은 자리 |
|---|---|---|
| Go Back과 Go Forward | Control Command 왼쪽 화살표와 Control Command 오른쪽 화살표 | Button 4와 Button 5 |
| 실행 | Command R | 엄지 버튼 |
| 빌드 | Command B | 엄지 버튼 |
| 중지 | Command 마침표 | 실행 버튼의 길게 누르기 |
| 빠르게 열기 | Shift Command O | 휠 누르기 |
| 정리 | Shift Command K | 빌드 버튼의 길게 누르기 |
Xcode에 자기 프리셋을 주고 Activate when these apps are in front 아래에 나열하세요. 버튼을 스캔하고 Xcode 메뉴에서 본 키를 바인딩하면 Xcode가 VS Code의 키를 보는 일이 없습니다. 버튼 하나의 길게 누르기에 실행과 중지를 두는 것이 어느 편집기든 다루는 가장 간단한 방법입니다.
VS Code에서 버튼이 아무 반응이 없을 때
작은 단계부터 이 순서로 따라가세요.
- 프리셋이 켜져 있는지 확인하기. Activate를 클릭하고, 프리셋이 따라가는 앱이 VS Code인지 확인합니다.
- 손쉬운 사용 확인하기. 시스템 설정의 개인정보 보호 및 보안, 손쉬운 사용입니다.
- 이중 동작 확인하기. 뒤로가 두 번 일어나면 VS Code 자체 설정과 내 행이 모두 동작하는 것입니다. Block the button's own action을 체크하세요.
- 기능 키 확인하기. 노트북에서는 F5와 F10에 Fn 키가 필요할 수 있습니다. 시스템 설정의 키보드에서 기능 키를 표준으로 두거나, 그것에 의존하지 않는 행에서 키를 보내세요.
- Scan 확인하기. 버튼이 키로 스캔된다면 먼저 제조사 소프트웨어에서 F13부터 F20으로 설정하세요.
- 제조사 소프트웨어 종료하기. Logi Options+ 같은 앱이 버튼을 가로챌 수 있습니다.
할 수 없는 것
- 코드 읽기. InputConfig는 키, 클릭, 스크롤을 보냅니다. 지금 어느 파일에 있는지, 디버거가 어떤 상태인지는 알 수 없습니다.
- 마우스 두 대 구분하기. 연결된 마우스는 모두 기기 하나로 취급됩니다.
- 포인터 속도 바꾸기. Mac의 설정, 제조사의 앱, 또는 LinearMouse, Mac Mouse Fix, SteerMouse를 쓰세요.
- 한 프로젝트에서만 실행하기. 프리셋은 폴더나 작업 영역이 아니라 맨 앞의 앱을 따라갑니다.
짧은 정리
- 설정을 먼저 확인하세요. VS Code는 Button 4와 Button 5로 스스로 이동할 수 있습니다.
- 대괄호 키를 피하세요. Command 왼쪽과 오른쪽 대괄호는 VS Code에서 줄을 들여씁니다.
- 앱을 따라가세요. VS Code와 Xcode는 각각 자기 프리셋을 가집니다.
엄지 버튼 하나에서 한 번 누르면 실행, 길게 누르면 중지가 제가 먼저 해 볼 설정입니다.
자주 묻는 질문
Mac의 VS Code에서 마우스 뒤로, 앞으로 버튼을 쓸 수 있나요?
네. VS Code에는 마우스 버튼 4와 5를 Go Back과 Go Forward로 쓰는 설정이 있고, 소스에는 기본값이 켜짐으로 나와 있습니다. 키보드 키는 Control 마이너스와 Control Shift 마이너스입니다.
마우스 뒤로 버튼이 VS Code에서 줄을 들여쓰는 이유는 무엇인가요?
프리셋이 Command 왼쪽 대괄호나 Command 오른쪽 대괄호를 보내고 있는데, VS Code는 이것을 들여쓰기와 내어쓰기에 씁니다. 대신 Control 마이너스를 보내는 VS Code 프리셋을 쓰세요.
Mac의 VS Code에서 실행과 빌드 단축키는 무엇인가요?
F5는 디버깅을 시작하거나 계속하고, Shift F5는 중지하며, Shift Command B는 빌드 작업을 실행합니다.
VS Code에서 마우스 버튼으로 코드를 실행하려면 어떻게 하나요?
InputConfig에서 버튼을 스캔하고 출력을 키보드 키로 정한 다음 F5를 고르세요. 같은 버튼이 중지하도록 Shift F5의 길게 누르기 동작을 더합니다.
Mac의 Xcode에서 뒤로 가는 단축키는 무엇인가요?
Apple의 표에서는 Control Command 왼쪽 화살표이고, 앞으로는 Control Command 오른쪽 화살표입니다. 표가 이전 버전의 것이니 내 Xcode 메뉴를 확인하세요.
한국어 페이지 더 보기
자세한 안내(영어)
글쓴이 소개. Ryleigh Newman은 InputConfig를 개발하고 있습니다. 손을 쓰기가 어려워서 매일 컨트롤러로 Mac을 조작합니다. 이 페이지는 영어에서 번역했습니다. Mac 언어가 한국어로 설정되어 있으면 앱의 주요 버튼과 메뉴가 한국어로 표시되며, 이 페이지는 그 이름에 영어 이름을 괄호로 함께 적었습니다. 앱의 나머지 부분과 사이트의 다른 페이지는 영어입니다.
이 페이지의 다른 언어: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文
무료. macOS 14 이상. 계정이 필요 없고, 데이터는 Mac 밖으로 나가지 않습니다. 소스 코드는 GitHub에 있습니다.