APIキーを誤って git commit してしまった時の緊急対応手順 — Claude Code を使った履歴削除とキーローテーション
.envのAPIキーを誤ってgit commitしてしまったときの緊急対応手順です。最初の5分で行うキーのローテーション、被害範囲の確認、git履歴からの完全削除、GitHubのシークレットスキャンニングアラートの解除、.gitignore整備を含む再発防止までClaude Codeを使って実践的に解説します。
何度直しても同じ間違いをするClaudeへの対処法 — 「指摘しても治らない」の正体と根本解決策
何度指摘してもClaudeが同じ間違いを繰り返すのは、会話の流れの中で修正指示が薄れていくためです。一時的な修正と永続的な修正の違いを整理し、即効性のある対処法3つと、Claude Projectsやプロフィール設定を使って根本的に直す方法を具体例とともに紹介します。
Claude Code MCP 接続トラブル完全診断ガイド
Claude Code の MCP サーバーが繋がらない・途中で切れる・ツールが見つからない問題を根本から診断する。設定ファイルの構造から通信ログの読み方、よくある落とし穴まで、実際のエラーパターンをもとに体系的に解説します。
Claude Code でよく出るエラー5選と即解決策
Claude Code 開発中によく遭遇するエラー5種類を原因と解決策のセットで解説。Permission denied・レート制限・MCP接続・コンテキスト超過など、詰まりがちなポイントを実体験をもとに整理しました。
Claude API の stop_sequences が効かないときに確認すべき5つのポイント
Claude API の stop_sequences パラメータが期待通りに止まらない問題の原因を、トークン境界・空白・Tool Use・ストリーミングの観点から実例コード付きで切り分ける手順をまとめました。
Claude Code が途中で止まる・フリーズする問題の完全診断ガイド
作業を任せていたClaude Codeがぴたりと止まったとき、中断すべきか待つべきかは症状で判断できます。最多ケースのコンテキストバジェット枯渇、ツールやサブエージェントの無応答、無限ループとタスク放棄という原因カテゴリ別に、見分け方と即効性のある対処法を整理しました。
Claude API のリトライを書いたらレート制限が悪化した話 — Retry-After を読まないリトライの罠
Claude API でリトライを実装したのに 429 エラーがむしろ増えた、という相談をよく受けます。原因のほとんどは Retry-After ヘッダーの無視と、ジッターのない指数バックオフです。診断と修正手順をまとめました。
Claude にメッセージが送れないときの原因切り分け — 5分で本当の原因にたどり着く手順
Claudeにメッセージが送れない、送信ボタンが無反応、送信後に消えるといった現象の切り分け手順を頻度の高い順にまとめました。Anthropic側の障害を30秒で確認する方法、体感9割を占めるブラウザ拡張機能の干渉、プロキシやVPN、プラン上限、コンテキスト満杯まで順に確認します。
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エラーは、多くがモデルIDの綴りや古いエイリアスの残存で起きます。2026年4月時点で実在するモデルIDの一覧、Tier・地域・権限の3分チェック、Sonnet 4.6への安全な移行手順、ログから切り分ける診断スニペットまで順に整理しました。
Claude API のプロンプトキャッシュがヒットしない時の診断手順
Claude API のプロンプトキャッシュが効いていない時、まず確認すべきは usage フィールドです。cache_read_input_tokens がゼロのまま増えない原因を、5つの典型パターンに沿って切り分けます。