2026年11月1日

claude agentの意味は4つ|Claude Code・Agent SDK・Managed Agentsの違い

claude agentで調べた人がまず知るべき、4つの意味の見分け方

同じ言葉で呼ばれているものが、そもそも複数ある

室谷室谷代表取締役
この言葉でたどり着くと、全然違うものが同じ名前で出てくるんですよね。Claude Codeのエージェント機能、Claude本体のチャット、Agent SDK、Managed Agents・・・ここを混ぜたまま読み進めると、料金の話も噛み合わなくなります。
テキトー教師テキトー教師DotAI 認定講師
初めて触る人が最初に戸惑うのがまさにそこです。「エージェントって書いてあるけど、どれの話?」と。

目的が違うものを同じ呼び名でまとめてるだけなので、切り分けてしまえば一気に楽になります。
室谷室谷代表取締役
あと名前が似ていて厄介なのがコマンドの方で。claude agents を打つとエージェントビューという画面が開きます。

バックグラウンドで走っているセッションを一覧で監視するためのもので、カスタムサブエージェントを管理する /agents とは別物なんですよ。公式ドキュメントにも紛らわしいと明記されています。
テキトー教師テキトー教師DotAI 認定講師
そこは現場でも混ざりやすいところです。複数のタスクを同時に扱う入口としては、サブエージェント、エージェントビュー、エージェントチーム、動的ワークフロー、プロジェクト、と何股にも分かれているので、まず「どれの話を読んでいるのか」を決めるのが先ですね。

Claude Codeのエージェント機能は、何を自動でやってくれるのか

室谷室谷代表取締役
Claude Codeの場合、答えて終わりではなくて、ファイルを読む・編集する・コマンドを実行する・Web検索する、を自分で判断して呼び出すわけです。さらにその中に、専用の担当としてサブエージェントを置ける。
テキトー教師テキトー教師DotAI 認定講師
作業部屋を分けて渡すイメージです。サブエージェントは独自のコンテキストウィンドウとシステムプロンプト、ツールアクセス、権限を持つので、本筋の会話を汚さずに調べ物だけ任せられる。

ただ、使用量は同じ使用制限にカウントされます。
室谷室谷代表取締役
そこ、経営目線だと見落とされがちで。別の会話だから別枠でしょ、と思われがちなんですが、同じプールから引かれていくんですよね。

試算が崩れる原因はだいたいここです。
テキトー教師テキトー教師DotAI 認定講師
その認識ズレは現場でもよく聞きます。

Agent SDK・Managed Agents・Claude本体は、それぞれ何者か

室谷室谷代表取締役
SDKとManaged Agentsは毛色が違います。Agent SDKはClaude CodeをライブラリとしてPythonやTypeScriptから呼び、自分のアプリにエージェントを組み込むためのもの。
テキトー教師テキトー教師DotAI 認定講師
手元で動かす道具ではなく、プロダクトに載せる部品なんですよね。しかもサブスクのログインやレート制限は使えず、Anthropic Consoleで発行するAPIキー認証が必須。

ここで手が止まる人が多いです。詳しくはClaude Agent SDK入門|PythonとTypeScriptで動かす前に知る料金と権限の話で解説しています。
室谷室谷代表取締役
Managed AgentsはAnthropic側がホストする、組み上げ済みのエージェントハーネスです。数分から数時間の長時間実行や非同期タスクに向いていて、Agent・Environment・Session・Eventsという4つの概念で組み立てる形。

2026年時点ではベータ扱いですね。
テキトー教師テキトー教師DotAI 認定講師
Claude本体のチャットは、いわゆる普通の対話相手です。同じClaudeでも、できることと課金の入口がまったく別物なんですよ。

誰が使うか・何が手に入るか・課金方式で並べるとどうなる?

室谷室谷代表取締役
ここまでを並べると、判断が早いんですよね。
名前何者か誰が使うか課金の入口
Claude Code(サブエージェント)ツールを自分で呼び出すエージェント。専用担当を分けられる手元の開発作業をする人有料プラン(Pro/Max/Ultra)に含まれ、チャットと同じ使用量プール
エージェントビュー(claude agents)バックグラウンド実行中のセッションを一覧・監視する画面並列で回す開発者Claude Codeの利用に含まれる(詳細は公式で確認を)
Agent SDKClaude Codeをライブラリとしてアプリに組み込むSDKプロダクトに載せる開発者APIキーによる従量課金(サブスクの上限とは別体系)
Managed AgentsAnthropicがホストする事前構築済みハーネス長時間・非同期タスクを回す人APIキーによる従量課金。2026年時点はベータ
Claude本体のチャット対話相手としてのClaudeふだん使いの人Free / Pro / Max / Ultra のサブスク
テキトー教師テキトー教師DotAI 認定講師
表にすると、日常で使うのか、プロダクトに組み込むのかで入口がはっきり分かれますね。
室谷室谷代表取締役
一番の落とし穴は課金の入口が違うことで。サブスク内で収まる話と、APIキーで従量課金になる話を同じ財布で考え始めると、社内の予算が一瞬で狂います。

まずどっちの財布か、を決めてから触るのが安全です。

サブエージェントとマルチエージェント、エージェントチームは何が違う?

サブエージェントは単一セッション内の専任担当

室谷室谷代表取締役
まず言葉の整理から。サブエージェントって、要は1つの会話セッションの中にいる「専任担当」なんですよ。

独自のコンテキストウィンドウとシステムプロンプトを持って、メインの会話とは別にリクエストを投げる。使用量は同じ使用制限にカウントされる仕組みです。
テキトー教師テキトー教師DotAI 認定講師
現場でよく聞くのは「じゃあ別のAIが増えるんですか?」なんですよ。増えるというより、同じセッションの中で役割を分けてるイメージですね。

組み込みだと Explore が読み取り専用でコードベースを探す係、Plan が計画前の調査係。General-purpose は探索も変更も必要な複雑なタスク用です。
室谷室谷代表取締役
だからメインの会話が汚れないわけですね。ここ、地味にデカいと思ってて。

長い会話に探索ログが混ざると、後半の判断がだんだん鈍るじゃないですか。分業ってコスト削減の基本中の基本ですから。
テキトー教師テキトー教師DotAI 認定講師
たしかに。ひとつの机に資料を山積みにしないのと同じ理屈ですね。

バックグラウンドエージェントとエージェントチームの使い分け

室谷室谷代表取締役
で、一段上がるのがバックグラウンドエージェント。独立したセッションを複数並行で走らせて、1か所でまとめて監視する形なんですよね。

並列に走らせたいけど、人間が横で見張りたい場面です。
テキトー教師テキトー教師DotAI 認定講師
エージェントチームはまた別で、Claude自身がセッションを生んで監督する側に回る構成です。ただここ、前提を飛ばすと事故るんですよ。

エージェントチームは実験的機能で、デフォルトでは無効。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化しないと動きません。
室谷室谷代表取締役
それは先に書いておかないと。設定したつもりで「動かない」って問い合わせになるパターンですね。

構造としては、監督する側がいる方が人数を増やしやすい。人を増やすより安いかは別として、管理コストの設計問題として面白いですよね。
テキトー教師テキトー教師DotAI 認定講師
その住み分けはClaude CodeのAgent Teamsとは?Subagentとの違いとコスト・使い方を整理でさらに細かく整理されてます。

複数のclaude agentsを並べるべき場面、1体で足りる場面

室谷室谷代表取締役
じゃあ何体並べるべきか。僕の感覚だと、タスクが互いに独立してる時だけ増やす。

リサーチAとリサーチBと検証Cみたいに、片方の結果がもう片方に効かないやつですね。
テキトー教師テキトー教師DotAI 認定講師
逆に1体で足りるのは、作業が一直線のときです。実装して確認して直す、のように順番が決まっているなら、分けても待ち時間が増えるだけ。

初めて触る人がハマるのはだいたいここで、とりあえず分ければ速くなると思ってしまうんですよ。
室谷室谷代表取締役
それはROIで言うとマイナスなんですよ。エージェントを増やすほど、コンテキストの受け渡しと結果の突き合わせという手間が乗る。

並列化は「待ち時間より調整コストが安い」と確認できたときだけ効きます。ここを見極められるかが、たぶんこれからの開発の勘所ですね。
テキトー教師テキトー教師DotAI 認定講師
なるほど。数を増やすのが上手さじゃない、と。

カスタムサブエージェントの作り方、保存場所はどう選ぶ?

スラッシュコマンドから作る場合と、ファイルを直接置く場合

サブエージェントの保存場所と使い分け
プロジェクト
  • `.claude/agents/` に置く
  • 案件固有の専用エージェント向け
  • 客先案件の専用エージェントを閉じ込める運用
全プロジェクト共通
  • `~/.claude/agents/` に置く
  • 個人の道具箱
  • 共通のレビュー用はホームに置く運用
室谷室谷代表取締役
サブエージェントの作り方、結局2ルートなんですよね。/agents を打ってClaudeに頼むか、.claude/agents/ や ~/.claude/agents/ にMarkdownファイルを直接置くか。
テキトー教師テキトー教師DotAI 認定講師
現場でよく聞くのは「どっちが正解なんですか」なんですけど、中身は同じMarkdownなんですよ。Claudeに雛形を作らせてから手で直すのが、たぶん一番早いです。
室谷室谷代表取締役
そうですね。YAMLフロントマターと本文のプロンプト、構造は1個覚えれば済む。

で、必須がnameとdescriptionだけという割り切りが効いてるんですよ。
テキトー教師テキトー教師DotAI 認定講師
そこ、最初に戸惑うのが「全部書かないと動かない」と思い込むパターンですね。任意項目はあとから足せますから、まず2行で動かすのがおすすめです。

フロントマターの必須項目はnameとdescriptionだけ

室谷室谷代表取締役
任意項目はどこまで見ておけばいいんですかね。tools、model、maxTurns、permissionMode、isolation あたりが並んでますけど。
テキトー教師テキトー教師DotAI 認定講師
最初は tools と description だけで十分だと思います。description が曖昧だと、呼ばれるべき場面で呼ばれないんですよ。

ここが体感で一番効きます。
室谷室谷代表取締役
なるほど。運用で詰まったら model や isolation を足す、と。

細かい設定項目はエージェント機能の完全解説にまとまってるので、そっちを参照するのが早いですね。
テキトー教師テキトー教師DotAI 認定講師
はい。あと tools を省略すると全ツールを継承するので、読み取り専用にしたいなら明示的に絞る。

任せる範囲を決めるのが設計の第一歩です。

プロジェクト用・全プロジェクト共通・組織管理、優先順位で決まる

Claude Code公式ドキュメントのサブエージェント保存場所・優先順位の表(code.claude.com、2026年)

室谷室谷代表取締役
保存場所、ここが地味に設計判断なんですよね。プロジェクトの .claude/agents/ に置くか、ホームの ~/.claude/agents/ に置くか、管理設定で配るか。
テキトー教師テキトー教師DotAI 認定講師
優先順位は 管理設定 > --agents フラグ > プロジェクト > 全プロジェクト共通 > プラグイン、の順です。同名だと上が勝つので、チームで上書きしたいときに効きます。
室谷室谷代表取締役
組織で統制したいなら管理設定、個人の道具箱はホーム、案件固有はプロジェクト。MYUUUだと、共通のレビュー用はホームに置いて、客先案件の専用エージェントだけプロジェクトに閉じ込める運用にしてます。
テキトー教師テキトー教師DotAI 認定講師
その分け方いいですね。全プロジェクト共通に何でも置くと、意図しない場面で発火するので。

範囲が広いほどdescriptionは慎重に、が現場感覚です。

作り直したのに反映されないときの落とし穴

室谷室谷代表取締役
で、ここが今日いちばん聞きたかったところで。ファイル直したのに反映されない、みたいな話です。
テキトー教師テキトー教師DotAI 認定講師
編集や追加は数秒で検出されて、再起動はいらないんですよ。ハマる人が多いのは、agentsディレクトリを新しく作った直後と、add-dir で足したディレクトリ配下。

この2つは再起動が要ります。
室谷室谷代表取締役
なるほど、ディレクトリの新設だけ別扱いなんですね。あとは置き場所の優先順位で、上に同名ファイルが残ってて古い定義が読まれてる、みたいな。
テキトー教師テキトー教師DotAI 認定講師
まさにそれです。反映されないなと思ったら、まず同名ファイルが上の階層にないか見る。

それでもダメなら再起動。この順番で切り分けると早いです。

エージェントチームやマルチエージェントはどう作って動かす?

チーム構成にするとき、Claudeに何を監督させるか

室谷室谷代表取締役
ここ、順番を間違えるとだいたい失敗するんですよ。先にツールを設定するんじゃなくて、仕事をどう分けるか、その分けた仕事を誰が監督するかを先に決める。

エージェントチームはClaudeが生成して監督する、調整されたセッションのチームという位置づけなので、監督する側の判断基準がないと成立しないんですよね。
テキトー教師テキトー教師DotAI 認定講師
現場でよく聞くのは、いきなり人数から決めちゃうパターンです。「何を任せて、何をClaudeに見張らせるか」が曖昧なまま増やすと、誰の成果か分からない作業が増えるだけなんですよ。
室谷室谷代表取締役
経営の感覚で言うと、分担表がないまま人を増やすと調整コストだけが増える。人件費でも同じことが起きますから。

あと動かす前提として、エージェントチームは実験的機能でデフォルトでは無効なんです。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定しないと始まらないので、そこは先に押さえておきたいところですね。

複数走らせたとき、全体はどこで見るのか

室谷室谷代表取締役
並行で走らせ始めると、今どれが動いてるのか分からなくなる。その入口がエージェントビューで、バックグラウンドで実行中のセッションを一覧で見られるんですよ。

カスタムサブエージェントを作る・管理する /agents とは別物で、公式も名前が似ていて紛らわしいと明記してます。
テキトー教師テキトー教師DotAI 認定講師
そこ、初めて触る人がだいたい混同しますね。「作る・管理する」が /agents、「走っているものを眺める」がエージェントビュー、と役割で分けて覚えると整理しやすいです。

配布されているテンプレート集を使う前に確認したいこと

室谷室谷代表取締役
エージェント定義をまとめたテンプレート集が配られていて、git clone してインストールスクリプトを流すと ~/.claude/agents/ に一気に入る、というものもあります。ただあれ、Anthropic公式ではなくてOSSコミュニティの製品なんですよ。
テキトー教師テキトー教師DotAI 認定講師
手軽に見えるんですけど、中身が分からないまま入れるのは怖いですね。どのツールを許可している定義なのか、一度は目を通しておきたいです。
室谷室谷代表取締役
定義はYAMLフロントマターとMarkdownのテキストなので、その気になれば読めます。nameとdescription、あとtoolsだけでも確認しておくと、意図しない権限で動く事故は減りますから。

自作エージェントを増やすほど効くとは限らない理由

テキトー教師テキトー教師DotAI 認定講師
最初に戸惑うのが、増やせば速くなると思ってしまうところで。切り分けが甘いと、同じ調査を何本も並行して走らせるだけになります。
室谷室谷代表取締役
サブエージェントは独自のコンテキストウィンドウを持つので、メイン会話を汚さずに済むのが効くところ。ただ別リクエストとして送る以上、使用量は同じ使用制限にカウントされる。

増やすほど枠を食う構造なんですよね。
テキトー教師テキトー教師DotAI 認定講師
分けたあとに統合する手間も含めて判断、ですかね。作る前に「これは分ける価値があるか」を一回挟むだけで、だいぶ変わります。
室谷室谷代表取締役
そこは並列化の設計そのものなので、詳しくはClaude Codeの並列実行・並列処理完全ガイドで解説しています。数を増やすより、分ける単位を揃えるほうが結果的に速いんですよ。

サブエージェントは同時にいくつまで動かせる?

公式ドキュメントにデフォルト上限の明示はない

サブエージェント並列化の要点
デフォルト上限は非明示
公式ドキュメントにデフォルト上限の明示なし。「3〜5並列が目安」は体感値で仕様ではない
設定で絞る発想
上限を探すより maxTurns や tools などの項目で制御する
ツールアクセスの2段フィルタ
1段目: Agent・AskUserQuestion・EndConversation 等を全サブエージェントから除外。2段目: バックグラウンド実行時は Read・Grep・Glob・Bash・Edit・Write 等に絞られる。フォークは適用外
コストとファイルの取り合い
使用量はメイン会話と同じ使用制限にカウント。同一ファイルは後から書いた方で上書きされる
isolation で worktree 指定
作業ディレクトリを分けてぶつからない形にする。並列数を上げるより有効
室谷室谷代表取締役
ここ、けっこう聞かれるんですよ・・・。「サブエージェントって何個まで同時に動かせるの?」って。

で、公式ドキュメントを追いかけると、デフォルトの上限って明示されていないんですよね。
テキトー教師テキトー教師DotAI 認定講師
そこ、現場で一番モヤッとするやつです。「3個まで」みたいな数字を探しちゃうんですけど、書いてないんですよ。
室谷室谷代表取締役
ネットだと「3〜5並列が目安」みたいな話が回ってますけど、あれは誰かの環境での体感値であって仕様じゃない。数字を鵜呑みにして仕組みを組むと、後で崩れるんですよね。
テキトー教師テキトー教師DotAI 認定講師
初めて触る人は、上限というより「設定でどう絞るか」を見た方が早いですね。maxTurns とか tools とか、そういう項目で制御する発想に切り替わります。

ツールアクセスの2段フィルタとバックグラウンド実行の制約

テキトー教師テキトー教師DotAI 認定講師
並列数を考える前に知っておきたいのが、ツールアクセスの2段フィルタなんです。1段目は Agent や AskUserQuestion、EndConversation みたいな一部のツールが、全サブエージェントから除外される、と。
室谷室谷代表取締役
2段目はバックグラウンドで走らせたときの話ですよね。組み込みツールが Read、Grep、Glob、Bash、Edit、Write あたりに絞られる。

つまり裏で動かすほど、できることが狭くなるわけです。
テキトー教師テキトー教師DotAI 認定講師
ここ、ハマる人多いんですよ。「並列で走らせたのに、さっきまでできた操作ができない」って。

フォークはこの2段が適用されないので、そこも挙動が変わるポイントです。
室谷室谷代表取締役
だから並列を増やすなら、まず「この子に何をさせるか」を絞る。全部できる子を10個並べるより、仕事を切って渡す方が結果的に速いんですよね。

並列を増やすとぶつかるのは、コストとファイルの取り合い

室谷室谷代表取締役
実際に増やしていくと必ずぶつかるのが、コストとファイルの取り合いで。サブエージェントの使用量はメインの会話と同じ使用制限にカウントされるので、並べた分だけ消費が速く進みます。
テキトー教師テキトー教師DotAI 認定講師
しかも同じファイルを複数の子が触ると、後から書いた方で上書きされて。現場感覚で言うと、ここで一度手戻りが起きると、並列にした意味がほぼ消えます。
室谷室谷代表取締役
なので isolation で worktree を指定して、作業ディレクトリを分ける。経営目線で言うと、並列数を上げるより「ぶつからない形に分ける」方が、時給あたりのリターンは大きいんですよ。
テキトー教師テキトー教師DotAI 認定講師
並列の詰め方はClaude Codeの並列実行・並列処理完全ガイドでworktreeの使い方まで整理されてますので、そっちを見ると設計の絵が描きやすいです。

エージェントに任せても安全?権限とリスクの管理

toolsとdisallowedToolsで、できることを先に削る

室谷室谷代表取締役
サブエージェントの設定って、まず何から決めるのが正解なんでしょう。業務で使う前提だと、権限の話を飛ばして動かすのは正直怖いんですよね。
テキトー教師テキトー教師DotAI 認定講師
現場感覚で言うと、最初に戸惑うのが「何を許可するか」より「何を禁止するか」なんですよ。許可リストだけ見て安心しちゃう人が多いんです。
室谷室谷代表取締役
そこは順番の話で。フロントマターの tools が許可リスト、disallowedTools が拒否リスト。

tools を省略すると全ツールを継承するので、書かないこと自体が一番危ない選択になるんですよ。
テキトー教師テキトー教師DotAI 認定講師
加えてツールアクセスには2段のフィルタがあって、Agent や AskUserQuestion といった一部は全サブエージェントから除外される仕組みです。バックグラウンド実行のときは組み込みツールが Read/Grep/Glob/Bash/Edit/Write あたりに絞られるので、その前提で設計すると安全側に寄りますね。

permissionModeとworktree分離で被害を閉じ込める

室谷室谷代表取締役
permissionMode と isolation って、セットで考えるものなんですか。
テキトー教師テキトー教師DotAI 認定講師
別物なんですが、狙いは同じで「事故が起きたときの被害範囲を先に決める」ことなんですよ。permissionMode は行動の許可、isolation に worktree を指定すると専用の git worktree で動く、という作業場所の分離ですね。
室谷室谷代表取締役
本番ブランチを触られない安心感は、経営目線だと保険料に近いんですよ。事故1回の対応コストを時給で換算すると、最初から入れておく方が安く済む。

設定が増えるほど「後でやろう」が積み上がるので、なおさらです。
テキトー教師テキトー教師DotAI 認定講師
maxTurns で回数の上限も切れます。項目が多いので細部はClaude Codeのエージェント機能完全解説に譲るとして、まず permissionMode と worktree の2つだけ決める、で十分始められますよ。

読み取り専用のExploreに任せる範囲の見極め方

室谷室谷代表取締役
Explore が読み取り専用という話でしたけど、実際どこまで任せていいんでしょう。
テキトー教師テキトー教師DotAI 認定講師
調べるだけで完結するなら Explore、直す必要があるなら別の担当、という線引きが基本ですね。General-purpose は探索と変更の両方が必要な複雑なタスク用で全ツールを持つので、そこは同じ棚に置かない方がいいんですよ。
室谷室谷代表取締役
読み取り専用に投げておけば、判断を外しても壊れない。任せる範囲を見極めるというより、壊れてもいい範囲から広げていく感覚に近いんですよね。
テキトー教師テキトー教師DotAI 認定講師
ここで迷うのが Plan との使い分けで。Plan は計画時の調査用なので、実装前の下調べは Plan、コードベースを広く見たいなら Explore、という住み分けで考えると整理しやすいです。

料金とトークン消費、どこで課金が分かれる?

いまのプランはFree・Pro・Max・Ultra、旧Max 5x/20xではない

claude.com/pricingの料金プランカード。Free・Pro・Max・Ultraの月額(日本からのアクセスはJCT込み表示、2026年)

室谷室谷代表取締役
まず前提の訂正からなんですけど。ネット上には「Max 5x」「Max 20x」って書いた記事がまだ残ってるんですよね。

あれは旧プラン名で、いまの公式の並びは Free・Pro・Max・Ultra の4つなんですよ。
テキトー教師テキトー教師DotAI 認定講師
たしかに、そこは混ざりやすいんですよ。古い記事を読んで「5xにしておけば安心」みたいに判断しちゃう人がいる。

料金ページを開いた時点で最新を見るのが一番早いですね。
室谷室谷代表取締役
日本から見ると10%のJCT込みで表示されて、Free $0、Pro は年間契約で月$18($220の一括請求)、月払いだと$22、Max が月$110、Ultra が月$220っていう並びなんですよね。地域や為替で変わるので目安ですけど。
テキトー教師テキトー教師DotAI 認定講師
そしてClaude Codeは有料プランに全部含まれてる。ターミナルで使ってもチャットと同じ使用量プールを共有する、というところが実務だと効いてきますね。

サブスクの使用上限とAPI従量課金は別の財布

サブスク使用上限 vs API従量課金
サブスクの使用上限
  • Free・Pro・Max・Ultraの4プラン
  • 5時間ごと・週ごとの使用上限
  • Claude Codeも有料プランに含まれる
  • ターミナル利用もチャットと同じ使用量プールを共有
  • サブエージェントの並列実行も同じ使用制限にカウント
API従量課金
  • Agent SDK・Managed Agentsが対象
  • Anthropic Consoleで発行するAPIキー認証が必須
  • claude.aiのログインやサブスクのレート制限は使えない
  • サブスクとは別の財布
  • Enterpriseはシート課金$20/月+API従量課金
室谷室谷代表取締役
ここが一番の落とし穴で。サブスクの5時間ごと・週ごとの使用上限と、Agent SDK や Managed Agents のAPI課金は、まったく別の財布なんですよね。
テキトー教師テキトー教師DotAI 認定講師
混同しやすいところですね。サブスク内だからタダだと思ってSDKを回して、Console側で従量課金が積み上がってた、という声は現場でよく聞きます。
室谷室谷代表取締役
Agent SDK は claude.ai のログインやサブスクのレート制限を使うことが許されてなくて、Anthropic Console で発行するAPIキー認証が必須なんですよ。だから設計した時点で「どっちの財布か」を決める必要がある。
テキトー教師テキトー教師DotAI 認定講師
単価は変わるので、見積もりは公式のAPI料金ページで都度確認が前提ですね。Enterpriseはシート課金$20/月+API従量課金という組み合わせになりますし。

サブエージェントは同じ使用量プールにカウントされる

室谷室谷代表取締役
で、サブエージェントを何個も走らせたときの話。あれはメイン会話とは別にリクエストを送るんですけど、使用量は同じ使用制限にカウントされるんですよね。
テキトー教師テキトー教師DotAI 認定講師
現場感覚で言うと、ここが一番ハマるんですよ。「別の窓だから別会計」というイメージで並列に回して、気づいたら上限に張り付いてた、と。
室谷室谷代表取締役
経営目線で言うと、並列数は「速さ」じゃなくて「消費レート」のパラメータなんですよ。何本まで同時に走らせるとどのくらいで枯れるかを先に測ってから増やすべきで。
テキトー教師テキトー教師DotAI 認定講師
逆に言えば、上限に当たる前に「どの処理を任せるか」を絞るのが先ですね。読み取り専用の役割に寄せるだけでも、無駄な消費はかなり変わります。

トークンを膨らませない任せ方の設計

室谷室谷代表取締役
消費を抑えるコツは、任せ方の設計そのものなんですよね。大きなファイルを丸ごと読ませるより、範囲を切って渡す。
テキトー教師テキトー教師DotAI 認定講師
初めて触る人は、とりあえず全部渡しがちなんですよ。で、応答が長いから「賢いんだな」と思ってしまう。

実際はコンテキストを食ってるだけ、という。
室谷室谷代表取締役
あとはモデルの使い分け。サブエージェントはフロントマターでモデルを指定できるので、軽い探索は軽いモデルに寄せる。

これだけで体感コストが変わるんですよ。
テキトー教師テキトー教師DotAI 認定講師
並列実行とあわせて設計を知りたい人は、Claude CodeのAgent Teamsとは?Subagentとの違いとコスト・使い方を整理に違いとコストの話がまとまってますね。

Claude Agent SDKとManaged Agentsはどんな場面で使う?

Agent SDKで自分のアプリに埋め込めるもの

室谷室谷代表取締役
Agent SDKは、Claude Codeの中身をライブラリとしてPythonやTypeScriptから呼べる形にしたものなんですよね。つまり自分たちのプロダクトの中にエージェントを埋め込める、と。
テキトー教師テキトー教師DotAI 認定講師
そうなんです。ここで混同されがちなのが、ターミナルで動いてるClaude Codeそのものと、SDKとして組み込む場合の違いで。

現場でよく聞くのは「自分のアプリからClaude Codeを呼べるんですか」という質問ですね。
室谷室谷代表取締役
呼べるんですよ。しかも同じツール群とエージェントループを持っている。

だから自前でツール実行のループを書き直さなくていい。ここは開発コストに直結する部分です。
テキトー教師テキトー教師DotAI 認定講師
実装の入り口はClaude Agent SDK入門にまとまってますが、まず「自分のアプリに組み込む」という用途がイメージできるかどうかが分かれ目ですね。

APIキー認証が必須で、サブスクのレート制限は使えない

テキトー教師テキトー教師DotAI 認定講師
ここが最初のつまずきで。Agent SDK上で動かすエージェントは、claude.aiのログインやサブスクのレート制限を使うことを許可されていないんですよ。
室谷室谷代表取締役
そう、Anthropic Consoleで発行するAPIキー認証が必須。サブスクで安く済ませる、という発想はここでは通用しないんですよね。
テキトー教師テキトー教師DotAI 認定講師
初めて触る人は「有料プランに入ってるのに動かない」で止まりやすいところです。従量課金の世界に切り替わる、と覚えておくといいと思います。
室谷室谷代表取締役
逆に言えば、誰がどれだけ使ったかが見える化される。経費の話としてはむしろありがたい面もあるんですけど、コスト管理を前提に設計しないといけないのは確かです。

Managed Agentsが向くのは長時間・非同期のタスク

室谷室谷代表取締役
一方のManaged Agentsは、Anthropicがホストする側で動く完成品のハーネスなんですよね。モデルやプロンプト、ツール、MCPサーバーをAgentとして定義して、EnvironmentとSessionとEventsで回す。
テキトー教師テキトー教師DotAI 認定講師
手元で動かすのではなく、向こうで動かしっぱなしにできるのが違いですね。数分から数時間かかる処理、cronによる定期実行、ステートフルなセッションが得意なんですよ。
室谷室谷代表取締役
常時動かす仕事を自前のサーバーで抱えると、落ちたときの運用コストが地味に効いてくる。そこを外出しできるかどうかは、事業の規模で判断が分かれるところです。
テキトー教師テキトー教師DotAI 認定講師
ただし2026年時点ではベータ扱いで、セッションが長期保存される性質上、ゼロデータ保持やHIPAAのBAAの対象外なんですよね。機密性の高いデータを扱うなら、そこは先に確認が必要です。

CLI・Client SDK・Agent SDK・Managed Agentsの使い分け

室谷室谷代表取締役
で、Anthropicはこの4つを用途で分けてるんですよ。手元の開発作業ならCLI、自分のアプリに組み込むならAgent SDK、Claude APIを直接呼んで自前のツールループを書くならClient SDK、Anthropic側で動かすならManaged Agents。
テキトー教師テキトー教師DotAI 認定講師
表にすると整理しやすいと思うんですけど、こんな感じです。
選択肢動く場所向く用途
CLI自分のターミナル対話的な開発作業
Client SDK自分のアプリ自前のツールループでAPIを直接呼ぶ
Agent SDK自分のアプリエージェントループごと埋め込む
Managed AgentsAnthropic側長時間・非同期・定期実行
室谷室谷代表取締役
迷ったら「そのプロセスを誰に持たせたいか」で考えると早い。自社で持ちたいならSDK系、持ちたくないならマネージド、という切り方なんですよね。
テキトー教師テキトー教師DotAI 認定講師
たしかに。最初から全部を使い分けようとしなくてよくて、手元で試せるところから始めれば十分だと思います。

よくある質問

Q1. Claude Codeを使ったことがない人は、何から始めればいい?

室谷室谷代表取締役
Claude Codeをまだ触ってない人が、いきなりエージェントから入るのは正直もったいないんですよね。まず素の状態で書かせて、どこで自分が詰まるかを見たほうが早い・・・
テキトー教師テキトー教師DotAI 認定講師
現場でよく聞くのは「設定を先に固めなきゃ」という発想なんですけど、順番は逆で。一人で淡々と作業させてみて、手が回らない部分が見えてから任せる範囲を決めるほうが馴染みます。
室谷室谷代表取締役
そうそう。最初から分業させる必要はなくて、まずは自分の作業の延長で使う。

そこから「これは並行で走らせたいな」が出てきたら考える、くらいの温度でいいと思います。

Q2. 他のツールにも「エージェント」ってありますよね。何が違う?

室谷室谷代表取締役
他のエディタ系ツールにも「エージェント」って名前の機能はありますよね。呼び方が同じだけで、設計の考え方はけっこう違うんですよ。
テキトー教師テキトー教師DotAI 認定講師
初めて触る人は同じものだと思い込んで、同じ感覚で設定して戸惑うパターンがあります。片方は「目の前の作業を代行する」、もう片方は「役割を持った担当を並べる」イメージに近いですね。
室谷室谷代表取締役
名前で比較するより、何を単位に仕事を分けてるかで見ると一気に整理されます。ここを混ぜたまま進めると、後で構成を組み直すことになるので。

Q3. エージェントが思った通りに動かないとき、どこを見直す?

室谷室谷代表取締役
動かないときに設定をいじる前に、見るべき場所があるんですけど、わかります?
テキトー教師テキトー教師DotAI 認定講師
現場感覚で言うと、原因の多くは任せる範囲の切り方なんですよ。仕事の粒度が大きすぎると、どこで転んだか見えなくなる。

まず一回で終わる単位まで割ってみる。
室谷室谷代表取締役
あと、何をもって完了とするかを先に決めておくことですね。ゴールが曖昧なまま走らせると、それらしい成果物だけ返ってきて、確認の段階で泣くことになります。

Q4. 指示は日本語でも大丈夫?

室谷室谷代表取締役
指示って日本語で書いてます? うちの現場だと普通に日本語なんですけど。
テキトー教師テキトー教師DotAI 認定講師
日本語で問題ないですよ。ただ、口語でだらっと書くと解釈の余地が増えるので、条件と「やらないこと」だけは短く区切って渡すといいですね。
室谷室谷代表取締役
そこ大事で。丁寧に長く書くより、「これはやらないで」を一行入れるほうが効きますから。

Q5. チームで使うとき、成果物の確認はどう回す?

室谷室谷代表取締役
エージェントの出力って、結局だれが責任を持つんだという話になるんですよね。そこを曖昧にしたまま広げると必ず揉めます。
テキトー教師テキトー教師DotAI 認定講師
現場でよくあるのは、出てきたものがそれっぽいので読み飛ばしてしまうパターンです。差分だけでも目を通す習慣を先に作っておくと、後から崩れにくいですね。
室谷室谷代表取締役
あとは任せた仕事の記録を残しておくこと。時給で換算すると、確認に貼り付きになる時間のほうが高くつくので、そこは仕組みで減らすべきなんですよ。

まとめ

室谷室谷代表取締役
結局、用語が4つに増えて見えるのは、出す側の整理が追いついていないだけで、読む側が困る話じゃないんですよね。
テキトー教師テキトー教師DotAI 認定講師
たしかに。最初に戸惑うのが「どれを覚えればいいのか」で、実際は自分がどこで使うかから逆算すれば、触るべきものは1つか2つに絞れます。
室谷室谷代表取締役
なので、全部理解しないと動かせない、みたいに思ったらそれは捨てていいです。まず1つ触って、動かして、困ったら戻ってくる。

その順番で十分。
テキトー教師テキトー教師DotAI 認定講師
そうですね。最初は小さく任せて、返ってきたものを自分で確認する。

この往復がそのまま自分の判断基準になっていきますから。
室谷室谷代表取締役
用語の整理は後からついてきます。手を動かした分だけ解像度が上がるので、今日は1つだけ試してみてください。

Related

関連記事

New Articles

新着記事

ガイド

Grokの読み方は「グロック」か「グロク」か?公式回答と会社名・料金の最新事情

2026年11月18日
室谷テキトー教師
ガイド

GoogleのAIモードとAIによる概要の消し方|公式オフ機能の有無とPC・スマホの回避策

2026年11月18日
室谷テキトー教師
ガイド

Azure OpenAI Serviceとは?料金・モデル一覧・データの扱いを最新情報で整理

2026年11月18日
室谷テキトー教師
ニュース

Perplexityの「Orchestrator API」とは?45以上のモデルを1つのAPIキーに統合

2026年11月18日
室谷テキトー教師
ニュース

Microsoftの「Copilot Workspaces」とは?人とエージェントが協働する新体験

2026年11月18日
室谷テキトー教師
ガイド

Geminiのファミリープランは何人まで?Google AI Proを家族で割る料金と設定の手順

2026年11月18日
室谷テキトー教師
ニュース

Microsoft MAIとは?Ignite 2026で発表の7モデルと料金

2026年11月18日
室谷テキトー教師
ニュース

Replit Missionsとは?エージェントスウォームで目標達成型の自律実行

2026年11月18日
室谷テキトー教師
ニュース

Copilot Fusion Maxとは?Terminal-Bench 4.1首位の自動モデル選択

2026年11月18日
室谷テキトー教師
ニュース

Googleの「Gemini Tasks」とは?日本でも無料開始、Gemini 4 Hydrogen搭載

2026年11月18日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。

参加を申請する