すべての記事
APIキーを誤って git commit してしまった時の緊急対応手順 — Claude Code を使った履歴削除とキーローテーション
.envのAPIキーを誤ってgit commitしてしまったときの緊急対応手順です。最初の5分で行うキーのローテーション、被害範囲の確認、git履歴からの完全削除、GitHubのシークレットスキャンニングアラートの解除、.gitignore整備を含む再発防止までClaude Codeを使って実践的に解説します。
iOS アプリの Localizable.strings を Claude Code で管理する — 個人で複数アプリを運営するときのローカライズフロー
壁紙アプリを複数運営している個人開発者が、Localizable.stringsの管理をClaude Codeで省力化した実際のワークフロー。新しいキーの追加から翻訳品質チェックまで、一人で回すときの現実的なアプローチを書きます。
Haiku 4.5・ストリーミング・プロンプトキャッシングを組み合わせて個人開発アプリのAPIコストを抑えた記録
個人開発アプリのAI機能で膨らむAPIコストを、Haiku 4.5への移行・ストリーミング・プロンプトキャッシングの3つの組み合わせで抑えた記録です。各ステップの実装と落とし穴、統合パターン、実装前後のコスト比較、キャッシュの損益分岐を先に計算する考え方までまとめました。
Claude Code MCP サーバーが起動しない — "spawn ENOENT" エラーの原因は PATH の罠だった
Claude Code で MCP サーバーを設定したのに「spawn npx ENOENT」「spawn uvx ENOENT」が出て起動しない。この厄介なエラーの根本原因は Claude Code が使う PATH と、あなたのシェルの PATH が別物だという点にあります。診断から修正まで解説します。
Claude Code でクラッシュレポートから修正コミットまでの導線を引く — 個人開発のリリース後障害対応を仕組み化する
Crashlytics や Sentry に届くクラッシュレポートを Claude Code で自動診断し、修正コミットまでつなげる個人開発者向けの実装パイプラインを、今も自分が回している運用とコード例で具体的に書きます。
Claude Code の SKILL.md に grep ガードを仕込んで、AI 生成記事のテンプレ語句を push 前に弾く
Claude Code の Skill にプロンプトだけで品質指示しても、毎日大量に記事を生成していると徐々にテンプレ語句がすり抜けてきます。SKILL.md の最終ステップに grep ガードを差し込んで、違反を検出したら再生成に戻す仕組みを、4サイト運用の実例から紹介します。
Claude API の metadata.user_id は何のために送るのか — abuse 検知とプライバシーの折り合いを設計する
Claude API の metadata.user_id は abuse 検知の精度を上げるためのフィールドですが、生のメールアドレスをそのまま渡すとプライバシー上の問題が出ます。HMAC で安定した擬似 ID を作る具体的な実装と、渡すべき/渡さない場面の判断基準をまとめました。
Claude Code の Glob と Grep が0件を返すときの原因切り分け
Claude Code の Glob/Grep ツールがファイルを見つけられないとき、.gitignore除外・隠しファイル・パターン記法の落とし穴を切り分け、適切な代替手段で確実に発見する手順をまとめます。
Claude Code の Read が大きなファイルを最後まで読まないとき — PARTIAL view の受け取り方と offset / limit の設計
Read が大きなファイルを途中までしか返さないとき、Claude Code は PARTIAL view の通知を出しています。通知の受け取り方と、行数ではなくバイト予算で offset / limit を決める方法を、実測値とともにお伝えします。
Claude API のプレフィルで『JSON 出力が必ず通る』本番設計 — 個人 SaaS で辿り着いた4層防御
Claude API のプレフィルだけでは JSON パースが落ちる本番ケースを、4層防御パイプラインでパース成功率 99.98% まで持ち上げた実装記録です。切断応答 1,081 件で修復コードを実測し、当初掲載していた閉じ補完の誤りも訂正しています。
Claude API の 400/422/529 を“呼ぶ前”に消す5層プリフライト設計 — 月数百件の失敗呼び出しをゼロにした実装
Claude API の 400/422/529 エラーを“呼ぶ前”に止める5層プリフライト設計を、TypeScript の完全実装と運用1ヶ月分の数値でまとめました。失敗呼び出しのコスト・リトライ・通知ノイズを同時に削減できます。
Claude Code Skill を無人で動かす設計 — 許可ダイアログで止まらない3つの実装パターン
Claude Code のスキルをスケジュール実行や CI で動かしたとき、許可ダイアログが出て途中で固まる現象に何度もぶつかってきました。Read/Write 系ツールに依存せず bash で完結させる、3つの実装パターンを実体験から共有します。