9 articles
MCPサーバーのoutputSchemaがJSON Schema draft-07を宣言していると、Claude Desktop/Coworkの2020-12専用バリデータがツールを全て拒否する。CLIで再現しない理由と、GitHub Issue #86142の検証結果に基づくサーバー側の直し方・クライアント側の回避スクリプトまで整理した。
Claude Codeで一度は遭遇する「API Error: 400」。公式のエラーリファレンスとGitHub Issueの実例を照らし合わせ、cache_control・tool_use不整合・拡張思考の設定ミスなど原因別の見分け方と対処法を整理した。
settings.jsonは構文エラーが1つあるだけでファイル全体が丸ごとスキップされる。過去に報告された7件のGitHub Issueと公式ドキュメントの現在の挙動を照らし合わせ、症状別の原因切り分けと確認手順をまとめた。
output styleを設定したのに反映されない、`/output-style`コマンドが見当たらない、カスタムスタイルを作ったらコーディング規約ごと消えた——といった症状を、公式ドキュメントと未修正のGitHub Issue実例から原因別に整理。Concise styleの追加(v2.1.237)まで含めて2026年8月時点の状況をまとめた。
Claude Code Skillsが「一覧に出てこない」「発火しない」「descriptionが消える」「disable-model-invocationで手動呼び出しまで拒否される」等の原因を症状別に整理。未修正のGitHub Issueと公式トラブルシューティングを突き合わせた自己診断表つき。
Claude Codeの「Prompt is too long」エラーの原因と復旧手順を解説。200kトークン制限との違い、「usage limit reached」への誤表示問題、MCPツール肥大化などの原因別チェックリスト、GitHub Issue実例つきでまとめた。
Claude Codeのauto-compactが100%に達しても発動しない、サードパーティAPI経由だと止まる、長時間セッションで固まる——症状別に公式changelogとGitHub Issueの一次情報から原因を特定し、アップデート・手動/compact・ダウングレードまで対処法をまとめた。
Claude Codeで「Connection closed mid-response」と表示されるのに応答自体は完了しているケースをv2.1.222の修正内容から解説。同時期に直った紛らわしい表示バグ(ストリームタイムアウト誤発火・部分出力の破棄・ターミナルフリーズ・描画停止)を整理し、本当に落ちているかの見分け方と対処法をまとめた。
Claude Codeの「process exited with code 1/3/127/137」エラーを原因別に整理。認証競合・Windows特有のクラッシュ・OOM・新設定sandbox.network.strictAllowlistまで、切り分け手順つきで解説する。