QiitaにIud7nさんが投稿した、Code with Claude東京2026の参加レポートです。
イベントレポは速報性で読まれて終わりがちですが、この記事はAnthropic公式の発表内容を整理しつつ、エージェント設計の型を要点でまとめてくれているので、後から読み返す価値があります。
僕が注目したのは「何を実装したか」ではなく、「Anthropic自身がどう設計を整理しているか」という観点で読める点です。 ここを押さえると、社内のエージェント運用を始めるときに迷う回数が減ります。
エージェント開発の現場で詰まりがちな箇所
社内でAIエージェントを試そうとすると、こんな壁にぶつかります。
- ツールをどこまで持たせるべきか判断がつかない（権限分離の設計）
- プランを提示させたいが、自由文だと粒度がバラつく
- 「ユーザーに質問させる」タイミングの設計が曖昧
- 評価指標が決まらず、改善のループが回らない
エージェント実装はサンプルコードを動かすのは簡単ですが、現場運用に乗せようとした瞬間に「設計の型」が無いと崩れます。 レポート記事の価値は、ここを公式視点でまとめてくれているところです。
レポートから読み取れる設計の型
元記事(Qiita、Iud7n、2026-06-14)で取り上げられている主な話題です。
- 対象イベント: Code with Claude Tokyo 2026(Anthropic主催)
- 言及されている設計要素:
AskUserQuestionツール: エージェントが不明点をユーザーに確認する仕組み- HTMLプラン: プランを構造化し、
data-verify-*等のDOM属性で検証可能にする発想 - Managed Agents: BrainとHandsを分離し、
/v1/agents//v1/environments//v1/sessionsで管理 - 記事の立ち位置: 参加者個人(Iud7n氏)による会場レポと所感
ポイントは「思考(Brain)」と「実行(Hands)」を分離するという考え方です。 社内運用で「エージェントが何でもできちゃう」状態を放置すると、権限事故が起きやすい。 分離設計を最初の前提にすると、ツールの足し算で済むことが増えます。
「公式の整理」を取り込むメリット
レポート記事を読んで、すぐ社内で真似できるかというと、そこは正直に書いておきます。
- これは参加者個人のレポートであり、Anthropic公式の規範文書ではない
- 紹介されている設計要素(AskUserQuestion、HTMLプラン等)は、API仕様や実装可否を別途公式ドキュメントで裏取りする必要がある
- 「コミュニティ参考実装」と元記事メタにあるが、本記事執筆時点で実装の公開先・採用事例数は未確認
ここを踏まえた上で、レポートの価値は「公式が今どの方向で整理しているかを早めに知れる」点にあります。 仕様の確定を待ってから動くと、社内ナレッジが半年遅れます。
中小企業で再現するなら
ここからが本題です。年商5億規模の会社で「社内AIエージェント運用」を始めるとき、このレポートをどう使うか。
構成
| 項目 | Qiitaレポ(Iud7n) | 中小企業(年商5億・社員30名) |
|---|---|---|
| 対象 | 個人開発者・参加者 | 情シス兼任1名 or 外部支援1名 |
| ツール | Claude API・エージェント設計の知見 | Claude API + Claude Code(月3,000円/人〜、2026年6月時点。要最新価格確認) |
| 月額費用 | (個人実験コスト) | 推定 月1〜3万円(API従量+Code Max Plan、2026年6月時点) |
| 初期費用 | ほぼゼロ(自己学習) | 推定 50〜100万円(エージェント設計支援+権限分離ルール策定) |
| 体制 | 本人1名 | 担当1名+外部設計支援月10時間 |
| 期間 | レポ参照〜サンプル実装まで数日 | 3〜6ヶ月で社内1業務にPoC |
評価軸スコア
| 評価軸 | スコア |
|---|---|
| ROI(投資対効果) | ★★★☆☆ |
| 再現性(中小企業) | ★★☆☆☆ |
| 難易度(低いほど簡単) | ★★★★☆ |
(難易度=数字小さいほど簡単)
スコア根拠は以下です。
- ROIが中程度なのは、エージェント運用の効果が業務選定に大きく左右されるため
- 再現性が低めなのは、設計知識・API理解・権限設計を担える人材が中小企業では希少なため
- 難易度が高めなのは、サンプルを動かす段階と現場運用の段階で要求される設計力が大きく違うため
前提条件・必要データ
- 対象業務の手順が言語化されている(暗黙知のままでは設計に落ちない)
- Claude API・ツール呼び出しの基本概念に抵抗が無い担当者がいる
- 機密情報をAIに渡す際の社内ルールが策定済み、または策定可能
- 最初から全自動を狙わず、人間チェックを残す前提で設計できる
失敗条件・適用しないケース
- 「とりあえずエージェント化」だけが先に決まり、対象業務が後付け
- BrainとHandsを分離せず、1エージェントに全権限を持たせようとする
- AskUserQuestion相当の確認ステップを省いて、ユーザー入力なしの全自動を目指す
- レポート記事の引用だけで意思決定し、公式仕様の裏取りを後回しにする
「Code with Claudeのレポを読んだから、社内エージェントが回る」わけではありません。
対象業務の手順言語化→Brain/Hands分離設計→ツール権限の最小化→確認ステップの設計→評価指標の定義、という5ステップを踏んで、初めて運用に耐える形になります。
特に評価指標の定義は、PoCから本番運用に上げる段階で必ず詰まる箇所です。
出典・参考
市野
愛知県岡崎市でAI活用支援を手がける一人社長。 中小企業の現場でAIを実装してきた経験から、他社事例を「うちで再現するには」の視点で読み解いて発信中。
愛知県岡崎市を拠点に、中小企業向けのAI活用支援を提供。ChatGPT・Claude Code等を活用した業務自動化やSEO・広告運用の内製化を支援。経営者が自らAIを使いこなせる体制づくりをサポートしている。
＞＞詳細なプロフィールはこちら