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, in a clone of the repository:
mise trust
mise install
mise run setup
mise run launch
The app opens on the device. Installation 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 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 says why, and what else dictation needs.
4. Try it¶
With a Claude Code session focused on the Mac:
- Hold OK, and speak.
- Release OK.
- Wait out
Voice: processing…. - Tap OK: the prompt is sent.
Using the remote has every other button.