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で動かす前に知る料金と権限の話で解説しています。
ここで手が止まる人が多いです。詳しくはClaude Agent SDK入門｜PythonとTypeScriptで動かす前に知る料金と権限の話で解説しています。
室谷代表取締役Managed AgentsはAnthropic側がホストする、組み上げ済みのエージェントハーネスです。数分から数時間の長時間実行や非同期タスクに向いていて、Agent・Environment・Session・Eventsという4つの概念で組み立てる形。
2026年時点ではベータ扱いですね。
2026年時点ではベータ扱いですね。
テキトー教師DotAI 認定講師Claude本体のチャットは、いわゆる普通の対話相手です。同じClaudeでも、できることと課金の入口がまったく別物なんですよ。
誰が使うか・何が手に入るか・課金方式で並べるとどうなる？
室谷代表取締役ここまでを並べると、判断が早いんですよね。
| 名前 | 何者か | 誰が使うか | 課金の入口 |
|---|---|---|---|
| Claude Code（サブエージェント） | ツールを自分で呼び出すエージェント。専用担当を分けられる | 手元の開発作業をする人 | 有料プラン（Pro/Max/Ultra）に含まれ、チャットと同じ使用量プール |
エージェントビュー（claude agents） | バックグラウンド実行中のセッションを一覧・監視する画面 | 並列で回す開発者 | Claude Codeの利用に含まれる（詳細は公式で確認を） |
| Agent SDK | Claude Codeをライブラリとしてアプリに組み込むSDK | プロダクトに載せる開発者 | APIキーによる従量課金（サブスクの上限とは別体系） |
| Managed Agents | Anthropicがホストする事前構築済みハーネス | 長時間・非同期タスクを回す人 | APIキーによる従量課金。2026年時点はベータ |
| Claude本体のチャット | 対話相手としてのClaude | ふだん使いの人 | Free / Pro / Max / Ultra のサブスク |
テキトー教師DotAI 認定講師表にすると、日常で使うのか、プロダクトに組み込むのかで入口がはっきり分かれますね。
室谷代表取締役一番の落とし穴は課金の入口が違うことで。サブスク内で収まる話と、APIキーで従量課金になる話を同じ財布で考え始めると、社内の予算が一瞬で狂います。
まずどっちの財布か、を決めてから触るのが安全です。
まずどっちの財布か、を決めてから触るのが安全です。
サブエージェントとマルチエージェント、エージェントチームは何が違う？
サブエージェントは単一セッション内の専任担当
室谷代表取締役まず言葉の整理から。サブエージェントって、要は1つの会話セッションの中にいる「専任担当」なんですよ。
独自のコンテキストウィンドウとシステムプロンプトを持って、メインの会話とは別にリクエストを投げる。使用量は同じ使用制限にカウントされる仕組みです。
独自のコンテキストウィンドウとシステムプロンプトを持って、メインの会話とは別にリクエストを投げる。使用量は同じ使用制限にカウントされる仕組みです。
テキトー教師DotAI 認定講師現場でよく聞くのは「じゃあ別のAIが増えるんですか？」なんですよ。増えるというより、同じセッションの中で役割を分けてるイメージですね。
組み込みだと Explore が読み取り専用でコードベースを探す係、Plan が計画前の調査係。General-purpose は探索も変更も必要な複雑なタスク用です。
組み込みだと Explore が読み取り専用でコードベースを探す係、Plan が計画前の調査係。General-purpose は探索も変更も必要な複雑なタスク用です。
室谷代表取締役だからメインの会話が汚れないわけですね。ここ、地味にデカいと思ってて。
長い会話に探索ログが混ざると、後半の判断がだんだん鈍るじゃないですか。分業ってコスト削減の基本中の基本ですから。
長い会話に探索ログが混ざると、後半の判断がだんだん鈍るじゃないですか。分業ってコスト削減の基本中の基本ですから。
テキトー教師DotAI 認定講師たしかに。ひとつの机に資料を山積みにしないのと同じ理屈ですね。
バックグラウンドエージェントとエージェントチームの使い分け
室谷代表取締役で、一段上がるのがバックグラウンドエージェント。独立したセッションを複数並行で走らせて、1か所でまとめて監視する形なんですよね。
並列に走らせたいけど、人間が横で見張りたい場面です。
並列に走らせたいけど、人間が横で見張りたい場面です。
テキトー教師DotAI 認定講師エージェントチームはまた別で、Claude自身がセッションを生んで監督する側に回る構成です。ただここ、前提を飛ばすと事故るんですよ。
エージェントチームは実験的機能で、デフォルトでは無効。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化しないと動きません。
エージェントチームは実験的機能で、デフォルトでは無効。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化しないと動きません。
室谷代表取締役それは先に書いておかないと。設定したつもりで「動かない」って問い合わせになるパターンですね。
構造としては、監督する側がいる方が人数を増やしやすい。人を増やすより安いかは別として、管理コストの設計問題として面白いですよね。
構造としては、監督する側がいる方が人数を増やしやすい。人を増やすより安いかは別として、管理コストの設計問題として面白いですよね。
テキトー教師DotAI 認定講師複数のclaude agentsを並べるべき場面、1体で足りる場面
室谷代表取締役じゃあ何体並べるべきか。僕の感覚だと、タスクが互いに独立してる時だけ増やす。
リサーチAとリサーチBと検証Cみたいに、片方の結果がもう片方に効かないやつですね。
リサーチ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だけという割り切りが効いてるんですよ。
で、必須がnameとdescriptionだけという割り切りが効いてるんですよ。
テキトー教師DotAI 認定講師そこ、最初に戸惑うのが「全部書かないと動かない」と思い込むパターンですね。任意項目はあとから足せますから、まず2行で動かすのがおすすめです。
フロントマターの必須項目はnameとdescriptionだけ
室谷代表取締役任意項目はどこまで見ておけばいいんですかね。tools、model、maxTurns、permissionMode、isolation あたりが並んでますけど。
テキトー教師DotAI 認定講師最初は tools と description だけで十分だと思います。description が曖昧だと、呼ばれるべき場面で呼ばれないんですよ。
ここが体感で一番効きます。
ここが体感で一番効きます。
室谷代表取締役なるほど。運用で詰まったら model や isolation を足す、と。
細かい設定項目はエージェント機能の完全解説にまとまってるので、そっちを参照するのが早いですね。
細かい設定項目はエージェント機能の完全解説にまとまってるので、そっちを参照するのが早いですね。
テキトー教師DotAI 認定講師はい。あと tools を省略すると全ツールを継承するので、読み取り専用にしたいなら明示的に絞る。
任せる範囲を決めるのが設計の第一歩です。
任せる範囲を決めるのが設計の第一歩です。
プロジェクト用・全プロジェクト共通・組織管理、優先順位で決まる
室谷代表取締役保存場所、ここが地味に設計判断なんですよね。プロジェクトの
.claude/agents/ に置くか、ホームの ~/.claude/agents/ に置くか、管理設定で配るか。テキトー教師DotAI 認定講師優先順位は 管理設定 >
--agents フラグ > プロジェクト > 全プロジェクト共通 > プラグイン、の順です。同名だと上が勝つので、チームで上書きしたいときに効きます。室谷代表取締役組織で統制したいなら管理設定、個人の道具箱はホーム、案件固有はプロジェクト。MYUUUだと、共通のレビュー用はホームに置いて、客先案件の専用エージェントだけプロジェクトに閉じ込める運用にしてます。
テキトー教師DotAI 認定講師その分け方いいですね。全プロジェクト共通に何でも置くと、意図しない場面で発火するので。
範囲が広いほどdescriptionは慎重に、が現場感覚です。
範囲が広いほどdescriptionは慎重に、が現場感覚です。
作り直したのに反映されないときの落とし穴
室谷代表取締役で、ここが今日いちばん聞きたかったところで。ファイル直したのに反映されない、みたいな話です。
テキトー教師DotAI 認定講師編集や追加は数秒で検出されて、再起動はいらないんですよ。ハマる人が多いのは、agentsディレクトリを新しく作った直後と、add-dir で足したディレクトリ配下。
この2つは再起動が要ります。
この2つは再起動が要ります。
室谷代表取締役なるほど、ディレクトリの新設だけ別扱いなんですね。あとは置き場所の優先順位で、上に同名ファイルが残ってて古い定義が読まれてる、みたいな。
テキトー教師DotAI 認定講師まさにそれです。反映されないなと思ったら、まず同名ファイルが上の階層にないか見る。
それでもダメなら再起動。この順番で切り分けると早いです。
それでもダメなら再起動。この順番で切り分けると早いです。
エージェントチームやマルチエージェントはどう作って動かす？
チーム構成にするとき、Claudeに何を監督させるか
室谷代表取締役ここ、順番を間違えるとだいたい失敗するんですよ。先にツールを設定するんじゃなくて、仕事をどう分けるか、その分けた仕事を誰が監督するかを先に決める。
エージェントチームはClaudeが生成して監督する、調整されたセッションのチームという位置づけなので、監督する側の判断基準がないと成立しないんですよね。
エージェントチームはClaudeが生成して監督する、調整されたセッションのチームという位置づけなので、監督する側の判断基準がないと成立しないんですよね。
テキトー教師DotAI 認定講師現場でよく聞くのは、いきなり人数から決めちゃうパターンです。「何を任せて、何をClaudeに見張らせるか」が曖昧なまま増やすと、誰の成果か分からない作業が増えるだけなんですよ。
室谷代表取締役経営の感覚で言うと、分担表がないまま人を増やすと調整コストだけが増える。人件費でも同じことが起きますから。
あと動かす前提として、エージェントチームは実験的機能でデフォルトでは無効なんです。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定しないと始まらないので、そこは先に押さえておきたいところですね。
あと動かす前提として、エージェントチームは実験的機能でデフォルトでは無効なんです。settings.json か環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定しないと始まらないので、そこは先に押さえておきたいところですね。
複数走らせたとき、全体はどこで見るのか
室谷代表取締役並行で走らせ始めると、今どれが動いてるのか分からなくなる。その入口がエージェントビューで、バックグラウンドで実行中のセッションを一覧で見られるんですよ。
カスタムサブエージェントを作る・管理する /agents とは別物で、公式も名前が似ていて紛らわしいと明記してます。
カスタムサブエージェントを作る・管理する /agents とは別物で、公式も名前が似ていて紛らわしいと明記してます。
テキトー教師DotAI 認定講師そこ、初めて触る人がだいたい混同しますね。「作る・管理する」が /agents、「走っているものを眺める」がエージェントビュー、と役割で分けて覚えると整理しやすいです。
配布されているテンプレート集を使う前に確認したいこと
室谷代表取締役エージェント定義をまとめたテンプレート集が配られていて、git clone してインストールスクリプトを流すと ~/.claude/agents/ に一気に入る、というものもあります。ただあれ、Anthropic公式ではなくてOSSコミュニティの製品なんですよ。
テキトー教師DotAI 認定講師手軽に見えるんですけど、中身が分からないまま入れるのは怖いですね。どのツールを許可している定義なのか、一度は目を通しておきたいです。
室谷代表取締役定義はYAMLフロントマターとMarkdownのテキストなので、その気になれば読めます。nameとdescription、あとtoolsだけでも確認しておくと、意図しない権限で動く事故は減りますから。
自作エージェントを増やすほど効くとは限らない理由
テキトー教師DotAI 認定講師最初に戸惑うのが、増やせば速くなると思ってしまうところで。切り分けが甘いと、同じ調査を何本も並行して走らせるだけになります。
室谷代表取締役サブエージェントは独自のコンテキストウィンドウを持つので、メイン会話を汚さずに済むのが効くところ。ただ別リクエストとして送る以上、使用量は同じ使用制限にカウントされる。
増やすほど枠を食う構造なんですよね。
増やすほど枠を食う構造なんですよね。
テキトー教師DotAI 認定講師分けたあとに統合する手間も含めて判断、ですかね。作る前に「これは分ける価値があるか」を一回挟むだけで、だいぶ変わります。
室谷代表取締役サブエージェントは同時にいくつまで動かせる？
公式ドキュメントにデフォルト上限の明示はない
サブエージェント並列化の要点
デフォルト上限は非明示
公式ドキュメントにデフォルト上限の明示なし。「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段が適用されないので、そこも挙動が変わるポイントです。
フォークはこの2段が適用されないので、そこも挙動が変わるポイントです。
室谷代表取締役だから並列を増やすなら、まず「この子に何をさせるか」を絞る。全部できる子を10個並べるより、仕事を切って渡す方が結果的に速いんですよね。
並列を増やすとぶつかるのは、コストとファイルの取り合い
室谷代表取締役実際に増やしていくと必ずぶつかるのが、コストとファイルの取り合いで。サブエージェントの使用量はメインの会話と同じ使用制限にカウントされるので、並べた分だけ消費が速く進みます。
テキトー教師DotAI 認定講師しかも同じファイルを複数の子が触ると、後から書いた方で上書きされて。現場感覚で言うと、ここで一度手戻りが起きると、並列にした意味がほぼ消えます。
室谷代表取締役なので isolation で worktree を指定して、作業ディレクトリを分ける。経営目線で言うと、並列数を上げるより「ぶつからない形に分ける」方が、時給あたりのリターンは大きいんですよ。
テキトー教師DotAI 認定講師エージェントに任せても安全？権限とリスクの管理
toolsとdisallowedToolsで、できることを先に削る
室谷代表取締役サブエージェントの設定って、まず何から決めるのが正解なんでしょう。業務で使う前提だと、権限の話を飛ばして動かすのは正直怖いんですよね。
テキトー教師DotAI 認定講師現場感覚で言うと、最初に戸惑うのが「何を許可するか」より「何を禁止するか」なんですよ。許可リストだけ見て安心しちゃう人が多いんです。
室谷代表取締役そこは順番の話で。フロントマターの tools が許可リスト、disallowedTools が拒否リスト。
tools を省略すると全ツールを継承するので、書かないこと自体が一番危ない選択になるんですよ。
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ではない
室谷代表取締役まず前提の訂正からなんですけど。ネット上には「Max 5x」「Max 20x」って書いた記事がまだ残ってるんですよね。
あれは旧プラン名で、いまの公式の並びは Free・Pro・Max・Ultra の4つなんですよ。
あれは旧プラン名で、いまの公式の並びは 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 Agent SDKとManaged Agentsはどんな場面で使う？
Agent SDKで自分のアプリに埋め込めるもの
室谷代表取締役Agent SDKは、Claude Codeの中身をライブラリとしてPythonやTypeScriptから呼べる形にしたものなんですよね。つまり自分たちのプロダクトの中にエージェントを埋め込める、と。
テキトー教師DotAI 認定講師そうなんです。ここで混同されがちなのが、ターミナルで動いてるClaude Codeそのものと、SDKとして組み込む場合の違いで。
現場でよく聞くのは「自分のアプリからClaude Codeを呼べるんですか」という質問ですね。
現場でよく聞くのは「自分のアプリからClaude Codeを呼べるんですか」という質問ですね。
室谷代表取締役呼べるんですよ。しかも同じツール群とエージェントループを持っている。
だから自前でツール実行のループを書き直さなくていい。ここは開発コストに直結する部分です。
だから自前でツール実行のループを書き直さなくていい。ここは開発コストに直結する部分です。
テキトー教師DotAI 認定講師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 Agents | Anthropic側 | 長時間・非同期・定期実行 |
室谷代表取締役迷ったら「そのプロセスを誰に持たせたいか」で考えると早い。自社で持ちたいならSDK系、持ちたくないならマネージド、という切り方なんですよね。
テキトー教師DotAI 認定講師たしかに。最初から全部を使い分けようとしなくてよくて、手元で試せるところから始めれば十分だと思います。
よくある質問
Q1. Claude Codeを使ったことがない人は、何から始めればいい？
室谷代表取締役Claude Codeをまだ触ってない人が、いきなりエージェントから入るのは正直もったいないんですよね。まず素の状態で書かせて、どこで自分が詰まるかを見たほうが早い・・・
テキトー教師DotAI 認定講師現場でよく聞くのは「設定を先に固めなきゃ」という発想なんですけど、順番は逆で。一人で淡々と作業させてみて、手が回らない部分が見えてから任せる範囲を決めるほうが馴染みます。
室谷代表取締役そうそう。最初から分業させる必要はなくて、まずは自分の作業の延長で使う。
そこから「これは並行で走らせたいな」が出てきたら考える、くらいの温度でいいと思います。
そこから「これは並行で走らせたいな」が出てきたら考える、くらいの温度でいいと思います。
Q2. 他のツールにも「エージェント」ってありますよね。何が違う？
室谷代表取締役他のエディタ系ツールにも「エージェント」って名前の機能はありますよね。呼び方が同じだけで、設計の考え方はけっこう違うんですよ。
テキトー教師DotAI 認定講師初めて触る人は同じものだと思い込んで、同じ感覚で設定して戸惑うパターンがあります。片方は「目の前の作業を代行する」、もう片方は「役割を持った担当を並べる」イメージに近いですね。
室谷代表取締役名前で比較するより、何を単位に仕事を分けてるかで見ると一気に整理されます。ここを混ぜたまま進めると、後で構成を組み直すことになるので。
Q3. エージェントが思った通りに動かないとき、どこを見直す？
室谷代表取締役動かないときに設定をいじる前に、見るべき場所があるんですけど、わかります？
テキトー教師DotAI 認定講師現場感覚で言うと、原因の多くは任せる範囲の切り方なんですよ。仕事の粒度が大きすぎると、どこで転んだか見えなくなる。
まず一回で終わる単位まで割ってみる。
まず一回で終わる単位まで割ってみる。
室谷代表取締役あと、何をもって完了とするかを先に決めておくことですね。ゴールが曖昧なまま走らせると、それらしい成果物だけ返ってきて、確認の段階で泣くことになります。
Q4. 指示は日本語でも大丈夫？
室谷代表取締役指示って日本語で書いてます？ うちの現場だと普通に日本語なんですけど。
テキトー教師DotAI 認定講師日本語で問題ないですよ。ただ、口語でだらっと書くと解釈の余地が増えるので、条件と「やらないこと」だけは短く区切って渡すといいですね。
室谷代表取締役そこ大事で。丁寧に長く書くより、「これはやらないで」を一行入れるほうが効きますから。
Q5. チームで使うとき、成果物の確認はどう回す？
室谷代表取締役エージェントの出力って、結局だれが責任を持つんだという話になるんですよね。そこを曖昧にしたまま広げると必ず揉めます。
テキトー教師DotAI 認定講師現場でよくあるのは、出てきたものがそれっぽいので読み飛ばしてしまうパターンです。差分だけでも目を通す習慣を先に作っておくと、後から崩れにくいですね。
室谷代表取締役あとは任せた仕事の記録を残しておくこと。時給で換算すると、確認に貼り付きになる時間のほうが高くつくので、そこは仕組みで減らすべきなんですよ。
まとめ
室谷代表取締役結局、用語が4つに増えて見えるのは、出す側の整理が追いついていないだけで、読む側が困る話じゃないんですよね。
テキトー教師DotAI 認定講師たしかに。最初に戸惑うのが「どれを覚えればいいのか」で、実際は自分がどこで使うかから逆算すれば、触るべきものは1つか2つに絞れます。
室谷代表取締役なので、全部理解しないと動かせない、みたいに思ったらそれは捨てていいです。まず1つ触って、動かして、困ったら戻ってくる。
その順番で十分。
その順番で十分。
テキトー教師DotAI 認定講師そうですね。最初は小さく任せて、返ってきたものを自分で確認する。
この往復がそのまま自分の判断基準になっていきますから。
この往復がそのまま自分の判断基準になっていきますから。
室谷代表取締役用語の整理は後からついてきます。手を動かした分だけ解像度が上がるので、今日は1つだけ試してみてください。
