Skip to content
← Back to release · 2.1.310
Improvements / v2.1.310

Fix mod images in tmux

CHANGELOG · original

Improved a mod's Image to draw inside tmux with allow-passthrough and focus-events on, in kitty, Ghostty, and iTerm2 3.5+ with fullscreen rendering, where it showed only its alt text
Open official changelog ↗

Documentation

Documentation excerpt

Configure tmux

When Claude Code runs inside tmux, by default Shift+Enter submits instead of inserting a newline, and desktop notifications don't reach the outer terminal. Add these lines to ~/.tmux.conf, then run tmux source-file ~/.tmux.conf to apply them to the running server:

set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

To use Shift+Enter, keep the last two lines, then detach from tmux, attach again, and restart Claude Code. To send notifications from a visible pane to Ghostty, Kitty, or iTerm2, keep the allow-passthrough line and restart Claude Code. With this sample, a pane in a window you aren't viewing sends none. Before v2.1.326 or inside tmux older than 3.3, which has no allow-passthrough, set preferredNotifChannel to "iterm2", "kitty", or "ghostty".

A mod's Image needs the allow-passthrough and focus-events lines, along with the other requirements for drawing inside tmux. After you add the lines, also detach from tmux, attach again, and restart Claude Code.

Documentation snapshot · 2026-11-20

Change details