# 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 - Connect your agent

### Configure .mcp.json

Add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "cv-claude-channel": {
      "command": "npx",
      "args": ["@carbonvoice/cv-claude-channel"],
      "env": {
        "CV_PAT": "your-carbon-voice-pat"
      }
    }
  }
}
```

### Start Claude Code with Channels Enabled

```bash
claude --dangerously-load-development-channels server:cv-claude-channel
```
Note: Claude Channels are currently in research preview.  This is required to accept permissions.

⚠️ 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 add them via cv-claude-channel in Claude Code
> - Your Carbon Voice PAT is stored in `.mcp.json` which is gitignored
> - Never commit your PAT to version control
> - Channels carry prompt injection risks - only enable with trusted sources