# Better Call GPT – Plugin for Talking to Claude Code in Live

> Source: <https://github.com/insta-fusion/bettercallgpt>
> Published: 2026-10-02 02:19:37+00:00

Talk while it codes. GPT Realtime talks back. A spoken “yes” never approves anything.

[**Demo**](https://pub-e5158abb37d74611a90c9a80bcd9fd9b.r2.dev/bettercallgpt/launch-video/2026-09-29/better-call-gpt-A-r9-16x9.mp4)
   • 
  [**Install**](#install-once)
   • 
  [**How it works**](#how-a-call-works)
   • 
  [**Guide**](https://github.com/insta-fusion/bettercallgpt/blob/main/docs/GUIDE.md)
   • 
  **简体中文**

Say what you want while you do something else. A realtime voice model keeps the conversation; only real requests reach your Claude Code session, which does the work in your repo and reports back by voice. In the launch video: fix a Stripe refund bug, draft an email you approve before it sends, and learn a Sylas combo, all mid-game.

```
sequenceDiagram
    participant You
    participant GPT as GPT Realtime
    participant CC as Claude Code (your session)
    You->>GPT: speak: "fix the refund bug and ship it"
    GPT-->>You: small talk is answered right here
    GPT->>CC: real requests arrive as a line tagged ⟨v#35;1⟩
    CC->>CC: reads, edits, runs tests, pushes
    CC-->>GPT: progress and results
    GPT-->>You: reads them back, you can interrupt any time
    Note over You,CC: Permission prompts go to your keyboard only. The voice cannot approve.
```

1. **`/bettercallgpt:on`** starts a voice process bound to*this* session only. It proves which
session started it with zero keystrokes and refuses anything else.
2. **You talk, full duplex, in your language.** It opens in Chinese and answers in whatever
language you just spoke; English tech words don't switch it. GPT Realtime decides what is chat
and what is work.
3. **Work is relayed as your words** , tagged`⟨v#n⟩` , so Claude treats it as you speaking.
4. **Results come back by voice** when they land; ask “how's it going?” mid-task.
5. **It ends** when you say so, type`/bettercallgpt:off` , or stay quiet for 10 minutes.

```
npx skills add insta-fusion/bettercallgpt -g      # needs Node; macOS + Claude Code
```

Then tell your agent: **“set up bettercallgpt”**. No Node? Paste this into Claude Code instead:
`Set up https://github.com/insta-fusion/bettercallgpt for me.` (it follows [AGENTS.md](https://github.com/insta-fusion/bettercallgpt/blob/main/AGENTS.md)). It checks for [uv](https://docs.astral.sh/uv/)
and your platform, installs the Claude Code plugin, creates an empty key file and runs a
readiness check. You do two things yourself:

1. **Paste your key** into the file it names (Azure Voice Live; OpenAI Realtime is
experimental). Setup never asks for the key — don't paste it into the chat.
2. **Type `/bettercallgpt:on`** in a new Claude Code session and approve the start. A rising tone:
you're live.

Better Call GPT is free and MIT; the voice service bills your own account. Prefer to skip the skill?
Install [uv](https://docs.astral.sh/uv/), type `/plugin marketplace add insta-fusion/bettercallgpt`
and `/plugin install bettercallgpt@bettercallgpt`, fill `~/.config/bettercallgpt/.env` from
[`.env.example`](https://github.com/insta-fusion/bettercallgpt/blob/main/.env.example), then `/bettercallgpt:on`.

Or pin the release without the skill: `uv tool install "git+https://github.com/insta-fusion/bettercallgpt@v0.1.0"`.

|  | Voice Live (default) | GPT-Live | 
|---|---|---|
| Model | `gpt-realtime-2.1` | `gpt-live-1` | 
| Echo | The service removes its own voice from your mic (server echo cancellation), so open speakers are fine. | Echo cancellation is not advertised, so the call's start notes “use headphones”. On open speakers it is untested: our own calls on it did not cut themselves off. | 
| Keys in `~/.config/bettercallgpt/.env` | `AZURE_OPENAI_ENDPOINT` ,`AZURE_OPENAI_API_KEY` | `VOICE_LIVE_PROVIDER=gpt_live` ,`VOICE_GPT_LIVE_ENDPOINT` ,`VOICE_GPT_LIVE_API_KEY` (its own Azure resource) | 

If the AI ever cuts itself off mid-sentence while on speakers, put on headphones or switch to
Voice Live (delete the `VOICE_LIVE_PROVIDER=gpt_live` line).

| Command | Does | 
|---|---|
| `/bettercallgpt:on` | start a call attached to this session | 
| `/bettercallgpt:status` | one line: phase, relay | 
| `/bettercallgpt:off` | end the call | 

- **A spoken “yes” never approves anything.** The voice cannot answer a permission prompt; you
answer it on the keyboard. (What your agent may already do without asking is still up to your
Claude Code permission settings.)
- **The start asks you first** — unless Claude Code runs in auto or bypass mode, or an allow rule
matches it. Don't allow-list it (no`bettercallgpt` wildcard, no broad`uvx` rule): it opens your microphone and a paid connection.
- **What leaves your machine:** your microphone audio, and what the voice needs to talk about the
work (your prompts, the agent's progress and results, permission prompts), go to the voice
provider you configure. The call ledger stays local (`0600` ). See[SECURITY.md › Privacy notes](https://github.com/insta-fusion/bettercallgpt/blob/main/SECURITY.md#privacy-notes) .
- **It attaches only to the session that started it** , proven with zero keystrokes, and refuses
anything else.
- **The plugin is three small command files** ([plugin/commands/](https://github.com/insta-fusion/bettercallgpt/blob/main/plugin/commands) ) that only
you can run: no hooks, and the voice process runs only during a call. They run the tagged
release from GitHub through`uvx` ; release tags are published as immutable GitHub releases,
so a tag cannot be moved after release.

|  | Today | Not yet | 
|---|---|---|
| Agent | **Claude Code CLI on macOS** , any terminal, and the**Claude desktop app's Code tab** (both proven live) | Cowork (runs in a VM: unsupported), Codex as a child agent ( `VOICE_BACKEND=process` , unit-tested) | 
| Voice | **Azure GPT Realtime** (`gpt-realtime-2.1` through Azure Voice Live; default, proven live, echo-cancelled: speakers OK) and the**Azure GPT-Live API** (`gpt-live-1` , proven live; headphones) | OpenAI Realtime API (unit-tested; no echo cancellation: headphones) | 
| OS | **macOS** | Linux/Windows: the Claude Code backend's peer check is macOS-only | 
| Orca | Works in any [Orca](https://github.com/stablyai/orca) pane; when the pane proves itself (needs the`orca` CLI) the call also tells you when Claude is waiting on a permission prompt | long calls in that mode: unverified | 

**Want it in another coding agent or CLI** (Codex, Gemini CLI, Cursor, Aider, …) or on another voice model or OS? [Open a support request](https://github.com/insta-fusion/bettercallgpt/issues/new?template=agent-support.yml) and say which one; requests decide what comes next.

Status line, running without the plugin, configuration, how it is built and tests: [docs/GUIDE.md](https://github.com/insta-fusion/bettercallgpt/blob/main/docs/GUIDE.md).

MIT — see [LICENSE](https://github.com/insta-fusion/bettercallgpt/blob/main/LICENSE).
