Documentation

Get started in
under 5 minutes

Set up voice calls with your AI coding assistant. Works with Claude Code.

1

Create an account

Sign up with your email. You'll get a 7-day free trial with no credit card required.

2

Verify your phone

Add and verify your phone number. This is where your AI will call you.

3

Get your API key

Generate an API key from your dashboard. You'll need this for the skill.

4

Install the skill

Run this command in your terminal to install the Claude Code skill:

curl -fsSL https://claude-calls-web.pages.dev/skill.md -o ~/.claude/skills/call-user/SKILL.md --create-dirs
5

Set your API key

Add your API key to your environment:

export CLAUDE_CALLS_API_KEY="your-api-key-here"

You're ready!

Tell Claude "call me" and your phone will ring. Speak your instructions and Claude will get to work.

How it works

When you say "call me" to Claude Code, the skill makes an API call to initiate a phone call to your verified number.

You answer, speak your instructions, and hang up. Your voice is transcribed and sent back to Claude, who continues working based on what you said.

When Claude finishes a task, it can call you back to report results and ask what's next. This creates a natural back-and-forth workflow.

API Reference

Start a call

POST /api/call
Content-Type: application/json
X-API-Key: your-api-key

{"message": "Hey! What would you like me to work on?"}

Returns {"callId": "call_abc123"}

Poll for result

GET /api/call/:callId/result
X-API-Key: your-api-key

Possible responses:

  • {"status": "pending"} — still ringing or talking
  • {"status": "completed", "transcript": "..."} — got response
  • {"status": "no_answer"} — user didn't pick up
  • {"status": "failed"} — something went wrong

Tips

  • Speak naturally. The transcription handles conversational speech well.
  • Be specific. "Fix the login bug in auth.ts" works better than "fix the bug".
  • Say "that's all" when done. Claude will stop calling back.
  • Check your usage. Monitor call counts in your dashboard.

Need help?

Having trouble getting set up? We're here to help.

Contact support →