Claude Code 음성 받아쓰기: /voice, Mac 받아쓰기, 로컬 앱

Anthropic의 음성 받아쓰기 페이지에 조건이 나와 있습니다.

• Claude.ai 계정. 이 페이지에 따르면 Claude Code를 Anthropic API 키로 직접 설정하거나 Amazon Bedrock, Google Cloud, Microsoft Foundry를 통해 설정한 경우에는 음성 텍스트 변환 서비스를 사용할 수 없습니다.
• 로컬 마이크. 클라우드 세션이나 SSH 연결에서는 작동하지 않습니다.
• 인터넷 연결. 오디오가 전사를 위해 Anthropic 서버로 스트리밍되기 때문입니다.
• /config로 설정하는 20개 언어 중 하나. 설정하지 않으면 받아쓰기는 기본적으로 영어로 작동합니다.
• 이를 허용하는 조직. 관리자가 정책으로 음성 기능을 끌 수 있습니다.

기본값은 누르고 있기 모드입니다. Space 키를 누르고 있는 동안 녹음되고, 놓으면 멈춥니다. 자동 제출을 켜지 않으면 전사본은 프롬프트에서 사용자가 보내기를 기다립니다.

탭 모드는 더 긴 지시를 위한 것입니다. 첫 번째 탭으로 녹음이 시작되며, 빈 프롬프트에서만 시작됩니다. 두 번째 탭으로 보냅니다. 문서에 따르면 15초 동안 조용하거나 총 2분이 지나면 녹음이 자동으로 멈춥니다.

키는 변경할 수 있습니다. ~/.claude/keybindings.json의 voice:pushToTalk 바인딩입니다.

Enter 키를 누르면 메시지가 보내집니다. 보내지 않고 줄을 바꾸는 방법으로 Anthropic의 터미널 페이지는 모든 터미널에서 작동하는 두 가지를 안내합니다. Ctrl-J를 누르거나, 백슬래시를 입력한 다음 Enter 키를 누르는 것입니다. Shift-Enter는 일부 터미널에서는 설정 없이 작동하고, 다른 터미널에서는 /terminal-setup을 한 번 실행한 후에 작동합니다.

긴 텍스트를 붙여넣으면 다르게 표시됩니다. 800자가 넘거나 세 줄이 넘는 텍스트를 붙여넣으면 Claude Code는 이를 [Pasted text #1 +120 lines] 같은 자리 표시자로 접어서 보여 주지만, 전체 내용은 그대로 보냅니다. 붙여넣기로 텍스트를 입력하는 받아쓰기 도구라면 Flit을 포함해 모두 해당됩니다. 긴 받아쓰기는 온전히 들어가지만, 화면에는 단어가 아니라 자리 표시자가 보입니다.

Apple 받아쓰기는 터미널을 포함해 입력할 수 있는 곳이라면 어디서나 입력합니다. Claude Code 프롬프트를 클릭하고 받아쓰기 단축키를 누르세요. Claude 계정과는 상관없으며, 일부 언어와 Mac에서는 기기에서 실행됩니다.

프롬프트용으로는 두 가지 단점이 있습니다. 30초 동안 음성이 없으면 멈추고, 파일 이름을 알지 못합니다. 설정 방법은 Mac에서 받아쓰기하는 방법에서 다룹니다.

동료에게 업무를 설명하듯이 말하세요. 무엇이 잘못되었는지, 무엇을 원하는지, 그리고 잘 되었는지 어떻게 알 수 있는지를 말하세요. 파일과 함수 이름을 소리 내어 말하세요. 테스트 명령이 있다면 알려 주세요.

그런 다음 보내기 전에 전사본을 읽어 보세요. 파일 이름을 잘못 들으면 에이전트가 한 번 더 검색하면 되지만, “하지 마”를 잘못 들으면 엉뚱한 변경이 생깁니다.

같은 습관은 Codex와 Cursor에도 그대로 적용됩니다.