Keys in Claude Code¶
Each fact ends with its kind and its source: documented, read in Claude Code 2.1.311's package, or seen on the Mac. A Claude Code update can break the second kind; the package publishes no browsable source, so its links go to the archived change that read it.
Ctrl chords¶
Typed, /effort high comes out under a non-Latin layout as .уаащке рушр,
and Enter then sends it as a message
(seen: effort-actions, proposal).
Under a non-Latin layout, in a terminal that does not report a key's position,
Claude Code matches what the terminal sends:
an ASCII control code triggers the Latin shortcut,
and a Cyrillic character matches no binding
(documented: Keybindings).
A Ctrl letter arrives as a control code under any layout,
so each command is a chord of Ctrl letters,
bound in keybindings.json to command:<name>, which runs /<name>
(documented: Keybindings).
The text after command: runs as typed, argument and all
(Claude Code 2.1.311's package: effort-actions, design),
and the draft in the prompt stays
(seen: effort-actions, task 4.1).
Ctrl+L alone only redraws the screen
(documented: Keybindings),
so /clear is ctrl+x ctrl+l.
Sent during a turn, /clear waits for the turn's end
(Claude Code 2.1.311's package: remote-actions, design),
and /resume lists the conversation it left
(documented: Commands).
Voice¶
voice:pushToTalk takes one key at a time
(documented: Voice dictation),
so Ctrl+Q replaces Space, on the Mac's keyboard too.
Claude Code compares that key with the character it receives
(Claude Code 2.1.311's package: remote-actions, design),
so Option+K, the first choice, started no dictation under a non-Latin layout
(seen: remote-actions, proposal).
Claude Code tells a held key by its key repeats (documented: Voice dictation). The first press arms a 2000 ms fallback, then a 200 ms gap between repeats ends the recording (Claude Code 2.1.311's package: remote-actions, design), so with key repeat off a recording ends about 2.2 s into the hold. The device holds Ctrl+Q down for as long as OK is held, and the Mac repeats it. On the Mac's keyboard, a 10-second hold under a non-Latin layout dictated throughout (seen: remote-actions, task 1.2), and a hold of OK over Bluetooth dictated as well (seen: remote-actions, task 4.1).
Effort levels¶
Effort high is ctrl+x ctrl+f, and effort max ctrl+x ctrl+x:
with ctrl+q bound to voice, ctrl+x ctrl+q started a recording
(seen: remote-actions, task 1.3),
and Ctrl+X twice needs no key the device does not already send.
high is saved as the default for the model, and max lasts the session
(documented: Commands;
Model configuration).
Typed during a turn, /effort applies from the next message
(documented: Model configuration);
a keybinding's command runs at once
(Claude Code 2.1.311's package: effort-actions, design),
and the level changed inside a turn with no line printed
(seen: effort-actions, task 4.2).
What the schema warns of¶
The schema allows no space in a command's name
(documented: claude-code-keybindings.json),
so an editor validating against $schema marks both effort lines.
Claude Code only notes the space in its debug log and runs them
(Claude Code 2.1.311's package: effort-actions, design).