# Carbon Voice + Claude Code

[![Demo: Carbon Voice + Claude Code](../../config/images/claude-cv-demo-thumbnail.png)](https://www.loom.com/share/a6501c10a1f94518b825f3140f5298c4)

> **About this intergration**
>
>[Why Carbon Voice?](../concepts/why-carbonvoice.md) 
>
>- **Talk to Claude Code** — Tap a button on your phone or computer to start >talking to [Claude Code](https://claude.ai/code).
>- **Send even when agent is offline and recovers** — Your messages are queued and delivered when you next open your Claude Code session.
>- **Code or agent** - Use this integration to talk to your code or use Claude as a personal agent.
>
>NOTE: Claude Code Channels are currently in preview. You'll need to enable them in your Claude Code settings.

## 1 - Create an Agent Account and Get PAT

1. [Create an agent](../api-how-to/how-to-create-a-voice-agent-account.md)
2. Generate a Personal Access Token (PAT) for that agent
3. Copy the PAT - you'll need it for configuration

## 2 - Install the Carbon Voice plugin

Carbon Voice ships as a Claude Code plugin. Start a Claude Code session (`claude`) and, inside it, add the marketplace and install the plugin:

```
/plugin marketplace add PhononX/cv-claude-channels
/plugin install cv-channel@carbonvoice
```

> **Migrating from the old setup?** If you previously added a `cv-claude-channel` server to your `.mcp.json`, remove it first so the two don't conflict:
>
> ```bash
> claude mcp remove cv-claude-channel
> ```
>
> (or delete the `cv-claude-channel` block from `.mcp.json`).

### Configure your token

**Restart Claude Code** after installing so the plugin's commands load, then save your PAT:

```
/cv-channel:configure your-carbon-voice-pat
```

Your token is saved to `~/.claude/channels/cv/.env` — it never goes in `.mcp.json`.

### Start Claude Code with the channel enabled

```bash
claude --dangerously-load-development-channels plugin:cv-channel@carbonvoice
```

Note: Claude Channels are currently in research preview. Configure your token **before** this step, or the channel won't connect.

⚠️ You'll need to approve the `send_message` to get it to respond through Carbon Voice.

## 3 - Talk to your agent

Get desktop app to setup hotkeys to talk to your agent.
Get mobile app to talk to your agent on the go.
[Download Carbon Voice](https://carbonvoice.app/download)



> **Security Notes**
>
> - All senders are ignored until you approve them via `/cv-channel:access` in Claude Code
> - Your Carbon Voice PAT is stored in `~/.claude/channels/cv/.env` (written by `/cv-channel:configure`), never in `.mcp.json`
> - Never commit your PAT to version control
> - Channels carry prompt injection risks - only enable with trusted sources