
프롬프트를 사무실 전체에 말하지 마세요
수정 방향, 오류, 예외 조건을 작은 목소리로 설명하면 됩니다. 주변 사람이 대화에 참여할 필요는 없습니다.
사무실에서도 부담 없는 음성 입력
undervoice를 쓰면 아직 남에게 말하고 싶지 않은 아이디어도 주변 눈치 없이 말로 풀어낼 수 있습니다. 동료들 앞에서 프롬프트를 읽는 민망함도 없습니다. iPhone에 작게 말하면 Mac이 로컬에서 받아써 현재 커서에 바로 입력합니다.

01 / 작동 방식
undervoice는 책상 건너편의 Mac 대신 손에 든 iPhone으로 목소리를 받습니다. 마이크가 가까우니 키보드 소리, 냉난방 소리, 주변 대화보다 내 목소리가 먼저 또렷하게 들어갑니다. 목소리를 높이지 않아도 Mac의 로컬 음성 인식에 깨끗한 소리를 전달할 수 있습니다.
IPHONE → MAC / 실제 사용 흐름
iPhone은 가까이서 소리를 받습니다. 암호화된 오디오는 페어링한 Mac으로 전달되고, Mac 안에서 인식된 뒤 활성 커서에 바로 입력됩니다.
ScenicRouteRanker.swift

수정 방향, 오류, 예외 조건을 작은 목소리로 설명하면 됩니다. 주변 사람이 대화에 참여할 필요는 없습니다.

근접 수음이 사무실을 조용하게 만들지는 않습니다. 대신 인식이 시작되기 전에 내 목소리가 주변 소리보다 두드러지게 합니다.
Codex, Claude Code, Xcode, Terminal, 브라우저에 그대로 머무세요. 텍스트가 현재 커서로 들어옵니다.
02 / 책상에서 중요한 숫자
얼마나 작게 말할 수 있는지, 오디오가 어디로 가는지, 말한 뒤에 별도 작업이 필요한지에 답하는 수치입니다.
iPhone은 입 가까이 가져오고 MacBook은 50–80 cm 떨어진 책상 위에 그대로 둘 수 있습니다.
5–10 cm와 50–80 cm의 거리만으로 계산한 추정치입니다. 공간, 방향, 마이크에 따라 실제 결과는 달라집니다.
인식은 Mac에서 실행됩니다. 모델 준비 후 로컬 사용에는 공용 인터넷이 필요 없습니다.
오디오는 메모리에서 처리한 뒤 해제하며 iPhone이나 Mac에 녹음으로 남기지 않습니다.
다른 앱을 열거나 복사해 돌아올 필요 없이 현재 입력란에 바로 들어갑니다.
Mac 기록은 완전히 끌 수도 있으며 undervoice 서버와 동기화되지 않습니다.
03 / 한국어 음성 인식
한국어를 긴 지원 언어 목록의 한 항목으로 다루지 않습니다. undervoice는 한국어 프롬프트와 그 안에 자연스럽게 들어가는 영어 라이브러리명, API, 변수, 명령을 중심으로 인식을 구성합니다.
Whisper Large v3 Turbo를 한국어 사용에 맞춘 로컬 팩으로 구성합니다. 런타임과 양자화도 Mac에서 실용적인 속도로 받아쓰기 위해 선택했습니다.
라이브러리명, API, 변수, 명령, 약어를 한국어 문장에 자연스럽게 섞어 말할 수 있습니다. 문장 중간에 언어 모드를 바꿀 필요가 없습니다.
한국어용 팩, 로컬 런타임, 양자화, 제품 설정을 한국어 개발 프롬프트를 위한 하나의 인식 경로로 구성합니다. 하나의 범용 모델이 모든 언어에서 똑같이 작동한다는 뜻이 아닙니다.
04 / IPHONE과 MACBOOK 마이크
둘 다 Mac의 같은 로컬 모델을 사용할 수 있습니다. 차이는 음성이 입에서 몇 cm 떨어진 곳에서 시작하는지, 책상 건너편에서 시작하는지입니다.
| 공유 오피스 | 입 가까이 든 iPhone | MacBook 내장 마이크 |
|---|---|---|
| 입과 마이크 거리 | 5–10 cm | 50–80 cm |
| 작게 말할 때 | 내 목소리가 먼저 강하게 들어감 | 목소리, 키보드, 냉난방, 주변 대화가 함께 들어감 |
| 필요한 목소리 크기 | 작은 목소리 유지 | 책상 거리에서는 더 크게 말하기 쉬움 |
| 인식 위치 | 내 Mac에서 로컬 처리 | 내 Mac에서 로컬 처리 |
| 잘 맞는 환경 | 개방형 사무실, 공유 좌석 | 개인실, 내용이 들려도 괜찮은 상황 |
14–24 dB은 자유 음장 공식 20 × log10(r₂/r₁)로 5–10 cm와 50–80 cm를 비교한 추정치입니다. 반사음, 배치, 말하는 방향에 따라 실제 값은 달라집니다.
05 / 보안과 네트워크
undervoice에는 음성 중계 서버가 없습니다. 같은 네트워크에서는 iPhone이 Mac에 직접 연결되고, 다른 네트워크에서는 사용자의 Tailscale을 쓸 수 있습니다. 어느 경로에서도 앱 수준 기기 인증과 암호화는 유지됩니다.
설치 및 권한 안내 →같은 Wi-Fi에 있다는 것만으로는 부족합니다. 새 iPhone은 명시적으로 페어링해야 합니다.
오디오, 텍스트, 제어 메시지를 인증하고 종단간 암호화합니다.
다시 연결할 때마다 새로운 세션 키를 만듭니다.
녹음은 메모리에만 존재하며 진단 정보에도 오디오와 받아쓰기 본문이 없습니다.
로컬 네트워크에서는 오디오가 iPhone에서 Mac으로 바로 가고 모델도 Mac에서 실행됩니다.
다른 Wi-Fi나 셀룰러에서는 내 Tailscale을 사용할 수 있고 undervoice 암호화도 그대로 유지됩니다.
06 / 어디서나 입력
“공개 API는 유지하고 재시도는 지수 백오프로 바꾼 다음 경계 조건 테스트를 세 개 추가해 줘.”
듣는 중받아쓰기를 시작할 때 활성 앱과 선택 영역을 Mac이 기억합니다. 도중에 포커스가 바뀌면 입력을 멈춥니다. 암호 입력란과 Secure Keyboard Entry 컨트롤에는 절대 쓰지 않습니다.
사무실이 아니라 MAC에게 말하세요
Mac에 모델을 설치하고 iPhone으로 페어링 코드를 스캔하세요. 이제 누른 채 말하면 됩니다.