すべての記事
Claude Code × uv で Python 環境を瞬速構築する — pip より 10 倍速いパッケージ管理の現場活用
Rust製の高速Pythonパッケージマネージャー「uv」をClaude Codeと組み合わせた開発環境構築を解説。pipの10〜100倍速い環境セットアップと、Claude Codeによる依存関係管理の自動化を実践的に紹介します。
Claude Code の --print と --output-format json で CI/CD パイプラインを自動化する
Claude Code の --print フラグと --output-format json オプションを使い、CI/CD パイプラインに AI 判断を組み込む実践ガイド。GitHub Actions でのコードレビュー自動化、PR コメント生成、テスト失敗解析まで、動作するコードで解説します。
Claude Code の git 操作が `index.lock` で詰まる時、VM・CI 環境で必ず効く3つの回避策
Claude Code が VM や CI 環境で git add や git commit を実行した時に `Unable to create '.git/index.lock'` で停止する問題の根本原因と、現場で効く3つの回避策を解説します。
Claude Code の --add-dir で複数リポジトリを横断編集する実践パターン
Claude Code の --add-dir フラグで複数リポジトリを同時に編集する具体的な手順。フロントエンドとバックエンドをまたぐ API 変更、monorepo 化していない複数サービスの一括修正などを安全に進めるコツをまとめます。
Claude Code で壊れないAIコーディングを回す — Plan Mode・Hooks・Rewind・Subagent を統合した失敗前提の本番運用設計
Claude Code で本番リポジトリを触ると壊れる・戻せないという不安を解消する実装ガイド。Plan Mode・Hooks・Rewind・Subagent を1つのワークフローに統合し、失敗を前提に設計された本番運用パターンを実例で解説します。
自作 MCP サーバーのログが消える — Claude Code で stderr を正しく拾う
Claude Code で自作の MCP サーバーを書いていて、console.log を足したのにログがどこにも出ない。実はサーバー自体が応答しなくなっている、という落とし穴の正体と、stdio を汚染しない正しいログ出力の置き換え方をまとめました。
Claude Code のサブエージェントが結果を返さない時の診断手順
Claude Codeのサブエージェントが結果を返さない・止まったように見えるときの診断フローです。症状を分類する最初の3つの質問、ツール呼び出しの無限ループ、エラーが親に伝わらないパターン、出力スキーマの不在による内容ズレ、.claude/agents/のリロードまでコード例つきで解説します。
Claude Code の TodoList はタスク粒度で品質が決まる — 実装で効いたパターン集
Claude Code の TodoList ツールは使い方を誤ると逆効果になります。タスクの粒度・検証ステップの設計・更新タイミングの3つの観点から、実務で成果が出た使い分けパターンをまとめました。
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ツール・ログ・タイムアウトなど、公式ドキュメントに散らばる情報を一本にまとめ、個人開発からチーム運用まで使える推奨設定を提示します。