# Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| No `Verify code` on the device while pairing, and closing the app hangs | The app was launched over the open Apps browser, which holds the dialog | Leave the browser with Back, and launch from the desktop |
| Connect in the Mac's Bluetooth settings times out | After a minute with no link the device stops advertising and shows `Reconnect stopped` | Press any button but Back on the device, then Connect again |
| A recording ends about 2.2 s into the hold | Key repeat is off on the Mac | Turn key repeat on: Claude Code tells a held key by its repeats |
| A dictated prompt is sent cut short | OK was tapped during `Voice: processing…`, which sends the interim text and drops the rest | Wait out `Voice: processing…` before tapping OK |
| Holding Left buzzes, but `/clear` shows no change | The session holds no conversation, so there is nothing to clear | None needed |
| Holding OK, Up, Down or Left buzzes, and Claude Code does nothing | The keys are not bound, or another window is focused | Add the block from [Claude Code setup](<https://petr-korobeinikov.github.io/f0-claude-remote/guide/claude-code-setup/index.md>), and focus the Claude Code session |
| `mise run launch` fails | A PIN locks the device, which drops its USB console | Unlock it; turn auto-lock off in Settings → Desktop while working |
| A press gives no buzz | Vibration is `Off` in the options; otherwise no link, dictation on, or a press with no action, such as a tap on Back: nothing was sent | Turn Vibration `On` in the options; otherwise wait for `No link` to clear, or release OK |
| `No link` goes too soon to hold Right for USB | A paired Mac in range reconnects within a second | Forget `Claude Remote` on the Mac, or turn its Bluetooth off |
| `mise run launch` finds no device on USB | USB takes the device's console while it lasts | Hold Back to leave the app, or hold Right on `No link` with the cable out |
| An editor marks the two effort lines in `keybindings.json` | Claude Code's schema has no space in a command's name | None needed: they run all the same |
