Mac에는 이미 Claude Code용 음성 입력이 있습니다

Mac에는 이미 Claude Code에 쓸 수 있는 음성 입력 경로가 있습니다. 핵심은 새 플러그인이 아니라, 평범한 macOS 받아쓰기를 터미널 프롬프트에 맞춰 쓰는 것입니다.

Mac에서 Claude Code 프롬프트를 받아쓸 수 있나요?

네. macOS 받아쓰기는 입력이 지원되는 곳이면 어디든 말한 텍스트를 넣을 수 있으므로, 별도 받아쓰기 앱 없이 Claude Code 터미널 프롬프트를 채울 수 있습니다. Apple은 받아쓰기를 시스템 전반의 텍스트 입력 기능으로 설명하고, Claude Code는 대화형 claude, 일회성 프롬프트, print mode 같은 터미널 화면을 통해 프롬프트 입력을 제공합니다 .

빠른 답변: Mac 사용자는 내장 macOS 받아쓰기로 Claude Code 프롬프트를 말해서 입력할 수 있습니다. 터미널 프롬프트에 포커스를 두고, 받아쓰기를 시작한 뒤, 작업을 말하고, 입력된 텍스트를 검토한 다음 제출하면 됩니다. Apple에 따르면 받아쓰기는 말이 없는 상태가 30초 이어지면 중지됩니다 .

흐름은 단순합니다. Claude Code 프롬프트를 클릭하거나 탭으로 이동하고, macOS 받아쓰기를 시작한 뒤, 작업 요약을 말하고, 변환된 텍스트를 확인하고, 파일 경로나 플래그를 고친 다음, 프롬프트가 의도한 내용이 되었을 때 Return을 누르면 됩니다. 이 방법은 한 개발자 영상에서 처음 알려졌는데, 이 영상은 Mac 사용자가 받아쓰기를 켜고 Claude Code에 프롬프트를 타이핑하는 대신 말로 입력할 수 있다고 설명했습니다 .

이 점이 중요한 이유는 유용한 Claude Code 프롬프트가 셸 명령보다 말로 설명하는 엔지니어링 브리프에 더 가까운 경우가 많기 때문입니다. Anthropic은 Claude Code를 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, git으로 작업하며, 개발 워크플로를 자동화할 수 있는 에이전트형 코딩 도구라고 설명합니다 . 실제로는 프롬프트에 의도, 제약 조건, 영향을 받는 모듈, 테스트 기대사항, 수용 기준이 함께 들어가는 경우가 많다는 뜻입니다.

소스 영상의 제작자는 “내 프롬프트 중 상당수는 Claude Code에 직접 손으로 입력하지 않는다”고 말하며, Mac 사용자에게 별도 앱보다 내장 받아쓰기를 권합니다 (source: YouTube).

긴 프롬프트에 음성 입력을 쓰기 전에 시간 동작은 알아두는 것이 좋습니다. Apple에 따르면 macOS 받아쓰기는 말이 없는 상태가 30초 이어지면 자동으로 중지되고, Anthropic에 따르면 Claude Code의 탭하여 녹음하는 음성 모드는 15초간 침묵하거나 총 2분이 지나면 중지됩니다 . 따라서 특히 프롬프트에 식별자, 패키지 이름, 경로, 파괴적 작업이 포함될 때는 검토가 필수입니다.

프롬프트를 말하기 전에 무엇이 필요할까요?

운영체제 수준에서 macOS 받아쓰기를 켜 두었거나, 지원되는 로컬 환경에서 Claude Code의 내장 /voice 모드를 사용할 수 있어야 합니다. macOS 경로는 시스템 설정 > 키보드 > 받아쓰기에서 시작하고, Claude Code 경로는 /voice에는 버전 2.1.69 이상, 탭하여 녹음에는 버전 2.1.116 이상이 필요합니다 .

Mac 내장 기능을 쓰는 방식이라면 키보드 설정에서 받아쓰기를 켠 다음, Claude Code 터미널 프롬프트에 커서를 두고 마이크 키, 설정한 받아쓰기 단축키, 또는 편집 > 받아쓰기 시작으로 받아쓰기를 시작하면 됩니다. 이는 Apple의 macOS 받아쓰기 가이드에 따른 방법입니다. 표준 텍스트 입력이므로 Claude 전용 통합 기능을 설치할 필요는 없습니다.

잘못된 대상을 디버깅하기 전에 환경 차이를 이해하는 것이 중요합니다. Anthropic에 따르면 /voice는 로컬 마이크가 필요하며, 오디오 캡처가 로컬 컴퓨터에서 이루어지기 때문에 SSH나 원격 환경에서는 작동하지 않습니다 . macOS 받아쓰기는 다릅니다. 로컬 텍스트 필드를 대상으로 하므로, 원격 셸에 연결된 로컬 터미널 창에 입력할 때도 도움이 될 수 있습니다.

macOS 받아쓰기로 프롬프트를 입력하는 방법

Claude Code 프롬프트 입력에 macOS 받아쓰기를 쓰는 방법은 터미널을 다른 Mac 텍스트 입력란처럼 다루면 됩니다. 평소 사용하는 Claude Code 화면을 열고, 프롬프트에 포커스를 둔 뒤, 요청을 받아쓰고, 변환된 텍스트를 수정한 다음 제출하면 됩니다. Anthropic의 CLI 사용 문서에 따르면 Claude Code는 대화형 claude, 초기 프롬프트 claude "query", 출력 모드 claude -p "query" 워크플로를 지원하며 , Apple은 받아쓰기가 입력할 수 있는 모든 곳에 텍스트를 넣을 수 있다고 설명합니다 .

1. 평소 사용하는 Claude Code 터미널 화면을 엽니다. 일반적인 주고받기 세션이라면 대화형 claude를 시작합니다. 한 번에 끝나는 작업이라면 초기 프롬프트로 시작할 수 있습니다. 스크립팅이나 자동화에는 Anthropic이 claude -p "query"를 쓰는 출력 모드를 문서화해 두었습니다 . 받아쓰기는 Return을 누르기 전에 변환된 텍스트를 검토할 수 있는 대화형 프롬프트에서 가장 편합니다.
2. Claude Code가 입력을 받는 위치에 커서를 둔 다음 받아쓰기를 시작합니다. Apple은 시작 방법을 몇 가지로 안내합니다. 마이크 키, 설정해 둔 받아쓰기 단축키, 또는 해당 메뉴 항목을 제공하는 앱의 편집 > 받아쓰기 시작을 사용할 수 있습니다 . 터미널에서는 단순합니다. 프롬프트 줄을 클릭하거나 포커스한 뒤 받아쓰기를 실행하고, 요청을 말한 다음, 제출하기 전에 받아쓰기를 멈추면 됩니다.
3. 단어만 말하지 말고 구조까지 말합니다. Apple의 받아쓰기 도움말은 말로 입력하는 문장부호와 읽기 쉬운 텍스트 입력을 위한 “new line”, “new paragraph” 같은 명령을 안내합니다 . Claude Code에서는 유용한 코딩 프롬프트에 의도, 제약, 파일명, 수락 기준이 들어가는 경우가 많기 때문에 이 점이 중요합니다. 자동 문장부호는 지원되는 언어와 지역에서 쉼표, 마침표, 물음표를 추가할 수 있지만, Apple의 기능 지원 현황 표를 보면 언어와 지역에 따라 지원 여부가 다릅니다 .
4. 제출하기 전에 변환된 텍스트를 고칩니다. 파일 경로, 플래그, 패키지 이름, 기호, 브랜치 이름, 고유명사는 직접 확인하세요. Apple은 지원되는 Apple silicon Mac에서 모드리스 받아쓰기를 사용할 수 있으며, 이 경우 같은 흐름 안에서 타이핑과 받아쓰기를 함께 할 수 있다고 설명합니다 . 실무적으로는 이 습관이 유용합니다. 설명 문장은 말로 입력하고, 깨지기 쉬운 토큰은 직접 타이핑한 다음, 변환된 텍스트가 의도와 맞을 때만 프롬프트를 보내세요.

받아쓰기와 /voice는 어디서 달라지나요?

macOS 받아쓰기와 Claude Code /voice는 제품 경계에서 갈라집니다. 받아쓰기는 운영체제의 텍스트 입력 기능이고, /voice는 Claude Code의 프롬프트 기능입니다. Apple은 받아쓰기를 입력할 수 있는 모든 곳에 음성 텍스트를 넣는 방법으로 설명하며 , Anthropic은 /voice를 Claude Code 안에서 실시간으로 전사하고 그 결과를 CLI 프롬프트 입력에 삽입하는 기능으로 문서화합니다 . 개발자 입장에서는 구분이 간단합니다. Terminal, iTerm2, Ghostty, VS Code, 그 밖의 텍스트 입력란 전반에서 같은 음성-텍스트 동작을 원하면 macOS 받아쓰기를 쓰고, Claude Code에 통합된 녹음 제어가 필요할 때는 /voice를 쓰면 됩니다.

개인정보 처리 방식도 다릅니다. Apple은 Mac 사용자가 키보드 설정에서 받아쓰기 요청이 기기 내에서 처리되는지 Siri 서버로 전송되는지 확인할 수 있다고 설명합니다 . Apple의 Siri 및 받아쓰기 개인정보 고지는 요청이 기기 내에서 처리되지 않을 경우 받아쓴 내용이 Apple로 전송될 수 있으며, 전사문과 관련 요청 데이터가 최대 2년 동안 임의 식별자와 연결될 수 있다고 설명합니다 . Anthropic의 Claude Code 문서는 /voice에 대해 더 직접적으로 설명합니다. 녹음된 오디오는 전사를 위해 Anthropic 서버로 스트리밍되며 로컬에서 처리되지 않습니다 .

"녹음은 전사를 위해 Anthropic 서버로 스트리밍되며 로컬에서 처리되지 않습니다," — Anthropic, Claude Code 문서 Claude Code Voice Dictation

제어 방식에서는 /voice가 범위는 더 좁지만 더 풍부한 인터페이스를 제공합니다. Anthropic은 Claude Code 음성이 길게 눌러 녹음하는 모드와 탭해서 녹음하는 모드를 지원하고, voice:pushToTalk 키 바인딩의 기본값은 Space이며, 이 바인딩은 ~/.claude/keybindings.json에서 변경할 수 있고, 최종 전사문이 최소 세 단어를 포함하면 선택적으로 자동 제출할 수 있다고 설명합니다 . 같은 페이지는 Claude Code 음성 기능에 버전 2.1.69 이상이 필요하고, 탭 모드에는 버전 2.1.116 이상이 필요하다고 설명합니다 .

완성도 신호는 기능을 피하라는 경고가 아니라 운영 맥락으로 읽는 편이 좋습니다. Anthropic의 2026년 3월 변경 기록에는 음성 관련 수정이 여러 개 올라와 있습니다. 버전 2.1.71은 다시 바인딩할 수 있는 voice:pushToTalk 키 바인딩을 추가하고 잠자기 해제 후 CoreAudio 시작이 멈추는 문제를 수정했으며, 버전 2.1.74는 macOS audio-input 권한을 추가했고, 버전 2.1.75는 새 설치 후 활성화 문제를 수정했으며, 버전 2.1.79는 Windows npm 오디오 캡처를 수정했고, 버전 2.1.81은 재시도와 WebSocket 복구 동작을 개선했습니다 . 실무에서는 Claude Code 음성을 사용할 수 없거나, 정책상 제한되거나, CLI에 너무 좁게 묶여 있을 때 macOS 받아쓰기가 믿을 만한 대안입니다.

첫 받아쓰기 프롬프트 다음에는 무엇을 해보면 좋을까요?

첫 Claude Code 받아쓰기 프롬프트를 넣은 뒤에는 흐름을 단순하게 유지하세요. 터미널에 말한 텍스트만 입력하면 될 때는 표준 macOS 받아쓰기를 쓰고, Mac 탐색, 클릭, 받아쓰기, 편집까지 더 넓은 범위의 핸즈프리 제어가 필요할 때만 손쉬운 사용 음성 명령으로 전환하면 됩니다 . 이 구분이 중요한 이유는 프롬프트 입력과 Mac 전체 제어가 서로 다른 작업이기 때문입니다.

다음 단계에서 가장 안정적인 방식은 하이브리드 입력입니다. 무엇이 바뀌었는지, Claude Code가 무엇을 살펴보길 원하는지, 어떤 제약이 중요한지, 어떤 기준이면 완료로 볼지 같은 작업 설명은 받아쓰기로 입력하세요. 그런 다음 정확한 파일 경로, CLI 플래그, 패키지 이름, 브랜치 이름, 심볼은 직접 타이핑하세요. Apple은 받아쓰기를 시스템 전반의 텍스트 입력 기능으로 설명하지만, 코드와 가까운 토큰은 여전히 녹취 결과를 정리하는 시간이 직접 입력보다 더 들 수 있는 지점입니다 .

Claude Desktop Quick Entry는 별도의 용도로 생각해 두는 편이 좋습니다. Anthropic에 따르면 macOS의 Quick Entry는 생각을 데스크톱 앱에 빠르게 기록할 수 있고, 빠른 입력에는 macOS 12 이상, 음성 받아쓰기에는 macOS 14 이상이 필요하며, Option 두 번 탭으로 Quick Entry를 열고 선택적으로 Caps Lock 음성 입력을 사용할 수 있습니다 . 유용하긴 하지만, 실행 중인 Claude Code 터미널 프롬프트에 직접 말하는 것과는 다릅니다.

Claude Code /voice가 불안정하게 느껴진다면 마이크부터 디버깅하기 전에 버전 변경 이력을 확인하세요. Anthropic의 2026년 3월 변경 로그에는 v2.1.71의 잠자기 해제 후 5-8초 CoreAudio 시작 멈춤 수정, v2.1.74의 macOS 오디오 입력 권한 동작, v2.1.75의 새 설치 활성화, v2.1.79의 Windows npm 오디오 캡처, v2.1.81의 재시도 및 WebSocket 복구 관련 수정이 포함되어 있습니다 . 실무적으로는 산문은 말로 입력하고, 정확해야 하는 부분은 타이핑한 뒤, Enter를 누르기 전에 검토하는 방식이 좋습니다.

자주 묻는 질문

Mac에서 Claude Code 프롬프트를 받아쓰려면 서드파티 앱이 필요한가요?

아니요. macOS 받아쓰기는 운영체제에 기본 포함되어 있으며, 터미널 앱의 입력 동작에 따라 Claude Code가 실행 중인 로컬 터미널 프롬프트를 포함해 텍스트 입력이 지원되는 곳이라면 말한 내용을 입력할 수 있습니다. Apple은 받아쓰기를 Mac 설정의 시스템 전반 텍스트 입력 기능으로 설명하고, Anthropic은 Claude Code를 대화형 CLI 사용 같은 프롬프트 입력 표면을 가진 터미널 기반 코딩 도구로 설명합니다. Apple의 Mac 받아쓰기 가이드와 Anthropic의 Claude Code CLI 사용 문서를 참고하세요.

Claude Code /voice는 macOS 받아쓰기와 같은 기능인가요?

아니요. macOS 받아쓰기는 운영체제의 텍스트 입력 기능이고, Claude Code /voice는 Claude Code CLI 안에 내장된 Anthropic의 전사 모드입니다. Anthropic은 /voice에 Claude Code v2.1.69 이상이 필요하다고 설명하며 , 녹음, 인증, 키 바인딩, 서버 측 전사 동작이 별도로 적용됩니다. Apple 받아쓰기는 macOS 설정에서 구성하고, Claude Code /voice는 Claude Code 안에서 구성합니다.

프롬프트 받아쓰기에서 어느 쪽이 더 비공개에 가까운가요?

설정과 위협 모델에 따라 다릅니다. Apple은 언어, 기기, 설정에 따라 받아쓰기가 기기 내에서 처리되거나 Apple 서버로 전송될 수 있다고 설명합니다. Apple의 개인정보 고지도 서버 처리가 적용될 경우 녹취문과 관련 요청 데이터가 최대 2년 동안 보관될 수 있다고 밝힙니다 . Anthropic은 Claude Code /voice가 녹음된 오디오를 전사를 위해 Anthropic 서버로 스트리밍하며 로컬에서 처리되지 않는다고 명시하므로, 엄격한 데이터 처리 규칙이 있는 팀은 활성화하기 전에 Claude Code 음성 문서를 검토해야 합니다.

코드 심볼과 파일 경로도 정확하게 받아쓸 수 있나요?

가능하지만 수동 수정이 필요하다고 보는 편이 좋습니다. 받아쓰기는 Claude Code 프롬프트의 자연어 부분, 즉 의도, 맥락, 제약, 기대 동작, 테스트 지시를 입력할 때 가장 잘 맞습니다. 정확한 심볼, 파일 경로, 플래그, 패키지 이름, 브랜치 이름, 파괴적인 명령은 작업 설명은 말로 입력하고, 정밀도가 중요한 토큰은 직접 타이핑한 뒤, Enter를 누르기 전에 전체 프롬프트를 검토하는 흐름이 더 안전합니다.

Claude Code /voice는 SSH에서도 작동하나요?

아니요. Anthropic 문서에 따르면 Claude Code /voice는 로컬 마이크 접근이 필요하므로 SSH나 원격 환경에서는 작동하지 않습니다. 원격 머신에 연결되어 있다면 macOS 받아쓰기로 로컬 터미널 입력란에 텍스트를 넣거나, 원격 Claude Code 세션으로 보내기 전에 프롬프트를 직접 입력하세요.

이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.

구독하기