すべての記事
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 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 形式に変換する、小さな運用ルールをまとめました。
Claude Code の Plan Mode で手戻りをなくす — 設計フェーズを独立させる実践
Claude Code の Plan Mode は機能説明だけ読むと地味ですが、実務に組み込むとトークン消費とやり直しの回数が目に見えて減ります。切り替えのタイミング・良い計画を引き出す質問の型・よくある落とし穴をまとめました。
Claude Code 個人開発エンジニアの収益を安定化させる顧客ポートフォリオ設計
単価の次に考えるべきは顧客構成です。受託を続ける個人エンジニアが収益の波を抑えるための顧客ポートフォリオ設計を、4象限モデルでの分類、月3万円リテイナーの入口プラン、契約書とSLA、四半期レビューの指標、チャーン防止の仕掛けまで実例ベースでまとめました。