Голосовой ввод

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 перейдите в System Settings → Privacy & Security → Microphone и включите приложение вашего терминала, затем запустите /voice снова. На Windows перейдите в Settings → Privacy & security → Microphone и включите доступ к микрофону для приложений рабочего стола, затем запустите /voice снова. Если ваш терминал не указан в параметрах macOS Microphone, см. Терминал не указан в параметрах macOS Microphone.
• No audio recording tool found на Linux: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому 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 для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью /voice tap, чтобы избежать требования повтора клавиш.
• Нажатие Space печатает пробел вместо записи в режиме нажатия: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив /voice tap.
• No audio detected from microphone: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.
• No speech detected: аудио достигло сервиса транскрибирования, но слова не были распознаны. Говорите ближе к микрофону, уменьшите фоновый шум и подтвердите, что ваш язык диктовки соответствует языку, на котором вы говорите.
• Транскрибирование искажено или на неправильном языке: диктовка по умолчанию использует английский язык. Если вы диктуете на другом языке, установите его в /config сначала. См. Изменение языка диктовки.

​

Терминал не указан в параметрах macOS Microphone

​

См. также

• Настройка сочетаний клавиш: переназначьте voice:pushToTalk и другие действия клавиатуры CLI
• Настройка параметров: полный справочник для ключей voice, language и других параметров
• Интерактивный режим: сочетания клавиш, режимы ввода и управление сеансом
• Команды: справочник для /voice, /config и всех других команд