superwhisper의 Vocabulary와 Replacements: 인식 결과를 해치지 않고 내 단어 가르치기

글쓴이 · 게시일

superwhisper가 자꾸 틀리는 단어를 위한 도구는 두 가지이고, 서로 반대 방식으로 작동합니다. Vocabulary 단어(어휘 단어)는 음성과 함께 보내는 힌트여서, 모델이 이름이나 용어를 알아들을 가능성을 높입니다. Replacements(치환)는 텍스트가 만들어진 뒤에 실행되어, 설정한 그대로 한 문자열을 다른 문자열로 바꿉니다. 잘못된 도구를 쓰거나 힌트를 너무 많이 넣는 것이 superwhisper가 나아지기는커녕 나빠지는 흔한 이유입니다.

저는 Mac용 다른 받아쓰기 앱 YapToText를 만들고 있으니, superwhisper에 관한 제 설명은 그 점을 감안하고 읽어 주세요. 여기 있는 superwhisper에 관한 내용은 모두 2026년 10월 10일에 읽은 공식 문서에서 가져왔습니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

다른 언어로 읽기: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

두 도구를 나란히 비교

superwhisper 문서 Vocabulary에서 2026년 10월 10일에 읽은 내용입니다.

Vocabulary 단어Replacements
작동하는 때음성 인식 전에, 음성과 함께 힌트로 전달됩니다음성 인식 후에, 완성된 텍스트에 적용됩니다
하는 일모델이 단어를 알아들을 가능성을 높입니다AI 없이 한 문자열을 다른 문자열로 바꿉니다
결과 보장아니요. 모델을 살짝 유도할 뿐이고, 효과는 모델마다 다릅니다예. 어떤 모델이든 매번 같은 결과가 나옵니다
적합한 경우이름, 약어, 회사 이름, 전문 용어, 다른 언어의 단어계속 반복되는 오류, 기호, 이메일 주소, 풀어 쓰는 문구
위험목록이 길면 모델이 혼란스러워하고 구두점이 달라질 수 있습니다거의 없습니다. 대소문자는 구분하지 않고 일치시킵니다

Vocabulary 목록은 짧게 유지하기

문서는 이 점을 분명히 말합니다. Vocabulary 단어가 너무 많으면 음성 인식 모델이 혼란스러워질 수 있고, 다른 언어의 단어는 정확도와 자동 언어 감지를 해칠 수 있으며, 어휘는 철자뿐 아니라 구두점과 서식에도 영향을 줍니다. 문서의 조언은 목록을 짧게 유지하고, 일관되게 고쳐야 하는 부분에는 Replacements를 쓰라는 것입니다.

어휘를 많이 추가한 뒤 superwhisper가 단어를 덧붙이거나 텍스트를 반복하기 시작했다면 단어가 덧붙거나 반복되는 문제 페이지에서 그 경우를 다룹니다.

Replacements의 동작 방식

  • 일치시킬 때는 대소문자가 상관없습니다. todo를 위한 치환은 ToDo, TODO, Todo도 잡아냅니다.
  • 결과에서는 대소문자가 그대로 반영됩니다. 텍스트는 치환에 입력한 그대로 나옵니다.
  • 틀린 단어 하나에 철자 여러 개. 한 단어가 여러 방식으로 잘못 들린다면 각각에 대한 치환을 추가하고 모두 올바른 철자로 연결합니다.
  • 모델과 무관합니다. 어떤 음성 모델이 받아썼든 똑같이 적용됩니다.

기호와 이메일 주소

음성 모델은 말을 인식하도록 조정되어 있어서, at sign이나 slash가 기호로 나오는 일은 드뭅니다. 문서는 이를 위해 다음과 같은 치환 세트를 제안합니다.

superwhisper 문서 Vocabulary에서 2026년 10월 10일에 읽은 내용입니다. 문서에는 dash도 있습니다.

말하는 것나오는 결과
at sign(골뱅이)@
dot com.com
dot net.net
dot org.org
hashtag#
slash/
underscore_

자주 쓰는 주소는 각각 치환으로 추가하세요. 예를 들어 my work email 같은 문구가 주소로 바뀌게 할 수 있습니다. 한 번만 쓰는 주소는 이름, at sign, 도메인, dot com 순서로 말하면 기호 치환이 나머지를 처리합니다.

설정하는 곳

둘 다 Mac 앱의 Settings, Vocabulary에 있고, 같은 목록에 들어 있습니다. 항목 옆의 휴지통 아이콘을 클릭하면 지워집니다. 터미널에서는 superwhisper CLI의 superwhisper vocab이 어휘 단어, superwhisper snippets가 치환을 다룹니다. CLI 문서는 이를 앱과 같은 From과 To 쌍이라고 설명합니다.

새 Mac으로 옮기나요? 어휘는 나머지 설정과 함께 옮겨지며, 백업 페이지에서 설명합니다. 다른 명령은 CLI 페이지에서 다룹니다.

언어 감지를 위한 어휘 요령 하나

언어가 Automatic으로 설정되어 있는데 받아쓰기가 계속 영어로 나온다면, superwhisper 문서는 쓰는 언어의 문구 하나를 힌트로 어휘 목록에 추가하거나 언어를 고정하라고 제안합니다. 이 힌트는 모델을 거쳐 작동하므로 효과는 모델마다 다릅니다. 단계는 언어 변경 페이지에 있습니다.

YapToText가 같은 일을 하는 방법

superwhisper는 문서에서 2026년 10월 10일에 읽은 내용이고, YapToText는 앱 자체의 설정에서 가져왔습니다.

superwhisperYapToText
음성 모델에 주는 힌트Vocabulary 단어사전의 단어가 Whisper 모델에 미리 전달됩니다
이후의 고정된 치환ReplacementsSubstitutions, Whole word와 Case 옵션이 있습니다
목록 여러 개문서에 설명이 없습니다사전이 여러 개이고, 각각 지우지 않고 끌 수 있습니다
사용자에게서 배우기문서에 설명이 없습니다같은 단어를 두 번 고치면 그 수정을 계속 적용할지 묻습니다
작업별 설정문서에 설명이 없습니다모드마다 켜져 있는 모든 사전을 쓰거나 일부만 고를 수 있습니다

YapToText는 Mac에서 받아쓴 내용을 바탕으로 수정도 제안합니다. 가장 빠른 방법은 어디서든 올바른 철자를 선택하고 Quick Edit 키를 누른 다음 add this to my dictionary라고 말하는 것입니다. 사전 도움말 페이지에서 자세히 다루고, 사용자 단어 가이드에서는 Mac에서 쓸 수 있는 방법을 비교합니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

정리

  • 자꾸 틀리게 듣는 이름. Vocabulary 단어로 추가합니다.
  • 항상 철자를 틀리는 단어. 치환을 추가하고, 틀린 철자마다 하나씩 만듭니다.
  • 기호와 이메일. at sign과 dot com 같은 치환을 씁니다.
  • 결과가 나빠졌다면. 어휘 목록을 줄입니다.
  • 터미널. superwhisper vocab과 superwhisper snippets입니다.

superwhisper가 이 기능의 동작을 바꾸면 GitHub에 이슈를 남겨 주세요. 이 페이지를 고치겠습니다. 모두 읽습니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

글쓴이 소개. Ryleigh Newman은 소프트웨어를 개발합니다. 손으로 타이핑하기가 어려워서, 이 사이트에서 소개하는 앱인 YapToText로 매일 받아쓰기를 합니다. 이 페이지는 영어에서 번역한 것입니다. 앱의 화면과 사이트의 다른 페이지는 영어로 되어 있습니다. 프로젝트 더 알아보기(영어).

가이드

다른 가이드(영어)

출처

자주 묻는 질문

superwhisper에서 Vocabulary와 Replacements는 무엇이 다른가요?

Vocabulary 단어는 음성과 함께 보내는 힌트여서 모델이 용어를 알아듣게 돕습니다. Replacements는 음성 인식 후에 실행되어 설정한 그대로 텍스트를 바꿉니다.

어휘를 추가했더니 superwhisper가 나빠진 이유는 무엇인가요?

문서에 따르면 Vocabulary 단어가 너무 많으면 모델이 혼란스러워지고 구두점과 언어 감지에 영향을 줄 수 있습니다. 목록은 짧게 유지하고, 고정된 수정에는 Replacements를 쓰세요.

superwhisper의 Replacements는 대소문자를 구분하나요?

일치시킬 때는 구분하지 않으므로 todo가 TODO와도 일치합니다. 결과에는 치환에 입력한 대소문자가 그대로 쓰입니다.

superwhisper에서 이메일 주소를 받아쓰려면 어떻게 하나요?

at sign을 @로, dot com을 .com으로 바꾸는 치환을 추가하거나, 주소 전체를 하나의 치환으로 추가합니다.

터미널에서 superwhisper 어휘를 편집할 수 있나요?

네. superwhisper CLI에서 vocab은 어휘 단어를, snippets는 치환을 다룹니다.