Claude Code语音听写:/voice、Mac听写,还是本地App

Atta 🐬

Flit创始人

· 更新于

简短回答

Claude Code内置了语音模式,叫作语音听写:输入/voice,然后在说话时按住空格键,转写文本就会插入到光标处。它需要登录Claude.ai并有本地麦克风,Anthropic的文档说明音频会以流式传输到它的服务器,不在本地处理。Mac自带的听写也能在终端中使用。Flit是一款Mac本地听写App,是第三种方式:按住一个键说话,你的原话就会进入提示词,项目中的文件名拼写准确,而且没有音频离开Mac。

如何用/voice向Claude Code听写

  1. 在终端中启动Claude Code,并用Claude.ai账户登录。
  2. 输入/voice并按Enter键,打开听写。
  3. 按住空格键说话。按住期间一直在录音。
  4. 松开空格键。转写文本会插入到光标处。
  5. 读一遍,修正有问题的地方,然后按Enter键发送。
  6. 如果想轻点而不是按住,输入/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上听写介绍了设置方法。

说什么

像向同事交代任务那样说:哪里有问题,你想要什么,以及怎样才算成功。把文件和函数的名字说出来。如果有测试命令,也一起说。

然后在发送前读一遍转写文本。听错一个文件名,智能体要多搜索一次;听错一个“不要”,你就会得到一个错误的修改。

同样的习惯也适用于Codex和Cursor。

用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的语音命令,目前只支持英语。
下载Mac版 macOS 14或更高版本 · Apple芯片

常见问题

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买断,无需账户,无需订阅。

词汇表中的相关条目

更多指南