技術Tips

起動スクリプトで二重起動チェックを誤判定させてしまう人へ。プロジェクト名からディレクトリを解決し、外部から叩いても壊れない冪等な起動CLIの内部設計を、実際に踏んだバグの直し方とあわせてまとめました。

外出先やモバイルから、AIエージェントが常駐する手元の開発マシンへ入る回線をどう設計するか。電車のトンネルで切れても復帰する接続、CLIだけで通すVPN、そして地味にハマるクリップボードの落とし穴までをまとめました。

普段Claude CodeとCodexを併用していて、Codexのスマホアプリのように手元のClaude Codeも外から動かしたい——その一点を埋めるべく、iPhoneから開発マシンのセッションを1コマンドで起動するCLIを自作した記録です。

AIエージェントに自分のAPIキーを握らせるのは、正直こわい。でも、渡さなくても動く。sandbox の一段上、権限そのものを最小に絞る——ネットワーク・秘匿値・信用範囲の線引きを、ポリシー設計の視点で紹介します。

Issue から PR まで無人で進むワークフローでも、機械のほうから人間に差し戻すべき場所があります。品質と責任の切り分け、LLM が緩められない床、行き詰まりの検出という3つの設計を実装の裏付けで解説します。

AIが書いたテストの「緑」を、そのまま信じて次に進んでいないだろうか。品質ゲート全体ではなく、テストの信頼性だけに絞って——緑が保証すること・しないこと、緑の嘘を見抜く設計を整理します。

安全のために入れた仕組みで、確認プロンプトが止まらない・セッションが終わらない。設定を見直す前に、まず「暴発・遅延・無限ループ」の3症状で切り分ける——hook を入れた後のデバッグ手順に絞って解説します。

複数ファイルに同じロジックをコピペしたら、いつの間にか片方だけ更新されてズレてバグになった。この「ドリフト」問題を、1ファイルを正本にして自動生成し CI で差分検出する設計で根治した方法を紹介します。

2026年6月、Anthropic の新モデル Claude Fable 5 を発表翌日に実務投入した小さな会社が、3日後の米政府による全世界提供停止を受けて定数1行で撤退するまで。新モデルの位置づけと突然の停止の経緯を一次情報で整理し、いつでも戻せる切り替え設計がなぜ効くのかを実例で解説します。