음성 받아쓰기

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

요구 사항

​

음성 받아쓰기 활성화

/voice
Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

​

누르고 있기로 녹음

> refactor the auth middleware to ▮
  # hold Space, speak "use the new token validation helper"
> refactor the auth middleware to use the new token validation helper▮

​

탭하여 녹음 및 전송

​

받아쓰기 언어 변경

{
  "language": "japanese"
}

​

받아쓰기 키 다시 바인딩

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "meta+k": "voice:pushToTalk",
        "space": null
      }
    }
  ]
}

​

문제 해결

• Voice mode requires a Claude.ai account: API 키 또는 타사 공급자로 인증되었습니다. /login을 실행하여 Claude.ai 계정으로 로그인하세요.
• Microphone access is denied: 시스템 설정에서 터미널에 마이크 권한을 부여하세요. macOS에서는 시스템 설정 → 개인정보 보호 및 보안 → 마이크로 이동하여 터미널 앱을 활성화한 다음 /voice를 다시 실행하세요. Windows에서는 설정 → 개인정보 보호 및 보안 → 마이크로 이동하여 데스크톱 앱에 대한 마이크 접근을 켜세요. 그런 다음 /voice를 다시 실행하세요. 터미널이 macOS 설정에 나열되지 않으면 macOS 마이크 설정에 나열되지 않은 터미널을 참조하세요.
• Linux에서 No audio recording tool found: 네이티브 오디오 모듈을 로드할 수 없고 폴백이 설치되지 않았습니다. 오류 메시지에 표시된 명령으로 SoX를 설치하세요. 예: sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL: WSLg는 ALSA 장치가 아닌 PulseAudio를 통해 오디오를 라우팅하므로 SoX는 PulseAudio 백엔드가 명시적으로 설치되어야 합니다. sudo apt install sox libsox-fmt-pulse를 실행하세요. sox만 설치하면 ALSA 백엔드가 함께 설치되는데, WSL에서는 /dev/snd 장치가 없기 때문에 녹음할 수 없습니다.
• Voice input is failing repeatedly and has been paused: 음성 받아쓰기가 여러 번 시작 실패를 겪었고 하나가 성공할 때까지 새 세션 시도를 중단했습니다. 이는 일반적으로 이 호스트의 마이크 또는 오디오 스택이 오디오를 캡처할 수 없음을 의미합니다. 예를 들어 헤드리스 서버, 오디오 패스스루가 없는 원격 셸 또는 거부된 마이크 권한이 있습니다. 작동하는 입력 장치를 확인하고 위의 항목에서 근본 원인을 해결한 다음 음성을 다시 트리거하세요.
• 누르고 있기 모드에서 Space를 누르고 있어도 아무것도 일어나지 않음: 누르고 있는 동안 프롬프트 입력을 봅니다. 공백이 계속 누적되면 음성 받아쓰기가 꺼져 있을 가능성이 높습니다. /voice hold를 실행하여 활성화하세요. 1~2개의 공백만 나타나고 그 다음 아무것도 없으면 음성 받아쓰기는 켜져 있지만 누르고 있기 감지가 트리거되지 않습니다. 누르고 있기 감지는 터미널이 키 반복 이벤트를 보내야 하므로 OS 수준에서 키 반복이 비활성화되면 누르고 있는 키를 감지할 수 없습니다. 키 반복 요구 사항을 피하려면 /voice tap으로 탭 모드로 전환하세요.
• 탭 모드에서 Space를 탭하면 녹음 대신 공백을 입력함: 첫 번째 탭은 프롬프트 입력이 비어 있을 때만 녹음을 시작합니다. 먼저 입력을 지우거나 /voice tap을 실행하여 탭 모드에 있는지 확인하세요.
• No audio detected from microphone: 녹음이 시작되었지만 침묵을 캡처했습니다. 올바른 입력 장치가 시스템 기본값으로 설정되어 있고 입력 수준이 음소거되거나 0에 가깝지 않은지 확인하세요. Windows에서는 설정 → 시스템 → 사운드 → 입력을 열고 마이크를 선택하세요. macOS에서는 시스템 설정 → 사운드 → 입력을 열어보세요.
• No speech detected: 오디오가 전사 서비스에 도달했지만 단어가 인식되지 않았습니다. 마이크에 더 가깝게 말하고, 배경 소음을 줄이고, 받아쓰기 언어가 말하는 언어와 일치하는지 확인하세요.
• 전사가 왜곡되었거나 잘못된 언어임: 받아쓰기는 기본적으로 영어입니다. 다른 언어로 받아쓰기하는 경우 먼저 /config에서 설정하세요. 받아쓰기 언어 변경을 참조하세요.

​

macOS 마이크 설정에 나열되지 않은 터미널

​

참고 항목

• 키보드 단축키 사용자 정의: voice:pushToTalk 및 기타 CLI 키보드 작업 다시 바인딩
• 설정 구성: voice, language 및 기타 설정 키에 대한 전체 참조
• 대화형 모드: 키보드 단축키, 입력 모드 및 세션 제어
• 명령: /voice, /config 및 기타 모든 명령에 대한 참조