Скрипты и автоматизация CLI

Эта страница описывает рабочие процессы, ориентированные на задачи и построенные на основе CLI ant. Для получения информации о базовых флагах и параметрах вывода см. Использование CLI.



Управление версиями ресурсов API

Вы можете использовать CLI для управления версиями ресурсов API, таких как навыки, агенты, окружения или развёртывания, в виде файлов YAML в вашем репозитории и поддерживать их синхронизацию с Claude API.



Шаблоны скриптов

CLI разработан для совместной работы со стандартными инструментами оболочки.



Передача вывода списка во вторую команду

--transform id --raw-output на конечной точке списка выводит по одному чистому ID на строку, поэтому стандартные инструменты, такие как head и xargs, применяются напрямую. Захватите первый результат, затем передайте его в последующую команду:

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl



Анализ ошибок

Флаги --transform-error и --format-error применяют ту же фильтрацию к ответам с ошибками. --raw-output не применяется к ошибкам, поэтому используйте --format-error yaml для получения скаляра без кавычек. Извлеките только сообщение об ошибке:

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

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.



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

Claude Code может использовать CLI ant сразу после установки. Когда CLI установлен и аутентифицирован, вы можете попросить Claude Code работать с вашими ресурсами API напрямую. Например:

• «Перечисли мои недавние сессии агентов и подытожь, какие из них завершились с ошибкой.»
• «Загрузи каждый PDF из ./reports в Files API и выведи полученные ID.»
• «Получи события для сессии session_01... и скажи мне, где агент застрял.»

Claude Code вызывает ant через оболочку, разбирает структурированный вывод и анализирует результаты (никакого пользовательского кода интеграции не требуется).



Аутентификация запросов curl с помощью учётных данных CLI

Скрипты, которые вызывают API с помощью curl или другого HTTP-клиента, могут использовать учётные данные, сохранённые командой ant auth login, вместо статического ключа API. Токен доступа OAuth передаётся в заголовке Authorization как bearer-токен; заголовок x-api-key предназначен только для статических ключей API.

ant auth print-credentials --access-token выводит токен доступа активного профиля, предварительно обновляя его, если он истёк или близок к истечению:

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Выполните ant auth status, чтобы подтвердить, в какую организацию и рабочее пространство вы вошли; команда предупреждает, когда переменная окружения переопределяет ваш вход.