Claude Code 中文语音输入:支持与设置
Claude Code /voice 没有中文选项?核对官方语言支持,设置 Mac 中英混说输入,并按原稿、清稿、插入三个阶段排查术语错误与丢字。
2026 年 10 月 17 日依据 Ducduc 0.3.7 开发源码(构建 42)核对。10 月 15 日发布的公开 v0.3.7 为构建 35,之后的改动可能尚未包含在下载版中;以已安装 App 的控件为准。 查看公开版本
先看结论
截至 2026 年 10 月 17 日,Claude Code 官方 /voice 语言列表没有中文。Mac 上可用 Ducduc 这样的独立听写路径输入中英混说指令,检查文字后再发送。把 Claude 的回复语言设为中文,不等于语音识别也支持中文。
Claude Code /voice 支持中文吗?
截至 2026 年 10 月 17 日,Anthropic 语音文档列出的 20 种听写语言没有中文。不受支持的 language 设置会让听写回退到英语,不影响文字回复。同一页另一处提到中文词数统计,并不等于声明中文转写已受支持。
也要区分 Claude Code CLI 听写与 Claude 聊天 App 的显示、语音设置;Anthropic 对后者的语言选项有单独说明。Claude 能用中文回答,不能证明 /voice 已配置为识别中文。
这里核对的是文档支持范围,不是断言每句中文都会失败。我们没有用同一音频集比较原生 /voice 和 Ducduc。如果你安装的 Claude Code 能转写中文,仍应测试自己的项目术语、查看当前官方列表,不要只依赖旧教程。
在 Mac 上输入中英混说指令
Ducduc 是独立的 Mac 听写 App:在 Mac 录音和识别中英混说,再把文字插入本地 Claude Code 输入框。需要 macOS 14 或更新版本、相关权限和语音资源,不需要 Claude Code 插件。
- 下载 Ducduc,完成麦克风、语音识别和辅助功能设置。这些权限授予 Ducduc;原生
/voice的麦克风权限则属于终端。 - 在 设置 → 听写 中,把 识别语言 设为 中文(含中英混说)。提示资源缺失时,按语言模型指南处理。
- 在同一页确认实际的 听写键。macOS 占用 fn 时,新安装可能使用右 Command。fn 打开表情或切输入法时,先看快捷键指南。
- 想把口述整理成指令时,开启 在 AI 编码工具里写成 prompt。使用普通听写即可;独立的「AI 指令」模式另有自动发送选项。
- 为这次检查先执行
/voice off关闭 Claude Code 原生听写。聚焦 Claude Code 输入框,开始 Ducduc 听写,说完结束,保持焦点直到插入完成,然后检查并自行发送。
测试时只用一个录音入口,才能确认文字来自哪个 App。之后可以再选择适合自己的输入方式。
用一条实际任务结构检查含义和标识符
下面是模拟测试句,可以把术语换成自己项目里的词。它不是保存下来的产品输出,也不是识别测评:
先检查 login callback 为什么触发两次,我怀疑是 retry,但还不确定。先给我原因和修改方案,不要直接改数据库 schema。
发送前分别检查四件事:
| 检查项 | 为什么要检查 |
|---|---|
login callback、retry、schema 是否保留 | Agent 需要知道你指的是哪些技术概念 |
| “怀疑”是否仍是不确定的 | 猜测不能被整理成确定原因 |
| 是否先检查并给出方案 | 你要求先诊断时,不能直接跳到实现 |
| 是否保留“不改数据库 schema” | 最后补充的限制仍约束整个任务 |
Ducduc 的指令清稿旨在整理请求、去掉重复,并保留这些关系。简单要求可以保持段落,内容确实需要才分条。判断标准是意思有没有保留,而不是多了多少项目符号。
精确大小写、符号和长路径更适合手动输入。真实符号如果叫 LoginCallbackV2,可以先说周围的解释,再把符号输入或粘贴进去。个人词典能提供反复使用的词汇提示,但不能保证每个标识符都逐字准确。
按失败阶段排查
| 看到的现象 | 下一步 |
|---|---|
| 没有聆听指示 | 核对 Ducduc 的实际触发键和辅助功能权限,先处理 fn 冲突 |
| 指示随声音变化,但没有转写 | 检查麦克风输入和识别语言资源 |
| 最终 prompt 的英文术语错了 | 打开 听写历史 → 显示原始转写,对照原稿与成稿 |
| 转写正确,但文字没进入 Claude Code | 读复制卡片提示,检查焦点与安全键盘输入,再复制并手动粘贴 |
原稿已经错时,先看中英混说识别与个人词汇。只有成稿错时,换麦克风不会修复文字转换:检查清稿设置,并保留一组简短、不敏感的原稿与成稿用于反馈。
这条替代路径的本地边界
Ducduc 的识别音频留在 Mac。默认内置清稿会把识别文字发送到 Ducduc 服务,远程 BYOK 服务商也会收到文字。需要本地清稿时,下载本地 Ollama 模型、关闭 Ollama 云功能,再配置 Ducduc 离线模式;仅有 localhost 地址不能证明推理在本机。前提见本地设置指南与数据流向说明。
使用 SSH 时,Ducduc 把文字交给本地终端客户端,并不向远端转发麦克风。能否粘贴取决于客户端焦点和设置。发送 prompt 后,Claude Code 按自己的配置和政策处理它。
原生 /voice 的语言和环境已够用时,可以先用原生入口。需要在 Mac 多个 App 输入中英混说时,可试用 Ducduc,先检查上面的短句,再口述完整任务。原生录音、发送、额度与 SSH 限制见Claude Code 语音限制指南。
在自己的 Mac 上试一下
用自己的常用词和输入框试一段,确认是否适合你的工作流。
由 Ducduc 产品方发布;第三方信息以文中标注的来源与日期为准。 作者、来源与示例说明