AIエージェントの承認待ち(AI が人の判断を待って作業を止めている状態)に時間を取られている、1 人目のデータ担当の方向けの構築ログです。筆者がこのサイトの運用で、判断の点を図付きの「カード」にして選んで答える仕組みを作った記録をまとめます。読み終わると、どの判断を止めて聞き、どれを仮に決めて進めさせてよいかを、自分の作業に当てはめて決められるようになります。
この記事で分かること
- AI エージェントの判断の点を、長い会話の文ではなくカードで返す仕組みの部品と流れ
- 判断の点を「止めて聞く・仮に決めて進める・聞かずに進める」の 3 つに分ける基準
- Claude Code の公式の 権限モード(AI が確認なしに実行できる範囲を決める設定)との対応
- 作ってみてつまずいた点と、まだ確かめられていない点
ざっくり言うと:判断をカードにすると、止まる点が見えるようになった
筆者は、AI エージェント(Claude Code)にこのサイトの改修を任せています。任せる範囲が広がるにつれて、AI が「どちらにしますか」と聞いて止まる場面が増えました。
そこで、判断が必要な点を 1 枚のカードにして、図と選択肢を付けて画面に並べる仕組みを作りました。筆者はこれを 判断インボックス(判断を待っているカードを集めた受信箱のような画面)と呼んでいます。
結果をまとめると、次の表のとおりです。
| 項目 | 記録に残っていること |
|---|---|
| 最初の版のカード | 3 件 |
| 利用者が答えたカード | 3 件中 2 件 |
| 1 回目のレビューで直した指摘 | 5 種類 |
| 未確認のまま残った点 | 延べ 3 点 |
| 減った時間 | 測っていない |
使った時間や減った時間は測っていないので、この記事では効果の数字を示しません。その代わりに、仕組みの形と、作る時につまずいた点を具体的に書きます。
何が問題だったか:判断の点が会話の長文になる
AI エージェントは、迷う点に出会うと会話の中で質問を返します。質問には背景・選択肢・それぞれの良し悪しが長い文章で書かれていて、読むだけで時間がかかりました。
さらに、答えるには自分で返事の文を書く必要があります。席を外している間は、AI が返事を待って止まったままになります。
問題を分けると、次の 3 つでした。
| 問題 | 起きていたこと |
|---|---|
| 読む負担 | 質問が長文で、選択肢の違いが見えにくい |
| 答える負担 | 返事を文で書く必要がある |
| 止まる時間 | 離席中は AI が待ったままになる |
構成:カード・保存先・AI の読み書きの流れ
仕組みは、AI エージェント・カードの保存先・利用者の画面の 3 つの部品でできています。図 1 のとおり、AI がカードを書き、利用者が画面で選んだ答えを AI が読みます。
保存先には、claude.ai の Artifact(Claude が作る、会話の横に表示される小さなアプリやページ)の db(Artifact が持つ、データを保存する場所)を使いました。筆者の記録では、流れは次のとおりです。
Claude → カードを書く → Artifact の db
↓
利用者が図を見て選ぶ
↓
Claude ← 答えを読む ← 答えが db に入る
最初の版では、ページ本体・説明書(README)・最初のカード 3 件の控えの 3 ファイルを新しく作りました。追加した行数は、ページ本体 506 行、README 76 行、カードの控え 734 行で、合わせて 1,316 行です(筆者が記録から計算)。
ページには 3 列(カードの一覧・選択肢・根拠)を置き、選択肢ごとに基準ごとの評価の表、やさしい解説、用語集を付けました。最初のカード 3 件は、ニュースレターの登録フォーム、OG 画像(SNS で共有した時に表示される画像)のフォント、生成した画像の容量が大きくなりすぎる問題の 3 つの Issue から作りました。
作業の段階を分ける 3 つのタブ
最初の版のタブは「判断待ち」と「答えた」の 2 つでした。その後の変更で、次の 3 つに作り直しました。
| タブ | 中身 |
|---|---|
| 次にやること | これから始める作業 |
| いまの作業 | あなたの番・動いている・止まっている |
| 終わったこと | 終わった作業 |
「いまの作業」の中を 3 つに分けたのは、利用者の答えを待っているものと、AI が動いているものを見分けるためです。さらに後の 3 件の変更で、タブに マイルストーン(作業の区切りとなる目標)を出し、判断カードをマイルストーンの下に入れ子で並べ、答えが出たら見ている Claude のセッションへ知らせる機能を足しました。
判断の点を 3 つに分ける基準
すべての判断を止めて聞くと、AI は止まってばかりになります。反対に、すべてを AI に任せると、戻せない失敗が起きた時に困ります。
そこで筆者は、判断の点を「取り消せるかどうか」と「影響の大きさ」の 2 軸で、3 つに分けて考えました。図 3 は、その分け方と、記録に出てきた操作の置き場所を示したものです。
4 つの区画に 3 つの分類を次のように割り当てました。項目の位置は筆者の判断で、測った値ではありません。
| 区画 | 分類 |
|---|---|
| 取り消しにくい・影響大 | 止めて聞く |
| 取り消しにくい・影響小 | 止めて聞く |
| 取り消せる・影響大 | 仮に決めて進める |
| 取り消せる・影響小 | 聞かずに進める |
迷った判断は、取り消せるかどうかを先に確かめ、取り消しにくければ影響が小さくても止めて聞く側に置きます。取り消しにくい失敗は、後から直す手間ではなく、直せないこと自体が損になるからです。
図 3 に置いた操作の根拠は次のとおりです。
- 読み取り: Claude Code の Manual モード(設定値は default)でも、確認なしに実行できるのは読み取りだけです(Claude Code Docs: Permission modes)。
- ファイルの編集: acceptEdits モードでは、読み取り・ファイル編集・mkdir や mv などの基本的なファイル操作を確認なしで実行します(同上)。Git で戻せる前提で、取り消せる側に置きました。
- rm -rf での削除: 公式の説明に、フックで rm -rf を含むコマンドを止める例があります(Claude Code Docs: Hooks)。
- 答えの set 上書き: 答え済みのカードを set(中身をまるごと置き換える書き方)で上書きすると答えが消えるため、筆者の仕組みの README では update(一部だけを書き換える書き方)を使うよう定めています。
- 離席の設定の保存: Claude 自身の振る舞いを変える設定なので、AI が自分で切り替えず、人に聞く側に置きました。切り替えは OFF に戻せますが、ON の間に AI が仮決めで進めた作業は自動では元に戻らないため、取り消しにくい側と筆者は判断しました。確認の作業でも押さなかったのは同じ理由です(後の節で説明します)。
Claude Code の公式の権限の考え方と突き合わせる
Claude Code には、道具の操作をどこまで確認なしで実行させるかを決める仕組みがあります。権限モードは「Claude が確認なしに実行できる範囲を決める設定」と説明されています(Claude Code Docs: Permission modes)。
公式の表の順に、主な権限モードを並べると次のとおりです。計画を立てるための plan モードは、この記事の話題から外れるため省きました。
| モード | 確認なしで動く範囲 |
|---|---|
| Manual(default) | 読み取りだけ |
| acceptEdits | 読み取りとファイル操作 |
| auto | すべて(別のモデルが審査) |
| dontAsk | 読み取りと事前に許可した道具(他は拒否) |
| bypassPermissions | すべて(隔離環境だけ) |
auto モードでは、分類器(操作が安全かを判定する別のモデル)が利用者の代わりに操作を審査します。dontAsk モードは確認が必要になる操作をすべて拒否するモードで、CI(コードを自動でチェックする仕組み)のような固定した環境向けと説明されています(同上)。
また、規則は deny(禁止)・ask(確認)・allow(許可)の順に評価され、最初に当たった規則で結果が決まります(Claude Code Docs: Configure permissions)。deny の規則は、bypassPermissions を含むすべてのモードで有効です(Permission modes)。
筆者の 3 分類を公式の仕組みに当てはめると、次のようになります。公式の権限は「道具の操作」の話で、「業務の判断」の話ではないため、この対応は筆者の類推です。deny は聞かずに止めるため、3 分類の外の行として足しました。
| 筆者の分類 | 近い公式の仕組み |
|---|---|
| 止めて聞く | ask の規則・default |
| 止める(聞かない) | deny の規則 |
| 仮に決めて進める | 直接の対応なし |
| 聞かずに進める | allow の規則・acceptEdits |
「仮に決めて進める」に当たる公式の仕組みは見当たりませんでした。いちばん近いのは、利用者の代わりに別のモデルが審査する auto モードだと考えられます。ただし auto モードは操作を通すか止めるかを決めるもので、業務の選択肢を仮に選んで後から直す仕組みではありません。
権限の確認そのものを自動で処理したい場合は、フックの PermissionRequest(道具の実行が権限の判断を必要とする時に動くイベント)を使えます(Claude Code Docs: Hooks)。フックで危ない操作を止める設計は、Claude Code のフックで AI の危険な操作を止める設計パターンで詳しく書いています。
離席中の仮決めと、後から直す流れ
判断インボックスの 2 回目の変更で、離席の切り替えを作りました。切り替えは db の settings/presence という場所に保存し、ON の間は Claude がおすすめの案で仮に決めて作業を続けます。図 2 は、1 つの判断がどう流れるかを示したものです。
仮に決めた答えには、画面で「仮決め」と表示します。データの上では provisional(仮かどうかを表す項目)を付け、利用者が答えると provisional が false に変わります。
離席の切り替え ON(settings/presence に保存)
↓
Claude がおすすめの案で仮決め → 答えに「仮決め」の印
↓
利用者が戻って答える
↓
provisional が false になり、印が外れる
さらに後の変更で、答えが出たことを見ている Claude Code のセッションへ comments(Artifact に付けるコメントの機能)で知らせる機能を足しました。この知らせは、判断インボックスを見ているセッションがある時だけ届きます。初めて送る時は claude.ai が利用者にコメントの許可を聞き、許可しないと知らせは届きません(答えは保存されます)。
離席中の仮決めは仕組みを作っただけで、実際に Claude が仮決めで進んだ記録はまだありません。切り替えを押すと Claude の振る舞いを変える設定が保存されるため、確認の作業でも押さなかったからです。
人の確認なしに AI の成果物を先へ進める時の考え方は、AI の成果物を人の確認なしで本番へ出す経路の設計でも扱っています。
つまずきやすい点:作ってみて引っかかったところ
作ってみて引っかかった点を、記録に残っている数で並べると次の表のとおりです。
| 種類 | 数 | 数え方 |
|---|---|---|
| 1 回目のレビューで直した指摘 | 5 | 種類の数 |
| 未確認のまま残った点 | 3 | 延べの数 |
| 別の Issue に回した問題 | 1 | 件数 |
数え方がそろっていないので、合計して全体の量として読まないでください。後続の 3 件の変更のレビューで直した指摘の数は、記録から数えていません。
レビューで直した 5 種類
最初の版の 1 回目のレビューでは、次の 5 種類を直しました。記録に残っているのは種類の名前だけで、原因や直し方の詳しい記述はありません。
| 指摘の種類 | 何に関わるか |
|---|---|
| メモの消失 | 入力したメモ |
| 待ちの文言 | 待ち状態の表示 |
| 控えの扱い | カードの控えのファイル |
| 起動の失敗 | ページの起動 |
| README | 説明書 |
入力欄の作り直し
2 回目の変更の時点で、メモを入力している途中に入力欄が作り直される問題が残りました。この問題は別の Issue として起票し、2 回目の変更では直していません。
答えを消してしまう書き方
答え済みのカードを set で上書きすると、利用者の答えが消えます。そこで README には、答え済みのカードを直す時は update を使い、status(カードの状態)と answer(答え)を送らないと書きました。
人の答えを保存する仕組みでは、AI がカードを直す時に答えの項目を上書きしない書き方を、説明書に決めておく必要があります。AI は説明書を読んで書き込むので、決めていないと良かれと思って全体を書き直すおそれがあると考えられます。
スマホ幅での表示は未確認
最初の版の表示は、PC の幅で 1 回だけ確かめました。スマホ幅では確かめておらず、2 回目の変更で足した縦向きの図も、実機が無く確かめていません。スマホ幅の表示は、利用者が実機で確かめる扱いにしています。
承認の確認を記録して分ける話は、Claude Code の承認ログを SQLite に記録して分析するでも書いています。人がいない時の実行で許可が効かなかった例は、AI エージェントの毎日自動実行が初回 0 本で止まった構築ログが参考になります。
費用と、まだ確かめられていないこと
費用
Claude の料金表では、2026-11-16 時点で次の月額が示されています(Claude 料金表)。
| プラン | 月額 |
|---|---|
| Pro(年払い) | 17 ドル(200 ドル一括) |
| Pro(月払い) | 20 ドル |
| Max | 100 ドル |
Max は Pro の 5 倍の使用量とされています。Pro を 1 年使う場合、月払いだと 240 ドル、年払いだと 200 ドルで、差は 40 ドルです(筆者が料金表の値から計算)。
料金表の機能一覧には「Artifacts を作成」があり、Free プランの項目にも載っています。ただし、この仕組みで使った db や comments の機能を使う条件は、料金表には書かれておらず、確認できませんでした。この仕組みに必要なプランは断定できないため、上の表は参考の月額として読んでください。
まだ確かめられていないこと
| 項目 | 状態 |
|---|---|
| 減った時間 | 測っていない |
| 離席中の仮決め | 動いた記録なし |
| スマホ幅の表示 | 2 回とも確かめていない |
| db・comments の利用条件 | 公式で確認できず |
| 後続 3 件のレビュー指摘の数 | 記録から数えていない |
まとめ
- 判断の点を図付きのカードにすると、AI が止まっている点が画面で一覧できるようになりました。
- 判断は「取り消せるか」と「影響の大きさ」で分け、取り消しにくいものは止めて聞き、取り消せるものだけを仮決めや自動に回します。
- 離席中の仮決めは仕組みだけで、動いた記録・時間の効果・スマホ幅の表示は、まだ確かめられていません。
AI エージェントに任せる作業の範囲や、確認の置き方を自社の環境で相談したい方は、お問い合わせからご連絡ください。AI が作った集計の SQL の確認に不安がある場合は、BigQuery SQL レビューパックも用意しています。