TAG

troubleshooting

61 記事

Claude Code 開発中によく遭遇するエラー5種類を原因と解決策のセットで解説。Permission denied・レート制限・MCP接続・コンテキスト超過など、詰まりがちなポイントを実体験をもとに整理しました。

Claude API の stop_sequences パラメータが期待通りに止まらない問題の原因を、トークン境界・空白・Tool Use・ストリーミングの観点から実例コード付きで切り分ける手順をまとめました。

Coworkのスケジュールタスクが黙って止まる原因を、実測した終了コードとエラー文で切り分けます。safe.directory が失敗を遅らせる仕組み、書ける場所を先に決めるプリフライト、理由コード付きログまで扱います。

作業を任せていたClaude Codeがぴたりと止まったとき、中断すべきか待つべきかは症状で判断できます。最多ケースのコンテキストバジェット枯渇、ツールやサブエージェントの無応答、無限ループとタスク放棄という原因カテゴリ別に、見分け方と即効性のある対処法を整理しました。

Claude Code の Edit ツールで「old_string is not unique」が頻発するのは、編集ターゲットの一意性をプロンプト側で保証していないことが根本原因です。再発を防ぐ書き換え戦略を解説します。

Claude API でリトライを実装したのに 429 エラーがむしろ増えた、という相談をよく受けます。原因のほとんどは Retry-After ヘッダーの無視と、ジッターのない指数バックオフです。診断と修正手順をまとめました。

Claudeにメッセージが送れない、送信ボタンが無反応、送信後に消えるといった現象の切り分け手順を頻度の高い順にまとめました。Anthropic側の障害を30秒で確認する方法、体感9割を占めるブラウザ拡張機能の干渉、プロキシやVPN、プラン上限、コンテキスト満杯まで順に確認します。

Claude API で頻発する『messages.X.role must alternate』エラーの原因と直し方を、user/assistant の交互ルール・tool_use と tool_result の対応関係・履歴管理の落とし穴に分けて、実例コード付きで整理します。

.env.example や dist/ が Claude Code の Glob/Grep に引っかからないとき、原因は .gitignore です。挙動の理由と、Read ツール・--no-ignore・一時的な除外解除の3つの突破口を具体的に解説します。

Claude APIのmodel_not_foundエラーは、多くがモデルIDの綴りや古いエイリアスの残存で起きます。2026年4月時点で実在するモデルIDの一覧、Tier・地域・権限の3分チェック、Sonnet 4.6への安全な移行手順、ログから切り分ける診断スニペットまで順に整理しました。

Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。

ClaudeのWeb検索が反応しない・古い情報しか返らないときに見直したい7つのチェックポイントを実例ベースで解説します。モデルの対応状況とトグル設定、検索を促すプロンプトの書き方、レート制限、取得先サイトのrobots.txt、検索が実際に走ったかを確かめるコツまで扱います。