如何在 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 套件同時提供了 glbgpt 和 globalgpt 指令，並包含一個 執行 用於腳本和外部代理程式的介面。.

Claude Code 提供推理與專案背景。GlobalGPT CLI 提供模型與媒體操作。捆綁的 globalgpt-generate 「代理技能」課程將教授 Claude 代碼，說明何時以及如何呼叫 CLI，內容包含如何估算媒體成本、從即時模型目錄中選取項目、附加參考圖片、等待任務，以及避免意外產生重複收費。.

連接 GlobalGPT 與 Claude 代碼的三種方式

對於大多數 Claude Code 使用者而言，, 「Agent Skill + CLI」是最佳的起點. 此設定不僅體積小巧，還能利用 Claude Code 現有的殼層功能，並讓您以自然語言進行操作，同時仍能保留明確的成本檢查機制。若您的團隊使用多個編碼代理程式，您亦可將此設定與以下相關指南進行比較： 在 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 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

此套件會安裝兩個可互換的指令名稱： glbgpt 和 globalgpt. 本指南採用較簡短的 glbgpt 表單。.

安裝時間與套件數量會因您的 npm 版本、網路狀況及依賴項更新而有所不同。安裝成功後，系統會自動完成，不會顯示任何 npm 錯誤. npm 的訊息 這些專案正在尋求資金 此訊息僅供參考，並不表示安裝失敗。.

步驟 2：使用您的 GlobalGPT 帳號登入

GlobalGPT CLI 會透過您的 GlobalGPT 帳戶進行瀏覽器授權，因此您無需在命令列中建立或貼上 API 金鑰。.

執行：

glbgpt 登入

在瀏覽器頁面處於活躍狀態時，請保持終端機開啟。請在開啟的頁面中登入並核准該請求。CLI 將在收到本地回調後繼續執行。.

如果瀏覽器無法自動開啟，請使用：

glbgpt 登入 --no-browser

若為無顯示器的機器或 SSH 連線，請使用一次性驗證碼流程：

glbgpt 登入 --code

切勿分享一次性驗證碼、授權狀態或回呼網址。請僅在您自行啟動的登入流程中輸入驗證碼。.

授權後驗證會話：

glbgpt whoami
glbgpt 帳戶

glbgpt whoami 確認已登入的帳戶。. glbgpt 帳戶 顯示會員資格與信用資訊，這在生成媒體之前相當有用。.

步驟 3：在連接 Claude 程式碼之前，先測試 GlobalGPT 命令列介面

單獨測試 CLI，可將身份驗證或網路問題與 Claude 程式碼整合問題區分開來。.

啟動互動式終端介面：

glbgpt

傳送一則簡短訊息，例如 嗨. 若回應成功，即表示 CLI 能夠啟動、讀取您的帳戶會話、存取聊天模型，並顯示結果。.

在 GlobalGPT 終端介面中，輸入 / 以查看可用的指令。常見的指令包括 /模型, /models, /圖片, /影片, /任務, /狀態, /帳戶, /成本, /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 Code 介面將其列為斜線指令，則通常在安裝該技能後，且任務明顯涉及 GlobalGPT 圖片或影片生成時，使用自然語言請求便已足夠。.

步驟 6：根據 Claude 程式碼生成影像

一旦您核准了報價單，請指示 Claude Code 著手進行。具體的請求可以是：

請使用 GlobalGPT 生成經核准的 16:9 編輯主圖。
該圖片應呈現以終端機為先的 AI 內容工作流程，具備簡潔的深色使用者介面、藍色點綴，且不得出現任何標誌或可辨識的介面文字。
將結果儲存至 ./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 Code 直接回答的問題。.

可選：將 GlobalGPT 設定為 MCP 伺服器

當 Claude Code 能夠執行 shell 指令時，建議採用「Agent Skill」路徑。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 並將設定工作量降至最低，請選擇 Agent Skill。.

在 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 重設為自動模式並清除快取後，兩者皆 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 登入 --code.

glbgpt 安裝後無法被識別

請開啟一個新的終端機並重新嘗試。如果該指令仍然無法使用，請檢查 npm 的全域前綴：

npm prefix -g

請確認 npm 的全域可執行檔目錄是否位於您的 PATH, 然後重新執行 glbgpt --version.

Claude 程式碼無法偵測該技能

奔跑 glbgpt 技能安裝 再次確認系統是否顯示 Claude 技能目錄，完全退出 Claude 程式碼，並開始新的工作階段。您也可以嘗試 /globalgpt-generate 以明示方式呼叫該技能。.

模型或參數被拒絕

型號目錄是動態更新的，且各型號支援的參數各不相同。請重新載入目錄並檢查所選型號：

glbgpt 模型清單圖片
glbgpt 模型清單影片
glbgpt 顯示

請使用清單中的值，或省略此可選標誌，以便套用模型預設值。.

一個「Generation Command」似乎卡住了

圖片和影片指令預設會等待最終檔案產生。影片生成可能需要數分鐘。若終端機操作中斷，請先檢查現有任務，再考慮重新提交：

glbgpt 任務清單
glbgpt task show

切勿盲目地重新嘗試付費生成。.

如何測量每個 Claude 程式碼任務所需的時間與代幣使用量

在每次進行 Claude Code 任務的測量之前：

1. 奔跑 /用法 並記錄顯示的會話值。.
2. 記錄實際開始時間。.
3. 僅執行正在進行量測的任務。.
4. 記錄完賽時間並開始跑步 /用法 又來了。.
5. 計算已耗費的時間，並在取得確切的代幣數量時，計算代幣數量的增減幅度。.

Claude Code 的現行文件指出，該 /用法 此指令提供 API 使用者代幣的使用狀況。訂閱介面可能會顯示方案使用量，而非精確的代幣數量，因此請精確記錄當前介面所揭露的內容，並將不可用的值標記為 不適用; 請勿估算或杜撰代幣數量。.

針對 GlobalGPT 媒體任務，亦應記錄生成前後的帳戶或交易餘額。Claude 代碼代幣與 GlobalGPT 媒體積分屬於不同單位，應分別進行申報。.

常見問題

我需要 GlobalGPT API 金鑰嗎？

No. GlobalGPT CLI 會透過您的 GlobalGPT 帳戶進行瀏覽器授權。執行 glbgpt 登入, 完成核准流程，並讓 CLI 儲存其本機工作階段憑證。請勿將一次性登入碼或授權網址貼入專案檔案、螢幕截圖或共享的聊天記錄中。.

如果沒有 Claude 代碼，我還能使用 GlobalGPT CLI 嗎？

是的。執行 glbgpt 若要進行互動式聊天，, 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 轉化為適用於聊天、圖片、影片及結構化內容工作流程的實用控制層。首先進行無成本估算，對一個小型任務進行端到端的驗證，之後再將工作流程擴展為批次處理或排程自動化。.