タグ
#Claude Code
Claude Codeに関する記事を公開しています。
npm を止めるだけなら Claude Code の mod は要らず hooks で足りた
CLAUDE.md の「npm ではなく pnpm を使う」を Haiku 4.5 に守らせるやり方を、Claude Code の mod と hooks で 5 通りずつ試しました。npm を止める点ではどれも hooks で mod と同じ結果になり、試した中で mod にしかできなかったのは、書き換えた記録を画面に出し続けることでした。
AI で動画を置くだけで YouTube に上がる仕組みを作る
撮った動画の編集と YouTube への投稿を AI に任せたい人向けに、動画を置くだけで非公開で上がる仕組みを Claude Code で作った手順と、Google 側で詰まった所を、筋トレ動画を例に示します。人に残るのは仕上がりへの OK と公開、7日ごとのログインだけです。
LLM に台本を判定させたら 12本すべて通した
生成した台本を LLM に判定させると 12本すべて通し、私が採用したのは 2本。判定のモデルを替えても私の選択には近づかず、通る台本が出たのは、生成の手前で素材を絞り、判定に通す例と落とす例を書き込んでからだった。
404 監視のボット除外ルールが、公開中のページを隠していた
404 の監視からボットを除外するルールは、間違えて実在のページを隠しても何の知らせも出ません。件数の減り方では気付けないので、サイトマップの全 URL をルールに通し、ボット扱いになるページが 0件かを確かめています。この確かめ方で、前からあったルールが公開中のページを隠していたのが見つかりました。
サブエージェントに作業を渡す親のエージェントには、コマンドを叩かせない
親のエージェントの誤診や見落としは、親が自分でコマンドを叩いた場面に集まっていました。2日分の作業記録から、親は判断と確認だけにして手を動かす作業は最初から渡す分担に変えた話です。
Claude Code のクラウドセッションに持ち込める鍵と持ち込めない鍵
Claude Code のクラウドセッションでは、鍵をセッションの中に置かず、通信の途中でプロキシが差し込みます。静的なトークンはそのまま動き、AWS の署名も専用の型で通りますが、1時間で切れるトークンと手元のログイン状態は持ち込めません。Node の fetch で鍵が付かなかった落とし穴と合わせて、鍵の型ごとに分けました。
Docker Sandboxes から Claude Code に移った決め手は指示の出し方
AI エージェントに作業を配る指示役のエージェントを、Docker Sandboxes から Claude Code のクラウドに移しました。決め手は鍵や料金ではなく、配る形がそのまま動き、話題ごとに分けた指示をスマホからでも出せることでした。
Claude Code に YouTube 動画編集を任せた
60分の定点長回し(カメラを固定して撮りっぱなしにした)筋トレ動画をフォルダに置くと、Claude Code が BGM・重量表示・サムネイル・タイトルと概要欄まで作った。私が返した注文は3回で、4分27秒の動画に仕上がった。
Claude Codeのルーチンで記事1本にAPI定価1,000円以上かかった
話題集めから検証、下書きまでを毎朝 AI エージェントに回させる仕組みを作りました。初回の 1本は正確でしたが、誰が試しても同じ結果になる記事で、使ったトークンは API の定価に換算して約 7.7ドル(1,000円以上)でした。2回目を待たずに止めた理由と費用の内訳です。
障害検知のトリアージから対応まで AI エージェントに任せる設計手法例
監視アラートの一次判定から修正の PR まで AI エージェントに任せ、判定に使う道具を読み取り専用に絞った設計。13週間で起票14件、人の本番操作0件。
戻せない D1 マイグレーションは本番のダンプで先に流す
EmDash は merge した瞬間に本番の D1 スキーマを自動で書き換える。down が空で戻せない 2本を含む 20本のアップグレードを、本番のダンプに先に流して検証してから通した設計を記す。
サンドボックスに鍵を置かずに EmDash の CLI を使う
CMS への記事投入を内蔵 MCP 経由で行うと本文がモデルの入出力を通り、トークン消費も文字化けの危険も増えます。サンドボックスの環境変数にプレースホルダーを置き、ホストのプロキシが差し替える経路に切り替えた設計を実例で示します。
X 公式 MCP が Docker サンドボックスで認可できない
X 公式 MCP を Docker サンドボックスから直接使おうとすると認可サーバーの制約と噛み合わない。接続して分かったツールの中身と読み取りの単価を示し、認証をホスト側のブリッジに置く設計を記す。
AI エージェントに X の鍵を渡さず投稿させる権限設計
X 公式 MCP に投稿ツールが無い前提で、鍵を neta-bot だけに残したまま AI エージェントに X へ投稿させる権限設計を実例で示します。承認は会話に一本化し、投稿口は 1 つに閉じて台帳に必ず載せます。
AI エージェントの記憶を git だけに置き環境は捨てる「秘書戦略」
サンドボックスは作り直すと中身がすべて消えます。事業の判断・手順・議事録を責務ごとに git の文書へ分けて置き、規約の書き換えだけを PR 必須にする、消える環境を前提にした記憶の設計を実例で示します。
GitHub Actions の OIDC で AWS の鍵を手元から無くした
Claude Code の Docker Sandbox に AWS の認証情報を渡すスクリプトを 3 本書きましたが、docker sandbox exec が別のコンテナに書き込んでいて一度も機能していませんでした。渡すこと自体をやめ、Terraform の bootstrap 層(Actions が引き受ける IAM ロールと OIDC)まで GitHub Actions の workflow_dispatch で plan / apply する構成にしました。ロールが自分自身を書き換える権限の線引きと、信頼ポリシーのリポジトリ名の既定値が古いままで自分を締め出しかけた話も残します。
changesets を AI エージェントに書かせると変更履歴が読める物になる
8 サイトのモノレポの変更をほぼ AI エージェントの PR で回していると、git log では「あのサイトはいつ何が変わったか」を追えなくなりました。changesets を入れ、PR を作るその瞬間にエージェントへ変更記録を書かせ、Release PR の merge でサイトごとの CHANGELOG に集約する形にしました。誤った記録を次の記録が訂正して並ぶ実例と、別リポジトリで踏んだ罠(タグの系統が 2 つになる、changeset status は commit 済みしか数えない、Release PR の merge がデプロイになる)を書きます。
.github リポジトリの PR テンプレートに「ハマったこと」欄を置く理由
AI エージェントに gh pr create --body で PR を作らせると、リポジトリの PR テンプレートは使われません。適用されるはずだと思い込んでいて、しばらく気づきませんでした。組織の .github 公開リポジトリにテンプレートを 1 つ置いて全リポジトリの既定にし、エージェントには「テンプレートを先に読んで本文を組む」手順を渡しました。テンプレート末尾の「ハマったこと・試行錯誤」欄は、commit には残らない物語を作業直後に残す場所で、別の bot が毎朝拾って素材にします。拾う側の本文上限が 300 文字で、一番下にあるこの欄ごと落ちていた失敗も書きます。
Claude Code の Docker Sandbox で API キーが渡らない原因
Claude Code の Docker Sandboxes で、sbx secret で入れたはずの API キーが環境変数に現れない、gh CLI が一部のコマンドだけ失敗する、という 2 つの症状に当たりました。原因はどちらも、プロキシがネットワーク層で認証を注入するというこの環境の設計です。direct モードでの実用解(ホスト側に .env を置く)と、gh の更新系操作を読み戻しで検証する運用を実測ベースで書いています。
Claude Code のサブエージェント並列でサイト群を保守する
AI コーディングエージェントを「司令塔 + 並列の実働班」に編成し、本番の複数サイトを日々保守している運用の設計を書きます。git worktree での物理分離、指示書に埋め込む計測プロトコル、権限の非対称、司令塔による二重検証、人間の介入点の切り分け。実際に出荷を止めたガードレールや、報告と実体の乖離といった実例と、この方式の限界まで含めてまとめます。