Improvements / v2.1.283
Save MCP images to disk
CHANGELOG · original
Improved MCP tool results: images returned by MCP tools are now also saved to a file, so Bash, Read and other tools can open them Open official changelog ↗ Documentation
Documentation excerpt
Images in tool results
When an MCP tool returns a PNG, JPEG, GIF, or WebP image, Claude sees the image inline in the conversation. The inline copy may be scaled down or compressed to fit the model's image size limits. Claude Code also saves the original bytes to a file in the session's tool-results directory under ~/.claude/projects/ and gives Claude the path. Claude can then crop, convert, or reuse the full-resolution file with tools such as Bash.
If you disable session persistence with --no-session-persistence or CLAUDE_CODE_SKIP_PROMPT_HISTORY, Claude Code writes no image file and Claude receives only the inline copy.
Saving MCP image results to a file requires Claude Code v2.1.283 or later.
Documentation snapshot · 2026-11-20