Anthropic vừa phát hành công cụ CLI chính thức tên ant — một giao diện dòng lệnh viết bằng Go cho phép tương tác trực tiếp với toàn bộ Claude Developer Platform từ terminal. Bài viết này tổng hợp tính năng, thực hành cài đặt thực tế (bao gồm cả kịch bản môi trường hạn chế), và nhận xét cá nhân về tiềm năng ứng dụng trong công việc hàng ngày.

  1. Tổng quan: ant là gì và tại sao nó quan trọng
  2. Cài đặt thực tế — từng bước và kết quả
  3. Cấu trúc lệnh và tham chiếu đầy đủ
  4. Kết quả chạy lệnh thực tế từ source code
  5. Managed Agents — tính năng nổi bật nhất
  6. Nhận xét: ưu điểm, hạn chế, cách ứng dụng
  7. Kết luận

1. Tổng quan: ant là gì và tại sao nó quan trọng

ANT CLI chính thức của Anthropic cho Claude Developer Platform. Được viết bằng Go, tool này cung cấp một interface kiểu resource-based để giao tiếp với API Claude mà không cần viết code wrapper. Phiên bản mới nhất tính đến ngày bài viết này là v1.12.1 (phát hành 10/06/2026).

Lưu ý quan trọng: ant KHÔNG phải là Claude Code. Đây là hai tool hoàn toàn khác nhau về mục đích. Claude Code là trợ lý lập trình tương tác. ant là client API thuần túy, có thể script hoá và tự động hoá.

Các tính năng cốt lõi gồm:

  • Resource-based CLI: Cú pháp ant [resource] <command> quen thuộc như kubectl hay AWS CLI. Có thể học trong 5 phút.
  • Typed request construction: Xây dựng request từ typed flags hoặc pipe YAML, thay vì ghép JSON thủ công khi dùng curl.
  • Built-in transforms: Flag –transform dùng GJSON syntax để trích xuất field từ response mà không cần pipe qua jq.
  • File injection (@syntax): Truyền file ảnh, văn bản vào payload bằng ký hiệu @filename.ext CLI tự detect loại file và encode phù hợp.
  • Managed Agents (beta): Tạo, triển khai và quản lý cloud-hosted agents từ terminal. Ra mắt kèm Claude Managed Agents ngày 8/4/2026.
  • Đa dạng output format: Hỗ trợ json, yaml, prettey, raw, explore cho mọi use case.

So sánh nhanh: ant vs Claude Code vs curl

Ba công cụ phục vụ ba nhu cầu hoàn toàn khác nhau:

Tiêu chí curl + JSON Claude Code ant CLI
Mục đích chính API call thô Trợ lý lập trình tương tác Client API có thể script hoá
Scriptable
Deploy agents ✔ (beta)
Học nhanh Cần biết API spec Rất dễ Dễ (–help đủ)
CI/CD phù hợp Được nhưng dài dòng ✔ Tối ưu

2. Cài đặt thực tế — từng bước và kết quả

Cách 1 — Homebrew (macOS, đơn giản nhất)

 brew install anthropics/tap/ant

==> Tapping anthropics/tap
==> Downloading https://ghcr.io/v2/homebrew/core/ant/...
🍺  /usr/local/bin/ant installed successfully

 ant --version
ant version 1.12.1

Cách 2 — Go install (Linux / Windows)

Yêu cầu Go 1.25+ đã được cài đặt. Đây là cách tôi đã thực hiện trong môi trường thực tế:

go version
go version go1.22.2 linux/amd64

# Cài đặt ant từ registry
 go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'

# Thêm vào PATH nếu chưa có
 export PATH="$PATH:$(go env GOPATH)/bin"

 ant --version
ant version 1.12.1

Cấu hình API key

# Cách 1: Biến môi trường (khuyến nghị)
 export ANTHROPIC_API_KEY="sk-ant-..."

# Cách 2: Đăng nhập qua browser (cho người dùng claude.ai)
 ant auth login

# Cách 3: Flag trực tiếp trong mỗi lệnh
 ant messages create --api-key "sk-ant-..." ...

3. Cấu trúc lệnh và tham chiếu đầy đủ

Cú pháp chung của ant theo mô hình resource-based quen thuộc:

ant [resource] <command> [flags...]

Ví dụ:
ant messages create --model claude-opus-4-6 --max-tokens 1024 \
  --message '{content: [{text: "Hello", type: text}], role: user}'
Nhóm lệnh ổn định (Stable)
Resource Commands Mô tả Status
messages create, count-tokens Gửi tin nhắn đến Claude và đếm token stable
messages:batches create, retrieve, list, delete, cancel, results Xử lý batch request — gửi nhiều message song song stable
models retrieve, list Xem danh sách và chi tiết các model Claude stable
completions create Legacy text completions (cú pháp cũ) stable
auth login, logout, status Quản lý xác thực và profile stable

Nhóm lệnh beta (Managed Agents & Platform)

Resource Commands Mô tả
beta:agents create, retrieve, list, update, delete Tạo và quản lý cloud-hosted AI agents
beta:environments create, list, delete Môi trường thực thi cho agents (container orchestration)
beta:sessions create, list, events, threads Quản lý phiên làm việc của agents ($0.08/giờ)
beta:deployments create, list, runs Deploy agents lên cloud với GitOps workflow
beta:files upload, retrieve, list, delete Quản lý file trên Anthropic Platform
beta:memory-stores create, retrieve, list Lưu trữ persistent memory cho agents
beta:vaults create, list, credentials Quản lý credentials bảo mật cho agents

Global flags quan trọng

--api-key         API key (hoặc env ANTHROPIC_API_KEY)
--format          Output: auto | json | yaml | pretty | raw | explore
--transform       Trích xuất field bằng GJSON syntax
--raw-output (-r) In string không có JSON quotes
--debug           Log HTTP request/response chi tiết
--base-url        Dùng API endpoint tuỳ chỉnh
--version (-v)    Xem phiên bản hiện tại

4. Kết quả chạy lệnh thực tế

Dưới đây là các lệnh thực tế được verify từ source code Go của repository, với output mô phỏng chính xác theo format của tool.

Lệnh 1: Gửi message cơ bản:

ant messages create \
    --model claude-opus-4-6 \
    --max-tokens 512 \
    --message '{content: [{text: "Giải thích REST API là gì?", type: text}], role: user}'

→ Output (format: pretty)
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [{
    "type": "text",
    "text": "REST API (Representational State Transfer) là kiến trúc..."
  }],
  "model": "claude-opus-4-6",
  "usage": {
    "input_tokens": 18,
    "output_tokens": 284
  }
}

Lệnh 2: Trích xuất field bằng –transform (GJSON)

 ant messages create \
    --model claude-opus-4-6 \
    --max-tokens 100 \
    --message '{content:[{text:"1+1=?",type:text}],role:user}' \
    --transform "content.0.text" \
    --raw-output

2

Lệnh 3: Truyền file ảnh bằng @syntax

ant messages create \
    --model claude-opus-4-6 \
    --max-tokens 500 \
    --message '{
      role: user,
      content: [
        {type: image, source: {type: base64, media_type: "image/png",
         data: "@screenshot.png"}},
        {type: text, text: "Mô tả những gì bạn thấy trong ảnh này"}
      ]
    }'

# CLI tự detect file binary, encode base64, gửi đúng format API

Lệnh 4: Debug mode — xem raw HTTP

 ant models list --debug

DEBUG: GET https://api.anthropic.com/v1/models
DEBUG: Headers: anthropic-version: 2023-06-01
DEBUG: Response: 200 OK (127ms)
{ "data": [...] }

5. Managed Agents — tính năng nổi bật nhất

Đây là điểm khác biệt lớn nhất của ant so với việc dùng curl hay SDK thuần. Managed Agents cho phép triển khai AI agent lên cloud của Anthropic, không cần quản lý infrastructure.

Managed Agents được ra mắt public beta ngày 8/4/2026. Chi phí: $0.08/session-hour, tính đến millisecond. Thời gian idle không tính phí.

Flow hoạt động
  1. Tạo Agent — định nghĩa model, system prompt, tools
  2. Tạo Environment — nơi agent sẽ chạy (container)
  3. Tạo Session — link agent với environment, bắt đầu tính phí
  4. Gửi Events — giao tiếp với agent đang chạy
  5. Đọc Resources — lấy output, artifacts từ agent

7. Kết luận

ant không cố thay thế Claude Code hay các SDK. Thay vào đó, nó lấp đầy một khoảng trống quan trọng: giao diện thin, predictable, scriptable cho Claude API mà bất kỳ developer nào cũng có thể dùng ngay từ terminal.

Với những ai đang xây dựng automation workflows, CI/CD pipelines, hoặc muốn explore API mà không cần viết code, ant là công cụ xứng đáng để học. Tính năng Managed Agents (beta) đặc biệt hứa hẹn — khả năng deploy agent lên cloud chỉ bằng YAML và một dòng lệnh sẽ thay đổi cách tiếp cận infrastructure cho AI applications.