Deskphone for Claude Code
Talk to Claude Code from a real, corded desk phone.
- Run
/deskphone:phonein a session and it gets an extension (101, 102, …). - Pick up the phone, dial that extension and speak. Your words arrive in the session as a prompt.
- When Claude finishes, the phone rings. It reads the answer aloud, beeps, and listens. Your reply becomes the next prompt, or stay silent and it hangs up.
- When Claude needs permission for a tool, the phone rings and reads the request. Say yes or no.
- Missed the call? The reply goes to voicemail and the phone plays a stutter dial tone. Dial
100#to hear every waiting reply, or press 2 there to hear which sessions are registered. - Dial a session with nothing waiting and it reads Claude Code’s own
※ recapof where that session is.
analog phone ──RJ11── ATA (Grandstream HT801) ──Ethernet── USB-C adapter ── Mac
│ Internet Sharing NAT
Asterisk (Docker on the Mac, or public on Kubernetes) ───┤ SIP + RTP
│ ARI + media WebSockets (Mac → Asterisk)
├─ deskphone daemon: whisper.cpp, macOS `say`
└─ Claude Code + deskphone plugin
├─ channel MCP server: speech in as prompts
└─ Stop hook: rings the phone with the reply
What you need
| Mac | macOS with Homebrew. Speech uses say and Internet Sharing, so the daemon is macOS-only. |
| Node.js | 23.6 or newer (runs the TypeScript directly). |
| Claude Code | A version with channels (a research preview; built against 2.1.312). On Team/Enterprise plans an admin must allow channels. |
| Phone hardware | Any analog (pulse/DTMF) phone, an ATA with an FXS port, and a USB Ethernet adapter. See Hardware. |
| Asterisk | Docker Desktop on the Mac, or a Kubernetes cluster you can expose to the internet. See Asterisk. |
Setup at a glance
- Get the hardware: an ATA and a USB Ethernet adapter.
- Install the software: clone, run
scripts/setup.sh. - Run Asterisk: locally in Docker, or publicly on Kubernetes.
- Connect and configure the ATA.
- Make your first call.
When something doesn’t work, check Troubleshooting. How it works explains the moving parts.