ARTICLES

すべての記事

Claude Code の Skill にプロンプトだけで品質指示しても、毎日大量に記事を生成していると徐々にテンプレ語句がすり抜けてきます。SKILL.md の最終ステップに grep ガードを差し込んで、違反を検出したら再生成に戻す仕組みを、4サイト運用の実例から紹介します。

Claude API の metadata.user_id は abuse 検知の精度を上げるためのフィールドですが、生のメールアドレスをそのまま渡すとプライバシー上の問題が出ます。HMAC で安定した擬似 ID を作る具体的な実装と、渡すべき/渡さない場面の判断基準をまとめました。

Claude Code の Glob/Grep ツールがファイルを見つけられないとき、.gitignore除外・隠しファイル・パターン記法の落とし穴を切り分け、適切な代替手段で確実に発見する手順をまとめます。

Claude Code の Read ツールが2000行で切り捨てたまま気づかず、grep結果がズレた経験から得た offset/limit の使い分けと、bash で代替すべきケースの判断基準をまとめます。

Claude API のプレフィル機能だけでは JSON パースが落ちる本番ケースを、4層防御パイプラインで月数千リクエスト・パース成功率 100% に持っていった実装記録です。TypeScript と Python の両方の動くコード付き。

Claude API の 400/422/529 エラーを“呼ぶ前”に止める5層プリフライト設計を、TypeScript の完全実装と運用1ヶ月分の数値でまとめました。失敗呼び出しのコスト・リトライ・通知ノイズを同時に削減できます。

Claude Code のスキルをスケジュール実行や CI で動かしたとき、許可ダイアログが出て途中で固まる現象に何度もぶつかってきました。Read/Write 系ツールに依存せず bash で完結させる、3つの実装パターンを実体験から共有します。

Claude API のツール呼び出しを TypeScript + Zod で型安全に実装する方法。スキーマ自動変換・ランタイムバリデーション・よくある型エラーの解決策を実践コード付きで解説します。

Claude Agent SDKで複数ステップのワークフローを安全に組み立てる実践ガイド。補償トランザクション・冪等性キー・部分失敗時の状態復元を、本番環境で動かしてきた構成パターンとともに紹介します。

git commit の直前に、ステージング済みファイルだけを Claude Code に渡して軽量レビューを走らせる方法。lint-staged で対象を絞ることで、コストと待ち時間を最小化する個人開発者向けのレシピです。

Claude Agent SDK で発生する「DBには書かれたのにメール/決済/通知が飛ばなかった」事故を防ぐため、Transactional Outbox パターンを Postgres と Cloudflare Queues を例に本番品質で実装する手順をまとめます。

複数のリポジトリをClaude Codeで同時に進めると、コンテキストの混乱やコスト増加が起きやすい。CLAUDE.mdの設計、セッション管理、--add-dirの活用など、3プロジェクト並行で機能した設定と習慣をまとめました。