Follow Discord
Sweep 23 Oct 2026 · 21:48Z Build v2.1.310 529 read Stable v2.1.308 Latest v2.1.309 Next v2.1.310 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.310 ·

Inline terminal images inside tmux

Claude Code now checks tmux itself to decide whether kitty or iTerm2 images can show, keeps them in place, and explains how to fix it when they can't

Group of 4 You'll notice Improvements
JSON All of v2.1.310
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
Terminal ImagesArea: what it touches
ImprovementsKind: in v2.1.310,
ImprovementsSection of the release

What

tmux is a terminal multiplexer, a program that splits one terminal window into panes. Some terminals, such as kitty and iTerm2, can show images inline. Claude Code's handling of these images inside tmux was reworked:

  • At startup, Claude Code asks tmux itself for facts about the pane (whether passthrough is allowed, focus events, pane position) and answers the kitty and iTerm2 image questions from that, logged as tmux images: passthrough .... It no longer runs tmux display-message -p #{client_termtype} there.
  • Image detection now has a separate tmux input, true when TMUX is set and STY is not, so tmux is no longer treated like screen. Inside tmux, image support defaults to off, with the reason "env: inside tmux, where the terminal cannot be asked whether it reads files". CLAUDE_CODE_FORCE_TERMINAL_IMAGES still overrides this. Screen is now labelled "env: inside screen".
  • When TMUX is set, images are present, tmux passthrough is not 'off' and kitty or iTerm2 support is detected, Claude Code tracks where the pane sits and re-sends or redraws images when the pane moves, the terminal regains focus or the window is resized. Sync markers are skipped in that case.
  • Image escape codes are wrapped for tmux passthrough, and large iTerm2 images are split into MultipartFile and FilePart chunks.
  • New diagnostic code queries tmux for client_termtype, allow-passthrough, focus-events and other pane fields and produces fix messages such as "images inside tmux need tmux 3.3 or later with allow-passthrough and focus-events on" and "tmux does not know which terminal is outside it, so Claude Code draws no images here". No caller for it was seen.
  • A denial for tmux passthrough now comes with a "tmux-passthrough" fix tag.

Why

Inline images inside tmux are decided differently, so they may now show where they did not before, or stop showing. Where they cannot show, there is now a specific explanation of what to change in tmux.

See this entry in the whole of v2.1.310 →

Feedback