Как использовать командную строку GlobalGPT в коде Claude

Быстрый ответ: Установите Node.js версии 18 или более поздней, запустите npm i -g @glbgpt/cli, авторизоваться с помощью Вход в glbgpt, а затем запустите Установка навыка glbgpt. Запустите программу «Claude Code» в каталоге вашего проекта и задайте ей использовать GlobalGPT для обработки изображений, видео или больших объемов текста. Используйте --оценка до формирования носителя, чтобы вы могли сначала ознакомиться со стоимостью кредита.

CLI-интерфейс GlobalGPT позволяет выполнять в терминале такие задачи, как чат, генерация изображений, генерация видео и неинтерактивные задачи искусственного интеллекта. При подключении к Claude Code Claude может выбирать подходящие команды GlobalGPT, работать с файлами в вашем проекте, оценивать затраты на медиа-ресурсы перед генерацией и запускать повторяемые рабочие процессы по созданию контента без необходимости разработки собственной API-интеграции.

В этом руководстве показано Как использовать командную строку GlobalGPT в коде Claude от начала до конца: проверьте наличие необходимых условий, установите GlobalGPT CLI, войдите в систему с помощью своей учетной записи GlobalGPT, установите входящий в комплект набор инструментов Agent Skill, проверьте работоспособность соединения, безопасно сгенерируйте мультимедийные файлы, автоматизируйте структурированные задачи и устраните проблемы с DNS и авторизацией в браузере, которые могут прервать процесс настройки в Windows.

Что такое GlobalGPT CLI и зачем его использовать вместе с кодом Claude?

GlobalGPT CLI — это официальный клиент командной строки для доступа к чат-моделям GlobalGPT, генераторам изображений, генераторам видео, информации об учетной записи и истории задач. Стабильный пакет npm предоставляет доступ как к glbgpt и globalgpt команды и содержит exec интерфейс для скриптов и внешних агентов.

Код Claude определяет логику и контекст проекта. GlobalGPT CLI обеспечивает работу модели и взаимодействие с мультимедиа. Входящие в комплект globalgpt-generate В рамках курса «Навыки агента» обучают работе с кодом Claude: когда и как обращаться к CLI, в том числе как рассчитывать стоимость медиаресурсов, выбирать товары из каталога актуальных моделей, прикреплять эталонные изображения, ожидать поступления заданий и избегать случайных двойных списаний.

Три способа соединить коды GlobalGPT и Claude

Для большинства пользователей кода Claude, «Agent Skill + CLI» — лучшая отправная точка. Такая конфигурация позволяет сохранить компактность системы, использует имеющиеся возможности оболочки Claude Code и дает возможность работать на естественном языке, сохраняя при этом явную проверку затрат. Если ваша команда использует несколько агентов кодирования, вы также можете сравнить эту конфигурацию с сопутствующими руководствами по использование командной строки GlobalGPT в Codex и Использование командной строки GLBGPT в Cursor.

Необходимые условия перед началом работы

Вам понадобится:

• Node.js версии 18 или более поздней. В текущем пакете CLI GlobalGPT указано: узел >= 18.
• npm, который обычно устанавливается вместе с Node.js.
• Код Claude установлен и прошел аутентификацию.
• Учетная запись GlobalGPT с доступом к моделям или медиа-инструментам, которые вы планируете использовать.
• Надежный каталог проекта, в котором Claude Code имеет право выполнять терминальные команды.
• Обычно на настройку уходит примерно от 10 до 20 минут. Проблемы с сетью или авторизацией в браузере могут привести к тому, что первая настройка займет больше времени.

Выполните эти проверки в PowerShell, Терминале или в любой другой оболочке по вашему выбору:

node --version
npm --version
claude --version

В процессе проверки подлинности Windows на локальном компьютере использовался Node.js v24.18.0, npm 11.16.0, а также код Claude 2.1.211. Указанные версии приведены в качестве примеров, а не в качестве минимальных требований; для работы с CLI GlobalGPT требуется Node.js версии 18 или более поздней.

Шаг 1: Установите GlobalGPT CLI

GlobalGPT CLI доступен в виде стабильного релиза npm. Установите последнюю стабильную версию с помощью команды:

npm i -g @glbgpt/cli

После установки проверьте работу команды и версию:

glbgpt --version
glbgpt --help

Пакет устанавливает два взаимозаменяемых имени команд: glbgpt и globalgpt. В данном руководстве используется более краткая glbgpt форма.

Время установки и количество пакетов зависят от версии npm, состояния сетевого соединения и обновлений зависимостей. Успешная установка завершается без Ошибка npm. Сообщение npm проекты ищут финансирование имеет информационный характер и не свидетельствует о сбое при установке.

Шаг 2: Войдите в систему, используя свою учетную запись GlobalGPT

GlobalGPT CLI использует авторизацию через браузер с помощью вашей учетной записи GlobalGPT, поэтому вам не нужно создавать или вставлять ключ API в командную строку.

Запуск:

Вход в glbgpt

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

Если браузер не открывается автоматически, воспользуйтесь следующим:

glbgpt login --no-browser

Для машины без графического интерфейса или сеанса SSH воспользуйтесь алгоритмом ввода одноразового кода:

glbgpt login --code

Никогда не сообщайте одноразовый код, статус авторизации или URL-адрес обратного вызова. Вводите код только для процедуры входа, которую вы инициировали самостоятельно.

Проверьте сессию после авторизации:

glbgpt whoami
аккаунт glbgpt

glbgpt whoami подтверждает учетную запись, в которую выполнен вход. Аккаунт glbgpt отображает информацию о членстве и кредитах, что полезно перед созданием медиафайлов.

Шаг 3: Проверка командной строки GlobalGPT перед подключением кода Claude

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

Запустите интерактивный интерфейс терминала:

glbgpt

Отправьте короткое сообщение, например: Привет. Успешный ответ подтверждает, что CLI может запуститься, прочитать сессию вашей учетной записи, обратиться к модели чата и отобразить результат.

В интерфейсе терминала GlobalGPT введите / чтобы просмотреть доступные команды. К наиболее распространённым командам относятся: /модель, /модели, /изображение, /видео, /задачи, /статус, /аккаунт, /стоимость, /помощь, и /выход.

Для неинтерактивного теста используйте exec:

glbgpt exec "Ответить точно: соединение установлено"

Сайт exec Эта команда выводит ответ модели и завершает работу, благодаря чему она лучше подходит для использования в скриптах и внешних агентах.

Шаг 4: Установите агентский с킬 GlobalGPT для кода Claude

CLI GlobalGPT включает в себя встроенный набор навыков агента под названием globalgpt-generate. Установите его с помощью команды:

Установка навыка glbgpt

По умолчанию программа установки создаёт ссылки в каталогах навыков агентов, в том числе ~/.claude/навыки и ~/.agents/skills. «Связанная установка» означает, что при будущем обновлении CLI также может быть обновлен входящий в комплект набор навыков.

Если ваша среда не поддерживает ссылки или вы предпочитаете использовать отдельные файлы, воспользуйтесь следующим:

glbgpt skill install --copy

Повторное выполнение команды копирования приведет к перезаписи скопированного набора навыков, поэтому не следует вносить постоянные изменения в скопированный каталог.

После установки перезапустите код Claude, чтобы он обнаружил новый навык:

cd /путь/к/вашему/проекту
claude

В Windows PowerShell команда directory может выглядеть следующим образом:

Set-Location "C:\путь\к\вашему\проекту"
claude

Шаг 5: Проверка CLI-команд GlobalGPT в коде Claude без расходования кредитов

Начните с расчета ориентировочной стоимости. Это подтверждает, что код Claude способен определить навык, выполнить команду GlobalGPT CLI, запросить текущий каталог моделей и вернуть ориентировочную стоимость без генерации мультимедиа.

Используйте следующий запрос в коде Claude:

Используйте GlobalGPT для расчета стоимости главного изображения формата 16:9 для редакционной статьи, посвященной автоматизации контента с помощью ИИ.
Не создавайте изображение. Покажите мне модель, поддерживаемые параметры, команду и ориентировочную стоимость кредитов, а затем дождитесь одобрения.

Важная фраза — это “Не создавайте изображение”.” Навык GlobalGPT предназначен для использования --оценка на данном этапе, но четкие инструкции позволяют ясно определить границы вашего одобрения.

Вы также можете явно вызвать этот навык с помощью /globalgpt-generate если в интерфейсе кода Claude она указана как команда со слэшем. Запросы на естественном языке обычно бывают достаточными, если с킬 установлен, а задача явно связана с генерацией изображений или видео по коду GlobalGPT.

Шаг 6: Создание образа на основе кода Claude

После утверждения сметы попросите компанию «Claude Code» приступить к работе. Вот пример точного запроса:

Используйте команду GlobalGPT для генерации утвержденного главного изображения формата 16:9.
На изображении должен быть показан рабочий процесс создания контента с использованием ИИ, ориентированный на терминал, с лаконичным темным интерфейсом, синими акцентами и без логотипов или читаемого текста интерфейса.
Сохраните результат в папке ./glbgpt-output/. Не запускайте повторное генерацию, если первая команда была прервана или истек лимит времени.

С помощью командной строки GlobalGPT CLI можно вывести список каталога актуальных образов с помощью следующей команды:

Изображение списка моделей glbgpt

С помощью следующего кода можно проверить, какие параметры поддерживаются моделью:

glbgpt model show

Не следует жестко прописывать название модели в подсказке кода Claude, предназначенной для многократного использования, если это не требуется вашим рабочим процессом. Каталог формируется динамически и может изменяться. Позвольте Claude отобразить список доступных моделей, а затем выберите ту, которая поддерживает требуемое соотношение сторон, разрешение, эталонные изображения или другие требования.

К прямым эквивалентам в CLI относятся:

glbgpt image "автоматизация создания контента с помощью ИИ с приоритетом терминала, лаконичный тёмный интерфейс, синие акценты" --ar 16:9 --estimate
glbgpt image "автоматизация создания контента с помощью ИИ с приоритетом терминала, лаконичный тёмный интерфейс, синие акценты" --ar 16:9

Готовые файлы сохраняются в папке ./glbgpt-output/ если только вы не сдадите --out.

Шаг 7: Создание видео на основе кода Claude

В запросах на создание видео следует указывать сцену и только те параметры, которые вам действительно нужны. Поддержка таких параметров, как продолжительность, разрешение, соотношение сторон, звук и контрольные кадры, зависит от модели.

Начните с приблизительной оценки:

Используйте GlobalGPT для расчета стоимости 6-секундного видео в формате 16:9, в котором утвержденное изображение главного героя оживает при медленном приближении камеры.
Сначала перечислите совместимые видеомодели. Не приступайте к созданию, пока я не одобрю модель и смету.

После утверждения код Claude можно использовать с помощью команды следующего вида:

glbgpt video "медленное приближение камеры, едва заметное свечение экрана, профессиональное движение" --ar 16:9 --duration 6 --start-image ./glbgpt-output/hero.png

По умолчанию CLI ожидает завершения формирования файла. Создание видео может занять несколько минут. Не создавайте ненужный цикл опроса и не отправляйте запрос автоматически в случае прерывания выполнения команды; исходная серверная задача может все еще выполняться, и повторная отправка запроса может привести к двойному списанию кредитов.

Проверить прерванные или отсоединённые задачи можно с помощью:

glbgpt: список задач
glbgpt: показать последнюю задачу
glbgpt: ожидание последней задачи
glbgpt: загрузка последней задачи

Шаг 8: Автоматизация работы с большими объёмами текста с помощью glbgpt exec

glbgpt exec выполняет один неинтерактивный запрос к модели и возвращает результат в виде простого текста, JSON или JSONL. Это удобно, когда в коде Claude необходимо применить одну и ту же операцию ко множеству файлов или исключить очень большой исходный файл из основного диалога кода Claude.

Пример прямой команды:

glbgpt exec "Извлечь окончательное решение, ответственное лицо и срок выполнения" --file meeting-notes.md --json

Для структурированного вывода определите файл JSON Schema и передайте его с помощью --output-schema:

glbgpt exec "Классифицировать все брифы по контенту в зависимости от канала и цели" \
  --file content-queue.json \
  --output-schema classification-schema.json \
  --json

В коде Claude можно сказать:

Используйте команду `GlobalGPT exec` для классификации записей в файле `content-queue.json` в соответствии с файлом `classification-schema.json`.
Сначала покажите мне точную команду. Сохраните итоговый JSON-файл в папке `./results/classified-content.json`.
Не изменяйте исходный файл.

Используйте этот шаблон для повторяющихся задач или задач с большим объемом работы, а не для однострочного вопроса, на который можно получить прямой ответ с помощью кода Claude.

Дополнительно: подключите GlobalGPT в качестве сервера MCP

Навык «Агент» рекомендуется выбирать в том случае, если код Claude может выполнять команды оболочки. CLI GlobalGPT также может запускать сервер MCP через стандартные каналы ввода-вывода:

claude mcp add glbgpt -- glbgpt mcp
claude mcp list

В результате в качестве инструментов MCP представлены чат GlobalGPT, генерация изображений, генерация видео, проверка заданий и список моделей.

Максимальный размер медиафайла составляет По умолчанию — 4 000 кредитов на сеанс сервера MCP. Вы можете установить другое ограничение на количество сеансов:

claude mcp add glbgpt -- glbgpt mcp --max-credits 8000

Чтобы отключить расходы на медиа-рекламу в MCP, сохранив при этом возможности, не связанные с медиа-рекламой, используйте --max-credits 0.

Выбирайте MCP, если вам нужны специальные инструменты MCP или обеспечение соблюдения кредитных лимитов на уровне сеанса. Выбирайте Agent Skill, если вы хотите, чтобы код Claude управлял стандартным CLI с минимальной настройкой.

Устранение неполадок при работе с CLI GlobalGPT в Windows

npm возвращает ENOTFOUND или getaddrinfo

А ENOTFOUND Эта ошибка означает, что npm не смог определить имя хоста реестра. Это не означает, что пакет GlobalGPT отсутствует или повреждён.

Проверьте работоспособность реестра и преобразование DNS-имен:

npm config get registry
Resolve-DnsName registry.npmjs.org
npm ping

Если npm настроен на использование зеркала, проверьте также и это имя хоста. Смена реестра не решит проблему с DNS, если ни одно из имен хостов не разрешается.

В проверенном случае с Windows активный DNS-сервер WLAN не смог разрешить домены npm. Первая попытка сброса завершилась неудачей, поскольку у PowerShell не было прав администратора. После запуска окна PowerShell с повышенными правами, переключения настроек DNS в автоматический режим и очистки кэша оба Resolve-DnsName и npm ping удалось.

Сначала определите активный адаптер:

Get-NetAdapter | Where-Object Status -eq "Up"

Затем запустите сброс из PowerShell от имени администратора, заменив WLAN если ваш активный интерфейс имеет другое имя:

Set-DnsClientServerAddress -InterfaceAlias "WLAN" -ResetServerAddresses
Clear-DnsClientCache
Resolve-DnsName registry.npmjs.org
npm ping

Если ваша организация отвечает за управление DNS или сетевыми политиками, обратитесь к администратору, а не переопределяйте настройки самостоятельно.

Истек срок авторизации в браузере

Истекло время ожидания авторизации в браузере означает, что локальное окно ожидания завершилось. Это не означает, что установка npm завершилась сбоем.

Запустить Вход в glbgpt снова и завершите работу браузера, пока терминал остается открытым. Если браузер открывается на другом компьютере или функция обратного вызова не может установить связь с терминалом, используйте glbgpt login --code.

glbgpt Не распознается после установки

Откройте новый терминал и попробуйте ещё раз. Если команда по-прежнему недоступна, проверьте глобальный префикс npm:

npm prefix -g

Убедитесь, что глобальный каталог исполняемых файлов npm находится в вашем PATH, а затем запустите снова glbgpt --version.

Код Claude не распознает навык

Запустить Установка навыка glbgpt Еще раз убедитесь, что система сообщает о наличии каталога навыков Claude, полностью выйдите из кода Claude и запустите новый сеанс. Вы также можете попробовать /globalgpt-generate чтобы явно вызвать этот навык.

Модель или параметр отклонены

Каталог моделей является динамическим, и поддержка параметров зависит от конкретной модели. Обновите каталог и ознакомьтесь с выбранной моделью:

Изображение списка моделей glbgpt
Видео списка моделей glbgpt
glbgpt model show

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

Приложение «Generation Command» как будто зависает

Команды для работы с изображениями и видео по умолчанию ожидают завершения формирования конечного файла. Создание видео может занять несколько минут. Если работа терминала была прервана, проверьте текущую задачу, прежде чем отправлять новую:

список задач glbgpt
показать задачу glbgpt

Никогда не повторяйте попытку платного генерации вслепую.

Как измерить время и использование токенов для каждой задачи с кодом Claude

Перед выполнением каждого задания с кодом Claude:

1. Запустить /использование и запишите отображаемые значения параметров сеанса.
2. Запишите время начала по календарному времени.
3. Запустите только ту задачу, которая подлежит измерению.
4. Запишите время финиша и пробежку /использование снова.
5. Рассчитайте прошедшее время, а также — при наличии точных данных о количестве токенов — разницу в количестве токенов «до» и «после».

В текущей документации по коду Claude указано, что /использование Команда предоставляет информацию об использовании токенов для пользователей API. Интерфейсы подписок могут отображать данные об использовании тарифного плана, а не точное количество токенов, поэтому следует точно фиксировать информацию, предоставляемую текущим интерфейсом, и помечать недоступные значения как Неприменимо; не оценивайте и не выдумывайте количество токенов.

В случае операций с носителями GlobalGPT также необходимо фиксировать остаток по счету или по транзакции до и после генерации. Кодовые токены Claude и кредиты на носителях GlobalGPT представляют собой разные единицы учета и должны отражаться в отчетности отдельно.

Часто задаваемые вопросы

Мне нужен ключ API GlobalGPT?

No. GlobalGPT CLI использует авторизацию через браузер с помощью вашей учетной записи GlobalGPT. Запустите Вход в glbgpt, завершите процесс утверждения и разрешите CLI сохранить учетные данные локальной сессии. Не вставляйте одноразовые коды входа или URL-адреса авторизации в файлы проекта, скриншоты или общие журналы чата.

Можно ли использовать командную строку GlobalGPT без кода Claude?

Да. Запустить glbgpt для интерактивного чата, glbgpt изображение или Видео glbgpt для СМИ, а также glbgpt exec для неинтерактивных скриптов. Код Claude добавляет контекст проекта, логику, координацию работы с файлами и управление на естественном языке, однако CLI работает автономно.

Что лучше использовать: навык «Агент» или MCP?

Используйте Agent Skill, если код Claude позволяет выполнять команды оболочки и вам нужен максимально простой рабочий процесс на естественном языке. Используйте MCP, если вы предпочитаете явные инструменты MCP или вам требуется ограничение на использование медиа-кредитов на уровне сеанса, установленное сервером MCP. Оба интерфейса используют одну и ту же учетную запись GlobalGPT.

Где программа GlobalGPT сохраняет сгенерированные файлы?

По умолчанию сгенерированные изображения и видеоролики сохраняются в папке glbgpt-output/ относительно каталога, в котором была запущена команда или сервер. Передайте --out если вам нужно выбрать другое местоположение. По завершении выполнения команда выводит сохраненный путь.

Как избежать непреднамеренных расходов на рекламу в СМИ?

Используйте --оценка Перед каждой новой настройкой средств массовой информации следует запросить у Claude Code явное разрешение и избегать пакетных заданий, выполняемых в автоматическом режиме. Для MCP необходимо установить --max-credits 0 чтобы отключить мультимедиа или установить намеренное ограничение на количество сеансов. Никогда не следует автоматически повторять прерванное создание.

Является ли CLI GlobalGPT стабильной?

По состоянию на 21 июля 2026 года GlobalGPT CLI доступен в качестве стабильного релиза npm, версия 0.1.0. Установите его с помощью npm i -g @glbgpt/cli, а затем запустите glbgpt --version чтобы проверить версию установленной программы.

Ключевые выводы

• Установите стабильную версию CLI с помощью команды npm i -g @glbgpt/cli и проверьте его, прежде чем применять код Claude.
• Используйте авторизацию через браузер; для описанного в документации процесса входа в систему API-ключ не требуется.
• Запустить Установка навыка glbgpt, затем перезапустите программу Claude Code, чтобы она смогла обнаружить globalgpt-generate.
• Начинайте каждый медиа-рабочий процесс с --оценка и явного одобрения со стороны человека.
• Учитывайте использование кода Claude и рекламные кредиты по коду GlobalGPT отдельно.
• В Windows обращайтесь с npm ENOTFOUND в первую очередь как проблему с DNS, а не как доказательство неисправности пакета CLI.
• Если генерация прервана, перед повторной попыткой проверьте текущее задание.

Теперь, когда вы знаете Как использовать командную строку GlobalGPT в коде Claude, вы сможете превратить код Claude в практичный уровень управления для рабочих процессов, связанных с чатом, изображениями, видео и структурированным контентом. Начните с бесплатной оценки, протестируйте одну небольшую задачу от начала до конца и только после этого масштабируйте рабочий процесс до пакетной обработки или автоматизации по расписанию.