如何在 Claude 代码中使用 GlobalGPT CLI

快速回答： 安装 Node.js 18 或更高版本，运行 npm i -g @glbgpt/cli, 授权方式为 glbgpt 登录, 然后运行 glbgpt 技能安装. 在项目目录中重新启动 Claude Code，并让其使用 GlobalGPT 处理图片、视频或批量文本任务。使用 --估计 在生成媒体之前，以便您能先查看信贷成本。.

GlobalGPT CLI 将聊天、图像生成、视频生成以及非交互式 AI 任务带入了终端。 当您将其与 Claude Code 连接时，Claude 能够选择合适的 GlobalGPT 命令、处理项目中的文件、在生成前估算媒体成本，并运行可重复的内容工作流，而无需您构建自定义 API 集成。.

本指南介绍了 如何在 Claude 代码中使用 GlobalGPT CLI 从头到尾：检查先决条件、安装 GlobalGPT CLI、使用您的 GlobalGPT 账户登录、安装捆绑的 Agent Skill、验证连接、安全地生成媒体、自动化结构化任务，并解决可能导致 Windows 系统上设置中断的 DNS 和浏览器授权问题。.

什么是 GlobalGPT CLI，为什么要在 Claude 代码中使用它？

GlobalGPT CLI 是用于访问 GlobalGPT 聊天模型、图像生成器、视频生成器、账户信息和任务历史记录的官方命令行客户端。该稳定的 npm 包同时提供了 全球生物技术 和 globalgpt 命令，并包含一个 执行 用于脚本和外部代理的接口。.

Claude Code 提供了推理和项目背景。GlobalGPT CLI 提供了模型和媒体操作。捆绑的 globalgpt-generate “代理技能”课程将传授Claude代码，讲解何时以及如何调用CLI，包括如何估算媒体成本、从实时模型目录中进行选择、附加参考图片、等待任务，以及如何避免意外重复收费。.

连接 GlobalGPT 和 Claude 代码的三种方法

对于大多数 Claude Code 用户来说，, “代理技能 + CLI”是最佳的入门起点. 该方案保持了配置的简洁性，利用了 Claude Code 现有的 shell 功能，既允许您使用自然语言进行操作，又能保留显式的成本检查。如果您的团队使用多个编码代理，您还可以将此配置与以下配套指南进行对比： 在 Codex 中使用 GlobalGPT CLI 和 在 Cursor 中使用 GLBGPT CLI.

开始前的先决条件

你需要：

• Node.js 18 或更高版本。当前的 GlobalGPT CLI 包声明如下： 节点 >=18.
• npm，通常随 Node.js 一起安装。.
• Claude 代码，已安装并验证。.
• 一个具有访问权限的 GlobalGPT 账户，可用于访问您计划使用的模型或媒体工具。.
• 一个受信任的项目目录，允许 Claude Code 在其中运行终端命令。.
• 正常情况下，首次设置大约需要 10 到 20 分钟。如果遇到网络或浏览器授权方面的问题，首次设置的时间可能会更长。.

请在 PowerShell、终端或您常用的命令行环境中运行以下检查：

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

本地 Windows 验证使用了 Node.js v24.18.0, npm, npm 11.16.0, ，以及 Claude 代码 2.1.211. 这些版本仅供参考，并非最低要求；Node.js 18 或更高版本是 GlobalGPT CLI 的相关要求。.

步骤 1：安装 GlobalGPT CLI

GlobalGPT CLI 已作为 npm 的稳定版本发布。请使用以下命令安装最新稳定版本：

npm i -g @glbgpt/cli

安装完成后，请验证该命令及其版本：

glbgpt --version
glbgpt --help

该软件包安装了两个可互换的命令名称： 全球生物技术 和 globalgpt. 本指南采用较短的 全球生物技术 表单。.

安装时间和包的数量会因您的 npm 版本、网络状况以及依赖项更新情况而有所不同。安装成功后，系统会自动完成，不会显示任何 npm 错误. npm 提示信息 这些项目正在寻求资金支持 此信息仅供参考，并不表示安装失败。.

第 2 步：使用您的 GlobalGPT 账户登录

GlobalGPT CLI 通过您的 GlobalGPT 账户进行浏览器授权，因此您无需在命令行中创建或粘贴 API 密钥。.

运行：

glbgpt 登录

在浏览器页面处于活动状态时，请保持终端窗口打开。在打开的页面上登录并批准该请求。CLI 在收到本地回调后将继续执行。.

如果浏览器无法自动打开，请使用：

glbgpt login --no-browser

对于无显示器的机器或 SSH 会话，请使用一次性验证码流程：

glbgpt 登录 --code

切勿泄露一次性验证码、授权状态或回调网址。请仅在您自己发起的登录流程中输入验证码。.

授权后验证会话：

glbgpt whoami
glbgpt 账户

glbgpt whoami 确认已登录的账户。. glbgpt 账户 显示会员和积分信息，这在生成媒体之前非常有用。.

步骤 3：在连接 Claude 代码之前测试 GlobalGPT CLI

单独测试 CLI 可以将身份验证或网络问题与 Claude 代码集成问题区分开来。.

启动交互式终端界面：

全球生物技术

发送一条简短的消息，例如 你好. 如果响应成功，则说明 CLI 能够启动、读取您的账户会话、调用聊天模型并显示结果。.

在 GlobalGPT 终端界面中，输入 / 以查看可用命令。常用命令包括 /模型, /models, /图片, /视频, /任务, /status, /account/account, /成本, /help, 和 /exit简体中文（大陆）.

对于非交互式测试，请使用 执行:

glbgpt exec "回复内容必须为：连接成功"

"(《世界人权宣言》) 执行 该命令会输出模型的答案并退出，因此更适合用于脚本和外部代理。.

第 4 步：安装适用于 Claude 代码的 GlobalGPT 代理技能

GlobalGPT CLI 包含一个捆绑的代理技能，名为 globalgpt-generate. 请使用以下命令进行安装：

glbgpt 技能安装

默认情况下，安装程序会在代理技能目录中创建链接，包括 ~/.claude/skills 和 ~/.agents/skills. “关联安装”意味着未来的 CLI 更新也能一并更新捆绑的技能。.

如果您的环境不支持链接，或者您更喜欢独立文件，请使用：

glbgpt skill install --copy

再次执行“复制”选项会覆盖已复制的技能，因此请勿在该复制目录内进行永久性自定义修改。.

安装完成后重启 Claude Code，以便其识别新技能：

cd /项目路径
claude

在 Windows PowerShell 中，directory 命令可能如下所示：

Set-Location "C:\项目路径"
claude

第 5 步：在不消耗积分的情况下，在 Claude 代码中验证 GlobalGPT CLI

首先进行成本估算。这可验证 Claude Code 能否识别该技能、执行 GlobalGPT CLI、查询当前模型目录，并在不生成媒体内容的情况下返回成本估算。.

在 Claude Code 中使用如下提示：

使用 GlobalGPT 估算一张关于 AI 内容自动化的 16:9 编辑主图的成本。
请勿生成图片。请向我展示模型、支持的参数、命令以及预估的积分成本，然后等待审批。.

关键短语是 “不要生成该图像。” GlobalGPT 技能旨在使用 --估计 虽然这个阶段不需要，但明确的指示让你的批准范围变得清晰。.

您还可以通过以下方式显式调用该技能： /globalgpt-generate 如果您的 Claude 代码接口将其列为斜杠命令。当技能已安装且任务明显涉及 GlobalGPT 图片或视频生成时，通常只需使用自然语言请求即可。.

第 6 步：根据 Claude 代码生成图像

一旦您批准了报价，请通知 Claude Code 开始执行。具体请求可以是：

使用 GlobalGPT 生成已获批准的 16:9 编辑主图。
该图片应展示以终端为先的AI内容工作流，采用简洁的深色UI和蓝色点缀，且不得包含任何徽标或可识别的界面文本。
将生成的结果保存至 ./glbgpt-output/ 目录。若首次生成命令被中断或超时，请勿启动第二次生成。.

GlobalGPT CLI 可通过以下命令列出实时映像目录：

glbgpt 模型列表图片

它可以通过以下方式检查模型支持的参数：

glbgpt 模型展示

除非您的工作流有此要求，否则请避免在可重用的 Claude 代码提示中硬编码模型名称。模型目录是动态提供的，可能会发生变化。请让 Claude 列出可用的模型，然后选择一个支持所需宽高比、分辨率、参考图像或其他要求的模型。.

相应的直接命令行界面（CLI）命令包括：

glbgpt image "以终端为先的 AI 内容自动化，简洁的深色界面，蓝色点缀" --ar 16:9 --estimate
glbgpt image "以终端为先的 AI 内容自动化，简洁的深色界面，蓝色点缀" --ar 16:9

已完成的文件保存在 ./glbgpt-output/ 除非你通过 --out.

第 7 步：根据 Claude 代码生成视频

视频请求应明确指定场景，并仅包含您实际需要的参数。各型号对时长、分辨率、宽高比、音频和参考帧的支持情况各不相同。.

先进行估算：

请使用 GlobalGPT 模型，对一段时长 6 秒、16:9 比例的视频进行估算，视频内容为经批准的主视觉图在镜头缓慢推近的过程中逐渐呈现。
请先列出兼容的视频模型。在获得我对模型及费用估算的批准之前，请勿进行生成。.

批准后，Claude Code 可以使用如下格式的命令：

glbgpt 视频 "慢速镜头推入，微妙的屏幕光晕，专业级运动效果" --ar 16:9 --duration 6 --start-image ./glbgpt-output/hero.png

默认情况下，CLI 会等待文件生成完成。视频生成可能需要几分钟时间。请勿构建不必要的轮询循环，且若命令被中断，请勿自动重新提交；因为原始服务器任务可能仍在运行，第二次提交可能会导致信用点被重复扣除。.

使用以下方法检查中断或脱离的任务：

glbgpt 任务列表
glbgpt 显示最新任务
glbgpt 等待最新任务
glbgpt 下载最新任务

第 8 步：使用 glbgpt exec 实现文本批量处理自动化

glbgpt 执行 执行一个非交互式模型请求，并返回纯文本、JSON 或 JSONL 格式的数据。当 Claude Code 需要对多个文件应用相同的操作，或者将一个非常大的源文件排除在 Claude Code 的主对话之外时，此功能非常有用。.

直接命令示例：

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 根据 classification-schema.json 对 content-queue.json 中的条目进行分类。
请先向我展示确切的命令。将最终的 JSON 结果保存到 ./results/classified-content.json 中。
请勿修改源文件。.

请将此模式用于重复性或大量的工作，而非仅需一行代码即可直接解答的问题（例如 Claude 代码）。.

可选：将 GlobalGPT 作为 MCP 服务器连接

当 Claude Code 能够执行 shell 命令时，建议采用“代理技能”路径。GlobalGPT CLI 也可以通过标准输入/输出运行 MCP 服务器：

claude mcp add glbgpt -- glbgpt mcp
claude mcp list

这将GlobalGPT的聊天、图像生成、视频生成、任务检查和模型列表功能作为MCP工具对外开放。.

媒体生成的上限为 默认情况下，每个 MCP 服务器会话为 4,000 个积分. 您可以设置不同的会话上限：

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

若要停用 MCP 的媒体投放功能，同时保留非媒体功能，请使用 --max-credits 0.

若需使用明确的 MCP 工具或会话级别的信用执行，请选择 MCP；若希望通过 Claude 代码以最少的配置驱动标准 CLI，请选择代理技能。.

在 Windows 上排查 GlobalGPT CLI 故障

npm 返回值 ENOTFOUND 或 getaddrinfo

一个 ENOTFOUND 该错误意味着 npm 无法解析注册表的主机名。这并不说明 GlobalGPT 包缺失或损坏。.

检查当前注册表和 DNS 解析：

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

如果 npm 已配置为使用镜像服务器，请同时测试该主机名。当两个主机名均无法解析时，更换注册表并不能解决 DNS 故障。.

在经过验证的 Windows 案例中，活动的 WLAN DNS 服务器无法解析 npm 域名。首次重置失败，原因是 PowerShell 没有管理员权限。在以管理员身份打开 PowerShell 窗口、将 DNS 设置为“自动”并清除缓存后，两者 解析-DNS名称 和 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 登录 --code.

全球生物技术 安装后无法被识别

打开一个新的终端并重试。如果该命令仍然不可用，请检查全局 npm 前缀：

npm prefix -g

请确认 npm 的全局可执行目录位于您的 PATH, 然后重新运行 glbgpt --version.

Claude 代码无法检测到该技能

运行 glbgpt 技能安装 再次确认其报告的技能目录为 Claude，完全退出 Claude 代码，然后开始一个新的会话。您也可以尝试 /globalgpt-generate 以显式方式调用该技能。.

模型或参数被拒绝

模型目录是动态更新的，且不同模型支持的参数各不相同。请刷新目录并检查所选模型：

glbgpt 模型列表图片
glbgpt 模型列表视频
glbgpt 显示

请使用列出的值，或省略该可选标志，以便应用模型默认值。.

一个“生成”命令似乎卡住了

默认情况下，图像和视频命令会等待最终文件的生成。视频生成可能需要几分钟。如果终端操作被中断，请先检查现有任务，再考虑再次提交：

glbgpt 任务列表
glbgpt task show

切勿盲目地重复尝试付费生成。.

如何统计每个 Claude 代码任务所耗费的时间和代币使用量

在每次进行Claude代码任务测量之前：

1. 运行 /使用 并记录显示的会话值。.
2. 记录实际开始时间。.
3. 仅运行正在被测量的任务。.
4. 记录完赛时间并开始跑步 /使用 再次。.
5. 计算已用时间，并在获得确切的令牌计数后，计算前后令牌数量的差值。.

Claude Code 的当前文档指出，该 /使用 该命令为 API 用户提供令牌使用情况。订阅接口可能显示的是套餐使用情况，而非精确的令牌数量，因此请准确记录当前接口所展示的内容，并将不可用的值标记为 不适用; 请勿估算或虚构代币数量。.

对于 GlobalGPT 媒体任务，还应记录生成前后的账户或交易余额。Claude 代码代币和 GlobalGPT 媒体积分属于不同的计量单位，应分别进行报告。.

常见问题

我需要一个 GlobalGPT API 密钥吗？

No. GlobalGPT CLI 使用您的 GlobalGPT 账户进行浏览器授权。运行 glbgpt 登录, ，完成审批流程，并让 CLI 将其本地会话凭据存储起来。请勿将一次性登录码或授权 URL 粘贴到项目文件、屏幕截图或共享的聊天记录中。.

如果没有 Claude 代码，我可以使用 GlobalGPT CLI 吗？

是的。运行 全球生物技术 如需进行互动聊天，, glbgpt 图片 或 glbgpt 视频 面向媒体，以及 glbgpt 执行 适用于非交互式脚本。Claude Code 提供了项目上下文、推理、文件协调和自然语言控制功能，但 CLI 可独立运行。.

我应该使用“代理技能”还是“MCP”？

当 Claude Code 能够执行 shell 命令，且您希望采用最简单的自然语言工作流时，请使用 Agent Skill。如果您更倾向于使用显式的 MCP 工具，或者需要 MCP 服务器提供的会话级媒体信用额度限制，请使用 MCP。这两种界面均使用同一个 GlobalGPT 账户。.

GlobalGPT 将生成的文件保存到哪里？

默认情况下，生成的图片和视频会保存在 glbgpt-output/ 相对于命令或服务器启动所在的目录。传递 --out 当您需要更改位置时。该命令在执行完成后会显示已保存的路径。.

如何避免意外的媒体支出？

使用 --估计 在每次进行新的媒体配置之前，请要求 Claude Code 等待明确批准，并避免无人值守的批处理。对于 MCP，请设置 --max-credits 0 以禁用媒体或设置一个预定的会话上限。切勿自动重试中断的生成操作。.

GlobalGPT CLI 是否稳定？

截至 2026 年 7 月 21 日，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 软件包出现故障的证据。.
• 如果某一代的生成被中断，请在重试之前检查现有任务。.

既然你已经知道了 如何在 Claude 代码中使用 GlobalGPT CLI, ，您可以将 Claude Code 转化为一个实用的控制层，用于管理聊天、图片、视频和结构化内容的工作流。首先进行一项无需花费的评估，对一个小型任务进行端到端的验证，之后再将工作流扩展为批量处理或定时自动化。.