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 외관 따르기
  • 라이트: 항상 라이트 모드
  • 다크: 항상 다크 모드

자동화 모드

소켓 접근 수준 제어:

  • 끄기: 소켓 제어 없음 (가장 안전)
  • 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