Claude Platform ant CLI: Официальное руководство разработчика

Что было запущено

Краткая версия: У Claude Platform теперь есть официальный API CLI под названием ant.

Твит о запуске полезен тем, что объясняет назначение продукта: API calls,

The new workflow shape:

terminal command
  -> ant resource action
  -> Claude API endpoint
  -> structured JSON/YAML/raw output
  -> shell pipeline, CI step, or Claude Code agent

Определение в одном предложении

The ant CLI is Anthropic's command-line interface for calling Claude API resources from a terminal.Это не замена для SDK на Python или TypeScript. Это нативный для оболочки (shell-native) интерфейс

Ментальная модель: четыре компонента

Чтение ant как небольшой адаптер между рабочими процессами в оболочке (shell) и платформой Claude.

[credentials/profile]
        |
        v
[ant resource:subresource action] --flags < stdin.yaml
        |
        v
[Claude API resource]
        |
        v
[formatted output] --transform -> shell, CI, or Claude Code

• Учетные данные: OAuth-авторизация, API key, федерация или именованный профиль.
• Команды: a resource action шаблон с вложенными ресурсами, разделенными двоеточиями.
• Ввод: флаги, stdin в формате YAML/JSON и @file ссылки на содержимое файлов для вставки (inline).
• Вывод: форматированный JSON, YAML, JSONL, необработанный вывод, интерактивный проводник и преобразования GJSON.

Установка и проверка

The CLI docs show install paths for Homebrew on macOS, curl on Linux/WSL, and Go. The least ambiguous official commands are Homebrew and Go, followed by the version check:

# macOS
brew install anthropics/tap/ant

# Go
go install github.com/anthropics/anthropic-cli/cmd/ant@latest

# Verify
ant --version

В документации также указано, что каждый доступный API ресурс отображается в локальной справке. ant --help, затем добавьте --help к ресурсу, ant messages create --help.

Аутентификация: OAuth, API Keys и профили

Официальная документация разделяет аутентификацию на локальную разработку и неинтерактивные ant auth login открывает OAuth-поток в браузере для Claude Console. Для удаленных хостов без локального браузера, --no-browser флаг выводит URL для авторизации и просит вставить полученный код.

ant auth login
ant auth login --no-browser
ant auth login --workspace-id wrkspc_01...
ant auth login --profile platform-dev

ant auth status
ant auth logout
ant auth logout --all

Важная деталь рабочего пространства: во время OAuth-логина вы выбираете организацию и рабочее пространство. Токен привязан к этому рабочему пространству. Чтобы работать с несколькими рабочими пространствами, создайте отдельный профиль для каждого из них и переключайтесь между профилями явно.

ant auth login --profile other-ws
ant profile activate other-ws

ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

Для CI, контейнеров и серверов документация CLI рекомендует отказаться от интерактивного входа в пользу Workload Identity Federation. Это позволяет соблюдать простое правило после установки: OAuth для вашей машины, федерация для автоматизации, API keys — когда вы намеренно хотите использовать аутентификацию на основе ключей.

Минимальный запрос от начала до конца

Как только ant установлен и прошел аутентификацию, документация переходит к Messages API. Это минимальная структура: модель, максимальное количество токенов и сообщение пользователя.

ant messages create \
  --model claude-opus-4-8 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

В документации ответ представлен как полный объект API: ID модели, ID сообщения, роль ассистента, массив контента, причина остановки и использование. CLI красиво форматирует этот объект, если stdout является терминалом.

Структура команд

Команды следуют структуре resource action . Вложенные ресурсы используют двоеточия, а бета-ресурсы находятся в beta:. В документации агенты, сессии, развертывания, окружения и навыки указаны как бета-ресурсы.

ant <resource>[:<subresource>] <action> [flags]

ant models list
ant messages create --model claude-opus-4-8 --max-tokens 1024 ...
ant beta:agents retrieve --agent-id agent_01...
ant beta:sessions:events list --session-id session_01...

Префикс beta важен, так как эти команды автоматически отправляют соответствующий anthropic-beta заголовок для этого ресурса. В документации сказано использовать --betaтолько тогда, когда вам нужно переопределить версию схемы по умолчанию.

Форматы вывода и преобразования GJSON

Вывод — это то, где ant становится чем-то большим, чем просто удобная обертка над curl. autoВ документации перечислены jsonAntigravity jsonlGemini yamlChrome prettyMCP rawAgent-First exploreIDE, API, macOS, Windows, Linux, Homebrew, AUR, Google, Vercel, Supabase, Postgres, GitHub, Cloudflare. Эндпоинты списков поддерживают автоматическую пагинацию, а вывод списка можно легко передавать в shell-команды через конвейер (pipe).

Язык трансформации — GJSON. Для эндпоинтов списков трансформация применяется к каждому элементу отдельно, а не ко всему конверту целиком. Именно поэтому данный паттерн позволяет выводить по одной сводке агента на строку:

ant beta:agents list \
  --transform "{id,name,model}" \
  --format jsonl

Мой практический совет: используйте --format jsonl когда следующая команда является shell-инструментом, и используйте --transform id --raw-output когда вам нужен ID ресурса для следующей ant вызов.

Передача тел запросов без написания JSON вручную

В документации CLI описаны три режима ввода: флаги, stdin и ссылки на файлы. Скалярные поля отображаются на флаги. Структурированные поля принимают упрощенный синтаксис в стиле YAML или строгий JSON. Полные тела запросов можно передавать через stdin в формате JSON или YAML.

ant beta:agents create <<'YAML'
name: Research Agent
model: claude-opus-4-8
system: |
  You are a research assistant. Cite sources for every claim.
tools:
  - type: agent_toolset_20260401
YAML

Для содержимого файлов в документации используется @path. Это позволяет встраивать файл промпта в строковое поле или отправлять PDF в Messages API, где CLI автоматически обнаруживает и кодирует бинарные файлы в base64.

ant beta:agents create \
  --name "Researcher" \
  --model '{id: claude-sonnet-4-6}' \
  --system @./prompts/researcher.txt

ant messages create \
  --model claude-opus-4-8 \
  --max-tokens 1024 \
  --message '{role: user, content: [
    {type: document, source: {type: base64, media_type: application/pdf, data: "@./scan.pdf"}},
    {type: text, text: "Extract the text from this scanned document."}
  ]}' \
  --transform 'content.0.text' --raw-output

Управление ресурсами API через системы контроля версий

Самая важная деталь запуска для платформенных команд — это не однострочный вызов Messages. Это раздел документации о хранении ресурсов API в YAML-файлах. Пример охватывает Managed Agent, окружение, сессию, событие пользователя и список событий сессии.

# 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

ant beta:agents create < summarizer.agent.yaml
ant beta:agents update --agent-id agent_011... --version 1 < summarizer.agent.yaml

# summarizer.environment.yaml
name: summarizer-env
config:
  type: cloud
  networking:
    type: unrestricted

ant beta:environments create < summarizer.environment.yaml

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Этот паттерн превращает ресурсы платформы в файлы, которые можно проверять, хранить в репозитории и обновлять через CI. CLI не отменяет необходимость управления, но делает операционную объектную модель доступной для shell-скриптов.

Использование ant из Claude Code

В твите о запуске сказано, что ant хорошо понимается агентами для кодинга, а документация CLI делает поведение Claude Code явным: с установленным и авторизованным ant Claude Code может вызывать его через shell, анализировать структурированный вывод и рассуждать на основе полученных результатов.

Prompts the docs say are now reasonable:

"List my recent agent sessions and summarize which ones errored."
"Upload every PDF in ./reports to the Files API and print the resulting IDs."
"Pull the events for session session_01... and tell me where the agent got stuck."

Практический вывод: Claude Code больше не нуждается в специализированных скриптах для понимания многих ресурсов Claude Platform. Установите ant, авторизуйте его в нужном рабочем пространстве, и Claude Code получит структурированную поверхность команд для работы.

Что я понял неправильно при изучении запуска

Моим первым ошибочным предположением было то, что ant — это просто более красивая обертка для Messages API. Документация проясняет более широкую цель: операции с ресурсами API, бета-версии Managed Agents, окружения, сессии, файлы, профили, трансформации и передача управления в Claude Code.

Вторым ошибочным предположением было то, что переключение профилей всегда имеет приоритет. Это не так. Если ANTHROPIC_API_KEY присутствует, в документации сказано, что профили игнорируются. Это первое, что я бы проверил, если команда выполняется не в том рабочем пространстве.

Третьим ошибочным предположением было то, что --format raw и --raw-output — это одно и то же. --raw-output и jq -r для строк. --format raw выводит необработанные байты ответа и ведет себя иначе на конечных точках (endpoints) со списками.

Отладка и автодополнение в оболочке (Shell Completion)

Для отладки добавьте --debug. В документации сказано, что это выводит точный HTTP-запрос и --format-error и --transform-error для фильтрации ответов с ошибками.

ant --debug beta:agents list

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

В документации также указано, что скрипты автодополнения поставляются для bash, zsh, fish и PowerShell. Это важно,

Вердикт

Пропустите его, если вам нужна типизированная интеграция в приложение, долгоживущие абстракции SDK или поведение среды выполнения,

FAQ

Глоссарий

ant

Инструмент командной строки от Anthropic для работы с ресурсами Claude Platform API.

Messages API

Конечная точка Claude API, используемая для отправки сообщений модели и получения ответов от ассистента.

Управляемый агент (Managed Agent)

Ресурс агента платформы Claude, настроенный с использованием модели, системного промпта, инструментов и параметров среды выполнения.

Рабочая область (Workspace)

Область в консоли Claude, определяющая, к каким API ресурсам могут обращаться учетные данные.

Профиль (Profile)

Именованная конфигурация CLI, используемая для переключения между учетными данными, рабочими областями и связанными настройками.

GJSON

Синтаксис пути, используемый --transform для извлечения или преобразования JSON ответов.

JSONL

JSON с разделителями в виде символов новой строки (Newline-delimited JSON), полезен, когда каждый элемент списка должен передаваться потоком в одну строку.

Федерация удостоверений рабочей нагрузки (Workload Identity Federation)

Неинтерактивный способ аутентификации, рекомендуемый в документации для CI, серверов и контейнеров.

Все официальные источники и ссылки

Согласно ограничениям при публикации данного поста, сообщества, ветки Reddit, комментарии на Hacker News, неофициальные блоги или сторонние руководства не использовались.