すべての記事
Claude Code のサブエージェントが結果を返さない時の診断手順
Claude Code のサブエージェントが止まる・結果を返さない時、どこから調べるかの実践的な診断フローを、症状別の原因とコード例で解説します。
Claude Code の TodoList はタスク粒度で品質が決まる — 実装で効いたパターン集
Claude Code の TodoList ツールは使い方を誤ると逆効果になります。タスクの粒度・検証ステップの設計・更新タイミングの3つの観点から、実務で成果が出た使い分けパターンをまとめました。
Claude Code エラー完全対処辞典 — 認証・決済・応答停止・ツール失敗を症状から逆引きする
Claude Code で実際に遭遇する 40 超のエラーパターンを、症状 → 原因 → 復旧手順の順で整理した実務向けハンドブックです。認証・決済・応答停止・ツール失敗・MCP・Hook まで、根本原因まで追える資料として活用いただけます。
Claude Code Hooks の本番デバッグ術 — ログが足りない時、どこから切り分けるか
ローカルでは動くのに本番で発火しない Claude Code Hooks を、どこから切り分けるか。私が実案件で使っている可観測性の仕込み方と、最小再現環境を60秒で作るテクニックを体系化しました。
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 にバグ修正を丸投げして空回りした経験を踏まえ、最初に「落ちる再現テスト」を書いてから委譲するワークフローを、運用している設計原則と具体的なコードで整理します。
Claude Codeの長時間タスクが途中で止まる問題を、運用設計で根本解決する
Claude Codeで数時間におよぶ長時間タスク——リファクタ、移行、大量テスト生成——を走らせると、途中で止まる・応答が返らない・再開できないという問題に必ず突き当たります。サーキットブレーカー・チェックポイント保存・冪等リトライ・部分成果の退避まで、本番運用で実際に効く設計パターンを具体コード付きでまとめました。
Claude Skills と Claude Code Plugins を「売れる商品」にする — 設計・審査・課金・改善の全要点
Claude Skills や Claude Code Plugins を自作し、それを単なる公開物ではなく「売れる商品」に育てていくための設計・審査・課金・改善サイクルを、実装例とともに体系的にまとめます。
Claude Code で Conventional Commits を自動生成する — git diff から type と scope を推論させる
コミットメッセージがいつのまにか「update」ばかりになっていませんか。Claude Code に git diff を読ませて Conventional Commits 形式に変換する、小さな運用ルールをまとめました。