voice-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Voice Skill - Talk to Claude About Your Code

Voice Skill - 与Claude讨论你的代码

Enable voice conversations with Claude Opus 4.5 about your projects. Have Claude call you or call Claude directly to discuss problems, brainstorm ideas, and get real-time code reviews.

启用与Claude Opus 4.5就你的项目进行语音对话的功能。你可以让Claude致电给你，也可以直接致电Claude，讨论问题、头脑风暴想法以及获取实时代码评审。

When to Use This Skill

何时使用此Skill

Discussing complex code problems hands-free
Brainstorming architecture decisions
Getting verbal code reviews
Explaining code while walking/commuting
Pair programming via voice
Quick questions without typing

无需动手即可讨论复杂代码问题
头脑风暴架构决策
获取口头代码评审
走路/通勤时讲解代码
通过语音进行结对编程
无需打字快速提问

How It Works

工作原理

Claude Calls You: Initiate outbound calls from Claude
You Call Claude: Call your Vapi number to reach Claude
Live Context: Claude has access to your project during calls
Transcripts: All calls automatically saved as markdown

Claude致电你：从Claude发起外呼电话
你致电Claude：拨打你的Vapi号码联系Claude
实时上下文：通话过程中Claude可访问你的项目
通话记录：所有通话自动保存为Markdown格式

Setup

设置步骤

Prerequisites

前置条件

Vapi account with API key
Phone number (~$2/month)
Node.js (for localtunnel)
Python 3.8+

拥有API密钥的Vapi账户
电话号码（约2美元/月）
Node.js（用于localtunnel）
Python 3.8及以上版本

1. Install

1. 安装

bash

pip install claude-code-voice-skill

bash

pip install claude-code-voice-skill

2. Setup Credentials

2. 设置凭据

bash

voice-skill setup

Prompts for:

Vapi API key
Your phone number
Your name (for personalized greetings)

bash

voice-skill setup

提示输入：

Vapi API密钥
你的电话号码
你的姓名（用于个性化问候）

3. Register Project

3. 注册项目

bash

cd /path/to/your/project
voice-skill register

Captures project snapshot for context.

bash

cd /path/to/your/project
voice-skill register

捕获项目快照以获取上下文。

4. Start Service

4. 启动服务

bash

voice-skill start

Launches server and tunnel.

bash

voice-skill start

启动服务器和隧道。

Commands

命令说明

Have Claude Call You

让Claude致电你

bash

voice-skill call

Claude calls your registered number and greets you by name.

bash

voice-skill call

Claude会拨打你注册的号码，并以你的姓名问候你。

Check Status

检查状态

bash

voice-skill status

Shows service status and active sessions.

bash

voice-skill status

显示服务状态和活跃会话。

Update Name

更新姓名

bash

voice-skill config name "Your Name"

bash

voice-skill config name "Your Name"

View Transcripts

查看通话记录

bash

ls ~/.voice-skill/transcripts/

bash

ls ~/.voice-skill/transcripts/

What Claude Can Do During Calls

通话中Claude可执行的操作

Read Files

读取文件

"Claude, what's in the main.py file?" → Claude reads and explains the file

"Claude，main.py文件里有什么内容？" → Claude会读取并解释该文件

Search Code

搜索代码

"Can you find where we handle authentication?" → Claude searches and reports findings

"你能找到我们处理身份验证的位置吗？" → Claude会搜索并报告结果

Check Git Status

检查Git状态

"What files have I changed today?" → Claude reports git diff summary

"我今天修改了哪些文件？" → Claude会报告git diff摘要

Review Code

评审代码

"Review the changes I made to the API module" → Claude provides verbal code review

"评审我对API模块所做的修改" → Claude会提供口头代码评审

Brainstorm

头脑风暴

"I need to add caching - what approaches should I consider?" → Claude discusses options with pros/cons

"我需要添加缓存功能，应该考虑哪些方案？" → Claude会讨论不同方案的优缺点

Example Conversation

对话示例

[Phone rings]

Claude: "Hey Alex! I see you're working on the user-service
project. What would you like to discuss?"

You: "I'm having trouble with the authentication middleware.
Can you take a look at auth.py?"

Claude: "Sure, let me read that... I see you're using JWT
tokens. The issue might be on line 45 where you're checking
the expiry. You're comparing timestamps in different formats..."

You: "Oh, that makes sense. What's the fix?"

Claude: "You should convert both to Unix timestamps before
comparing. I'd suggest using datetime.timestamp() on line 45..."

[电话响起]

Claude："嘿，Alex！我看到你正在处理user-service项目。你想讨论什么内容？"

你："我在身份验证中间件上遇到了问题，能帮我看看auth.py吗？"

Claude："没问题，让我看看……我发现你使用了JWT令牌。问题可能出在第45行的过期时间检查上，你在比较不同格式的时间戳……"

你："哦，原来是这样。怎么修复呢？"

Claude："你应该在比较前将两者都转换为Unix时间戳。我建议在第45行使用datetime.timestamp()……"

Transcripts

通话记录

Calls are automatically transcribed and saved:

markdown

undefined

通话会自动转录并保存为：

markdown

undefined

Call Transcript - 2025-01-12 10:30 AM

通话记录 - 2025-01-12 10:30 AM

Project: user-service Duration: 8 minutes

项目： user-service 时长： 8分钟

Summary

摘要

Discussed JWT authentication bug in auth.py. Identified timestamp comparison issue on line 45.

讨论了auth.py中的JWT身份验证漏洞。确定了第45行的时间戳比较问题。

Full Transcript

完整通话记录

Claude: Hey Alex! I see you're working on... You: I'm having trouble with... ...

undefined

Claude： 嘿，Alex！我看到你正在处理…… 你：我在……遇到了问题 ...

undefined

Configuration

配置说明

Config File Location

配置文件位置

~/.voice-skill/config.yaml

~/.voice-skill/config.yaml

Options

配置选项

yaml

user:
  name: "Your Name"
  phone: "+1234567890"

vapi:
  api_key: "your-key"
  phone_number: "+1987654321"

preferences:
  greeting_style: casual  # casual, professional
  auto_transcript: true
  transcript_dir: ~/.voice-skill/transcripts

yaml

user:
  name: "你的姓名"
  phone: "+1234567890"

vapi:
  api_key: "你的密钥"
  phone_number: "+1987654321"

preferences:
  greeting_style: casual  # casual, professional（随意、专业）
  auto_transcript: true
  transcript_dir: ~/.voice-skill/transcripts

Voice Provider Options

语音提供商选项

The skill supports different voice providers:

Default Vapi voices
ElevenLabs integration
Custom voice configurations

此Skill支持多种语音提供商：

默认Vapi语音
ElevenLabs集成
自定义语音配置

Security

安全性

API keys stored locally
Calls encrypted via Vapi
Transcripts stored locally only
No data sent to third parties (beyond Vapi)

API密钥本地存储
通话通过Vapi加密
通话记录仅本地存储
除Vapi外，无数据发送至第三方

Troubleshooting

故障排除

"Connection failed"

"连接失败"

Check internet connection
Verify Vapi API key
Restart with
```
voice-skill start
```

检查网络连接
验证Vapi API密钥
使用
```
voice-skill start
```
重启服务

"Project not found"

"未找到项目"

Run
```
voice-skill register
```
in project directory

在项目目录中运行
```
voice-skill register
```

"Call not connecting"

"无法接通电话"

Verify phone number format (+country code)
Check Vapi account balance

验证电话号码格式（需包含国家代码前缀+）
检查Vapi账户余额

Use Cases

使用场景

Code Reviews: Verbal feedback while looking at code
Debugging: Talk through problems out loud
Architecture: Discuss design decisions
Learning: Explain code concepts
Accessibility: Hands-free coding assistance

代码评审：查看代码时获取口头反馈
调试：大声讨论问题
架构设计：讨论设计决策
学习：讲解代码概念
无障碍使用：无需动手的编码辅助

Credits

致谢

Created by abracadabra50. Licensed under MIT.

由abracadabra50开发。基于MIT许可证开源。