AIエージェントが思った通りに動かないのはなぜ?成果物の質を決める「環境」の作り方

AIエージェントに指示しても思った通りの成果物が出ないのは、多くの場合、指示文よりも、AIの周りに置く「環境」が足りないことが原因です。AIエージェントは、頼まれた文章と、その場で読めるものだけを手がかりに動きます。守るルール、触ってよい範囲、仕事の手順書、確かめる役、参考にする材料が置かれていなければ、毎回その場の判断で進めるので、仕上がりにばらつきが出ます。
この記事では、当社(RealAIze)が実際に使っている環境を例に、仕事が通る6つの工程、安全に動かすためのルール・権限・フックの違い、質を揃える手順書と検品の置き方を図解で説明します。ホームページの更新なら何から置けばよいかも、併せて紹介します。
AIエージェントが思った通りに動かないのはなぜ?
多くの場合、足りないのは指示文の工夫ではなく、AIの周りに置く「環境」です。AIエージェントは、文章で頼むと、ファイルの読み書きや外部サービスの操作まで自分で進めるAIです。Claude Code(Anthropicが提供)やCodex(OpenAIが提供)が代表で、2つの違いはClaude CodeとCodexの比較にまとめています。
AIエージェントは、頼まれた文章と、その場で読めるものだけを手がかりに動きます。守る決まりも、進め方も、仕上がりの基準も渡されていなければ、毎回その場の判断で進めるしかなく、同じ依頼でも日によって仕上がりが変わります。
SNSで見かけた使い方をまねても同じ結果にならない理由も、ここにあります。画面に見えている指示は短くても、その裏には、ルールと手順書と参考にする材料が先に置かれています。指示が短くて済むのは、環境が代わりに説明しているからです。
この記事でいう環境は、ルール、権限、フック、スキル(手順書)、ナレッジなど、AIエージェントの周りに置くものを1つにまとめた仕組みを指します。英語ではハーネス(harness。元は馬具の意味)とも呼ばれます。もっと分かりやすく言うと、新しく入った人に渡す就業規則、業務マニュアル、鍵の範囲、ダブルチェックの決まりの一式です。

AIエージェントの環境とは?仕事が通る6つの工程
環境は、頼んだ仕事が通っていく道として見ると分かりやすくなります。当社(RealAIze)の環境では、仕事は次の6つの工程を順に通ります。
- 入り口:人が頼む。パソコンの画面、スマホ、決まった時刻に動く定期の仕事から入る
- ルールと権限:守る決まりと、触ってよい範囲を確かめる
- 振り分け:手順書を使うか、他のAIや外部サービスに頼むかを決める
- 手順書(スキル):仕事ごとの進め方と仕上がりの基準に沿って作る
- 担当と検品:作る役と確かめる役に分かれ、基準に届くまで直す
- 出口:多くの仕事は下書きやファイルで止め、人が確かめてから公開・送信する

当社では入り口をClaude Code1つに決めています。机のパソコンから頼む日も、外出先のスマホから頼む日もありますが、受け取るのはいつも同じAIエージェントです。スマホからの操作には、手元のパソコンで動いているClaude Codeを、スマホやブラウザから続けて使えるRemote Controlを使っています(2026年11月時点)。
画像の生成や長い資料の確認のように、他のAIが得意な仕事は、Claude CodeからCodexやGemini(GoogleのAI)に回します。人が道具を使い分けるのではなく、司令塔のAIエージェントが振り分ける形です。
6つの工程を支える部品は次の7つで、この記事ではこの7つを合わせて環境と呼びます。
部品 | 役割 | 会社に例えると |
|---|---|---|
ルール(CLAUDE.md) | 毎回読む決まりごと | 就業規則 |
権限(settings.json) | 許可・確認・禁止の線引き | 鍵と決裁の範囲 |
フック | 決まったきっかけで必ず動く処理 | 必ず通る受付 |
スキル | 仕事ごとの手順書 | 業務マニュアル |
サブエージェント | 作業や検品を受け持つ担当 | 担当者とチェック係 |
ナレッジ | 参考にする材料の置き場 | 社内の共有フォルダ |
外部連携(MCP・API) | 他のサービスを操作する接続 | 社外との連絡窓口 |
AIエージェントを安全に動かすには?ルール・権限・フックの違い
安全を支える仕組みは、ルール、権限、フックの3つです。3つは効き方が違うので、止めたい操作の重さに合わせて書く場所を分けます。

ルール(CLAUDE.md)は、お願いとして読まれる
CLAUDE.mdは、Claude Codeが会話の始めに毎回読み込む、指示を書いたファイルです。当社では「日本語は自然な言い回しで書く」「メモは決めた場所に残す」「出来上がったものは必ず見直す」といった決まりを書いています。
ただし、書いたことが必ず守られるわけではありません。公式ドキュメントは、CLAUDE.mdは文脈として扱われ、強制される設定ではないと説明しています(2026年11月時点)。人への申し送りに近いもの、と考えると実態に合います。
権限(settings.json)は、設定として強制される
必ず止めたい操作は、settings.jsonという設定ファイルの権限に書きます。権限のルールはallow(確認なしで許可)、ask(実行の前に人に確認)、deny(禁止)の3種類です。公式ドキュメントによると、判定はdeny、ask、allowの順で、禁止に当てはまった操作は、他で許可していても実行されません(2026年11月時点)。
当社ではファイルの削除と、チャットツール上の投稿の削除を禁止に入れています。一度困った操作は、同じことが起きないよう、その場で権限に足すようにしています。
ただし、コマンドの書き方によっては、禁止のルールに当てはまらないことがあります。守りたいフォルダは、次に説明するフックでも止めるようにしています。
フックは、決まったきっかけで必ず動く
フックは、「ファイルを書き換える前」のような決まったタイミングで、必ず実行される処理です。公式ドキュメントは、AIの判断に頼らず、決まった動作を必ず起こすための仕組みと説明しています(2026年11月時点)。例えば、当社では次のような処理を入れています。
- 文章を書く場面になったら、判断専用のAI(仕上がりを確かめる別のAI)を必ず動かす
- 特定のフォルダの中身を消そうとしたら、その場で止める
- 作業が終わったら、メモアプリに記録を残す
3つの違いを表にまとめます。
項目 | ルール(CLAUDE.md) | 権限(settings.json) | フック |
|---|---|---|---|
効き方 | 文脈として読まれる。強制ではない | 設定として強制される | 決まったきっかけで必ず実行される |
向く内容 | 書き方、進め方、報告の形 | 許可・確認・禁止の線引き | 特定の場面での確認や停止 |
当社の例 | 出来上がったものは必ず見直す | ファイルの削除は禁止 | 特定のフォルダを消そうとしたら止める |
APIキーは1か所にまとめ、実物を置かない
APIキーは、外部のサービスをプログラムから使うための合言葉です。漏れると、他人に勝手に使われて料金が発生することがあります。
当社ではAPIキーを1つのファイルにまとめていますが、そのファイルに書いてあるのはパスワード管理ツールへの参照だけです。キーそのものは置いていないので、ファイルが外に出てもキーの文字列は漏れません。
ホームページそのものの守り方は、AI時代のホームページのセキュリティにまとめています。
成果物の質を揃えるには?手順書・担当分け・検品
質を揃える仕組みは、仕事ごとの手順書、作る役と確かめる役の分担、基準に届くまで戻す流れの3つです。
手順書(エージェントスキル)は、小さい仕事ごとに作る
エージェントスキルは、仕事の手順と仕上がりの基準をフォルダにまとめて、AIに渡す仕組みです。中身と作り方はエージェントスキルの解説に書きました。
当社ではスキルを小さい仕事ごとに作り、組み合わせて大きな仕事をこなしています。動画なら、カット、テロップ入れ、図の作成が別々のスキルです。資料作成のスキルは取引先ごとに分け、デザインが混ざらないようにしています。
作る担当と確かめる担当を分ける
サブエージェントは、特定の仕事だけを受け持つ専任のAIです。公式ドキュメントによると、サブエージェントは自分専用の作業スペースで動き、結果の要約だけを返します(2026年11月時点)。
当社ではスキルごとに、作る担当と確かめる担当のサブエージェントを用意して、同時に進めています。1体のAIが全部を順番にこなすより速く、それぞれが1つの仕事に集中できるので、仕上がりも安定します。

判断は、別のAIに毎回確かめさせる
当社では作業の節目に、判断専用の小さなAIを挟んでいます。確かめるのは、段取りは妥当か、出来上がったものは基準に届いたか、日本語の言い回しは自然か、の3点です。
画像は画像を読めるAIに見せます。文字が崩れていないか、スクリーンショットに個人情報が写り込んでいないか、図の矢印や要素が重なっていないかを確かめ、問題があれば作り直しです。作ったAIの自己申告に頼らず、別の目を入れる形にしています。
得意なAIに回す
画像の生成はClaude CodeからCodexに頼みます。出来上がったものの確認も他のAIに回していて、普段はCodex、文章量が多いものや長い動画は、一度に読める量が大きいGeminiに見てもらいます。
ナレッジとは?AIが自分で取りに行く材料の置き場
ナレッジは、AIが仕事のたびに参照する材料の置き場です。材料を毎回コピーして渡すのではなく、決まった場所に置いておき、AIが必要なときに自分で取りに行きます。当社が置いているのは、主に次の4つです。
- 過去のやり取りの記憶:Claude Codeには、直された内容などを自動で覚える機能があります(公式ドキュメント、2026年11月時点)。これまでの仕事の内容が、次の仕事に引き継がれます
- AIが書くAI用のメモ:スキルの使い方、メールマガジンの配信の履歴、SNS投稿のネタなどを、AIがメモアプリのObsidianに書き溜めています
- 直された言い回し:「この日本語は使わない」と伝えた表現を一覧に溜めて、次から避けさせます
- デザインシステム:色・書体・部品の決まりをまとめたものです。資料の見た目が毎回揃い、取引先ごとに使い分けられます

このほか、Googleドライブの資料も参照先にしています。公開しているサイトのソースはGitHubで管理し、複数のパソコンと作業者で同じものを使えるようにしました。
当社の経験では、成果物の精度への影響が大きいのは、このナレッジです。材料が増えるほど、短い指示で期待どおりのものが出るようになります。
外部サービスとつなぐには?MCPとAPIの使い分け
外部サービスとのつなぎ方は、MCPとAPIの2つです。MCPは、AIとアプリをつなぐ共通の規格で、対応しているサービスなら設定を足すだけでAIから操作できます。仕組みと使い方はMCPの解説にまとめました。MCPが用意されていないサービスは、API(ソフトどうしがやり取りするための入り口)をAPIキーで呼び出します。
つなぎ方 | 向く相手 | 当社の例 |
|---|---|---|
MCP・コネクタ | MCPに対応しているサービス | メールの仕分け、ドライブの検索、請求書の作成、サイトの記事の登録 |
API | MCPが用意されていないサービス | 動画の生成、ナレーションの音声合成 |
実際の仕事ではどう動く?ブログ・動画・請求書の例
環境があると、1つの依頼は「作る、確かめる、直す」を何度か回ってから人の手元に届きます。当社の3つの仕事で見てみます。
ブログ記事は、材料を渡して頼むところから始まります。AIエージェントは依頼の種類を見分けてスキルを選び、材料を読んで、足りない情報を調べます。図、検索向けの題と説明文、本文の順に作ったら、次は推敲と検品です。そのあとMCPでつないだCMS(記事や画像を管理する仕組み)に下書きを登録し、元の材料と照合します。問題が見つかれば前の工程に戻る流れで、公開するのは人が読んでからです。

動画は、確かめる回数がさらに増えます。デザインを決め、ナレーションの音声を作り、画面を静止画の段階で確かめて、崩れていれば直す。動画に組んでからもう一度検品し、別のAIにも完成品を見せたうえで、最後の判断に進みます。当社の例では1本できるまでに20〜30分かかりますが、確かめる工程を何か所にも入れているので、質の高いものが出てきます。
請求書は、途中に人の確認を入れています。AIエージェントが会計ソフトで取引先を探し、金額の確認表を出したところで、一度人に見せる流れです。金額が合っていれば請求書を作り、PDFを保存して報告します。お金に関わる仕事は、最後だけでなく途中にも人が入る形にしました。
仕事 | AIエージェントが進めるところ | 人が入るところ |
|---|---|---|
ブログ記事 | 材料の読み込み、図、本文、推敲、検品、下書きの登録 | 最後に読んで公開する |
動画 | デザイン、音声、画面づくり、複数回の検品 | 完成品を確かめる |
請求書 | 取引先の検索、金額の確認表、作成、PDFの保存 | 作成の前に金額を確かめる |
どこに人の確認を入れるかの考え方は、AIに任せる仕事と、任せない仕事の見分け方で説明しています。
ホームページの更新に置き換えると、何を置けばよい?
ホームページの更新なら、当社の想定では、まず次の4つから始めるのがよいです。
- ルール:社名や商品名の表記、書いてはいけないこと
- 権限:AIの操作は下書きの登録まで。公開は人が行う
- 手順書:お知らせ1件の作り方。入力欄、文字数、確かめる項目
- 検品:日付・金額・固有名を、渡した材料と照合する

権限は、AIエージェントの設定だけでなく、CMSの側でも決められます。当社がサイトに使っているEmDash(Cloudflare上で動くCMS)では、AIをつなぐ利用者の役割を「寄稿者(Contributor)」にすると、AIができるのは下書きの作成と編集までです。公開には投稿者(Author)以上の役割が要ります(EmDashの公式ドキュメント、2026年11月時点)。役割を先に絞っておけば、指示を間違えても公開までは進みません。
動画や請求書まで広げるのは、お知らせの更新が安定してからで間に合います。学ぶ順番の全体は、AI活用力を上げる7つの項目にまとめました。
AIエージェントの環境の作り方は?頼んで1つずつ置く
環境は、AIエージェント自身に頼んで作れます。設定ファイルを人が一から書く必要は、ほとんどありません。おすすめの進め方は次のとおりです。
- 毎週繰り返している仕事を1つ選ぶ
- その仕事をAIエージェントに頼み、直してほしい点を言葉で伝える
- 直した内容を、ルールか手順書に残すよう頼む
- 困った操作が起きたら、権限かフックに足すよう頼む
- 仕上がりが安定しないところに、確かめる担当を足す
当社の環境は、いまではファイルの数が数百になっています。ただ、一度に作ったものではありません。仕事を頼み、直し、その直しを残す。この繰り返しで1つずつ増えてきたものです。
人の側に要るのは、設定の書き方の知識よりも、どの部品が何のためにあるかの理解です。「これは必ず止めたいから権限に入れて」「これは毎回同じ手順だからスキルにして」と頼めれば、あとはAIエージェントが形にします。
よくある質問
AIエージェントの環境(ハーネス)とは何ですか?
AIエージェントが仕事のたびに読むルール、使う手順書、触ってよい範囲、仕上がりを確かめる仕組みをまとめたものです。新しく入った人に渡す就業規則、業務マニュアル、鍵の範囲、ダブルチェックの決まりの一式にあたります。環境があると、短い指示でも同じ質で仕上がるようになります。
CLAUDE.mdとsettings.jsonの違いは何ですか?
CLAUDE.mdはお願いとして読まれるルール、settings.jsonの権限は設定として強制される線引きです。Claude Codeの公式ドキュメントは、CLAUDE.mdは文脈として扱われ、強制される設定ではないと説明しています(2026年11月時点)。書き方や進め方はCLAUDE.mdに、必ず止めたい操作は権限に書きます。
AIエージェントにファイルを消されないようにするには、どうすればよいですか?
settings.jsonの権限で、削除の操作をdeny(禁止)に入れます。Claude Codeの権限は、deny、ask、allowの順に判定され、禁止に当てはまった操作は、他で許可していても実行されません(2026年11月時点)。ただし、コマンドの書き方によっては禁止のルールに当てはまらないことがあるので、守りたいフォルダはフックでも止めるようにします。
フックとは何ですか?
フックは、「ファイルを書き換える前」のような決まったタイミングで、必ず実行される処理です。AIの判断に頼らず、決まった動作を必ず起こしたいときに使います。当社では、特定のフォルダの中身を消そうとしたら止める、作業が終わったらメモアプリに記録を残す、といった処理を入れています。
サブエージェントを使うと、何が変わりますか?
作る担当と確かめる担当を分けて、同時に進められるようになります。サブエージェントは特定の仕事だけを受け持つ専任のAIで、自分専用の作業スペースで動き、結果の要約だけを返します。当社の経験では、1体のAIが全部を順番にこなすより速く、仕上がりも安定します。
プログラミングができなくても、AIエージェントの環境は作れますか?
作れます。ルールや手順書、権限の設定は、AIエージェントに「こういう環境にしたい」と頼めば形にしてくれます。人の側に要るのは、設定の書き方の知識よりも、どの部品が何のためにあるかの理解です。必ず止めたい操作は権限に入れる、といった使い分けを先に押さえておくと進めやすくなります。
環境づくりは、何から始めればよいですか?
毎週繰り返している仕事を1つ選び、その仕事で直した内容をルールか手順書に残すところから始めます。ホームページの更新なら、当社の想定では、表記のルール、AIは下書きまでという権限、お知らせ1件の手順書、日付や金額を材料と照合する検品の4つから始めるのがよいです。困った操作が起きたら、その都度、権限かフックに足します。
