# Quick start

## 1\. Install

With a Flipper Zero on firmware 1.5.1, unlocked on USB, on its desktop, and an Apple Silicon Mac with [mise](<https://mise.jdx.dev>), in a clone of the repository:

```
mise trust
mise install
mise run setup
mise run launch
```

The app opens on the device. [Installation](<https://petr-korobeinikov.github.io/f0-claude-remote/guide/installation/index.md>) has the other route and the details.

## 2\. Pair

In the Mac's Bluetooth settings, press Connect on `Claude Remote` under Nearby Devices, accept the request, and press OK in `Verify code` on the device. [Pairing](<https://petr-korobeinikov.github.io/f0-claude-remote/guide/pairing/index.md>) covers the rest.

## 3\. Bind the keys

Add this block to the `bindings` array of `~/.claude/keybindings.json`:

```
{
  "context": "Chat",
  "bindings": {
    "ctrl+q": "voice:pushToTalk",
    "ctrl+x ctrl+f": "command:effort high",
    "ctrl+x ctrl+l": "command:clear",
    "ctrl+x ctrl+x": "command:effort max"
  }
}
```

Then run `/voice hold` once in Claude Code. [Claude Code setup](<https://petr-korobeinikov.github.io/f0-claude-remote/guide/claude-code-setup/index.md>) says why, and what else dictation needs.

## 4\. Try it

With a Claude Code session focused on the Mac:

1. Hold OK, and speak.
2. Release OK.
3. Wait out `Voice: processing…`.
4. Tap OK: the prompt is sent.

[Using the remote](<https://petr-korobeinikov.github.io/f0-claude-remote/guide/using-the-remote/index.md>) has every other button.
