cmuxcmux/docs

設定

cmux 從 Ghostty 設定檔讀取設定，如果你是從 Ghostty 轉過來的，會覺得很熟悉。

設定檔位置

cmux 會依序在以下位置尋找設定：

  1. ~/.config/ghostty/config
  2. ~/Library/Application Support/com.mitchellh.ghostty/config

如果設定檔不存在，請建立它：

mkdir -p ~/.config/ghostty
touch ~/.config/ghostty/config

外觀

字型

~/.config/ghostty/config
font-family = JetBrains Mono
font-size = 14

顏色

~/.config/ghostty/config
# Theme (or use individual colors below)
theme = Dracula

# Custom colors
background = #1e1e2e
foreground = #cdd6f4
cursor-color = #f5e0dc
cursor-text = #1e1e2e
selection-background = #585b70
selection-foreground = #cdd6f4

分割窗格

~/.config/ghostty/config
# Opacity for unfocused splits (0.0 to 1.0)
unfocused-split-opacity = 0.7

# Fill color for unfocused splits
unfocused-split-fill = #1e1e2e

# Divider color between splits
split-divider-color = #45475a

行為

捲動回看

~/.config/ghostty/config
# Number of lines to keep in scrollback buffer
scrollback-limit = 10000

工作目錄

~/.config/ghostty/config
# Default directory for new terminals
working-directory = ~/Projects

應用程式設定

應用程式內設定可透過 cmux > 設定（⌘,）存取：

主題模式

  • 系統：跟隨 macOS 外觀
  • 淺色：始終使用淺色模式
  • 深色：始終使用深色模式

自動化模式

控制 socket 存取層級：

  • 關閉：停用 socket 控制（最安全）
  • 僅限 cmux 程序：只允許在 cmux 終端機內啟動的程序連線
  • allowAll：允許任何本機程序連線（CMUX_SOCKET_MODE=allowAll，僅限環境變數覆寫）
在共用機器上，建議使用「關閉」或「僅限 cmux 程序」模式。

瀏覽器連結行為

在「設定 > 瀏覽器」中，cmux 提供兩個不同用途的主機列表：

  • 在內建瀏覽器中開啟的主機：適用於從終端機輸出點擊的連結。此列表中的主機會在 cmux 中開啟；其他主機會在你的預設瀏覽器中開啟。支援每行一個主機或萬用字元（例如：example.com、*.internal.example）。
  • 內建瀏覽器中允許的 HTTP 主機：僅適用於 HTTP（非 HTTPS）URL。此列表中的主機可以在 cmux 中開啟而不會出現警告提示。預設包含 localhost、127.0.0.1、::1、0.0.0.0 和 *.localtest.me。

範例設定

~/.config/ghostty/config
# Font
font-family = SF Mono
font-size = 13

# Colors
theme = One Dark

# Scrollback
scrollback-limit = 50000

# Splits
unfocused-split-opacity = 0.85
split-divider-color = #3e4451

# Working directory
working-directory = ~/code