【Claude Codeエラー】invokeタグが文字化けで止まる|タグ崩れの直し方

Claude Codeで作業中に、突如として画面に<invoke>function_callsといったタグがそのまま表示され、AIが期待した動作をしない現象に遭遇していませんか?「自分の命令の仕方が悪かったのか」「設定を壊してしまったのか」と不安になるかもしれませんが、安心してください。

この現象は、現在Claude Codeを利用している多くのユーザーが直面している「タグ崩れ」と呼ばれる既知の不具合です。本記事では、このタグ崩れ現象の正体と、今すぐできる復旧手順、そして再発を防ぐための運用ルールを詳しく解説します。

文字化け現象の正体

invoke等の症状

Claude Codeを利用していると、本来はAIの内部で実行されるはずの指示(ツール呼び出し)が、処理されずに画面上へそのままテキストとして出力されることがあります。具体的には、以下のような症状が報告されています。

  • 画面に<invoke><parameter><function_calls>というタグが文字として表示される
  • 先頭にcourtcallといった謎の文字列が突如現れる
  • 「The model's tool call could not be parsed(モデルのツール呼び出しを解析できませんでした)」というエラーメッセージと共に停止する
  • 「Your tool call was malformed and could not be parsed(ツール呼び出しが不正であり、解析できませんでした)」と表示され、操作が受け付けられない

これらの文字列は、本来Claude Codeが裏側で「ファイルを読む」「コマンドを実行する」といった動作をするための制御命令です。それが何らかの理由で表に出てきてしまっている状態です。

実際の画面例

言葉だけでは分かりにくいので、実際の画面例を見てみましょう。本来は裏側で実行されるはずのコマンドが、次のように「ただの文字」として画面に出力されてしまいます。

court
<invoke name="Bash">
<parameter name="command">npm run build</parameter>
</invoke>

この例には、タグ崩れの典型的な「3つのサイン」が表れています。

  • 先頭の謎の文字:本来あるはずのない callcourt といった文字が、命令の直前に紛れ込む
  • 接頭辞の欠落:正規のタグに付くはずの接頭辞が抜け落ち、<invoke> が裸のまま出てくる
  • 囲みタグの消失:全体を囲むはずの <function_calls> が無く、中身だけがむき出しになる

そして最大の特徴は、AIは「完了しました」と話を続けているのに、実際にはコマンドが一つも実行されていないことです。ファイルは書き換わらず、画面には制御用の文字列だけが残り、その応答が途中で終わってしまいます。「やったと言っているのに、何も反映されていない」——これがタグ崩れに遭遇したときの、実際の体験です。

既知の不具合と安全性

まず強調したいのは、これはあなたのプロンプト(指示)の出し方が悪かったり、環境を壊してしまったりしたわけではないということです。

この現象は、2026年5月末ごろから報告が急増しており、特にOpus 4.x系などの特定のモデルにおいて発生しやすいことが判明している既知の不具合です。GitHub上のIssue(不具合報告)を確認すると、#64690#66153#63870#68354#60584#63580など、数多くのスレッドで同様の症状が議論されています。

重要な安心材料として、この現象は「fail-closed(安全側に倒れる)」設計に基づいています。壊れたタグは「不正な形式」としてシステム側で自動的にブロックされるため、このエラーによってあなたのPC内の大切なファイルが勝手に書き換わったり、サーバーのデータが破損したりすることはありません。単にそのターンの処理が失敗し、AIの「心の声(制御用テキスト)」が漏れ出てしまっただけだと考えてください。

関連記事:Claude Codeの階層設計|CLAUDE.mdで指示を無視させない環境構築

 

文字化けが発生する原因

タグの破損と出力

Claude Codeは、AnthropicのAIモデルが「ツール(ファイル操作や検索など)」を使う際、XMLと呼ばれる構造化されたデータ形式で命令を出します。しかし、モデルの応答が不安定になると、このXMLの開始タグと終了タグの対応が崩れたり、途中に余計な文字が混じったりします。システム側がこれを「正しい命令」として認識できなくなると、処理を実行せずにそのままテキストとして画面に表示してしまうのです。

チャット履歴の汚染

この不具合の最も厄介な点は、一度タグ崩れが発生すると、同じチャットセッション内で何度も繰り返す傾向があることです。これは「self-poisoning(自己汚染)」と呼ばれる現象で(Issue #62407)、AIが過去の自分の「壊れた出力」をコンテキスト(文脈)として読み込み、それを模倣してしまうために起こります。チャット履歴が長くなればなるほど、この汚染のリスクは高まります。

フリーズの原因

また、タグが出るだけでなく「5分〜20分経っても反応がない」「プログレスバーが動いたまま固まる」という症状も、根底にある原因は同じです。長すぎるセッションや複雑な指示によって、HTTP通信の読み取りタイムアウトが発生しやすくなっており、AI側が正しいタグを生成できずに沈黙してしまっている状態です。

関連記事:Claude CodeのResume完全ガイド|作業再開とセッション管理術

図解:なぜ“ただの文字”になってしまうのか

その場で直す手順

エラーが発生して作業が止まってしまった場合は、以下のステップを上から順に試してください。

最新版への更新

まずは、現在使用しているClaude Codeを最新バージョンにアップデートしてください。開発チームはこのタグ崩れ問題を深刻に受け止めており、モデルのサンプリングパラメータの調整や、パース(解析)ロジックの改善を順次リリースしています。

公式サイトで案内されている最新の更新用コマンドを実行してください。アップデートするだけで、Opus 4.x系での発生頻度が劇的に下がったという報告もあります。

履歴の巻き戻しと削除

タグ崩れが起きた際、最も重要な鉄則は「壊れたまま続行しない」ことです。

  1. /rewind コマンドを使用する
    タグが崩れる直前の正常な状態まで履歴を巻き戻します。これにより、AIの記憶から「壊れた履歴」を消去できます。ただし、リトライは最大2回までに留めてください。2回やり直しても同じ場所でタグが崩れる場合、その指示内容や現在の履歴の長さに根本的な原因があるため、何度繰り返しても成功率は上がりません。
  2. /clear または新規チャット
    巻き戻しても直らない場合は、/clear コマンドで現在のセッションをリセットするか、一度ターミナルを終了して新しいチャットを開始してください。自己汚染を断ち切るには、これが最も確実な方法です。

指示の分割と短縮

一度に「10個のファイルを修正して、テストを実行し、ドキュメントも更新して」といった複雑な指示を出すと、生成されるXMLタグが長大になり、エラーの確率が跳ね上がります。

また、サンプリングパラメータ等の設定(詳細は公式サイトでご確認ください)を調整しすぎないことも重要です。思考時間を増やすために特定の設定を有効にしている場合、モデルがより複雑な推論を行おうとして、結果的に出力されるタグの構造が破綻しやすくなるケースが報告されています。通常はデフォルトの設定で使用し、指示をステップバイステップに細分化することで、タグ崩れを回避できます。

 

再発を減らす予防策

不具合が完全に修正されるまでの間、以下の運用ルールを守ることで、ストレスなくClaude Codeを使い続けることができます。

チャットの使い分け

Claude Codeの強力な機能ゆえに、ついつい1つのチャットでダラダラと作業を続けてしまいがちですが、これが「自己汚染」の温床です。「リファクタリングが終わった」「1つの機能実装が完了した」という区切りごとに、積極的に新しいセッションへ移行しましょう。1タスク1チャットの原則を守るだけで、タグ崩れの遭遇率は大幅に低下します。

図解:再発を減らす予防策

環境設定の確認

今回解説した「タグが文字として出る」現象ではなく、そもそもツールが立ち上がらない、あるいは別のエラーが出る場合は、インフラ側の設定に原因があるかもしれません。特に以下の3点は切り分けが必要です。

  • Node.jsのバージョン: 古いNode.js(LTS未満)を使用していると、通信周りで予期せぬ挙動をすることがあります。
  • 認証・APIキー: Anthropic Consoleでの課金設定が切れていないか、有効なAPIキーがセットされているか確認してください。
  • 権限の問題: 実行ディレクトリへの書き込み権限がない場合、ツール呼び出し自体が失敗します。

これらの「タグ崩れ以外の問題」については、以下の内部リンクから詳細な解決ガイドを参照してください。

図解:環境・設定が原因で「動かない」ときは

まとめ

本記事では、Claude Codeで発生する「invokeタグの文字化け・タグ崩れ」について解説しました。

  • この現象は2026年5月末ごろからOpus 4.x系で多く見られる既知の不具合。
  • ユーザーのミスではなく、データ破壊の心配もない。
  • 復旧には最新版への更新と、/rewindリトライは2回まで)が有効。
  • 予防策として、サンプリングパラメータ設定を調整しすぎないことや、こまめなセッションリセットが推奨される。

Claude Codeは非常に強力なツールですが、まだベータ版に近い側面を持っています。エラーの正体を正しく理解し、適切な対処法を身につけることで、次世代のAI開発体験を最大限に活用していきましょう。もし改善しない場合は、迷わず新しいチャットで仕切り直すのが、最も生産的な解決策です。

無料ニュースレター
AIの大事な変化を、見逃さない。

海外の最新AIニュースも、公式発表から日本語に要約してお届け。
「毎日忙しいけど、AIの最先端は知っておきたい」——そんな人のための1通です。

無料で読みはじめる → 🎁読者限定|AI活用ガイド進呈
運営:AIエージェント専門メディア編集部|登録無料・いつでも解除可能
AIニュースを読む様子