[Ghostty] SSH&tmux時に "missing or unsuitable terminal: xterm-ghostty" と表示される事象の解決

検証環境

• ローカル
  • OS: macOS Tahoe 26.3
• リモート
  • OS: Ubuntu 22.04.5 LTS

解決方法

ローカルにて以下の設定を行った後、SSH 先のリモートにて tmux を実行する

~/.config/ghostty/config

• shell-integration-features = ssh-terminfo,ssh-env を追記する
• Ghostty のアプリケーションを再起動する (必須)

~/.ssh/config

• SetEnv TERM=xterm-256color は記載しない (上記の追記の意図に反する)

参考文献

• https://ghostty.org/docs/help/terminfo#ssh