Claude Code语音听写:/voice、Mac听写,还是本地App
简短回答
Claude Code内置了语音模式,叫作语音听写:输入/voice,然后在说话时按住空格键,转写文本就会插入到光标处。它需要登录Claude.ai并有本地麦克风,Anthropic的文档说明音频会以流式传输到它的服务器,不在本地处理。Mac自带的听写也能在终端中使用。Flit是一款Mac本地听写App,是第三种方式:按住一个键说话,你的原话就会进入提示词,项目中的文件名拼写准确,而且没有音频离开Mac。
如何用/voice向Claude Code听写
- 在终端中启动Claude Code,并用Claude.ai账户登录。
- 输入
/voice并按Enter键,打开听写。 - 按住空格键说话。按住期间一直在录音。
- 松开空格键。转写文本会插入到光标处。
- 读一遍,修正有问题的地方,然后按Enter键发送。
- 如果想轻点而不是按住,输入
/voice tap:在空白提示词中轻点一次空格键开始,再轻点一次发送。
在按住模式下,录音开始前有一小段预热,因为Claude Code是通过按键重复来判断按键被按住的。单独轻点一下空格键仍然会输入一个空格。
给编程智能体的提示词正是语音擅长的那类文字:一段表达意图的话,而不是一行语法。把它输入Claude Code有三种方式,区别主要在于需要什么,以及音频在哪里转成文字。
向Claude Code听写的三种方式
| 方法 | 如何开始 | 音频在哪里转写 |
|---|---|---|
Claude Code的/voice | 按住空格键,或用/voice tap轻点 | 在Anthropic的服务器上 |
| Mac听写 | “键盘”设置中的听写快捷键 | 在Mac上或在Apple的服务器上;“键盘”设置中会说明是哪一种 |
| Flit | 按住Fn或你自己的快捷键 | 在Mac上 |
/voice需要什么
Anthropic的语音听写页面列出了这些条件。
- 一个Claude.ai账户。页面说明,如果Claude Code直接用Anthropic API密钥设置,或通过Amazon Bedrock、Google Cloud或Microsoft Foundry设置,语音转文字服务不可用。
- 一个本地麦克风。它在云端会话中或通过SSH时不能使用。
- 联网,因为音频会以流式传输到Anthropic的服务器进行转写。
- 20种语言之一,用
/config设置。如果没有设置,听写默认使用英语。 - 组织允许使用。管理员可以通过策略关闭语音功能。
按住模式和轻点模式
按住模式是默认模式:空格键按下时录音,松开时停止。转写文本会留在提示词中等你发送,除非你打开了自动提交。
轻点模式适合较长的说明。第一次轻点开始录音,而且只在提示词为空时有效;第二次轻点则发送。文档说明,静音15秒或总时长达到两分钟后,录音也会自动停止。
这个按键可以更改。它是~/.claude/keybindings.json中的voice:pushToTalk绑定。
换行和长文本
按Enter键会发送消息。要换行而不发送,Anthropic的终端页面给出了两种在所有终端中都可用的方法:按Ctrl-J,或输入一个反斜线再按Enter键。Shift-Enter在部分终端中无需设置即可使用,在其他终端中则需要先运行一次/terminal-setup。
粘贴的长文本会以不同方式显示。当粘贴的内容超过800个字符或超过三行时,Claude Code会把它折叠成一个占位符,例如[Pasted text #1 +120 lines],但仍会发送完整内容。这对任何通过粘贴插入文字的听写工具都有影响,Flit也一样:长段听写会完整送达,但你看到的是占位符,而不是文字。
使用Mac的听写
只要能打字的地方,Apple听写都能输入,终端也一样。点按进入Claude Code的提示词,然后按你的听写快捷键。它不需要你的Claude账户,而且在部分语言和Mac上会在设备端运行。
用它写提示词有两个缺点。30秒没有说话它就会停止,而且它不知道你的文件叫什么。如何在Mac上听写介绍了设置方法。
说什么
用Flit向Claude Code听写
Flit在Mac层面工作,而不是在Claude Code内部,所以它不需要账户、不需要/voice,也不需要联网。按住一个键,说话,松开,文字就在提示词里了。
- 你的原话。在终端中,Flit不会改写你说的话,所以命令还是命令。
- 项目中的文件名。Flit在Mac上读取终端工作目录中的文件名,所以“upload client dot swift”会输入为
UploadClient.swift。 - 用于参数和路径的口述符号,例如“dash dash”和“tilde slash”。
- 没有音频离开Mac,而且无论你用哪种方式登录Claude Code都能使用,包括API密钥。
- 在Claude桌面App和编辑器的聊天面板中使用同一个键,在那里Flit会把你说的话整理成提示词。
- Flit可免费试用7天,所有功能全部开放,之后$19买断,无需账户,无需订阅。
值得了解
- 在终端中你得到的是原话:Flit不会像在聊天框中那样,把东拉西扯的说明整理成一段干净的文字。
- Flit通过粘贴插入文字,所以Claude Code会把长段听写显示为粘贴文本占位符。
- Flit在搭载Apple芯片、运行macOS 14或更高版本的Mac上运行,它的语音模型需要下载,大小约0.5到2.8 GB,只需选择一次。
- Flit输入你说的话。它不会回话,不会朗读回答,也不会和工具进行语音对话。
- 识别项目中的文件名以及Flit的语音命令,目前只支持英语。
常见问题
Claude Code有语音模式吗?
有。输入/voice打开语音听写,然后在说话时按住空格键。它需要Claude.ai账户和本地麦克风。
Claude Code的语音听写是在本地处理的吗?
不是。Anthropic的文档说明,语音听写会把录下的音频以流式传输到Anthropic的服务器进行转写,音频不在本地处理。
为什么/voice在Claude Code中不起作用?
文档列出的原因有:用API密钥或云服务商登录,而不是用Claude.ai账户;通过SSH或在云端会话中工作;没有麦克风;或者组织策略关闭了语音功能。
Claude Code的语音听写会占用我的用量吗?
不会。Anthropic表示,转写不会消耗Claude消息或token,也不会计入/usage中显示的限额。
如何在Claude Code中换行而不发送?
按Ctrl-J,或输入一个反斜线再按Enter键。两种方法在所有终端中都可用。Shift-Enter在部分终端中无需设置即可使用。
有没有能离线使用的Claude Code听写App?
有。Flit是一款Mac本地听写App:按住一个键说话,你的话就会进入Claude Code的提示词,项目中的文件名拼写准确。不会向任何地方发送任何内容。Flit可免费试用7天,所有功能全部开放,之后$19买断,无需账户,无需订阅。