Claude Codeを毎日使う私の、仕事の任せ方と確かめ方

先に結論を書いておきます。今、私が何かを作るとき、コードを打つ作業の大半はClaude Codeがやっています。私の担当は、タスクの両端に移りました。始める前に、何をしてほしいのか、何をもって完了とするのかをはっきり伝えること。終わったあとに、その証拠を確かめること。真ん中はエージェントに任せています。

Claude Codeは毎日使っている相棒で、このサイトもホームラボもこれで管理しています（自分の手でコードを書きたいときは、今でもCursorを開きますが）。ここでは、私がClaude Codeとどう仕事をしているのかを、あえて任せていない部分も含めて紹介します。

タスクは新しいメンバーへのチケットのように書く

エージェントは速く、言われたとおりに動きます。でも、なぜそれが必要なのかは何も知りません。だから私は、優秀な新メンバーにチケットを書くつもりでタスクを渡します。目的、対象の場所、制約、触ってはいけないところ、そして何をもって完了とするか。

<URL> の登壇を src/content/speaking.ts に追加してください。
日付はアップロード日ではなく、イベントの開催日です。
ほかのファイルは触らないでください。
`npm run check` が通り、/speaking に表示されたら完了です。

一番効くのは最後の行です。自分で確かめられるゴールがあると、エージェントはチェックを自分で実行し、通るまで作業を続けます。コードがそれらしく見えた時点で止まってしまうことがなくなります。

ちょっとした修正を超える作業なら、まず計画を出してもらい（Claude Codeにはそのためのプランモードがあります）、ファイルが1つも変わらないうちに読みます。計画の修正ならメッセージ1通で済みますが、終わった作業の修正はそうはいきません。

ルールは一度だけ書く：CLAUDE.mdとAGENTS.md

Claude Codeは、セッションを始めるたびにリポジトリのCLAUDE.mdを読み込みます。このサイトのCLAUDE.mdは @AGENTS.md の1行だけで、共通のAGENTS.mdを読み込むようにしています。これで、どのエージェントも人間も、同じガイドを読むことになります。

ガイドは、完了の条件を含むTL;DRから始まり、コマンドの一覧表、ソースツリーの地図、よくある作業のレシピ（「登壇を追加する」なら、ファイル1つにオブジェクトを1つ足すだけ）、規約、そしてハマりどころの一覧と続きます。一番役に立つのはハマりどころで、どれにも理由が書いてあります。たとえばフォントをセルフホストしているのは、ネットワークのないサンドボックスではビルドが失敗するからです。過去のアップグレードでは、そのせいでフォントがいつの間にか消えていました。理由を知っているエージェントなら、それを「直して」元に戻したりはしません。

リンターでは絶対にチェックできないルールもあります。ここは実在する人物についての公開サイトなので、渡された履歴書に書いてあっても、プライベートな情報は載せないこと。

ゼロから始めるなら、これくらいでも十分役に立ちます。

## 完了と言う前に

- `npm run check`（format、lint、typecheck、build）を実行し、必ず通す。
- UIの変更は、アプリを起動してライトとダーク、390pxと1280pxで確認する。
- 依存パッケージを追加するときは理由を書く。
- シークレット、トークン、個人情報は絶対にコミットしない。

1文書いてあれば防げたはずの間違いをエージェントがしたら、その1文を書き足しましょう。

仕事の大部分は検証です

エージェントの「終わりました」は、あくまで自己申告です。私もそのつもりで扱います。このサイトでは、npm run check がフォーマット、lint、型チェック、本番ビルドをCIとまったく同じように実行します。続いて npm run smoke が起動中のサイトをクロールし、すべてのページが200を返すかどうかに加えて、フィード、OGP画像、サイトマップ、404ページまで確認します。CIはプルリクエストのたびに両方を実行するので、エージェントのブランチも私のブランチも同じ扱いです。

見た目は、目で見るしかありません。AGENTS.mdにはUIを変えたときに開くページのチェックリストがあり、両方のテーマ、スマホとデスクトップの幅、モバイルメニューやコマンドパレットまで含まれています。このサイトをTailwind CSS v4に上げたときの基準は「見た目の変化ゼロ」でした。全ルートをライトとダーク、モバイルとデスクトップで撮った62枚のスクリーンショットで確認し、旧ビルドとピクセル単位で一致しています。

そのうえで差分を読みます。ファイル名は毎回すべて確認し、設定、依存パッケージ、認証、ネットワークに関わるものは1行残らず読みます。見ているのはこんなところです。

そもそも差分に入っているべきではないファイル
削除・スキップされたテスト、緩められた型、紛れ込んだ any
新しい依存パッケージ
計算で出すべきなのにハードコードされた数字
AGENTS.mdで理由を説明しているハマりどころを、こっそり「直して」いるところ

MCP：コンテキストは貼るよりつなぐ

MCPサーバーを使うと、Claude Codeはターミナルの外にあるツールも扱えるようになります。課題管理、ホスティングのダッシュボード、データベース、ブラウザなどです。エラーログをチャットに貼り付けなくても、エージェントがログのある場所で直接読んでくれます。Anthropic、Raycast、Supabaseと共同開催したTokyo AI Hackathonで、多くのチームが1日かけて作っていたのも、このMCP連携でした。

ルールは2つです。まずは読み取り専用から始めること。MCPサーバーは、渡した認証情報でそのまま動くからです。そして、サーバーは1つずつ追加すること。つなぐツールが増えるほど、エージェントが「使おう」と判断するものも増えます。

長時間の自律実行と、その確かめ方

エージェントが一番力を発揮するのは、長時間の自律実行です。アップグレード、移行、何十ものファイルにまたがる同じ変更などです。ただし、これはエージェントが自分で確かめられるゴールがあって初めてうまくいきます。だから始める前に決めておきます。通すべきコマンド、欲しいスクリーンショット、触ってはいけないところ。

作業が終わって戻ってきたとき、コードを読むのは最後です。まず証拠を見ます。何を実行して何を飛ばしたかのまとめ、コミットの一覧、CIの結果、スクリーンショット。まとめに「このチェックは飛ばしました」とあれば、真っ先にそれを自分で実行し直します。差分を開くのはそのあとで、一番リスクの高いファイルから読みます。

ホームラボと、Mac miniで動くDiscordアシスタント

ホームラボも同じやり方で回しています。シンクライアントに作り替えた古いノートPC、Immich、Jellyfin、Paperless、Home Assistantが動くNAS、そして家じゅうのマシンの状態がひと目で分かる、エヴァンゲリオン風のNext.jsダッシュボードが2つあります。ダッシュボードは普通のNext.jsアプリなので、このサイトと同じように確認します。それ以外にはCIがないので、Uptime Kumaがスモークテストの代わりです。変更のせいでどこかのサービスが応答しなくなれば、すぐに分かります。

少し毛色が違うのが、Claudeを使ったDiscordアシスタントです。モニターなしで常時稼働しているMac miniでセルフホストしています。ここでのClaudeは私の代わりにコードを書く役ではなく、Claudeそのものが動いているプログラムです。こういうものを作るなら、チェックリストも変わります。必要なツールだけを渡す、何をしたかのログを残す、キーはリポジトリの外に置く。

任せないこと

何を作るか、なぜ作るか。 エージェントが得意なのは「どう作るか」の方です。
私について何を公開するか。 AGENTS.mdにはっきり書いてあります。私に関する事実は、公開されている情報源までたどれること。そしてエージェントが何を見つけても、プライベートな情報は載せないこと。
シークレットと、インターネットへの公開範囲を変えるもの。 うちのマシン同士はTailscaleでつながっていて、ポートは1つも開けていません。そこをエージェントに変えさせることはありません。
マージ。 プルリクエストを作るのはエージェントでも構いません。でも、それを出すと決めるのは私の仕事です。

信頼は証拠の積み重ね

エージェントへの信頼は、新しいメンバーへの信頼と同じで、作業の種類ごとに実績で積み上がっていきます。このサイトのコンテンツ編集は、checkとsmokeを通ってきた実績が長いので、ざっと目を通すだけです。依存パッケージのアップグレードはまだ実績が浅いので、しっかり読みます。認証やネットワークに関わるものは、毎回ゼロからです。

そして実行がうまくいかなかったときは、2か所を直します。コードと、AGENTS.mdの1行です。次のセッションは、それを知った状態で始まります。

次に長時間の実行を任せる前に、何をもって完了とするかを書き出してみてください。そして、そこまでたどり着いた証拠をエージェントに見せてもらいましょう。