voice-skill

voice-skill 是一个语音对话技能，用于围绕代码项目与 Claude Opus 4.5 进行电话交流。它适合免提讨论复杂代码问题、头脑风暴架构决策、获取口头代码评审、在通勤或散步时听代码讲解、通过语音结对编程，以及无需打字的快速提问。

工作方式：Claude 可主动拨出电话，也可由用户拨打绑定的 Vapi 号码联系 Claude。通话中 Claude 可访问当前项目上下文，所有通话自动保存为 markdown 转录。

通话中可让 Claude 读取并讲解文件、搜索代码、汇报 git diff、对指定改动做口头代码评审，以及讨论方案优劣。

使用前提：Vapi 账号及 API key、一个电话号码（约每月 2 美元）、Node.js（用于 localtunnel）、Python 3.8+。

安装与命令： pip install claude-code-voice-skill voice-skill setup # 输入 Vapi API key、电话号码、姓名 在项目目录中执行 voice-skill register 捕获项目快照 voice-skill start 启动服务与隧道 voice-skill call 让 Claude 拨打电话 voice-skill status 查看服务状态与会话 voice-skill config name "Your Name" 更新姓名 转录文件位于 ~/.voice-skill/transcripts/

配置位于 ~/.voice-skill/config.yaml，可设置 user 的 name 与 phone、vapi 的 api_key 与 phone_number，以及 greeting_style（casual、professional）、auto_transcript、transcript_dir。语音提供方支持默认 Vapi 语音、ElevenLabs 集成及自定义语音配置。

安全与隐私：API key 本地存储，通话通过 Vapi 加密，转录仅本地保存，除 Vapi 外不向第三方发送数据。

限制：需要 Vapi 账号与付费电话号码，依赖网络与 Node.js、Python 环境；通话可能因网络、API key、号码格式或 Vapi 余额问题失败。项目由 abracadabra50 创建，MIT 许可。其它功能、收费或价格细节暂未提供。