Follow Discord
Sweep 06 Nov 2026 · 01:32Z Build v2.1.319 537 read Stable v2.1.311 Latest v2.1.318 Next v2.1.319 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 Bug Fixes
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
Bug FixesKind: in v2.1.310,
ImprovementsSection of the release

Unclear It is not clear whether images appear inside tmux without setting CLAUDE_CODE_FORCE_TERMINAL_IMAGES.

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.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is not clear whether images appear inside tmux without setting `CLAUDE_CODE_FORCE_TERMINAL_IMAGES`.

See this entry in the whole of v2.1.310 →

Feedback