Anthropic公式『ant CLI』徹底ガイド|YAMLでClaude AgentをGitOps運用する
「リリース48時間後のAPIで作るとは、Stack Overflowに答えがないということだ」
Mediumに公開された開発者Aditya Sankhla氏のレポートにこんな一節がある(出典:Aditya Sankhla, Medium、2026年4月10日)。それでも氏はその日の夕方には、ターミナルから1コマンドで挿絵入りの絵本PDFを生成するCLIツールを動かしていた。リリースされたばかりのClaude Managed Agentsと、それを操るための公式CLIツール「ant」を組み合わせた成果物だ。
2026年4月8日、Anthropicは Claude Managed Agents のパブリックベータと同時に、APIを操作する公式コマンドラインツール「ant CLI」をリリースした(出典:anthropics/anthropic-cli, GitHub Releases)。Goで実装された330KB弱のシングルバイナリ、ライセンスはMIT。地味な発表だが、開発者の運用ワークフローには静かに大きな影響を与えつつある。
- Claude APIをcurlやSDKから叩いているが、もう少し型のあるツールに乗り換えたいエンジニア
- Managed Agentsの設定をGitで管理し、CIから自動デプロイしたいDevOps/SREエンジニア
- ant CLIとClaude Codeの使い分けを整理したい個人開発者・フリーランス
- 「kubectlっぽい」と聞いて警戒している、CLI設計に一家言あるエンジニア
ant CLIは、Claude APIのリソース管理を「kubectl風のリソース指向コマンド」と「YAMLによる宣言的定義」の組み合わせで提供する公式ツールだ。エージェント・環境・セッション・スキルといった抽象をGitリポジトリで管理し、CIから「ant beta:agents update」を流す運用が可能になる。Claude Codeが「対話で書く相棒」なら、ant CLIは「スクリプトと自動化の工具」だ。料金面ではManaged Agentsの0.08ドル/セッション時間がコスト超過の要因になり得るので、本番運用前に試算を必ず行いたい。
なぜ今、専用CLIなのか
そもそもClaude APIはRESTで設計されていて、curlでも操作できる。SDKもPython・TypeScript・Go・Javaが揃っている。なぜ専用CLIが必要なのか。
理由は端的に言えば、Managed Agentsの導入で「リソースの種類」が一気に増えたからだ。これまでのClaude APIは、メッセージを送って応答を受け取るというシンプルなI/Oだった。ところがManaged Agentsを使い始めると、エージェント定義(agents)、実行セッション(sessions)、コンテナ環境(environments)、スキル(skills)、デプロイ(deployments)といった抽象が次々登場する。それぞれにバージョンが付き、相互参照する。
curlでこれを管理しようとすると、JSONペイロードが手書きで爆発する。Qiitaに投稿された開発者の感想にこうある。
「
curlでAPIを叩くより大幅に少ないコードで、Claude APIのすべてのリソースをターミナルから操作できます。JSON手書きからの解放、APIリソースをYAMLファイルとしてGitリポジトリで管理できる」(出典:甲斐 甲, Qiita、2026年4月11日)
リソースが増え、関係性が複雑になり、バージョン管理が必要になる。これはまさにKubernetesがコンテナ管理で解いた問題と同じ構造だ。Anthropicがkubectl的なリソース指向CLIを採用したのは自然な流れと言える。
インストールと初期設定
公式ドキュメント(Claude API Docs: CLI)の手順は3パターンある。
macOS(Homebrew)
brew install anthropics/tap/ant
Linux / WSL(curl + tar)
VERSION=1.5.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/')
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin ant
Go環境がある場合
go install github.com/anthropics/anthropic-cli/cmd/ant@latest
認証は環境変数経由だ。
export ANTHROPIC_API_KEY="sk-ant-..."
ant messages create --model claude-opus-4-7 \
--max-tokens 1024 \
--message '{role: user, content: "Hello, Claude"}'
これだけでメッセージ生成が動く。--debugフラグを付けるとHTTPリクエスト/レスポンスがそのまま出力される(APIキーは自動でマスクされる)。地味だが、curl相当のデバッグ性能が組み込みで手に入るのは大きい。
リソース指向のコマンド体系
ant CLIのコマンドは「ant <resource>[:<subresource>] <action> [flags]」という形式に統一されている。kubectl風と呼ばれることが多いが、公式ドキュメント自身は「resource-based」という表現を使っている。
主要なリソースは以下のとおりだ。
| リソース | 用途 |
|---|---|
messages | 通常のメッセージ生成(GA) |
models | 利用可能なモデル一覧(GA) |
beta:agents | Managed Agentsのエージェント定義 |
beta:agents:versions | エージェントのバージョン履歴 |
beta:sessions | エージェント実行セッション |
beta:sessions:events | セッション内のイベント送受信 |
beta:environments | コンテナ実行環境 |
beta:files | ファイルアップロード・管理 |
ベータ機能にはbeta:プレフィックスがついており、CLI側が自動でanthropic-betaヘッダ(現状はmanaged-agents-2026-04-01)を付与してくれる。手書きでヘッダ管理する必要はない。これが地味に便利で、ベータヘッダの値が変わったときも CLI のアップデートで追従できる。
YAML定義とGitOps運用
ここがant CLIの真価が出るパートだ。エージェントを宣言的YAMLで定義し、Gitで管理する。
# summarizer.agent.yaml
name: Summarizer
model: claude-sonnet-4-6
system: |
You are a helpful assistant that writes concise summaries.
tools:
- type: agent_toolset_20260401
# summarizer.environment.yaml
name: summarizer-env
config:
type: cloud
networking:
type: unrestricted
作成は標準入力経由で。
ant beta:agents create < summarizer.agent.yaml
ant beta:environments create < summarizer.environment.yaml
更新時は--agent-idと--versionの指定が必要だ。versionは楽観ロック(更新リクエストにバージョン番号を添えて、サーバー側の最新値と一致しなければ拒否する仕組み)用で、複数人で同じエージェントを更新するときの上書き事故を防ぐ役割を担う。
ant beta:agents update --agent-id agent_011... --version 3 < summarizer.agent.yaml
CIに組み込む場合の典型的なフローはこうなる。
- プルリクエストでYAMLを変更してマージ
- GitHub ActionsやGitLab CIで
ant beta:agents updateを実行 - デプロイ後の動作確認をスクリプト化(
ant beta:sessions create→ant beta:sessions:events send→ 出力を検証)
「YAMLワークフローこそant CLIがチーム運用で本領を発揮するところ」と評する個人開発者ブログの言葉は的確だ(出典:Avinash Sangle、2026年4月18日)。
Claude Codeとの使い分け
混乱しやすいのが Claude Code との関係性だ。どちらもターミナルで動くAnthropic公式ツールだが、役割は明確に違う。
Claude Codeは対話型のコーディング支援ツールで、ターミナル内でファイルを編集したり、コードベースを調査したり、テストを走らせたりする「相棒」として動く。ユーザーが自然言語で指示し、Claudeが提案と実行を繰り返す。
ant CLIはAPIリソース管理のための工具だ。スクリプトやCIから呼び出して、Claude APIのリソースを作成・更新・取得する。対話はしない。
両者は競合せず、むしろ連携する。Claude Codeはant CLIの存在を最初から認識しており、ユーザーが「このYAMLを更新したい」と頼むと、Claude Codeが内部でantコマンドを実行して結果を解釈する。公式ドキュメントの言葉を借りればこうだ。
「Claude Codeは標準でantコマンドの使い方を理解している。CLIをインストールしてANTHROPIC_API_KEYを設定すれば、Claude Codeに直接APIリソースの操作を頼める」(出典:Claude API Docs: CLI)
実際の開発者の運用パターンも、両者を併用する形に収束しつつある。
「両方を毎日使っていて相互補完できている。シェルスクリプトやCIに乗せる用途ならantが正解だ」(出典:Avinash Sangle)
料金のリアリティチェック
ここで現実的な話をしておく。Managed Agentsの料金体系は、表面的にはシンプルだ。
- 通常のClaude APIトークン課金(入出力単価はモデルごと)
- セッション稼働時間に対して0.08ドル/セッション時間(ミリ秒単位、稼働中のみ課金)
- Web検索ツール利用時は1,000検索あたり10ドル
「8セント/時間なら安そうだ」と思った読者は注意したい。Mediumに投稿された分析記事は、現実的な試算を提示している。
「24エージェントが毎日8時間タスクを走らせると、セッション分だけで日15.36ドル。推論コストは別。」(出典:unicodeveloper, Medium、2026年4月9日)
24エージェント×8時間×0.08ドル×30日 = 460.8ドル/月。これはランタイム料金だけの話で、ここに各エージェントが消費するトークン料金が乗る。別の分析では、20分のカスタマーサービス的セッションで発生するランタイム料金が約0.027ドル、24時間常駐型エージェントでも月58ドル程度というサンプル試算が紹介されており、合計コストに占めるランタイム料金は推論側のトークン費用に対して相対的に小さい比重に収まるケースが多い(出典:Pebblous)。とはいえ、エージェント数とセッション時間の積で線形に増えるため、本番投入前に必ず実測しておきたい数字だ。
つまり、ant CLIで気軽にエージェントを増やせる仕組みは、コスト管理の責任も同じだけ増やす。本番投入前に1セッションあたりのコストプロファイルをサンプリングしておくことが、PMとしては強く推奨される。
競合との立ち位置
ant CLIに直接競合する公式CLIは、現時点で多くない。それでも近接する選択肢を整理しておく。
OpenAI Codex CLI は対話型のコーディングエージェントで、ant CLIとは用途が違う。MCPサーバー管理や/skillsコマンドはあるが、汎用エージェントの宣言的定義・デプロイ用ではない。
LangGraph CLIはlanggraph deployでグラフ志向のエージェントをデプロイできる。ただし設定はJSONベースで、デプロイ対象も同コマンドで作成したものに限定される(UIやGitHub連携で作成したデプロイは更新不可)。
CrewAI CLIは宣言的YAMLが中核で、運用思想がant CLIに最も近い。crewai create crewでスキャフォールドしてcrewai deployでAMP(Agent Management Platform)に上げる。料金は最小99ドル/月から。
Google Vertex AI Agent Engine + ADK CLIはGCPロックイン前提のSDK中心アプローチで、kubectl的なシンプルさは薄い。
ant CLIの差別化ポイントは、**「Anthropicが提供する単一のManaged Agentsプラットフォームに対する公式CLI」**という一貫性だ。LangGraphやCrewAIは複数モデルプロバイダを扱える代わりに、運用基盤が統合されていない。ant CLIはClaude専用の代わりに、モデルとプラットフォームと管理ツールが同じベンダーから提供される。
これは強みでもあり、弱みでもある。Hacker Newsのスレッドではベンダーロックインへの警戒が複数のコメントで挙がっていた。
「顧客をAnthropicソフトに依存させるのはNG。品質工学は彼らの強みじゃない」「単一モデルプロバイダ縛りは無理」(出典:Hacker News, item 47693047、2026年4月)
制限と注意点
公開ベータ段階での制約も把握しておく。
- ベータヘッダ依存:
beta:配下のリソースはベータヘッダmanaged-agents-2026-04-01が必須。正式リリース時に値が変わる可能性があり、CLI側で自動追従するとはいえ、CIスクリプトの再現性には注意したい - ドキュメントとSDKの食い違い:リリース直後はSDKドキュメントとCLIドキュメントの整合性が完全ではないという報告がある。「ダウンロードAPIがファイルを0件返してきた」「15分デバッグに溶かした」といった声もあった(出典:Aditya Sankhla, Medium)
- Claude専用:Managed AgentsはClaudeモデル専用。GPTやGeminiを混ぜたマルチプロバイダ構成は取れない。マルチモデルの柔軟性が必要なケースではLangGraphやCrewAIの併用が現実解になる
- バージョンの追随コスト:v1.0.0(2026年4月8日)からv1.5.0(2026年5月4日)まで1ヶ月で5回のマイナーアップデートが入っている。CIで使うならバージョン固定の運用ルールを早めに決めておきたい
電脳狐影としての判断
PMとしての視点で言えば、ant CLIは「Claudeエコシステムでエージェント運用を本気でやるなら、有力な選択肢となる工具」だと考える。curl + jqで頑張る必然性は薄れている。
ただし、ant CLIだけで設計判断が完結するわけではない。導入の前に、こういう問いに答えておきたい。
- エージェント運用にClaude以外のモデルが必要か。必要なら、ant CLIをベースにしつつLangGraphなどでマルチモデル層を別途設計する
- セッション稼働時間が長期化しそうか。長いほどランタイム料金が積み上がる。常駐型のワークフローはコスト試算を慎重に
- YAML/Gitでエージェント定義を管理する文化がチームにあるか。Infrastructure as Code(インフラ設定をコードとしてバージョン管理する考え方)に不慣れなチームでは、まずClaude PlatformのUIから入る方が学習コストが低いケースもある
逆に言えば、これらに「Yes・短い・Yes」と答えられるなら、ant CLIは即採用していい。CIにant beta:agents updateを1行入れるだけで、エージェント運用が一段階成熟する。
ant CLIの公式リファレンスは platform.claude.com/docs/en/api/sdks/cli で確認できる。Managed Agentsのクイックスタートと併せて読むと、CLI経由でゼロからエージェントを組み立てる手順が一通り理解できる。
関連記事
- Claude Managed Agents完全ガイド - ant CLIが操作対象とするManaged Agentsの全体像とアーキテクチャを解説
- Claude Code 2026年アップデート完全版 - もう一つの公式CLI、Claude Codeの最新機能と運用ノウハウ
- Claude Code vs Codex CLI - 対話型CLIエージェントの代表格、Claude CodeとCodex CLIの実戦比較
- Claude API 4月アップデート - ant CLIから利用するWeb検索・コード実行機能のGA化
- MCP実践ガイド - ant CLI経由で使えるMCPサーバーの基礎と実装パターン
本記事の情報は2026年5月5日時点のものです。ant CLIおよびClaude Managed Agentsはパブリックベータ段階であり、料金体系・コマンド仕様・ベータヘッダの値は正式リリースまでに変更される可能性があります。料金はすべて税抜きの米ドル建てで、為替変動の影響を受けます。最新情報はAnthropic公式ドキュメントおよびGitHubリポジトリを必ずご確認ください。記事内の企業名・サービス名は各社の商標または登録商標です。