Claude CodeでOpus 4.8のツール呼び出しが失敗する不具合と回避策(2026年6月時点)
今回は、Claude Codeで2026年5月末ごろから報告されている、Opus 4.8でのツール呼び出しが失敗する不具合について、現時点で分かってい る症状と回避策を、GitHubの報告ベースで簡潔に整理します。なお、この記事の作成にあたり、情報収集にはAIを使用しています。
なお、この記事では根本解決に至る方法は掲載していません。根本解決を期待されている方は別の情報をお探しください。
あくまで2026年6月初旬時点の情報であり、後述のとおり一時的な不具合と見られるため、お読みのタイミングではすでに解消している可能性があります。お使いのバージョンと最新の状況をあわせてご確認ください。
何が起きているのか
Opus 4.8がモデルとして使われているとき、ツール呼び出しの出力が壊れ、Claude Code側で解釈できずに失敗するケースが報告されています。anthropics/claude-codeリポジトリには、関連する不具合が複数登録されています(いずれも本記事執筆時点でOPEN)。
Issue | 報告されている症状 |
ツール呼び出しがパースできず「The model's tool call could not be parsed」になる | |
不正な形式のtool_useが繰り返し出力され、応答全体が破棄される(4.7では正常) | |
ツール実行後に応答が表示されず、利用枠(quota)だけが消費される | |
ツールを実行していな いのに、実行したかのような出力を生成する |
共通するのは、モデルが出力したツール呼び出しの開始部分が壊れた形になり(先頭に無関係なトークンが混じる、開始タグの一部が欠落するなど)、パーサーが解釈できずに失敗する、という点です。失敗してもモデル自身は気づかないことが多く、リトライを重ねても収束しないという報告もあります(#63604)。
どんな条件で起きやすいか
報告を見るかぎり、特定の条件下で発生しやすい傾向があります。
会話のターンが長く積み重なった、コンテキストの大きい状態
ツールの引数に非ASCII文字(日本語など)、引用符、コード、エスケープなどが多く含まれるとき
日本語を多用する環境では引数に非ASCII文字が入りやすいため、相対的に踏みやすいと考えられます。一方で、特定のOSだけで起きる性質ではないようです。報告環境はWindows・WSL・macOS・Linuxにまたがっており(macOSでの報告として#64076など)、OSを変えれば避けられるというものではありません。
私のmacOSでのClaudeデスクトップアプリ環境でも発生しています。
この不具合がやっかいなのは、失敗が見えにくい点です。ツール呼び出しと同じ応答に含まれるテキストごと破棄されるため、画面上は「何も返ってこない」状態になります(#64129)。それでいて処理自体は走っているため、利用枠(quota)は消費されます。つまり、成果が得られないまま消費だけが進む、という状況になりがちです。
回避策
現時点で確実なのは、モデルをOpus 4.7に切り替えることです。同一環境でOpus 4.7に戻すと正常に戻った、という報 告が複数あります(#63604ほか)。Claude Code内では /model でモデルを切り替えられます。急ぎの作業を止めたくない場合は、これが最も確実です。
そのうえで、誘発条件(長いコンテキスト・大きな引数)から考えて妥当な緩和策がいくつかあります。これらは報告で裏付けられた根本解決ではなく、発生条件を踏まえた対処療法的な一時凌ぎでしかありませんが。
コンテキストが大きくなったら
/compactや/clearでこまめに整理する大きなタスクは分割し、1セッションあたりの文脈を小さく保つ
壊れ始めたら
/rewindで直前の正常な状態に戻す重要な制約はCLAUDE.mdに書いておき、セッションをまたいでも失われないようにする
コンテキスト管理そのものの考え方は別記事で整理しているので、あわせて参考にしてください。
これはおそらく、一時的な問題
これは特定のモデルとバージョンの組み合わせで起きる回帰的な問題であり、Claude Code自体はポイントリリースが頻繁に出ています(本記事執筆時点の最新は2.1.163で、数日のうちに小刻みな更新が重ねられています)。この種の不具合は、いずれかの更新で解消される見込みが高い一時的な事象です。
本記事執筆時点(2026年6月初旬)では、CHANGELOGに該当する修正は確認できず、関連Issueも未解決のままです。ただ、お読みのタイミングではすでに直っている可能性があります。まずは最新バージョンへの更新と、上記Issueの状態をご確認いただくのが確実です。モデルを4.7に固定するといった対応も、解消が確 認できるまでの暫定的な措置と捉えておくのがよいと考えます。
まとめ
今回の不具合について押さえておきたいポイントは次の4つです。
Opus 4.8でツール呼び出しがパースに失敗し、応答が破棄される不具合が複数報告されている(本記事執筆時点でいずれもOPEN)
長いコンテキストや、非ASCII文字を含む大きな引数で起きやすく、OSを問わず発生する
応答が表示されないまま利用枠だけが消費されるため、気づきにくい
確実な回避はOpus 4.7への切り替え。ただしいずれ修正される見込みの一時的な事象なので、最新バージョンと状況の確認を優先する
新しいモデルが既存の運用を一時的に不安定にすることは起こり得ます。慌てて設定を作り込むよりも、安定したモデル世代へ退避しつつ状況を見る、という構えが現実的だと考えます。




