# 快捷键

cmux 中所有可用的快捷键，按类别分组。

Resize the focused pane with Ctrl+Shift+H/J/K/L (left/down/up/right). Hold a key to keep resizing. Change the bindings and Pane Resize Step in Settings → Keyboard Shortcuts. The step is also configurable with app.paneResizeStepPixels in cmux.json (1–200, default 20).

## Shortcut chords

cmux supports two-step shortcut chords in `~/.config/cmux/cmux.json`. For the full configuration schema, see the [configuration docs](https://cmux.com/zh-CN/docs/configuration).

Settings can edit shortcuts directly. Use cmux.json when you want an exact tmux-style prefix binding, keep shortcuts in dotfiles, or unbind an action with null, an empty string, "none", "clear", "unbound", or "disabled".

cmux.json

```
{
  "shortcuts": {
    "bindings": {
      "newSurface": ["ctrl+b", "c"],
      "showNotifications": ["ctrl+b", "i"],
      "toggleSidebar": "cmd+b",
      "toggleFileExplorer": "cmd+opt+b",
      "splitRight": "",
      "commandPalettePrevious": null
    }
  }
}
```

-   Use a plain string for a one-step shortcut.
-   Use a two-item array for a chord. The first item is the prefix stroke, the second is the key that follows it.
-   Each item uses the same syntax as regular bindings, for example cmd+b, ctrl+b, shift+/, or ctrl+1.

[App](https://cmux.com/zh-CN/docs/keyboard-shortcuts#app)·[工作区](https://cmux.com/zh-CN/docs/keyboard-shortcuts#workspaces)·[Surface](https://cmux.com/zh-CN/docs/keyboard-shortcuts#surfaces)·[分屏面板](https://cmux.com/zh-CN/docs/keyboard-shortcuts#split-panes)·[画布](https://cmux.com/zh-CN/docs/keyboard-shortcuts#canvas)·[浏览器](https://cmux.com/zh-CN/docs/keyboard-shortcuts#browser)·[差异查看器](https://cmux.com/zh-CN/docs/keyboard-shortcuts#diff-viewer)·[查找](https://cmux.com/zh-CN/docs/keyboard-shortcuts#find)·[通知](https://cmux.com/zh-CN/docs/keyboard-shortcuts#notifications)

App

Application, window, and top-level command shortcuts.

Settings

⌘+,

打开团队选择器

⌥+⇧+⌘+T

Reload configuration

⌘+⇧+,

Show/hide all cmux windowssystem-wide hotkey

⌃+⌥+⌘+.

Global searchwhen cmux is active

⌥+⌘+F

Command palette

⌘+⇧+P

显示代理收件箱

⌘+⇧+I

Command palette next resultwhen the command palette is open

⌃+N

Command palette previous resultwhen the command palette is open

⌃+P

New window

⌘+⇧+N

Close window

⌃+⌘+W

Toggle full screen

⌃+⌘+F

Send feedbackunbound by default

Reopen previous session

⌘+⇧+O

Quit cmux

⌘+Q

工作区

工作区位于侧边栏中。每个工作区有自己的面板和 surface。

Toggle left sidebar

⌘+B

Toggle right sidebar

⌘+⌥+B

新建本地工作区

⌘+N

新建本地工作区在远程 tmux 镜像工作区处于活动状态时打开本地工作区；此时“新建工作区”会改为在该工作区的主机上启动会话

⌃+⌥+⌘+N

New browser workspacelike New Workspace, but the first surface is a browser pane with the address bar focused

⌥+⌘+N

新建云工作区使用最近选中的 Cloud 工作区所属机器；如果没有，则使用右侧边栏中第一台机器；如果没有可用机器，则打开 New Cloud Machine

⌘+Y

新建云机器

⇧+⌘+Y

Save current workspace layout as a template

⌃+⌘+S

Open folder

⌘+O

Go to workspaceworkspace switcher

⌘+P

Next workspace

⌃+⌘+\]

Previous workspace

⌃+⌘+\[

Next workspace in groupunbound by default; skips the group anchor and uses window-wide cycling when ungrouped

Previous workspace in groupunbound by default; skips the group anchor and uses window-wide cycling when ungrouped

Move workspace up

⌃+⌥+⌘+\[

Move workspace down

⌃+⌥+⌘+\]

Focus backFocus Back/Forward use Cmd+\[ and Cmd+\] outside browser panes; browser Back/Forward use the same defaults inside browser panes. Unbind Focus Back/Forward to let terminal shortcuts handle those keys.

⌘+\[

Focus forwardFocus Back/Forward use Cmd+\[ and Cmd+\] outside browser panes; browser Back/Forward use the same defaults inside browser panes. Unbind Focus Back/Forward to let terminal shortcuts handle those keys.

⌘+\]

Focus lastunbound by default; toggles between the current position and the one focus last left, so pressing it twice returns where you started

Select workspace 1…9

⌘+1…9

Rename workspace

⌘+⇧+R

Edit workspace description

⌥+⌘+E

Mark workspace as done

⌘+;

Cycle workspace status one lane forward

⌘+⇧+;

Toggle the highlighted checklist itemApplies in the focused todo pane or checklist popover.

⌘+↩

New empty workspace group

⌃+⌘+G

Group selected workspaces

⌘+⇧+G

Collapse or expand focused workspace group

⌃+⌘+.

Focus the workspace sidebar↑/↓ select workspaces; Return or Esc returns to the terminal

⌃+⌘+E

Click by hint: label the window's controlsType a label to click it, Shift+label to right-click; Esc cancels. Preview feature, off by default: turn on Click by Hint in Settings > Beta Features or from the command palette

⌘+J

Toggle right-sidebar focus

⌘+⇧+E

Navigate focused sidebar rowsIn Files, H/L collapse and expand folders. Search starts with /.

J / K/⌃+N / P/H / L

打开所选文件或切换文件夹聚焦的文件资源管理器

↩

打开所选文件或切换文件夹聚焦的文件资源管理器的 Finder 风格别名

⌘+↓

Close workspace

⌘+⇧+W

Reopen closed workspaceunbound by default

Surface

Surface 是面板内的标签页。

New surface

⌘+T

Next surface

⌘+⇧+\]

Previous surface

⌘+⇧+\[

Reorder surface left

⌥+⌘+⇧+\[

Reorder surface right

⌥+⌘+⇧+\]

Move surface to previous pane

⌃+⌘+⇧+\[

Move surface to next pane

⌃+⌘+⇧+\]

Move surface to pane on left

⌥+⌘+⇧+←

Move surface to pane on right

⌥+⌘+⇧+→

Move surface to pane above

⌥+⌘+⇧+↑

Move surface to pane below

⌥+⌘+⇧+↓

Select surface 1…9

⌃+1…9

Rename tab

⌘+R

Close tab

⌘+W

Close other tabs in pane

⌥+⌘+T

Reopen last closed

⌘+⇧+T

Toggle terminal copy mode

⌘+⇧+M

Clear screen (keep scrollback)

⌘+⇧+K

Simulator: Homefocused Simulator

⌘+⇧+H

Simulator: rotate leftfocused Simulator

⌘+←

Simulator: rotate rightfocused Simulator

⌘+→

Simulator: toggle appearancefocused Simulator

⌘+⇧+A

Simulator: toggle software keyboardfocused Simulator

⌘+K

Switch focus between terminal and TextBox input

⌘+⇧+A

Cycle TextBox submit action

⇧+Tab

Attach file to TextBox input

⌥+⌘+⇧+A

Send Ctrl-F to terminalunbound by default; forwards Ctrl-F to the focused terminal (Claude Code: invoke twice to force-stop hung background agents)

Size shared terminal to my windowwhen a terminal is shared with phones or other clients, makes this Mac's window set its grid

⌃+⌥+⌘+\=

粘贴最新的截图默认未绑定；将 macOS 截图文件夹（未更改时为桌面）中最新截图的路径插入焦点所在的终端，远程工作区会先上传文件

Save file previewfocused text preview

⌘+S

切换文件编辑器自动换行焦点所在的文件编辑器

⌥+Z

分屏面板

Focus pane left

⌥+⌘+←

Focus pane right

⌥+⌘+→

Focus pane up

⌥+⌘+↑

Focus pane down

⌥+⌘+↓

Focus previous pane (cycle)unbound by default; a Ghostty goto\_split:previous keybind also cycles panes while Focus Back does not claim the same keys

Focus next pane (cycle)unbound by default; a Ghostty goto\_split:next keybind also cycles panes while Focus Forward does not claim the same keys

Focus pane 1…9

⌃+⌘+1…9

Split right

⌘+D

Split down

⌘+⇧+D

New pane (auto layout)retiles all panes like Zellij and cmux-tui Alt-n: the right column fills to four panes before a new column opens

⌃+⌘+N

Split browser right

⌥+⌘+D

Split browser down

⌥+⌘+⇧+D

Toggle pane zoom

⌘+⇧+↩

Increase font size for every terminal in the selected workspace

⌃+⌘+\=

Decrease font size for every terminal in the selected workspace

⌃+⌘+\-

Reset font size for every terminal in the selected workspace

⌃+⌘+0

Equalize split sizes

⌃+⌘+⇧+\=

Resize pane left

⌃+⇧+H

Resize pane right

⌃+⇧+L

Resize pane up

⌃+⇧+K

Resize pane down

⌃+⇧+J

画布

一种自由的二维布局模式，窗格漂浮在可任意平移的无限画布上。对齐和分布命令可在命令面板中使用。

Toggle canvas layout

⌃+⌘+C

Reveal focused pane

⌃+⌘+R

Toggle overview zoom

⌃+⌘+O

Zoom in

⌥+⌘+\=

Zoom out

⌥+⌘+\-

Actual size

⌘+0

Tidy panes into a grid

⌃+⌘+T

浏览器

Open browser

⌘+⇧+L

Focus address bar

⌘+L

Back

⌘+\[

Forward

⌘+\]

Reload pagefocused browser

⌘+R

强制刷新页面聚焦的浏览器

⌘+⇧+R

Zoom in

⌘+\=

Zoom out

⌘+\-

Actual size

⌘+0

Markdown viewer: zoom infocused markdown viewer

⌘+\=

Markdown viewer: zoom outfocused markdown viewer

⌘+\-

Markdown viewer: actual sizefocused markdown viewer

⌘+0

Toggle browser developer tools

⌥+⌘+I

Show browser JavaScript console

⌥+⌘+C

Enter browser focus modeGives the focused web page first claim on shortcuts. Press Esc twice to exit.

⌥+⌘+↩

Toggle browser design modeSelect and visually edit elements in the focused browser

⌃+⌥+⌘+D

Toggle React Grabfocused browser, or the only browser pane when a terminal is focused

⌘+⇧+G

差异查看器

Open diff viewer

⌃+⌘+⇧+D

Scroll viewer down one smooth stepfocused diff or Markdown viewer

J

Scroll viewer up one smooth stepfocused diff or Markdown viewer

K

Scroll viewer down half a pagefocused diff or Markdown viewer

⌃+D

Scroll viewer up half a pagefocused diff or Markdown viewer

⌃+U

Scroll viewer down one smooth step (Emacs)focused diff or Markdown viewer

⌃+N

Scroll viewer up one smooth step (Emacs)focused diff or Markdown viewer

⌃+P

Scroll diff to bottomfocused diff viewer

⇧+G

Scroll diff to topfocused diff viewer

G+G

Open diff file searchfocused diff viewer

/

Jump to next diff filefocused diff viewer

\]+F

Jump to previous diff filefocused diff viewer

\[+F

Jump to next hunkfocused diff viewer

N

Jump to previous hunkfocused diff viewer

P

切换当前文件的已查看状态聚焦的差异查看器

V

查找

Find

⌘+F

Find in directory

⌘+⇧+F

Find next

⌘+G

Find previous

⌥+⌘+G

Hide find bar

⌥+⌘+⇧+F

Use selection for find

⌘+E

通知

Show notifications

⌘+I

Jump to latest unread

⌘+⇧+U

跳转到你上次向代理发送提示的界面

⌘+⇧+B

Toggle current item unread state

⌥+⌘+U

Mark current item as oldest unread and jump to the next latest unread

⌃+⌘+U

将所有通知标记为已读默认未绑定

清除所有通知默认未绑定

Flash focused panel

⌘+⇧+H

Canonical: https://cmux.com/zh-CN/docs/keyboard-shortcuts

Documentation index: https://cmux.com/llms.txt