본문으로 건너뛰기

사용 가이드

Mac VS Code에서 음성 입력

VS Code는 공식 받아쓰기 확장 기능이 있는 드문 앱입니다. 동시에 받아쓴 문장을 코드로 취급하는 자동 완성 엔진도 있는데, 이 부분은 아무도 경고해 주지 않습니다.

최종 업데이트: 2026-08-29

Slack, Notion, Gmail과 달리 VS Code에는 자체 받아쓰기 기능이 있습니다. Microsoft가 VS Code Speech라는 확장 기능을 배포하고 있습니다. 이 기능을 써야 할지는 텍스트가 어디로 가느냐에 달려 있습니다.

방법 A: VS Code Speech(공식 확장 기능)

  1. 확장 보기를 열고 Microsoft가 배포한 VS Code Speech(확장 ID ms-vscode.vscode-speech)를 설치합니다.
  2. 편집기에 커서를 둡니다.
  3. Option+Command+V를 눌러 "Voice: Start Dictation in Editor"를 실행합니다. 같은 단축키로 멈춥니다.
  4. 이 확장 기능은 채팅 보기의 음성 입력도 지원하며, 실제로는 대부분의 사람이 이 용도로 씁니다.

한계는 사용 범위입니다. VS Code 안에서만 받아쓸 수 있으므로, 풀 리퀘스트 설명을 쓰려고 브라우저로 넘어가는 순간 다른 도구와 다른 단축키로 돌아가게 됩니다.

방법 B: macOS 받아쓰기(터미널 패널에서도 작동)

  1. 받아쓰기를 한 번 켭니다: 시스템 설정 → 키보드 → 받아쓰기. 자세한 단계는 macOS에서 받아쓰기 켜기를 참고하세요.
  2. 주석, 독스트링, 소스 제어의 커밋 메시지 입력란, 또는 통합 터미널을 클릭합니다.
  3. 받아쓰기를 시작해 말한 다음, 받아쓰기를 멈춰 확정합니다.

시스템 받아쓰기는 통합 터미널과 소스 제어 패널의 커밋 메시지 입력란에 닿습니다. 편집기에서 받아쓴 텍스트의 대부분이 실제로 가는 두 곳을 모두 다룹니다.

VS Code만의 함정: IntelliSense가 문장을 고칩니다

VS Code는 입력하는 동안 자동 완성 목록을 보여 주며, 기본 설정에서는 단어 구분 문자가 강조된 제안을 수락할 수 있습니다. 받아쓴 글은 단어와 구분 문자의 연속이라서, 주석에 내가 말한 단어 대신 파일에 있는 변수 이름이 들어갈 수 있습니다. 증상은 여섯 단어까지는 제대로 읽히던 주석이 문장 한가운데에 useEffectHandler 같은 것을 담고 있는 모습입니다.

  • "editor.acceptSuggestionOnCommitCharacter": false로 설정하면 구분 문자가 제안을 수락하지 않습니다.
  • "editor.acceptSuggestionOnEnter": "off"로 설정하면 말로 한 줄바꿈이 자동 완성을 고르지 않습니다.
  • "editor.quickSuggestions": { "comments": false, "strings": false }로 설정하면 받아쓰는 위치에서 목록이 열리지 않습니다.
  • 가능하면 편집기 대신 소스 제어의 커밋 입력란에 받아쓰세요. 자동 완성 엔진이 붙어 있지 않은 일반 텍스트 입력란입니다.

편집기에서 받아쓸 만한 것

  • 커밋 메시지 본문. 이유는 글로 쓰는 내용이고, 무엇을 바꿨는지는 diff가 이미 말해 줍니다.
  • 독스트링과 함수 주석의 초안. 나중에 다듬습니다.
  • 변경 로그 항목과 릴리스 노트.
  • 코드는 제외입니다. 식별자, 높은 문장 부호 밀도, 대소문자 때문에 음성은 키보드보다 느립니다.

아무것도 입력되지 않는다면

  • VS Code Speech 확장 기능을 쓰고 있다면 시스템 설정 → 개인정보 보호 및 보안 → 마이크 → Visual Studio Code를 허용하세요. 시스템 받아쓰기는 대신 macOS가 음성을 받으므로, 받아쓰기 도구에 대한 권한이 필요합니다.
  • VS Code뿐 아니라 어디서도 받아쓰기가 안 된다면: Mac에서 받아쓰기가 작동하지 않을 때.

방법 C: 편집기와 브라우저에서 쓰는 하나의 단축키

엔지니어가 받아쓰는 텍스트의 대부분은 편집기에 있지 않습니다. 풀 리퀘스트 설명, 티켓, Slack 스레드 순입니다. Voice Type은 이 모두에서 작동하는 누르고 말하기 단축키를 하나 지정하고, 모델을 Mac에서 실행합니다: Mac용 음성 입력.

이어서 보기

출처

Voice Type 사용해 보기 (7일 무료 체험)

실제 업무로 써 보세요

Voice Type은 macOS용 기기 내 받아쓰기입니다. 단축키를 누르고 말하면 입력 중인 앱에 텍스트가 들어갑니다. 음성은 Mac 밖으로 나가지 않습니다. 7일 무료, 이후 19.99달러(USD) 한 번 결제 로 Mac App Store에서 구매합니다. 구독도 계정도 필요 없습니다.

무료 체험 시작