Как я подключил Higgsfield CLI к Claude Code и автоматизировал видео-завод

Что вышло 6 мая 2026

Higgsfield AI — это студия, известная по моделям Soul V2 и кинематографичной видеогенерации. До мая 2026 у них был только веб-кабинет и MCP-сервер для AI-агентов. 6 мая 2026 они выложили в открытый доступ terminal CLI под лицензией MIT — npm-пакет @higgsfield/cli, версия v0.1.30.

Главная идея, которую прямо декларирует сама компания, — «turning Claude into a creative engine». Перевод: «превращаем Claude в творческий движок». Первым в списке поддерживаемых агентов у них стоит Claude Code, и это не маркетинговое притягивание — CLI спроектирован именно под автоматизацию из терминала и из агентских скиллов.

Терминал стал точкой сборки: Claude Code сам выбирает модель, собирает команду, ждёт результат и встраивает URL в следующий шаг — без ручного веб-кабинета.

Почему это релиз, а не просто инструмент

• Машиночитаемый вывод — флаг --json отдаёт структуру вместо человекочитаемой строки. Агент читает поле result_url без regex по логам.
• Синхронный режим — флаг --wait блокирует команду до завершения job (по умолчанию таймаут 10 минут, интервал опроса 3 секунды). Для агента это «один subprocess — один URL».
• OAuth вместо API-ключей — токен хранится в ~/.config/higgsfield/credentials.json. В коде агента ключей нет, в репозиторий ничего не утекает.
• 30+ моделей под одним протоколом — Google Veo 3.1, Kling v3.0 от Kuaishou, Wan 2.7 от Alibaba, OpenAI GPT Image 2, xAI Grok Video, Higgsfield Soul V2 — все вызываются командой higgsfield generate create <job_set_type> с одним и тем же набором базовых флагов.

Как Higgsfield CLI Работает Внутри Claude Code

Claude Code — официальный CLI Anthropic для Claude, в котором есть команды, скиллы и субагенты. Higgsfield CLI ложится в эту архитектуру четырьмя способами одновременно.

Минимальный пример: ролик из терминала за один вызов

Вот команда, которую агент собирает сам — и которая работает на любой машине, где прошёл OAuth:

higgsfield generate create kling3_0 \
  --prompt "slow camera push through a forest clearing at dawn" \
  --start-image ./first.png \
  --duration 5 --mode std --sound off \
  --json --wait \
  | jq -r '.result_url'

Что делает Claude Code:

1. Читает запрос пользователя («собери Reels про лес»).
2. Выбирает модель — kling3_0 по соотношению цена/качество для 5-секундного видео.
3. Если нужен старт-кадр — генерирует его через nano_banana_2 и кладёт в ./first.png.
4. Запускает команду выше, получает URL результата.
5. Скачивает видео, кладёт в ~/projects/content/reels-factory/in/, передаёт следующему шагу пайплайна — субтитры, монтаж, выгрузка.

Установка и OAuth за 3 минуты

Higgsfield CLI ставится тремя способами. На рабочем сервере у меня прижилась npm-версия — она кросс-платформенная и не зависит от Homebrew.

Установка

# Linux / macOS / Windows — npm
npm install -g @higgsfield/cli

# Альтернатива — curl-скрипт
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

# Альтернатива — Homebrew (только macOS / Linux)
brew install higgsfield-ai/tap/higgsfield

Проверка, что бинарник в PATH:

higgsfield version
higgsfield model list

OAuth-логин

Авторизация — однократная и через браузер, в духе gh auth login у GitHub:

higgsfield auth login

На сервере без браузера CLI отдаёт URL и device-код — открываете локально, авторизуетесь в Higgsfield, токен прилетает в ~/.config/higgsfield/credentials.json. Файл по дефолту приватный, но я ставлю chmod 600 и не коммичу никуда.

Проверка баланса

higgsfield account
# или машиночитаемо для скрипта
higgsfield account --json | jq '.credits'

На моём Ultra-плане баланс показал ровно 3 000 кредитов в месяц. По карте цен ниже — это много.

30+ Моделей Под Одним Интерфейсом

Список моделей живой — обновляется через higgsfield model list. На момент релиза CLI — 18 image-моделей и 16 видео-моделей. Параметры каждой смотрите через higgsfield model get <job_set_type>.

Видео — что я реально использую

Image — за что отвечает в Claude Code

Реальная Карта Цен (с явными параметрами)

Главный подвох, на котором я обжёгся в первый день: команда higgsfield generate cost <model> без флагов возвращает максимально дорогой default. Если вы не передаёте --duration, --quality, --mode, --resolution — она считает по топовому пресету, и 5-секундный Reels внезапно «стоит» 87 кредитов вместо 7.

Реальная стоимость с явными параметрами выглядит так:

Официальная страница тарифов — higgsfield.ai/pricing. Кредиты у CLI и веба общие — это удобно, не надо вести отдельный кошелёк.

Что Я Уже Автоматизировал в Claude Code

За первые сутки после релиза я подключил Higgsfield CLI к трём конвейерам, в которых раньше был ручной труд или API-зоопарк.

Кейс 1. Reels Factory — вертикальные ролики на автопилоте

В скилле reels-factory у меня была разведка трендов и ElevenLabs-озвучка, но финальное видео шло либо вручную, либо через хрупкий Veo API. Теперь:

• Скилл выбирает kling3_0 --mode std --duration 5 для черновиков и veo3_1_lite --duration 8 для финального постинга.
• Старт-кадр генерится через nano_banana_2 в 9:16, 2K.
• Subprocess с --json --wait возвращает URL, скачивание идёт curl-ом.
• Дальше — стандартный пайплайн: субтитры, монтаж, выгрузка.

Кейс 2. Hero-видео для презентаций /p/

На eco-os.ru у меня живут клиентские КП на /p/<slug>. Раньше hero-блок был статичной WebP-картинкой. Теперь скилл presentation при создании КП спрашивает: «hero статичный или живой?» — и при «живом» зовёт veo3_1 --quality basic --model veo-3-1-fast --duration 8. 22 кредита за hero — допустимый прайс на КП за 1.5 млн.

Кейс 3. OG-картинки блога aibot.direct

До этого OG-картинки шли через локальный Gemini API (Nano Banana Pro). Теперь у меня два маршрута в одном wrapper-скрипте: локальный Gemini для постоянного потока и Higgsfield Nano Banana Pro для случаев, когда нужен особый стиль или Soul-ID-консистентность с другими ассетами клиента.

CLI vs MCP-сервер: что выбрать для Claude Code

У Higgsfield два маршрута интеграции с агентами — CLI (то, о чём вся эта статья) и MCP-сервер по адресу https://mcp.higgsfield.ai/mcp. Я выбрал CLI и пользуюсь им основным, но у MCP есть свои сильные стороны.

Если у вас уже стоит Singularity MCP или другой MCP-сервер — добавлять второй имеет смысл, только если вы каждые 5 минут руками гоняете итерации в Claude Code. Для batch-конвейера CLI чище.

Грабли Первых Суток

Список того, на что я уже наступил — записывайте, чтобы не повторять.

1. cost без параметров считает по самому дорогому пресету

Команда higgsfield generate cost veo3_1 без флагов вернула 87 кредитов и я подумал, что это «средняя» цена. Это default «ultra + 8 секунд + preview». Реальная команда с --quality basic --model veo-3-1-fast --duration 8 стоит 22 кредита — в 4 раза дешевле. Всегда передавайте параметры в cost.

2. Veo принимает не любую длину

У veo3_1 --duration работает только для значений {4, 6, 8}. Не 5, не 10. Я пытался передать --duration 5 и получил молчаливый rejection. Для 5-секундных роликов берите Kling.

3. Aspect ratio — не каждой модели любой

Список валидных --aspect_ratio у каждой модели свой. kling_omni_image поддерживает 21:9, а nano_banana_2 — нет. Перед тем как ставить ROI на конкретное соотношение, дёрните higgsfield model get <name>.

4. Токены OAuth короткоживущие

У меня дважды за сутки выпадал Session expired. Решение — higgsfield auth login заново. На сервере без графики используйте device-flow с печатью URL в stdout.

5. --wait-timeout по умолчанию 10 минут

Для премиум-моделей Veo 3.1 ultra 8 секунд это иногда впритык. Я ставлю --wait-timeout 20m --wait-interval 10s для тяжёлых запусков и fire-and-forget с generate wait <job_id> позже — для больших batch-серий.