Claude Code の .claude/ ディレクトリをチームで共有する設計 — Git管理する範囲と個人設定の境界
Claude Code の .claude/ をチームで共有する時、どのファイルを Git に入れて、どこを個人設定に残すか。実プロジェクトで得た境界線と .gitignore テンプレートをまとめます。
Claude Code のシークレット管理とトラスト境界設計 — エージェント時代の秘匿情報ハンドリング本番ガイド
Claude Code がシェルを掌握する時代の秘匿情報設計を、トラスト境界・注入パターン・流出防止フックの3軸で体系化。.env から MCP までの本番運用パターンと、よくある落とし穴を実装コード付きで解説します。
Claude Code Hooksが無限ループする問題 — PostToolUseが自己発火するときの止め方
Claude Code の Hooks を仕掛けたら、ツール呼び出しが止まらなくなった。PostToolUse が自分で書き換えたファイルを再び拾って延々と発火し続ける、典型的な無限ループの原因と止め方を実例ベースで解説します。
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 化していない複数サービスの一括修正などを安全に進めるコツをまとめます。
自作 MCP サーバーのログが消える — Claude Code で stderr を正しく拾う
Claude Code で自作の MCP サーバーを書いていて、console.log を足したのにログがどこにも出ない。実はサーバー自体が応答しなくなっている、という落とし穴の正体と、stdio を汚染しない正しいログ出力の置き換え方をまとめました。
Claude Code のサブエージェントが結果を返さない時の診断手順
Claude Codeのサブエージェントが結果を返さない・止まったように見えるときの診断フローです。症状を分類する最初の3つの質問、ツール呼び出しの無限ループ、エラーが親に伝わらないパターン、出力スキーマの不在による内容ズレ、.claude/agents/のリロードまでコード例つきで解説します。
Claude Code エラー完全対処辞典 — 認証・決済・応答停止・ツール失敗を症状から逆引きする
Claude Code で実際に遭遇する 40 超のエラーパターンを、症状 → 原因 → 復旧手順の順で整理した実務向けハンドブックです。認証・決済・応答停止・ツール失敗・MCP・Hook まで、根本原因まで追える資料として活用いただけます。
Claude が「応答が未完了です」で止まる — 症状別の原因特定と復旧手順
Claude の会話が途中で切れて「応答が未完了です」「Try stopping」と表示される症状の原因を切り分け、ネットワーク・コンテキスト・ツール実行の3つの観点から順番に復旧する手順をまとめます。
Claude Code で Conventional Commits を自動生成する — git diff から type と scope を推論させる
コミットメッセージがいつのまにか「update」ばかりになっていませんか。Claude Code に git diff を読ませて Conventional Commits 形式に変換する、小さな運用ルールをまとめました。