Ark CLI
Официальный CLI Volcengine Ark для агентов: чат с моделями, генерация картинок и видео, Plan, деплой и диагностика
- 149 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Команды `plans buy` и `plans renew` оформляют платные тарифы, а `+deploy` создает платные Endpoint в вашем аккаунте.
- Вход выдает CLI доступ к ключам API аккаунта Volcengine, а `+connect` и `helper` пишут скиллы и настройки MCP в каталоги локальных агентов.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ark-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команды `plans buy` и `plans renew` оформляют платные тарифы, а `+deploy` создает платные Endpoint в вашем аккаунте.
- Вход выдает CLI доступ к ключам API аккаунта Volcengine, а `+connect` и `helper` пишут скиллы и настройки MCP в каталоги локальных агентов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ark CLI (команда `arkcli`) — официальный инструмент Volcengine для платформы моделей Ark, который подключают к Claude Code, OpenCode, Codex и другим локальным агентам. Команда `+chat` ведет текстовые и мультимодальные диалоги, `+gen` рисует картинки через Seedream и снимает видео через Seedance и скачивает результат, `+understand` распознает текст на изображениях, пересказывает видео, расшифровывает речь и вынимает поля из документов. Платформенные задачи тоже собраны в команды: `models` ищет модели, `plans` показывает и оформляет тарифы Agent Plan и Coding Plan, включая места в командной версии, `train finetune` запускает дообучение, `+deploy` разворачивает базовую или свою модель как Endpoint, `usage` и `billing` показывают расход, `doctor` диагностирует модель, Endpoint и коды ошибок и по умолчанию только читает. Команда `arkcli +connect` ставит в локальных агентов скиллы с префиксами `ark-` и `arkcli-` из каталога `skills/` репозитория, чтобы они знали, какие задачи Ark умеют решать. Команда `arkcli helper configure codex --with-mcp` настраивает Harness и добавляет MCP-инструменты. Убрать скиллы можно командой `arkcli +connect uninstall`.
Для кого. Разработчикам и командам, которые строят на моделях Doubao, Seedream и Seedance в облаке Volcengine и хотят управлять платформой из агента вместо консоли в браузере.
Подходит, если
- Агент должен выбрать модель Ark под задачу, подключиться к ней и проверить, укладывается ли расход в тариф.
- Видео или картинки надо генерировать из терминала, а результат складывать на диск.
- Дообученную модель требуется развернуть как Endpoint одной командой с пробным запуском `--dry-run`.
- Запросы к Endpoint падают с кодом ошибки, и нужен разбор по коду с метриками.
- Командная версия Plan: смотреть занятые места и продлевать подписку из агента.
Не подходит, если
- Облако Volcengine не используется: инструмент работает только с Ark.
- Чтение документации на китайском затруднено: README и справка составлены на этом языке.
- Агенту нельзя давать доступ к платежным операциям: `plans buy` и `plans renew` меняют платные подписки, хотя CLI просит подтверждение.
Пример запроса к агенту
Найди модель Ark для понимания видео, пересказывай по главам файл demo.mp4 командой +understand и покажи расход токенов за этот месяц.Ограничения
Вход выполняется через Volcengine SSO командой `arkcli auth login volc-sso`, нужен аккаунт Volcengine; на машине без браузера работает `arkcli auth login --no-browser`. Требуется Node.js 16 или новее. Переменная `ARKCLI_SKIP_SKILLS=1` при установке пропускает скачивание скиллов, их можно поставить позже через `arkcli +connect`. Генерация и модели оплачиваются по тарифам Ark. Подробная документация и чат поддержки на китайском языке.
Как отключить. Команда `arkcli +connect uninstall` убирает скиллы `ark-` и `arkcli-` из локальных агентов, а `npm uninstall -g @volcengine/ark-cli` удаляет саму утилиту; `arkcli auth logout` завершает сессию.
Частые вопросы
Как установить Ark CLI?
Командой `npm i -g @volcengine/ark-cli@latest`. После нее проверьте `arkcli --version`, войдите через `arkcli auth login volc-sso` и подключите скиллы командой `arkcli +connect`.
Какие агенты поддерживаются?
README называет Claude Code, OpenCode и Codex; `arkcli +connect list` показывает, какие агенты найдены на вашей машине. Harness настраивается командой `arkcli helper configure <агент>`.
Списывает ли CLI деньги без подтверждения?
Для `plans buy` и `plans renew` CLI сначала показывает соглашение и шаги подтверждения и по умолчанию не списывает средства. Параметры перед вызовом смотрите в `arkcli plans buy --help`.
Что делает doctor?
Диагностирует модели, Endpoint, метрики запросов и коды ошибок и по умолчанию только читает данные. Исправления выполняются через отдельный шаг подтверждения.
Можно ли поставить CLI без скиллов?
Да. Установите с `ARKCLI_SKIP_SKILLS=1`, переменная срабатывает только при значении `1`. Позже скиллы подключаются командой `arkcli +connect`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОдин рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
Мост между локальными CLI-агентами: Codex, Cursor или Claude Code делегируют работу Antigravity, Grok, Kimi и еще семи агентам.
Один агент запускает других в фоне: Claude Code, Codex, Copilot CLI, Grok Build и Pi, с выбором модели под каждый этап.
Viden — терминальная панель для кодового агента: чат с моделью, подтверждение правок и надзор за Codex и Claude в одном окне.
Кодинг-агент в терминале на одном бинарнике Rust: читает код, правит файлы, гоняет тесты и работает с любой моделью по выбору.
AgentOS ведет команду агентов OpenClaw: рабочие пространства, задачи по расписанию, отчеты и подтверждения человека
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ark CLI (эта карточка) | нет | 149 | ||
| Aliyun Model Studio CLI | да | 370 | CLI для моделей Alibaba Cloud; Ark CLI работает с моделями Volcengine, генерацией Seedream и Seedance и их тарифами | |
| Volcengine MCP Servers | да | API-ключ | 334 | MCP-серверы для сервисов Volcengine; Ark CLI дает консольные команды платформы Ark и ставит скиллы в агентов |
Из блога
Коротко о README
README на китайском языке: возможности, схема потребительской и производственной цепочки, затем команды для установки, чата, тарифов, подключения агентов, деплоя и диагностики. В конце разделы про вход, профили и скиллы.