CallMe: Claude Code插件——电话呼叫快速设置
CallMe – 适用于电话呼叫的最小化 Claude Code 插件
如果您曾经希望 Claude 能够完成一项任务后再给您打电话讨论下一步,CallMe 就能将这一愿望变为现实。它是一个超轻量级的开源插件,可将 Claude Code 转变为语音化助手。无论您想在代码评审后保持跟进,还是想即时获取某个功能的反馈,CallMe 都能通过一次电话提醒取代电子邮件或 Slack 消息。
该插件支持两大流行的语音 API 提供商 – Telnyx(建议使用,以降低成本)和 Twilio – 并使用 ngrok 安全地公开本地 webhook。设置完成后,插件会为您的提示暴露四个便捷工具:
| 工具 | 功能 |
|---|---|
initiate_call |
发起新电话 |
continue_call |
提出后续问题 |
speak_to_user |
朗读信息,不等待回复 |
end_call |
结束通话 |
下面是一份完整的分步教程,帮助您在几分钟内让 CallMe 在手边响起。
先决条件
| 项目 | 需求说明 |
|---|---|
| 手机号码 | 这是 Claude 将从其拨出的号码 |
| Telnyx 或 Twilio 账户 | 用于访问语音 API 与 webhook 管理 |
| OpenAI 账户 | TTS(文字转语音)与 STT(语音转文字)服务 |
| ngrok 账户 | 将本地 HTTP 服务器隧道至公共互联网上 |
git 与现代 CLI |
用于克隆仓库并执行命令 |
所有提供商均提供免费配额,测试阶段成本可忽略不计。
1️⃣ 搭建服务提供商
选项 A:Telnyx(推荐)
- 前往 portal.telnyx.com 并验证您的账户。
- 订购电话号码(约 $1/月)。
- 创建 Voice API 应用:
- Webhook URL:
https://<your‑ngrok‑url>/twiml - API 版本:
v2 - 复制 Application ID 与 API Key。
- (可选)在 Account Settings → Keys & Credentials 中复制 Public Key 以签名 webhook。
选项 B:Twilio(替代方案)
- 在 twilio.com 注册并获取免费试用号码。
- 从仪表盘复制 Account SID 与 Auth Token。
2️⃣ 配置环境变量
在 ~/.claude/settings.json(推荐)创建以下 JSON 结构:
{
"env": {
"CALLME_PHONE_PROVIDER": "telnyx",
"CALLME_PHONE_ACCOUNT_SID": "YOUR_APPID_OR_SID",
"CALLME_PHONE_AUTH_TOKEN": "YOUR_API_KEY_OR_TOKEN",
"CALLME_PHONE_NUMBER": "+15551234567",
"CALLME_USER_PHONE_NUMBER": "+15559876543",
"CALLME_OPENAI_API_KEY": "sk-…",
"CALLME_NGROK_AUTHTOKEN": "YOUR_NGROK_TOKEN"
}
}
小贴士: 若使用 Twilio,只需将
CALLME_PHONE_PROVIDER设为 twilio 并相应替换两项SID/Token。
如需使用可选 webhook 签名,追加:
"CALLME_TELNYX_PUBLIC_KEY": "YOUR_PUBLIC_KEY"
其余环境变量为可选,系统会使用合适的默认值。
3️⃣ 安装插件
# 在 Claude Code 里
/plugin marketplace add ZeframLou/call-me
/plugin install callme@callme
重启 Claude Code 以加载新工具。
4️⃣ 运行本地 MCP 服务器
插件捆绑了一个轻量级的 MCP(多通道提供商)服务器,可自动生成 ngrok 隧道。
cd call-me
bn run dev # 或者在安装了 bun 时使用 bun run dev
服务器启动后会在控制台输出公共 URL;这就是您的 webhook 端点。
5️⃣ 发起通话
在您的 Claude 提示中可调用工具。例如:
你完成了身份验证流程!给我打电话讨论下一步。
Claude 将回复:
{
"tool": "initiate_call",
"arguments": {
"message": "Hey! I finished the auth system. What should I work on next?"
}
}
Claude 会拨打电话,响铃后您即可通话。通话过程中可使用以下命令处理非阻塞语音:
continue_callspeak_to_user
6️⃣ 成本快照
| 项目 | Telnyx | Twilio |
|---|---|---|
| 出站每分钟 | ~$0.007 | ~$0.014 |
| 电话号码每月 | ~$1 | ~$1.15 |
| OpenAI TTS/ STT | ~$0.02/分钟 | 同上 |
| 总计 | ~$0.03–$0.04/分钟 | ~$0.04–$0.05/分钟 |
所有数字均为估算值,实际使用量会影响费用。
7️⃣ 故障排除手册
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
| Claude 未使用工具 | 环境变量缺失 | 在 settings.json 中添加所有必需变量 |
| 没有电话响铃 | webhook URL 错误 | 确认 URL 与 ngrok 输出一致 |
| 音频异常 | 电话号码未验证 | 重新验证提供商号码 |
| ngrok 出错 | 认证令牌错误 | 重新生成并设置 CALLME_NGROK_AUTHTOKEN |
| 工具名不匹配 | 使用旧版 Claude Code | 更新至最新版插件 |
使用 claude --debug 检查详细 MCP 日志。
8️⃣ 高级用法
自定义 TTS 语音
在环境变量中添加:
"CALLME_TTS_VOICE": "onyx" // 选项: alloy, echo, fable, onyx, nova, shimmer
使用自定义 ngrok 域名
若拥有付费 ngrok 计划,设置:
"CALLME_NGROK_DOMAIN": "mycustom.ngrok.io"
MCP 服务器将绑定至该域名。
9️⃣ 扩展与部署
尽管本地 MCP 服务器非常适合原型开发,但您也可以将其容器化或通过云函数公开。仓库已包含 Dockerfile 与 bun run dev 命令,便于快速构建 Docker 镜像。
docker build -t callme .
docker run --env-file ~/.claude/settings.json -p 3333:3333 callme
部署完成后,将提供商的 webhook URL 指向公共端点。
📌 结论
CallMe 为 Claude 带来了缺失的人性化触点——真正的电话呼叫,将自然语言理解、TTS/STT 与电话技术融合于一体。无论您是在构建远程优先型初创公司、协调分布式团队,还是单纯想以更生动的方式与 Claude 互动,插件都能即时实现免提沟通。
准备好试一试了吗?克隆仓库,配置 Telnyx 或 Twilio,让 Claude 立即响铃。祝通话愉快!