Claude Code でよく出るエラー5選と即解決策
Claude Code 開発中によく遭遇するエラー5種類を原因と解決策のセットで解説。Permission denied・レート制限・MCP接続・コンテキスト超過など、詰まりがちなポイントを実体験をもとに整理しました。
Claude API の stop_sequences が効かないときに確認すべき5つのポイント
Claude API の stop_sequences パラメータが期待通りに止まらない問題の原因を、トークン境界・空白・Tool Use・ストリーミングの観点から実例コード付きで切り分ける手順をまとめました。
Cowork スケジュールタスクが黙って止まる理由と、自動で立ち直る仕組みの作り方
Coworkのスケジュールタスクが黙って止まる原因を、実測した終了コードとエラー文で切り分けます。safe.directory が失敗を遅らせる仕組み、書ける場所を先に決めるプリフライト、理由コード付きログまで扱います。
Claude Code が途中で止まる・フリーズする問題の完全診断ガイド
Claude Codeが途中で止まる・フリーズする問題を症状別に診断。コンテキスト枯渇・サブエージェント無応答・無限ループなど主要な原因と即効対処法を網羅した実践ガイド。
Claude Code の Edit ツールで「old_string is not unique」エラーを止める実践的な書き換え戦略
Claude Code の Edit ツールで「old_string is not unique」が頻発するのは、編集ターゲットの一意性をプロンプト側で保証していないことが根本原因です。再発を防ぐ書き換え戦略を解説します。
Claude API のリトライを書いたらレート制限が悪化した話 — Retry-After を読まないリトライの罠
Claude API でリトライを実装したのに 429 エラーがむしろ増えた、という相談をよく受けます。原因のほとんどは Retry-After ヘッダーの無視と、ジッターのない指数バックオフです。診断と修正手順をまとめました。
Claude にメッセージが送れないときの原因切り分け — 5分で本当の原因にたどり着く手順
Claudeにメッセージを送信できない、送信ボタンが無反応、送信後に消える等の現象を、頻度の高い順に切り分けて原因にたどり着く手順をまとめました。
Claude API の『messages.X.role must alternate』を1分で直す — 400 invalid_request_error の典型パターン
Claude API で頻発する『messages.X.role must alternate』エラーの原因と直し方を、user/assistant の交互ルール・tool_use と tool_result の対応関係・履歴管理の落とし穴に分けて、実例コード付きで整理します。
Claude Code が .gitignore のファイルを検索しない理由と、必要なときに見つける方法
.env.example や dist/ が Claude Code の Glob/Grep に引っかからないとき、原因は .gitignore です。挙動の理由と、Read ツール・--no-ignore・一時的な除外解除の3つの突破口を具体的に解説します。
「The requested model does not exist」が消えない理由 — Claude API モデル名と権限の落とし穴
Claude API の model_not_found エラーは、9割が綴りや古いエイリアスの残存で発生します。2026年4月時点の正しいモデルIDと、権限・地域の切り分け手順を整理します。
Claude API のプロンプトキャッシュがヒットしない時の診断手順
Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。
Claude の Web 検索が動かないときに見直したい7つのチェックポイント
Claude の Web 検索が反応しない・古い情報しか返らない・特定サイトを取得できない、といった症状を実例ベースで一つずつ切り分けます。