手を動かして確かめた、AIエージェントと開発ツールの記録。https://agentkoji.com/jahttps://agentkoji.com/ja/articles/coding-agent-comparison/https://agentkoji.com/ja/articles/coding-agent-comparison/IDE型・CLI型・クラウド型の違いは入口にすぎない。どれを選んでも事故が起きた5つの場面と、編集部が使い続けている運用の型。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/agent-done-verification/https://agentkoji.com/ja/articles/agent-done-verification/ツールを1回も呼ばずに「6コミット先行、PR作成済み」と報告された。禁止のメモを書いても再発したので、hookとgitの実数で塞いだ記録。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/ai-agent-vps-setup/https://agentkoji.com/ja/articles/ai-agent-vps-setup/systemdで常駐させるだけなら30分。難しいのは「止まっているのに緑」を見抜くこと。常駐エージェントを運用して分かった監視と安全の設計。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/green-tests-prove-nothing/https://agentkoji.com/ja/articles/green-tests-prove-nothing/ガード8本のどれを潰しても全テストが緑だった。AIにテストを書かせるようになって増えた「飾りのテスト」を、わざと壊して見抜く方法。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/mcp-server-intro/https://agentkoji.com/ja/articles/mcp-server-intro/エージェントから呼べる最小のMCPサーバーを、実際に動くコードで作る。人間のタイポとは質の違う誤入力から、ツール側で身を守る設計まで。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-pricing/https://agentkoji.com/ja/articles/claude-code-pricing/Pro月20ドル、Maxは月100ドルから。6月の課金変更は当日に見送られ、10月には別の形になった。公式ページで確かめた内容をまとめる。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-md-trim/https://agentkoji.com/ja/articles/claude-md-trim/199行のCLAUDE.mdを114行に、120行を52行に削った。モデルが替わるたびに、足場は負債になる。何を残し、何を消したかを書く。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-cursor-codex/https://agentkoji.com/ja/articles/claude-code-cursor-codex/429で16体が同時に落ちた夜から、並列の上限を決め直した。指示ファイル、hook、レビュー出力の3点で3製品を比べる。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/subagent-failures/https://agentkoji.com/ja/articles/subagent-failures/worktreeには、gitignoreした検証スクリプトが無い。並列の3レーンが全部これを踏んだ。プロンプトに入れるガードと、回収の確かめ方。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-hooks/https://agentkoji.com/ja/articles/claude-code-hooks/破壊的なgit操作を止めるhookを書いたら、+mainとgit -Cが素通りした。終了コードの意味と、hookを実測で直す手順。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/agent-permission-design/https://agentkoji.com/ja/articles/agent-permission-design/本番DBを読ませたいが、書かせたくない。読み取り専用のSQLラッパーを実際に書き、拒否ルールとhookの順番を公式仕様で確かめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/bot-monitoring-invariants/https://agentkoji.com/ja/articles/bot-monitoring-invariants/AIエージェントの監視で、毎回失敗しているのにハートビートは緑だった。beatを打つ位置ひとつで監視は嘘をつく。その穴を再現コードで示す。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/ai-review-rounds/https://agentkoji.com/ja/articles/ai-review-rounds/計画書のレビューは4回目でようやくGOが出た。終わらないループと、途中で切ってはいけないループの見分け方を、実例とCLIの罠で書く。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/local-llm-claude-code/https://agentkoji.com/ja/articles/local-llm-claude-code/0.5Bの小さなモデルでも、16kトークンを読み込むだけで約47秒かかった。遅さの正体は生成ではなく、毎ターン送る量にある。CPUで測った。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/agent-memory-design/https://agentkoji.com/ja/articles/agent-memory-design/Claude Code メモリの索引 MEMORY.md と、毎回読ませる引き継ぎ文書が247KBまで膨らんだ。索引の書き方と、腐るメモの見分け方をまとめる。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-secrets/https://agentkoji.com/ja/articles/claude-code-secrets/Claude CodeのAPIキー管理は、denyだけでは足りない。grepやPythonは.envを読める。ダミーの鍵で漏れ道を再現した。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-env-vars/https://agentkoji.com/ja/articles/claude-code-env-vars/Claude Codeの環境変数が効かないときの切り分け方。env、export、.envの違いと反映の時機を、ダミー値で確かめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-ci-costs/https://agentkoji.com/ja/articles/claude-code-ci-costs/Claude Code GitHub Actionsの費用はAPIと実行時間の2本立て。試算とキャッシュの罠、暴走の止め方をまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/same-fix-three-times/https://agentkoji.com/ja/articles/same-fix-three-times/Claude Codeに同じ修正を何度も頼んでいないか。2回外したら止まる手順と、CLAUDE.mdに撤退・再開条件を書き残す型をまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/doubt-ai-root-cause/https://agentkoji.com/ja/articles/doubt-ai-root-cause/Claude Codeが示す原因は、間違いのこともある。対照、環境、成果物の鮮度、測定系の順に疑えば、深追いせずに済む。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/local-green-ci-red/https://agentkoji.com/ja/articles/local-green-ci-red/ローカルでは動くのにCIで失敗する。そんなときに差分を探す順番を、取り込むコミット、シェルとコマンド、依存、アーキテクチャの順にまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/ai-design-rebuttal/https://agentkoji.com/ja/articles/ai-design-rebuttal/AI 設計レビューは、コードを書く前のほうが安く済む。別のAIに一番強い反論を出させ、既に決めたことと照らして直す手順をまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/ai-deletion-refactor/https://agentkoji.com/ja/articles/ai-deletion-refactor/Claude Codeのリファクタリングで古いモジュールを消すなら、呼び出し側から順に。依存の向きの調べ方とコミットの切り方をまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/llm-pick-extract/https://agentkoji.com/ja/articles/llm-pick-extract/LLM 構造化出力で型をそろえても、答えが正しいとは限らない。文章は書かせず、選ばせて抜かせ、原文との一致を機械で確かめる。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/deploy-migration-accidents/https://agentkoji.com/ja/articles/deploy-migration-accidents/Claude Codeのデプロイ事故は、派手な削除より静かに壊れるほうが怖い。成功表示の空振りやテストの誤爆を、防ぎ方と一緒にまとめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/mcp-server-choose/https://agentkoji.com/ja/articles/mcp-server-choose/MCP サーバーのおすすめを探す前に、見ておきたい基準がある。出どころ、接続方式、スコープ、出力の大きさ、権限の絞り方を確かめた。Fri, 16 Oct 2026 00:00:00 GMThttps://agentkoji.com/ja/articles/claude-code-getting-started/https://agentkoji.com/ja/articles/claude-code-getting-started/Claude Codeの使い方を、インストールから最初の質問、最初の変更まで順に。公式の手順を手元で動かし、つまずきやすい所も確かめた。Fri, 16 Oct 2026 00:00:00 GMT