Claude の API を試したいとき、これまでは curl で長いJSONを手書きしたり、Python/Node の SDK を書いたり——「ちょっと叩きたいだけ」なのに準備が面倒でした。
そこで便利なのが、Anthropic 公式の ant CLI（anthropic-cli）です。Claude API をターミナルから直接叩ける公式コマンドラインツールで、メッセージ送信からモデル一覧、ファイル、エージェントまで、APIのほぼ全機能をシェルのサブコマンドとして使えます。
この記事では、ant CLI のインストール → 認証 → 最初のメッセージ送信 → 実用テクニックまでを、最短で動かせるようにまとめます。最初に「Claude Code との違い」もはっきりさせるので、「どっちを使えばいいの？」も解消できます。
※ ant CLI は活発に更新が続いているツールです（本記事執筆時点の最新は v1.12.x／2026年6月）。コマンドやフラグは変わる可能性があるので、最新は公式リポジトリ・公式Docsもあわせてご確認ください。
ant CLI とは？（Claude Code との違い）
まず混同しやすいポイントから。ant CLI と Claude Code は別物です。
ant CLI（ant） |
Claude Code | |
|---|---|---|
| 役割 | Claude API を直接叩く公式CLI | エージェント型のコーディング支援 |
| 使う相手 | API のエンドポイント（messages/models/files…） | あなたのコードベース（読んで・直して・実行） |
| 向く用途 | スクリプト・自動化・CI・APIの動作確認 | 実装・リファクタ・デバッグなどの開発作業 |
| 課金 | APIキーの従量課金 | Pro/Max などのサブスク（または API） |
| 実装 | Go製・MITライセンス・OSS | Anthropic 製のエージェントツール |
ざっくり言うと、ant CLI は「API を手軽に叩く道具」、Claude Code は「一緒に開発してくれる相棒」。やりたいことが「APIの結果をスクリプトで処理したい／挙動を確かめたい」なら ant CLI、「コードを書かせたい」なら Claude Code、という住み分けです。
ant CLI の特徴：
- 対応OS：macOS / Linux / Windows
- Go製・MITライセンス（オープンソース）
messages・models・files・agents・sessionsなど、APIリソースがそのままサブコマンドcurlの手書きJSONを、緩いYAML記法やtypedフラグで書ける
インストール
インストールは2通りです。手軽なのは Homebrew（macOS）。
Homebrew（macOS）
brew install anthropics/tap/ant
go install（macOS / Linux / Windows 共通）
Go 1.22 以上が必要です。
go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'
# バイナリは $(go env GOPATH)/bin に入るので、PATHを通す
export PATH="$PATH:$(go env GOPATH)/bin"
インストールできたら、バージョンを確認しておきましょう。
ant --version
認証（APIキーの設定）
ant CLI は Claude の API キーで認証します。キーは Claude Console で発行できます。設定方法は2通り。
① 対話ログイン
ant auth login
② 環境変数で指定
export ANTHROPIC_API_KEY=（あなたのAPIキー）
⚠️ 課金に注意：ant CLI は APIキーの従量課金で動きます（Pro/Max などのサブスク枠とは別）。これは、当ブログの【6月15日の料金変更は延期に】で触れた「APIキーのPlatformアカウントはサブスク枠の対象外」と同じ扱いです。叩いた分だけ料金が発生するので、
--max-tokensを小さめにして試すのがおすすめです。※ APIキーは秘密情報です。スクショやブログにそのまま載せないよう注意（この記事の画像もキー部分はぼかします）。
最初の一打：メッセージを送ってみる
基本は messages create です。モデルと最大トークン、メッセージを指定します。
ant messages create \
--model claude-opus-4-8 \
--max-tokens 256 \
--message '{role: user, content: "こんにちは。自己紹介を一文で。"}'
ポイントは、--message の中身が緩いYAML/JSON記法でOKなこと。role や content のキーをクォートで囲む必要がありません。curl で書く正式JSONより、ずっと書きやすくなっています。
応答から「本文だけ」を取り出す（–transform）
そのままだと応答はJSON構造で返りますが、--transform で欲しいフィールドだけ抜き出せます（GJSONパス指定）。本文テキストだけ欲しいなら：
ant messages create \
--model claude-opus-4-8 \
--max-tokens 256 \
--message '{role: user, content: "こんにちは"}' \
--transform content.0.text --raw-output
--raw-output を付けると、余計な装飾なしの生テキストで返るので、そのままシェルのパイプや変数に流せます。スクリプト連携の要になる機能です。
知っておくと便利な機能
ファイルを埋め込む（@path）
@path 構文を使うと、ファイルの内容をメッセージに直接埋め込めます。画像（base64）もこれでOK。
ant messages create \
--model claude-opus-4-8 \
--max-tokens 1024 \
--message '{role: user, content: [
{type: image, source: {type: base64, media_type: image/jpeg, data: "@photo.jpg"}},
{type: text, text: "この画像を説明して"}
]}'
"@photo.jpg" と書くだけで、ファイルを読み込んで該当フィールドに展開してくれます。手元の画像やテキストを渡すのが一気に楽になります。
使えるモデルを一覧する
ant models list
ベータ機能：エージェント・セッション・ファイル
ant CLI には beta: 系のサブコマンドもあり、Managed Agents のデプロイやセッション管理、ファイルのアップロードなども行えます。
ant beta:agents --help
ant beta:sessions --help
ant beta:files --help
まずは --help で何ができるかを眺めるのがおすすめです（ベータ機能はとくに更新が速いので、最新の挙動は公式Docsで確認を）。
どんな時に ant CLI を使う？
実際に触ってみると、ant CLI が向くのはこういう場面です。
- APIの挙動をサッと確認したい：
curlより手書きが楽。モデルやパラメータを変えて試行錯誤しやすい。 - シェルスクリプト・CIに組み込みたい：
--transform＋--raw-outputで、応答テキストをそのまま後続処理へ。 - 定型タスクの自動化：プロンプトを決め打ちで回すバッチ処理に。
逆に、「コードベースを読んで実装・修正してほしい」なら、それは Claude Code の領分です。ant CLI は API の薄いラッパーなので、“API そのものを使い倒す”用途に向いています。
コスト面の注意（再掲）：ant CLI は APIキー従量課金です。使いすぎを防ぐには、利用量の可視化が役立ちます。考え方は【Claude Code 1ヶ月のトークンコストを実測】や【ccusageでコストを可視化する方法】も参考に。
まとめ
- ant CLI＝Claude API をターミナルから叩く公式CLI（Go製・MIT・mac/Linux/Win）。Claude Code とは役割が別。
- インストールは
brew install anthropics/tap/antかgo install …/cmd/ant@latest（Go 1.22+）。 - 認証は
ant auth loginかANTHROPIC_API_KEY。課金は APIキー従量（サブスク枠とは別）。 - 最初の一打は
ant messages create。緩いYAML記法で書け、--transform＋--raw-outputで本文だけ抜ける。 @pathでファイル/画像を埋め込み、ant models listでモデル確認、beta:系でエージェント等も。- 用途は APIの確認・スクリプト・CI・自動化。コードを書かせたいなら Claude Code。
「API をちょっと叩きたい」が、これひとつで一気に身近になります。まずはインストールして ant messages create を一発、試してみてください。
あわせて読みたい：
・「6月15日の料金変更」は延期に｜なぜ撤回されたのか（APIキー課金とサブスク枠の違い）
・Claude Codeのサブエージェント実践｜使い方・自作・使いどころ（Claude Code側の使いこなし）
・Claude Code 1ヶ月のトークンコストを実測（コスト感の把握）
コメント