Index
記事
- 01コーディングエージェントの選び方
IDE型・CLI型・クラウド型の違いは入口にすぎない。どれを選んでも事故が起きた5つの場面と、編集部が使い続けている運用の型。 - 02AIの「完了しました」を信じない仕組み
ツールを1回も呼ばずに「6コミット先行、PR作成済み」と報告された。禁止のメモを書いても再発したので、hookとgitの実数で塞いだ記録。 - 03AIエージェントをVPSで24時間動かす
systemdで常駐させるだけなら30分。難しいのは「止まっているのに緑」を見抜くこと。常駐エージェントを運用して分かった監視と安全の設計。 - 04緑のテストは何も証明しない
ガード8本のどれを潰しても全テストが緑だった。AIにテストを書かせるようになって増えた「飾りのテスト」を、わざと壊して見抜く方法。 - 05MCPサーバー入門と設計の5原則
エージェントから呼べる最小のMCPサーバーを、実際に動くコードで作る。人間のタイポとは質の違う誤入力から、ツール側で身を守る設計まで。 - 06Claude Codeの料金、実際いくら？
Pro月20ドル、Maxは月100ドルから。6月の課金変更は当日に見送られ、10月には別の形になった。公式ページで確かめた内容をまとめる。 - 07CLAUDE.mdは削るほど効く
199行のCLAUDE.mdを114行に、120行を52行に削った。モデルが替わるたびに、足場は負債になる。何を残し、何を消したかを書く。 - 08AIコーディング3製品を運用で比較
429で16体が同時に落ちた夜から、並列の上限を決め直した。指示ファイル、hook、レビュー出力の3点で3製品を比べる。 - 09サブエージェント並列運用の失敗集
worktreeには、gitignoreした検証スクリプトが無い。並列の3レーンが全部これを踏んだ。プロンプトに入れるガードと、回収の確かめ方。 - 10Claude Code hooks実践
破壊的なgit操作を止めるhookを書いたら、+mainとgit -Cが素通りした。終了コードの意味と、hookを実測で直す手順。 - 11AIエージェントの権限設計
本番DBを読ませたいが、書かせたくない。読み取り専用のSQLラッパーを実際に書き、拒否ルールとhookの順番を公式仕様で確かめた。 - 12常駐Bot監視の落とし穴
AIエージェントの監視で、毎回失敗しているのにハートビートは緑だった。beatを打つ位置ひとつで監視は嘘をつく。その穴を再現コードで示す。 - 13AIコードレビューは何周で止める？
計画書のレビューは4回目でようやくGOが出た。終わらないループと、途中で切ってはいけないループの見分け方を、実例とCLIの罠で書く。 - 14ローカルLLMの遅さの正体
0.5Bの小さなモデルでも、16kトークンを読み込むだけで約47秒かかった。遅さの正体は生成ではなく、毎ターン送る量にある。CPUで測った。 - 15エージェントのメモリ設計
Claude Code メモリの索引 MEMORY.md と、毎回読ませる引き継ぎ文書が247KBまで膨らんだ。索引の書き方と、腐るメモの見分け方をまとめる。 - 16Claude Codeに秘密を渡さない
Claude CodeのAPIキー管理は、denyだけでは足りない。grepやPythonは.envを読める。ダミーの鍵で漏れ道を再現した。 - 17Claude Codeで環境変数が効かない
Claude Codeの環境変数が効かないときの切り分け方。env、export、.envの違いと反映の時機を、ダミー値で確かめた。 - 18Claude Code×CIの費用と罠
Claude Code GitHub Actionsの費用はAPIと実行時間の2本立て。試算とキャッシュの罠、暴走の止め方をまとめた。 - 19同じ修正を3回させない
Claude Codeに同じ修正を何度も頼んでいないか。2回外したら止まる手順と、CLAUDE.mdに撤退・再開条件を書き残す型をまとめた。 - 20AIが言う原因を疑う順番
Claude Codeが示す原因は、間違いのこともある。対照、環境、成果物の鮮度、測定系の順に疑えば、深追いせずに済む。 - 21ローカルは通るのにCIで落ちる
ローカルでは動くのにCIで失敗する。そんなときに差分を探す順番を、取り込むコミット、シェルとコマンド、依存、アーキテクチャの順にまとめた。 - 22別のAIに設計を反論させる
AI 設計レビューは、コードを書く前のほうが安く済む。別のAIに一番強い反論を出させ、既に決めたことと照らして直す手順をまとめた。 - 23数千行をリファクタリングで消す
Claude Codeのリファクタリングで古いモジュールを消すなら、呼び出し側から順に。依存の向きの調べ方とコミットの切り方をまとめた。 - 24LLMは「選ぶ・抜く」だけにする
LLM 構造化出力で型をそろえても、答えが正しいとは限らない。文章は書かせず、選ばせて抜かせ、原文との一致を機械で確かめる。 - 25デプロイとマイグレーションの事故集
Claude Codeのデプロイ事故は、派手な削除より静かに壊れるほうが怖い。成功表示の空振りやテストの誤爆を、防ぎ方と一緒にまとめた。 - 26MCPサーバーの選び方
MCP サーバーのおすすめを探す前に、見ておきたい基準がある。出どころ、接続方式、スコープ、出力の大きさ、権限の絞り方を確かめた。 - 27Claude Codeの始め方
Claude Codeの使い方を、インストールから最初の質問、最初の変更まで順に。公式の手順を手元で動かし、つまずきやすい所も確かめた。