call

name	call
description	Voice calls with Claude about your coding projects via Vapi. Use when you want to phone Claude, start a voice conversation, dial in for a project brainstorm, get a verbal status update, or talk through code hands-free.
allowed-tools	Bash, Read, Write, AskUserQuestion
user-invocable	true

/call

Voice calls with Claude about your projects. Claude calls you (outbound) or you call a Vapi number and Claude answers with your project context preloaded — read files, search code, check git status, and brainstorm live.

Quick Start

# One-time setup
pip install claude-code-voice
claude-code-voice setup              # Add API key, phone, name
claude-code-voice status             # Verify configuration is correct

# Register a project
cd your-project
claude-code-voice register

# Start receiving calls (does everything automatically)
claude-code-voice start

That's it! Now you can:

• Outbound: Run claude-code-voice call to have Claude call you
• Inbound: Call the Vapi number shown and Claude answers with your project loaded

Commands

Command	Description
setup	Configure Vapi API key, your phone number, and name
register	Register current directory as a project
start	Easy mode - starts server + tunnel, configures everything
call [topic]	Have Claude call you about current/recent project
status	Check if everything is configured
config name <name>	Update your name for greetings

Features

Personalized Greetings

Claude greets you by name: "Hey Sarah! I've got my-project loaded up."

Set your name during setup or update it:

claude-code-voice config name YourName

Live Project Context

During calls, Claude can:

• Read your files
• Search your code
• Check git status
• See recent changes

Auto-Sync Transcripts

Transcripts automatically save to ~/.claude/skills/call/data/transcripts/ when calls end.

How It Works

1. Setup stores your Vapi API key and creates voice tools
2. Register snapshots your project context (git status, recent files, etc.)
3. Start runs a local server + tunnel so Vapi can reach your code
4. Calls use Opus 4.5 with your project context preloaded

Requirements

• Vapi account with API key (https://dashboard.vapi.ai)
• Vapi phone number (purchase in dashboard ~$2/month)
• Node.js (for localtunnel)

Troubleshooting

Call doesn't connect

claude-code-voice status  # Check configuration

Claude can't access files during call

Make sure claude-code-voice start is running in a terminal.

"I don't recognize this number"

Call from the phone number you used during setup.

Manual Setup (Advanced)

If you prefer manual control:

# Terminal 1: Start server
claude-code-voice server

# Terminal 2: Start tunnel
npx localtunnel --port 8765

# Configure the tunnel URL
claude-code-voice config server-url https://xxx.loca.lt
claude-code-voice configure-inbound