# 鍵盤快捷鍵

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-TW/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-TW/docs/keyboard-shortcuts#app)·[工作區](https://cmux.com/zh-TW/docs/keyboard-shortcuts#workspaces)·[Surface](https://cmux.com/zh-TW/docs/keyboard-shortcuts#surfaces)·[分割窗格](https://cmux.com/zh-TW/docs/keyboard-shortcuts#split-panes)·[畫布](https://cmux.com/zh-TW/docs/keyboard-shortcuts#canvas)·[瀏覽器](https://cmux.com/zh-TW/docs/keyboard-shortcuts#browser)·[差異檢視器](https://cmux.com/zh-TW/docs/keyboard-shortcuts#diff-viewer)·[搜尋](https://cmux.com/zh-TW/docs/keyboard-shortcuts#find)·[通知](https://cmux.com/zh-TW/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-TW/docs/keyboard-shortcuts

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