WezTerm 설정

MobaXterm처럼 SSH 연결과 세션을 빠르게 전환할 수 있도록 구성한 개인 WezTerm 설정입니다. Windows 사용을 중심으로 하며, 탭/패인 관리, SSH 도메인, 대화형 설정 메뉴와 GPU 가속 렌더링을 한 파일에 담고 있습니다.

현재 상태

현재 홈 디렉터리의 ~/.wezterm.lua는 저장소 버전보다 이전 상태입니다. 저장소 버전에는 다음 변경이 더 포함되어 있습니다.

저장소의 wezterm.lua를 사용자 홈의 .wezterm.lua로 복사합니다.

Copy-Item .\wezterm.lua $HOME\.wezterm.lua

cp wezterm.lua ~/.wezterm.lua

기본 폰트인 JetBrains Mono와 Noto Sans KR을 설치한 뒤 WezTerm을 완전히 종료하고 다시 실행합니다. 설정 오류는 다음 명령으로 확인할 수 있습니다.

wezterm show-config

WezTerm을 시작하면 메인 메뉴가 열립니다. 등록된 SSH 도메인에 연결하거나 설정 메뉴로 들어갈 수 있습니다. 메뉴를 닫은 뒤에는 Leader+m으로 다시 열 수 있습니다.

설정 메뉴에서 다음 항목을 직접 변경할 수 있습니다.

메뉴에서 바꾼 값은 실행 중인 설정 파일에 기록되고 설정이 다시 로드됩니다. SSH 도메인을 추가하거나 수정한 경우 WezTerm 프로세스를 완전히 종료한 뒤 다시 실행해야 합니다.

Leader 키는 Ctrl+a이며, 다음 키를 1초 안에 이어서 누릅니다.

마우스 동작은 다음과 같습니다.

현재 첫 번째 SSH 도메인은 시작 시 자동 연결됩니다.

config.ssh_domains = {
  {
    name = "du5t",
    remote_address = "172.30.1.41:228",
    username = "gm",
    multiplexing = "None",
  },
}

다른 환경에서 사용할 때는 주소와 사용자명을 바꾸거나 해당 항목을 제거합니다. 접속 정보가 포함되어 있으므로 저장소 공개 범위를 변경하기 전에 내용을 확인해야 합니다.

Unix mux 세션을 사용하려면 먼저 서버를 실행합니다.

wezterm-mux-server --daemonize

자주 실행하는 명령은 config.launch_menu에 추가합니다.

config.launch_menu = {
  { label = "Local bash", args = { "bash", "-l" } },
  { label = "htop", args = { "htop" } },
}

WebGPU에서 문제가 생기면 다음 값을 OpenGL 또는 Software로 변경합니다.

config.front_end = "WebGpu"

새 탭과 분할 패인이 현재 작업 디렉터리를 이어받게 하려면 사용하는 셸에 WezTerm shell integration을 설정해야 합니다.