Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Readツールが画像処理に失敗した際に、過大なサイズの画像をコンテキストに格納してしまう問題を修正しました。この問題により、画像が多いセッションで後続のターンが壊れることがありました。

原文（英語） ​

Fixed the Read tool putting oversized images into context when image processing failed, breaking subsequent turns in long image-heavy sessions

概要 ​

Readツールで画像ファイルを読み込む際、画像の処理（リサイズや最適化）に失敗した場合に、元の過大なサイズの画像データがそのままコンテキストに追加されてしまうバグが修正されました。特に多数の画像を扱う長時間セッションにおいて、コンテキストがオーバーフローし、後続の操作が失敗する原因となっていました。修正後は処理失敗時に適切なエラーハンドリングが行われ、セッションの安定性が向上します。

基本的な使い方 ​

この修正はReadツールに自動的に適用されます。画像ファイルの読み込み時に処理が失敗した場合でも、セッションの継続が可能になります。

bash
# 画像ファイルを含むプロジェクトでの作業
> このスクリーンショット画像を読んで内容を説明してください

# 処理失敗時も適切にエラーハンドリングされ、セッションが継続できる

実践例 ​

多数の画像を含むドキュメント解析 ​

大量の画像ファイルを含むプロジェクトを継続的に解析する場合。

bash
# スクリーンショットや図表を多く含むプロジェクト
> docs/screenshots/ フォルダ内の全てのスクリーンショットを解析して、UIの変更点をまとめてください

# 以前: 一部の画像処理が失敗すると、過大な画像データでコンテキストが溢れ、後続のメッセージが失敗した
# 修正後: 処理失敗時にエラーが適切に処理され、セッションが継続できる

デザインレビューセッション ​

多数のデザインファイルやモックアップを確認する場合。

bash
# 複数のデザイン画像を順番に確認
> design-v1.png を読んでレビューしてください
> design-v2.png と比較して変更点を指摘してください
> design-v3.png の最終版を確認してください

# 長いセッションでも安定して動作するようになった

コードと画像の混在したセッション ​

コードファイルと画像ファイルを交互に扱う複合的なセッション。

bash
# コードと図を交互に参照しながら作業
> architecture.png のアーキテクチャ図を読んでください
> src/main.ts のコードと図を照らし合わせて、実装の問題点を指摘してください
> updated-architecture.png の新しい図に基づいてコードを更新してください

注意点 ​

  • この修正はv2.1.71以降で自動的に適用されます。
  • 非常に大きな画像ファイル（数十MB以上）は処理に時間がかかる場合があります。
  • 画像処理が失敗した場合、エラーメッセージが表示されますが、セッション自体は継続できます。
  • コンテキストウィンドウには依然として容量制限があるため、過度に多くの画像を扱う場合は注意が必要です。
  • サポートされる画像フォーマット（PNG、JPEG、GIF、WebPなど）であれば正常に処理されます。

関連情報 ​