自作 MCP サーバーのログが消える — Claude Code で stderr を正しく拾う
Claude Code で自作の MCP サーバーを書いていて、console.log を足したのにログがどこにも出ない。実はサーバー自体が応答しなくなっている、という落とし穴の正体と、stdio を汚染しない正しいログ出力の置き換え方をまとめました。
Claude Code のサブエージェントが結果を返さない時の診断手順
Claude Code のサブエージェントが止まる・結果を返さない時、どこから調べるかの実践的な診断フローを、症状別の原因とコード例で解説します。
Claude Code エラー完全対処辞典 — 認証・決済・応答停止・ツール失敗を症状から逆引きする
Claude Code で実際に遭遇する 40 超のエラーパターンを、症状 → 原因 → 復旧手順の順で整理した実務向けハンドブックです。認証・決済・応答停止・ツール失敗・MCP・Hook まで、根本原因まで追える資料として活用いただけます。
Claude Code Hooks の本番デバッグ術 — ログが足りない時、どこから切り分けるか
ローカルでは動くのに本番で発火しない Claude Code Hooks を、どこから切り分けるか。私が実案件で使っている可観測性の仕込み方と、最小再現環境を60秒で作るテクニックを体系化しました。
Claude が「応答が未完了です」で止まる — 症状別の原因特定と復旧手順
Claude の会話が途中で切れて「応答が未完了です」「Try stopping」と表示される症状の原因を切り分け、ネットワーク・コンテキスト・ツール実行の3つの観点から順番に復旧する手順をまとめます。
Claude Code で Conventional Commits を自動生成する — git diff から type と scope を推論させる
コミットメッセージがいつのまにか「update」ばかりになっていませんか。Claude Code に git diff を読ませて Conventional Commits 形式に変換する、小さな運用ルールをまとめました。
Claude Code の Plan Mode で手戻りをなくす — 設計フェーズを独立させる実践
Claude Code の Plan Mode は機能説明だけ読むと地味ですが、実務に組み込むとトークン消費とやり直しの回数が目に見えて減ります。切り替えのタイミング・良い計画を引き出す質問の型・よくある落とし穴をまとめました。
Claude Code × Python ハイブリッド開発パターン集 — トークン50%削減の実装ガイド
Claude Code と Python を役割分担で組み合わせる実装パターンを、動くコードと共に7つ紹介します。ログ解析、データ変換、定期バッチ、CI/CD 統合まで、実際の本番運用で削減効果を検証した設計例です。
Claude Code の Bash が Windows で詰まるときに — CLAUDE_CODE_USE_POWERSHELL_TOOL=1 の実用メモ
Windows で Claude Code を使っていると、Bash 経由のコマンドがときどき不自然に失敗します。環境変数 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を立てて PowerShell を直接叩くようにするだけで、症状の多くが消えます。この記事は、その切り替えを実際に使ってみた上で見えてきた注意点をまとめたものです。
Claude Code で tRPC の型エラーを15分で溶かす — 実践ワークフロー
tRPC プロジェクトで型エラーが連鎖するとき、Claude Code をどう使えば最短で解決できるか。ルーター設計・クライアント連携・よくある落とし穴まで、実際のプロジェクトで詰まった箇所を中心に解説します。
Claude Code SDK でカスタム自律エージェントを実装する — 公式 CLI を超えた独自ループ設計の実践
Claude Code SDK の内部構造を理解し、公式 CLI では制御しきれない自律エージェントループを Python/TypeScript で実装します。ツール許可・エラー回復・ストリーミングに加え、課金変更後のコスト計測とモデル棚卸しまで、実運用で使っているパターンを共有します。
Claude Code がタスク途中で止まった時の安全なリカバリーガイド ── 作業を失わず再開する5つのステップ
Claude Code がタスク途中で止まる・応答しなくなる問題の原因別診断と、git を活用して作業内容を確認しながら安全に再開する実践的な5ステップを解説します。