すべての記事
Claude エージェントに長期記憶を持たせる本番設計 — 7つの落とし穴と対策パターン
Claude エージェントに長期記憶を組み込んで本番運用するときに、多くの実装が踏み抜く7つの落とし穴を、書き込み設計・PII 対策・スコープ分離・破損検知・コスト制御・移行計画までの設計パターンとして体系化した本番向けプレミアムガイドです。
Claude Code エラー完全対処辞典 — 認証・決済・応答停止・ツール失敗を症状から逆引きする
Claude Code で実際に遭遇する 40 超のエラーパターンを、症状 → 原因 → 復旧手順の順で整理した実務向けハンドブックです。認証・決済・応答停止・ツール失敗・MCP・Hook まで、根本原因まで追える資料として活用いただけます。
Claude Code Hooks の本番デバッグ術 — ログが足りない時、どこから切り分けるか
ローカルでは動くのに本番で沈黙するClaude Code Hooksの切り分け方を体系化しました。まず疑うべきは出力先という視点、ログ不足を補う3層の可観測性、最小再現環境を60秒で作るテクニック、JSON入出力とexit codeのプロトコル把握、マルチユーザー環境の権限診断まで扱います。
Claude Code 時代の受託フリーランスが「固定見積もり」で利益を残す料金設計工学
Claude Codeで工数が読みにくくなった受託案件で、固定見積もりでも利益を残すための料金設計を体系化しました。時間単価×実稼働率×リスク係数への原価分解、見積書で書き分ける範囲と境界、変更管理条項の具体的な書き方、請けてはいけない案件の見分け方まで踏み込みます。
Claude Code 環境変数 完全リファレンス — 開発者が本当に押さえるべき設定項目
Claude Code で設定可能な環境変数を実務で使う観点から体系化します。API接続・モデル選択・PowerShellツール・ログ・タイムアウトなど、公式ドキュメントに散らばる情報を一本にまとめ、個人開発からチーム運用まで使える推奨設定を提示します。
Claude が「応答が未完了です」で止まる — 症状別の原因特定と復旧手順
Claude の会話が途中で切れて「応答が未完了です」「Try stopping」と表示される症状の原因を切り分け、ネットワーク・コンテキスト・ツール実行の3つの観点から順番に復旧する手順をまとめます。
Claude Code の /doctor で設定トラブルを3分で切り分ける — 実際に助かったチェック項目の話
Claude Code の挙動がおかしいとき、最初に叩くべきは /doctor コマンドです。設定ファイルの読み込み先・MCP サーバーの状態・権限モードを一気に可視化できます。実際に詰まったときに助けられたチェック項目を、失敗例とセットでまとめました。
Claude Code にバグ修正を任せる前に書くべき「再現テスト」— AIの無駄打ちを減らす設計
バグ修正をClaude Codeに丸投げして空回りした経験から、最初に「落ちる再現テスト」を書いてから委譲するワークフローに変えました。落ちるテストを最小化する4つの原則、リダイレクト失敗バグでの具体例、委譲とレビューの3段階、再現テストを書けないバグとの付き合い方を整理します。
Claude Agent SDK でシャドウモードを実装する — 本番影響ゼロでエージェント精度を測る段階的ロールアウト設計
AIエージェントを本番に出す前に精度を測りたい。でもユーザーに触れさせるしかない。この矛盾を解くのがシャドウモードです。Claude Agent SDK で既存フローに影響を与えずエージェントを並走させ、差分を記録し、段階的に昇格するまでの実装を解説します。
Claudeを教員の日常業務に組み込む — 授業準備・採点・個別フィードバックを効率化する
教員の日常業務にClaudeを組み込む方法を、授業準備・採点・個別フィードバックの3つの柱で整理しました。学習指導案と教材を型で量産する手順、長文記述の方向性チェック、生徒への返信を下書きとして作る使い方、個人情報とプライバシーの扱い、明日から始めるチェックリスト付きです。
Claude API の高可用性設計 — Sonnet / Haiku / Opus マルチモデルフォールバックを本番で成立させる
Claude API を単一モデル前提で組むと、障害やレート制限の瞬間にサービス全体が止まります。Sonnet・Haiku・Opus を段階的にフォールバックする本番実装を、コード・Circuit Breaker・ストリーミング対応まで含めて整理しました。
Claude で『メッセージを送信できませんでした』が出るとき — 原因切り分けと復旧フロー
Claudeで「メッセージを送信できませんでした」と表示されるときの復旧フローをまとめました。まず試す3秒チェックから、ネットワークのゆらぎ、添付ファイルのサイズ、長すぎる会話履歴、Anthropic側の障害、アカウントや利用上限まで5つの原因に分けて切り分けの順序を示します。