Mac Claude Code 음성 입력: 설정, 제한과 문제 해결

음성 대화와 받아쓰기는 다릅니다

받아쓰기는 말을 텍스트 프롬프트로 바꿉니다. 양방향 음성 대화는 답변도 소리로 들려줍니다. Anthropic의 설명은 둘을 구분합니다. 이 글은 Claude Code CLI의 /voice를 다루며 모든 Claude 앱의 마이크 기능을 동일하게 보지 않습니다.

전송 전에 확인하는 Mac 설정

1. 로컬 터미널에서 Claude Code를 열고 Claude.ai 계정으로 인증한 뒤 /voice hold를 실행합니다.
2. 해당 터미널에 마이크 권한을 주고 /config에서 말할 언어를 설정합니다.
3. 입력란에서 Space를 누른 채 듣기 표시를 확인하고, 민감한 정보가 없는 짧은 요청을 말한 뒤 놓습니다.
4. 내용을 확인한 뒤 Enter로 전송합니다. 기존 설정을 지우지 말고 ~/.claude/settings.json에 다음 항목을 병합하면 자동 전송을 명시적으로 끌 수 있습니다.

{
  "voice": {
    "enabled": true,
    "mode": "hold",
    "autoSubmit": false
  }
}

공식 음성 입력 문서에 따르면 hold는 기본적으로 초안을 남깁니다. tap은 세 단어 이상인 전사를 자동 전송할 수 있고, 15초 무음 또는 총 2분 뒤 녹음이 멈춥니다. 전사는 /usage에 포함되지 않지만 프롬프트를 보낸 뒤의 에이전트 작업은 별개입니다. 직접 API 키나 타사 제공자 설정은 이 음성 서비스의 지원 대상이 아닙니다.

작동하지 않을 때 먼저 볼 것

증상	확인 사항
/voice를 모르거나 로그인을 요구함	실제 인증 방식과 조직 정책. 업무에 필요한 설정을 함부로 지우지 않기
Space를 길게 눌러도 공백만 늘어남	hold 활성화와 터미널의 키 반복 이벤트
tap이 시작되지 않음	시작할 때 입력란이 비어 있는지 확인. 자동 전송도 주의
권한 거부 또는 무음	터미널의 마이크 권한과 macOS 사운드 → 입력을 각각 확인
SSH 또는 VS Code Remote	기본 녹음은 로컬 마이크가 필요. 로컬에서 만든 텍스트를 붙여넣는 방법 검토

2026년 10월 21일 확인한 공식 언어 목록에는 한국어·일본어·프랑스어·독일어·스페인어가 있습니다. 중국어는 기재되어 있지 않습니다. 중국어 답변 능력이 중국어 전사를 보장하지는 않습니다. 한국어가 목적이라면 우선 기본 기능이 요구에 맞는지 시험하세요.

ListenIn을 검토할 상황

기본 텍스트 입력에는 Apple 받아쓰기도 선택지입니다. 여러 앱에서 하나의 키를 쓰거나, 구술한 요청을 정리하거나, 중국어와 영어를 섞어 말해야 한다면 독립 도구인 ListenIn을 검토할 수 있습니다. 공개판은 2026년 10월 17일 출시한 v0.3.8(빌드 45)이며 macOS 14 이상이 필요합니다. 동일 음성으로 속도·정확도를 비교하지 않았으며 전문 용어의 완벽한 인식을 보장하지 않습니다.

설명용 사례로 Mac의 SSH 클라이언트에서 Claude Code 입력란에 “실패한 테스트의 원인을 설명하고 파일은 바꾸지 마”라고 입력한 뒤 제약이 남았는지 확인할 수 있습니다. 마이크 전달이 아니라 로컬 텍스트 입력입니다. 복사 카드가 나오면 올바른 입력란에 수동으로 붙여넣으세요. 붙여넣기 미리보기가 접혔다는 이유만으로 누락을 판단하지 말고 초안을 확인하세요.

음성과 정리 텍스트의 데이터 경계

ListenIn의 음성 인식은 Mac에서 실행됩니다. 기본 문장 정리는 텍스트를 서비스와 모델 제공자에 보냅니다. 로컬 Ollama 모델과 오프라인 모드라면 기기 안에서 정리할 수 있지만 모델 다운로드, Ollama 클라우드 기능 해제와 서비스 실행이 필요합니다. Claude Code에 보낸 내용에는 해당 도구의 데이터 정책이 적용됩니다. 영문 데이터 처리 설명을 확인하세요. 글의 번역이 앱 UI나 모든 음성 모델의 한국어 지원을 뜻하지는 않습니다.

Mac 버전 다운로드 후 실제 입력란에서 비민감 요청 하나를 시험하고 단어·제약·목적지를 확인해 판단할 수 있습니다.