Claude Code setup¶
Dictation, effort and /clear take one block in keybindings.json,
in Claude Code's config directory: ~/.claude, or what CLAUDE_CONFIG_DIR names.
It goes into the file's bindings array, or its lines into a Chat block already there,
and the file reloads by itself:
{
"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"
}
}
The device sends Ctrl chords rather than typed commands, since a Ctrl chord arrives the same under any keyboard layout. Enter, the arrows and Esc need nothing configured. Without the block, the chords leave the prompt and the conversation as they are.
Tried on Claude Code 2.1.311.
Its schema has no space in a command's name,
so an editor validating against $schema marks the two effort lines;
they run all the same.
Dictation¶
Ctrl+Q dictates from the Mac's own keyboard too,
since voice:pushToTalk takes one key.
Dictation also needs /voice hold, once,
and key repeat on, as macOS has it by default:
Claude Code tells a held key by its repeats,
and without them a recording ends about 2.2 s into the hold.