attunz 帮助
在 Mac 上口述编程提示词和技术文本
你可以在各类 Mac 应用中使用 attunz，包括 Cursor、VS Code、Claude Code、Codex 和终端，口述编程提示词、文档和技术笔记。先说出你想写的内容，再检查结果后使用。
把提示词说清楚
- 将光标放在要输入文本的位置，开始使用 attunz 语音输入。
- 说清目标、相关组件或 API 名称，以及需要遵守的限制。如果要写文档，也说明读者是谁、需要解释什么。
- 检查生成的文本，修正重要细节，再提交给正在使用的工具。
试着口述编程或文档需求
假设你要口述一段编程提示词：“在 UserSettings 中，当 API 返回的项目列表为空时，增加一个空状态。保留现有的加载状态和错误状态。修改代码前，先解释计划怎样改，并建议需要补充哪些测试。”
假设你要口述一段文档需求：“说明收到 HTTP 429 响应后如何使用 retryAfterMs，写清单位，并给出一个例子。”
这些例子展示了可以口述的文本。提交前，请确认 UserSettings、retryAfterMs 和 HTTP 429 与实际任务一致。
了解 attunz 使用的上下文
听写时，attunz 可以按需自动结合应用名称、AX 窗口文字、选中文本、输入框中已有的文本和可获取的光标位置。窗口文字通过 macOS 辅助功能（AX）接口获取，不通过截图获取。可用文本和光标信息取决于目标应用和权限，帮助 AI 增强理解当前输入场景，对 ASR 结果进行润色和格式优化。
用于模型上下文的剪贴板采集默认关闭。自动窗口上下文不会扫描项目源文件；主动导入文档是你选择的独立操作，获准读取的本地 Claude/Codex 历史是另一类输入。自动上下文获取可以关闭。
检查会影响含义的细节
检查标识符、大小写、文件路径、数字、单位和标点。尤其要核对“不要修改公共 API”这类限制条件。如果在终端里口述命令文本，请先检查，再执行。
经常使用的名称和专业术语，可以参考记忆功能指南。关于本地模型设置、本地处理与云端处理的区别，可以参考离线语音输入指南。是否获取上下文和在哪里处理，是两个不同的问题。
配置 AI 增强并预览提示词
在「AI 增强」设置中启用功能并选择模型。听写后，AI 会按提示词修正识别错误、去掉口头语与重复，并结合场景整理语气和格式。短文本可按设置直接输出。
在「AI 增强 → 提示词」中写下语气、格式等要求，用测试区预览效果。可插入当前应用等上下文变量；个人表达偏好也可在记忆的「风格画像」中编辑。
「提示词」测试区使用当前选择的增强模型。使用云端模型时，运行测试会把测试文本发送到对应供应商。建议用非敏感示例并检查输出；测试预览不保证每个应用中的结果都相同。
使用本地模型或 BYOK（自备 API Key），Attunz 完整软件功能终身免费，Attunz 不收取任何费用。第三方模型费用由你向供应商支付。Attunz 托管云服务已推出，为可选云端 ASR 与 AI 增强采用手动额度充值，当前不自动续费。 价格
选择适合你的语音输入方式
实时语音对话让你与 Agent 连续交流；听写则生成可编辑的提示词文本，供你检查后再提交。原生工具可能支持其中一种或两种，应区分具体 App 与 CLI 的功能。需要在提示词输入框、编辑器和笔记之间切换时，Mac 系统范围的语音输入流程可以提供帮助。
先确认 Claude Code 原生语音的使用条件
Claude Code 原生听写针对编程术语优化，并将项目名和分支名作为识别提示。它需要 Claude.ai 身份认证，音频发送到 Anthropic 转写。该功能不支持直接 API Key 或第三方供应商认证；其文档也排除 SSH／云会话和 VS Code Remote 会话。请选择对应使用界面的最新文档核对。
Codex 已有原生听写功能。Codex App 在 2026 年 5 月 5 日加入文本清理，以及用于名称、路径和代码符号的词典；另外，2026 年 9 月 22 日的 CLI 0.156.0 版本默认启用语音对话。App 听写与 CLI 对话属于不同界面和使用流程。
Codex App 更新记录 · Codex CLI 0.156.0 发布说明
按实际工作场景选择
- 只在一个工具工作：先查看它的原生语音功能。Claude Code 和 Codex 都有原生选项，Cursor 的 Agents Window 也提供语音输入。免费、本地或 BYOK 配置并非 Attunz 独有。
- 在多个 Mac 应用间切换：选择适合在编辑器、提示词输入框和技术笔记之间使用的听写流程。能否插入文本仍取决于目标应用和权限。
- 希望使用本地处理：按离线指南配置本地语音识别、增强和记忆模型，同时确认提交文本后，哪些服务会收到内容。
使用工作账户时，请遵守组织对应用和处理服务的规定。提交提示词或执行命令前，先核对文本。
常见问题
可以在 Cursor、VS Code、Claude Code、Codex 和终端中使用 attunz 吗？
可以。attunz 支持在各类 Mac 应用中进行语音输入，包括这些工具。将光标放在要写入的位置，口述内容，并在提交前检查文本。
attunz 会读取项目文件或剪贴板吗？
用于模型上下文的剪贴板采集默认关闭。自动窗口上下文不会扫描项目源文件；主动导入文档是你选择的独立操作，获准读取的本地 Claude/Codex 历史是另一类输入。自动上下文获取可以关闭。 听写时，attunz 可以按需自动结合应用名称、AX 窗口文字、选中文本、输入框中已有的文本和可获取的光标位置。窗口文字通过 macOS 辅助功能（AX）接口获取，不通过截图获取。可用文本和光标信息取决于目标应用和权限，帮助 AI 增强理解当前输入场景，对 ASR 结果进行润色和格式优化。
可以关闭自动获取上下文吗？
可以。上下文会自动获取，你也可以关闭这项功能。本地处理和云端处理的选择，请另外参阅离线语音输入指南。
本地语音输入能让 Claude Code 等编程服务离线运行吗？
不能。选择所需的本地模型后，听写可以在 Mac 上把语音转成文本；接收文本的应用或服务仍有自己的联网要求和数据政策。提交提示词前，需要单独确认这些条件。
可编辑听写与实时语音对话有什么区别？
听写先生成文本，你可以检查、编辑后再作为编程提示词提交；实时语音对话则是与 Agent 持续进行口头交流。原生功能满足需求时可以直接使用；需要跨应用输入文本或选择本地处理时，可考虑 Mac 听写流程。本地转写不会让接收文本的编程服务离线，也不代表已经支持远程会话。
正在从其他语音输入应用切换？看看 attunz 作为 Wispr Flow 替代品或 Superwhisper 替代品的对比。