GitLab Duo Agent Platformとは？料金（GitLab Credits）の見積もりとフロー13本・安全設定【2026年11月】

GitLab Duo Agent Platformは、コードの作成からレビュー、CI/CDの修正、脆弱性への対応までを、複数のAIエージェントとそれをつないだ「フロー」に任せるGitLabの機能群です。GitLab 18.8（2026年1月15日）で一般提供（GA）になり、利用料は人数ではなく実行した処理の量に応じて「GitLab Credits」で払います。

導入を検討する人がつまずくのは、何をすればいくらかかるのか、どこまで安全に任せられるのかが、公式ドキュメントの複数のページに分かれている点です。この記事では、2026年11月11日時点の公式ドキュメントと料金ページ（最新の安定版はGitLab 19.5.3）をもとに、料金の見積もり方、基盤フロー13本の役割、既定モデル、組織ルールの渡し方、サンドボックスと権限の落とし穴を1本にまとめます。

まとめ

• GitLab Duo Agent PlatformはGitLab 18.8でGAしました。対象はPremiumとUltimateですが、Freeでもクレジットを月単位で購入すれば一部の機能を使えます（GitLab.comは18.10から、Self-Managedは19.0から）。
• 料金は1クレジット1ドル（オンデマンドの定価）です。Premiumは1ユーザーあたり月12クレジット、Ultimateは24クレジットが付きますが、料金ページはこれを期間限定のプロモーションと明記しています。
• 付属クレジットは個人に割り当てられ、Code Review Flowのようにサービスアカウントで動くフローには使われません。フローの費用は月次コミットメントかオンデマンドから引かれるので、付属分だけで見積もると足りなくなります。
• 定額の機能は、Code Review Flowが1回0.25クレジット、SAST Vulnerability Resolution Flowが1回4クレジットです。チャットなどは呼び出したモデルごとに課金され、既定のClaude Sonnet 5.5は1クレジットで3.2回です。
• 安全面では、サンドボックスは条件を満たさないとジョブログに警告を出して適用されないこと、setup_scriptがサンドボックスの外で実行者の資格情報を使えること、GitLab側で基盤フローを止めてもIDEとGitLab Duo CLIからは実行できることの3点を先に押さえます。

GitLab Duo Agent Platformの主要機能と利用窓口

公式ドキュメントのGitLab Duo Agent Platformは、この機能群を、開発ライフサイクル全体に複数のエージェントを組み込み、人がエージェントと非同期に協業するためのものと説明しています。使う側から見ると、入口は次の3つです。

フローは複数の手順をまとめて自動で進める仕組みで、GitLabが用意する「基盤フロー」と、自社で定義する「カスタムフロー」があります。ほかに、Claude CodeやCodexなど外部のコーディングエージェントをGitLabのイベントから呼ぶ「外部エージェント」も同じ基盤の上で動きます。GitLabそのものの基本操作から確認したい場合はGitLabの使い方：プロジェクト作成からIssue・MR・CI/CDまでの手順【2026年10月】を先に読むと、MRやRunnerといった用語がつながります。

GitLab 18.8〜19.5の主要機能と課金仕様の変更

ベータは18.2で始まり、Self-Managed向けは18.4で実験的機能として入りました。GA後は月1回のマイナーリリースごとに機能が増えています。版ごとの詳細はGitLab 19.2とは？Duo CLI・カスタムフローGAで変わる開発運用とGitLab 18.10の新機能とパッチ18.10.8までの修正｜保守終了後の19.4・19.5への移行経路で扱っており、ここでは導入判断に効く変化だけを並べます。

19.5は2026年10月15日のリリースで、11月11日時点の最新パッチは19.5.3です。公式ドキュメントにはすでに19.6（2026年11月19日予定）の変更も載っているため、Self-Managedで運用している場合は、ページの履歴欄にある版番号と自社の版を照らし合わせてから設定を探してください。

対応プランとFreeで使える範囲

製品ページのバッジはPremiumとUltimateですが、ドキュメントの機能表にはFree列があります。Freeは月次コミットメント（後述）としてクレジットを買えば、Agentic Chat、コード提案、カスタムエージェント、Developer Flow、Code Review Flowなどを使えます。外部エージェントはFreeでは使えません。

Freeのオンデマンド利用は暦月あたり25,000ドルで自動的に止まり、翌月に戻ります。前提条件として、GitLab Duo ProかDuo Enterpriseを契約していない場合は、トップレベルグループかインスタンスで「GitLab Duo Core」を有効にしておく必要があります。Duo Enterpriseアドオンを契約している場合、18.9以前はAgent Platformと併用できず、18.10以降への更新が要ります。Self-Managedでセルフホストモデルを使う場合、オンラインライセンスならアドオンなしで従量課金になりますが、外部と通信しないオフラインライセンスでは「GitLab Duo Agent Platform Self-Hosted」アドオンの購入が必要です。GitHubとの料金体系の違いはGitHubとGitLabの違い｜ActionsとGitLab CIの対応表・料金・セルフホスト比較で比較しています。

GitLab Creditsの料金と消費量

GitLab Credits and usage billingによると、クレジットは従量課金の共通通貨で、請求はプロジェクト単位ではなくトップレベルグループ（ルート名前空間）単位でまとめられます。GitLab Duo ProとEnterpriseの機能はシート課金のままで、クレジットを消費しません。

付属・コミットメント・オンデマンドの消費順

19.4以降は、評価用の一時クレジットも含め、次の4段階の順に使われます。

1. 付属クレジット：Premium・Ultimateの各ユーザーに付く分。個人に割り当てられ、他人と共有できず、翌月に繰り越せません。
2. 評価用の一時クレジット：月次コミットメントを購入しておらず、オンデマンドの利用規約にも同意していない場合に、営業へ依頼できる無料の共有枠です。有効期限は30日です。
3. 月次コミットメント：年単位で購入し12で割った量が毎月使える共有プールです。増量はいつでもできますが、減量は更新時だけです。
4. オンデマンド：上の3つを使い切った後の分で、1クレジット1ドルで月ごとに請求されます。利用規約に同意した時点で有効になり、同意は撤回できません。

見積もりで外せないのは課金先の区別です。人がAgentic Chatを直接使った分はその人に付きますが、基盤フローやカスタムフローのようにサービスアカウントで動く処理は、誰が起動しても名前空間に請求されます。名前空間への請求は月次コミットメントとオンデマンドから引かれるため、付属クレジットでは払えません。

定額で課金される4つの機能

次の4機能は、内部でLLMを何回呼んでも1回の実行あたりの消費量が決まっています。セルフホストモデルで動かすと20%安くなりますが、この割引は19.1で入った機能フラグself_hosted_flat_pricing_discountで制御されています。

モデルごとの呼び出し回数とプロモ価格の期限

定額でない機能は、LLMを1回呼ぶたびに課金されます。Agentic Chatで1通送ると、回答のために1回以上の呼び出しが起きます。新しく大きいモデルほど1クレジットで呼べる回数が減ります。主なモデルの値は次のとおりです（GitLab管理のモデル）。

同じ呼び出し回数なら、プロモ終了後の費用はGemini 3.6 Flashで約2倍、GPT-5.6 Solの短文脈で約1.33倍になります。見積もりは期限後の値で計算するのが安全です。

GitLab Orbitのクエリ課金

製品ページで大きく扱われているGitLab Orbitは、コード、MR、パイプライン、デプロイを1つのグラフにつないでエージェントに渡す仕組みです。GitLab Orbit credit usageによると、19.5からOrbit APIへのクエリは100回あたり3クレジットを消費し、GitLab Duoが自動で投げたクエリも含まれます。手元のOrbit CLIが作るローカルのグラフへの問い合わせは課金されません。グラフ容量の上限はGitLab.comとDedicatedでPremiumが2GiB、Ultimateが5GiBで、購入やSelf-Managedでの利用は営業経由です。

失敗した実行の扱い

GitLab.comのGitLab管理モデルでは、途中で失敗したフローはクレジットを引きません。Self-Managedのセルフホストモデルは逆で、呼び出しの開始時点で課金されるため、途中で失敗しても呼んだ分は請求されます。同じSelf-Managedのセルフホストモデルでは、定額の機能も失敗時に満額が請求されます。セルフホスト環境では、利用者に開放する前にクレジットを消費しない機能検証（functional verification check）を通しておくと、設定ミスで無駄な課金が出ません。

月額費用の見積もり方

公式の単価から、Premiumで10人のチームがAgentic ChatとCode Review Flowを使う場合のクレジット費用を試算します。Runnerの実行費用や、利用に応じて発生するOrbitクエリ料金は含めません。ここでの回数は前提として置いた数字で、実際の呼び出し回数は使い方で大きく変わります。

チャットは1人あたり約31.3クレジットから付属の12を引いた約19.3クレジットが超過し、10人で約193クレジットです。Code Review Flowの50クレジットを足すと、付属クレジットとは別に月約243クレジット、オンデマンドなら約243ドルかかります。Premiumの本体価格（10人で月290ドル相当）に近い額で、付属クレジットだけで足りるのは、チャットを軽く使う程度のチームに限られます。

想定外の請求を防ぐには、19.3でGAした利用上限（usage caps）を先に設定します。上限は3種類あり、サブスクリプション全体の上限はオンデマンド分だけを数え、達すると全ユーザーのクレジット機能が止まります。ユーザー単位の一律上限と個別上書きは、人が直接使った分だけを数えます。フローの費用は人ではなく名前空間に付くため、ユーザー単位の上限ではレビューの自動実行を抑えられない点に注意してください。

基盤フロー13本の一覧と起動のしかた

Foundational flowsの一覧は2026年11月時点で13本です。9月時点の11本から、作業計画を作るGenerate Workplanと、脆弱性の優先度付け用の文脈を作るVulnerability Context Flowが増えました。提供段階と対象プランはフローごとに違い、セキュリティ系の多くはUltimateだけです。

課金の数字はクレジット数です。Security Review Flowはベータでも課金され、公式の目安は小さな差分で約8、標準的な機能ブランチで約14、大きな変更で約20クレジットです。Code Review Flowの30〜80倍にあたるため、全MRに自動で走らせる前に対象を絞ります。ベータ期間中は手動でしか起動できません。課金なしのベータ・実験的機能も、GAになった時点で全版・全提供形態で課金が始まり、GA化はいつでも起こり得ると明記されています。

SASTの指摘を扱うフローは、事前にSASTがパイプラインで動いている必要があります。SASTの組み込み方はSASTとは？DAST・SCAとの違いとCI/CDへの組み込み・導入判断を実装視点で解説で扱っています。

Developer FlowとSoftware Development Flowの使い分け

コードを書くフローは2本あり、どちらが動くかは作業を始める場所で決まります。

GitLab UIでは、IssueにフローをアサインするほかにIssueで@duo-developer-<namespace>とメンションする、「Implement」を選ぶ、作業項目のステータスを変える、のいずれかでDeveloper Flowが始まります。Agentic Chatから起動した場合、フローは別セッションとして動き、チャット側のツール承認はフローには適用されません。

既定モデルと選べるモデル

Model selectionによると、2026年10月7日にAgentic Chat、Developer、その他のエージェントの既定モデルがClaude Sonnet 5.5（Google CloudのGemini Enterprise Agent Platform経由）に変わりました。Code Review Flowは10月5日に同じモデルへ、Recommend Reviewers Flowは10月8日にClaude Haiku 5.5へ変わり、Security Review FlowだけはClaude Sonnet 4.6のままです。

既定モデルのまま使っていると、GitLabは利用者に通知せずにモデルを入れ替えることがあります。上の表のとおりモデルで1クレジットあたりの回数が違うため、モデルの自動変更による課金倍率の変化を避けたい場合は、トップレベルグループで利用モデルを明示的に選びます。総費用は呼び出し回数によって変動します。19.1からはAgentic Chatで使えるモデルを特定のモデルに絞れますが（19.2でGA）、既定モデルは常に使える状態で外せません。19.5ではこの制限を外部エージェントにも広げる機能がフラグ付き（既定は無効）で入りました。

AGENTS.md・Agent Skillsによる組織ルールの適用範囲

コーディング規約やビルド手順をエージェントに渡す手段は5つあり、効く範囲が少しずつ違います。共通する例外はCode Review Flowで、AGENTS.mdもSkillsも読まず、レビュー基準は専用のレビュー指示ファイルで渡します。

AGENTS.mdには、ユーザー単位、プロジェクト単位、サブディレクトリ単位の3段階がありますが、GitLab UIで効くのはプロジェクト単位だけです。ユーザー単位とサブディレクトリ単位は、エディタ拡張（VS Code 6.60以降、JetBrains 3.26.0以降）とGitLab Duo CLI（8.47.0以降）でしか読まれません。Agent Skillsはプロジェクト単位が18.10、ユーザー単位が19.0（Duo CLIのみ・実験的機能）からで、GitLab UIのAgentic ChatはSkillsに対応していません。AGENTS.md自体の書き方はAGENTS.mdとは？書き方・配置とCodex・Claude Code・Copilotの読み込み仕様【2026年11月実測】、SKILL.mdの仕様はAgent Skillsとは？SKILL.md仕様とAAIF寄贈後も移植性を保つ実装手順を参照してください。

カスタムフローでAGENTS.mdを読ませる設定

基盤フローはAGENTS.mdを自動で読みますが、カスタムフローは定義ファイルで受け取る設定を書かないと読みません。AGENTS.md customization filesの例は次のとおりです。

components:
- name: "my_agent"
  type: AgentComponent
  prompt_id: "my_prompt"
  inputs:
  - from: "context:inputs.user_rule"
    as: "agents_dot_md"
    optional: true

optional: trueを付けると、AGENTS.mdが無いリポジトリでもフローが失敗しません。AGENTS.mdを追加・更新しても、すでに始まっている会話とフローには反映されず、新しく始めたものから効きます。

外部エージェントとGitLab Duo CLI

外部エージェントは、Claude Code、OpenAI Codex、Amazon Q、Geminiなどを、MRやIssueのイベントをきっかけにRunner上で動かす仕組みです。GitLabが資格情報を管理して提供するのはAnthropic ClaudeとOpenAI Codexだけで、Amazon QとGeminiは自前の資格情報を使います。External agentsは機能フラグで制御され、自社の名前空間やインスタンスで使うにはGitLabサポートへの連絡が必要と書かれています。Self-Hostedモデルの環境では使えません。また、外部エージェントはGitLab標準のプロンプトスキャンの対象外で、組み込みエージェントやフローと同等のネットワーク隔離も適用されません。導入前に外部プロバイダーのデータ取扱条件とセキュリティ対策を確認してください。なお、Claude CodeやCursorなど外部のAIツールからGitLabのIssueやMRを操作する接続設定は、GitLab MCPサーバーの接続設定：Claude Code・Cursorでの使い方とツール一覧で扱っています。

GitLab Duo CLI（コマンド名duo）は19.2でGAし、19.4からはGitLab UIと同じDeveloper Flowを手元で動かします。対話モードでは端末でツール呼び出しを承認しながら進め、ヘッドレスモードではスクリプトやRunnerから非対話で実行できます。glab経由でも呼べます。GitLab以外のツールでMRレビューを自動化したい場合の比較材料としては、PR-AgentをGitLabで使う手順｜CI・Webhook・Lambdaの設定と自動レビューの制御【v0.49対応】が参考になります。

安全に動かすための実行環境と権限

GitLab UIから起動するフローはRunner上のCI/CDジョブで動き、通常は実行者とサービスアカウントを組み合わせた権限でリポジトリやAPIを操作します。導入時に最も事故につながりやすいのはこの章の4点です。

サンドボックスが外れる条件

フローの通信とファイルアクセスを制限する実行環境サンドボックスは、Anthropic Sandbox Runtime（SRT）が入ったイメージで、ジョブがユーザー名前空間とマウント名前空間を作れるときだけ有効になります。使えるイメージは、既定イメージ（v0.0.6以降）、強化版のUBI 9 Minimal、SRT 0.0.20以降を入れたカスタムイメージです。image: python:3.11のようにSRTの無いイメージを指定すると、通信制限はかかりません。

Runnerのprivileged = trueは条件を満たす方法の1つですが、それだけでは足りず、必須でもありません。ホストのuser.max_user_namespacesが0の場合、seccompやAppArmorがCLONE_NEWUSERを塞いでいる場合、docker-autoscalerやkubernetes executorで特権がジョブコンテナまで届かない場合は失敗します。失敗してもフローは止まらず、ジョブログに次の警告を出してサンドボックスなしで動きます。

Warning: SRT found but can't create sandbox (insufficient privileges), running command directly without sandbox

この警告のログ監視で、サンドボックスなしの実行を検知できます。通信先の制限が必須なら、Runner側のファイアウォールやKubernetes NetworkPolicyでも送信先を制限します。ドキュメントには、サンドボックスを作れないときにジョブを失敗させる「必須化」の設定が19.6の機能として載っていますが、カスタムイメージやsetup_scriptを使うプロジェクトでは、どのsrtコマンドが動くかをプロジェクト側が決められるため、必須化しても隔離は保証されないと注記されています。

agent-config.ymlとsetup_scriptの権限

フローの実行環境は.gitlab/duo/agent-config.ymlで決めます。このファイルは既定ブランチからだけ読まれ、別ブランチに置いたものは無視されます。次の例は、サンドボックス適用後の追加許可先をregistry.npmjs.orgに絞る設定です。GitLabなどの固定許可先は残り、setup_script中の通信にはこの制限が適用されません。

setup_script:
  - npm ci
network_policy:
  include_recommended_allowed: false
  allowed_domains:
    - registry.npmjs.org

allowed_domainsとdenied_domainsは各1,000件まで、"*"は使えず、include_recommended_allowedの既定はfalseです。定義済みのCI/CD変数はこのファイルの設定に使えません。

注意すべきはsetup_scriptです。このコマンドはサンドボックスが適用される前に外で動き、実行者のOAuthトークン、サービストークン、身元情報を含むフロー内のすべての環境変数にアクセスできます。しかも使われるのは、ファイルをコミットした人ではなくフローを起動した人の資格情報です。agent-config.ymlへの変更は認証情報に触れる変更として扱います。既定ブランチへの直接pushを制限し、このファイルにCode Ownersを指定したうえで、所有者の承認を必須にする承認ルールを設定してください。

サービスアカウントとコンポジットアイデンティティ

基盤フローを有効にすると、トップレベルグループにduo-<フロー名>-<グループ名>という名前のサービスアカウントが作られ、各プロジェクトにDeveloperロールで追加されます（カスタムフローはai-で始まる名前）。実行時は起動した人のロールとサービスアカウントのDeveloperロールを組み合わせたコンポジットアイデンティティが使われ、両者のうち制約の強いほうが適用されます。Maintainerがフローを起動しても、フローはDeveloperの範囲でしか動きません。

フローが作ったMRは、サービスアカウントではなく起動した人に帰属します。職務分離を求めるコンプライアンス要件に合わせた仕様です。また、フローがアクセスできるのは、起動した人が見られるプロジェクトのうちサービスアカウントが追加されているものに限られます。なお、Agentic Chatにはコンポジットアイデンティティが適用されず、使う人の権限で動きます。

基盤フローの停止設定とIDE・CLIへの適用範囲

グループ設定で基盤フローやフロー実行をオフにしても、止まるのはGitLab上で動くフロー（IssueやMRから起動するもの）だけです。Agent Platformが使えるプロジェクトであれば、利用者はIDEやGitLab Duo CLIのセッションから同じフローを実行できます。組織として利用を禁止する場合は、Agent Platform自体をオフにします。利用上限は費用の制御であり、ユーザー単位の上限では付属クレジットが残っている間の利用や名前空間に課金されるフローを止められません。

導入が向くチームと見送る条件

向いているのは、すでにGitLab PremiumかUltimateを使い、MRとCI/CDがGitLabに集まっているチームです。レビュー、パイプライン修正、SASTの誤検出判定は、GitLabの中にある情報だけで完結するため、別のAIツールより文脈を集める手間が少なく済みます。Code Review Flowの1回0.25ドルは、レビュー待ちで止まる時間と比べて判断しやすい単価です。

見送るべきなのは次のような場合です。

• ソースコードの管理がGitHubなどGitLab以外にあり、GitLabはCI/CDだけに使っている：GitLabのMRやIssueを起点にするフローを主目的とする場合は、対象作業をGitLabに集約できるかを先に確認します。
• Runnerがkubernetes executorで、名前空間の作成をセキュリティ方針で禁じている：サンドボックスが効かないまま、資格情報を持つフローを動かすことになります。
• 月額予算を超えられず、予算到達による月途中の利用停止も許容できない：クレジット消費は実行量に依存するため、必要な処理を予算内で継続できるか、試行期間の利用量から判断します。

自社の業務フローに合わせたエージェントの設計から相談したい場合は、AIエージェント開発の支援内容も参考にしてください。

よくある質問

GitLab Duo Agent Platformはいつから正式版ですか？

GitLab 18.8で一般提供になり、リリースは2026年1月15日です。ベータは18.2から提供されていました。Self-Managedでは18.4で実験的機能として入り、18.9で機能フラグが削除されています。

GitLab DuoとGitLab Duo Agent Platformは何が違いますか？

GitLab DuoはGitLabのAI機能全体の名前です。シート課金のアドオン（Duo Pro、Duo Enterprise）とPremium以上に含まれるDuo Coreがあり、Agent Platformはその中のエージェントとフローを扱う部分で、GitLab Creditsの従量課金です。Duo ProとEnterpriseの機能はクレジットを消費しません。Duo Coreの利用者は2026年5月21日から従来型（非エージェント型）のチャットを使えなくなっており、チャットを使うにはAgent Platform側でクレジットを消費します。

GitLab Duoの料金はいくらですか？

Agent Platformはオンデマンドの定価で1クレジット1ドルです。Premium（29ドル／人・月の年払い）には月12クレジット、Ultimateには月24クレジットが1人ずつ付きますが、期間限定のプロモーションと明記されています。Code Review Flowは1回0.25ドルです。

Freeプランでも使えますか？

使えます。GitLab.comは18.10から、Self-Managedは19.0から、Freeでも月次コミットメントとしてクレジットを購入するとAgentic Chatや一部のフローを使えます。外部エージェント、Recommend Reviewers Flow、SASTとシークレット検出の各フローはFreeの対象外です。

Claude CodeやCodexをGitLabのコーディングエージェントとして動かせますか？

外部エージェントとして、MRやIssueのイベントからRunner上で動かせます。ClaudeとCodexはGitLabが管理する資格情報で動かせますが、機能フラグで制御されており、有効化にはGitLabサポートへの連絡が必要です。Freeプランでは使えません。

関連記事

• GitLabの使い方：プロジェクト作成からIssue・MR・CI/CDまでの手順【2026年10月】
• GitLab 19.2とは？Duo CLI・カスタムフローGAで変わる開発運用
• GitHubとGitLabの違い｜ActionsとGitLab CIの対応表・料金・セルフホスト比較
• AGENTS.mdとは？書き方・配置とCodex・Claude Code・Copilotの読み込み仕様【2026年11月実測】
• PR-AgentをGitLabで使う手順｜CI・Webhook・Lambdaの設定と自動レビューの制御【v0.49対応】