Paybond CLI

Paybond CLI 是一款終端機工具，可在命令列安全建立代理支出流程，涵蓋 sandbox 登入、guardrail 骨架、MCP 設定、診斷與 JSON 自動化，支援 TypeScript 與 Python 並保持相同命令樹與輸出合約。

AI代理開發 AI開發者工具程式設計代理

訪問網站

從終端機安全管理代理支出

Paybond CLI 是一款以終端機為優先的工具，可從命令列建立安全的代理支出流程。它將 sandbox 登入、guardrail 骨架、MCP 設定、診斷與機器可讀自動化整合在同一個共用命令樹中。

TypeScript 與 Python 套件的設計目標是保持一致，因此不論執行環境為何，代理與操作人員都能使用相同的命令、JSON 封裝與退出碼合約。文件將此 CLI 定位為預設入口，用於在工作流程呼叫付費 API、供應商動作或結算步驟之前加入付費工具 guardrail。

設定流程從 sandbox 開始，使用租戶範圍憑證，並讓第一次整合先聚焦於 guardrail，而非正式結算通道。之後，CLI 可產生主機設定、透過 doctor 檢查驗證路徑，並以 JSON 輸出支援腳本化使用。

核心功能

Sandbox 登入

在執行 guardrail 或 MCP 指令之前，先用租戶範圍的 sandbox 憑證完成一次驗證。登入流程會將 sandbox `PAYBOND_API_KEY` 寫入 `.env.local`，並在輸出中遮蔽金鑰識別資訊。

一鍵 guardrail 骨架

使用 `paid-tool-guard` 預設值搭配 `paybond-init`，為第一個付費工具整合建立骨架。產生的 helper 會包裝你應用程式自有的工具處理器，而不是替你實作該工具。

MCP 設定與驗證

為支援的用戶端產生 MCP 主機設定，並以 `PAYBOND_ENV_FILE` 作為連線點。文件包含 Codex 與基於 JSON 的用戶端之安裝指令與主機設定範例。

診斷檢查

執行 `doctor` 與相關診斷，在代理到達正式支出路徑前先找出設定偏移。代理設定指南建議驗證憑證、principal 查詢、MCP 啟動與工具清單。

JSON 自動化

為腳本與 CI 使用機器可讀的 JSON 封裝，並在 TypeScript 與 Python 套件之間維持穩定輸出與同步的退出碼。這讓 CLI 同時適合自動化與互動式終端機使用。

常見工作流程

為儲存庫加入付費工具 guardrail
編碼代理需要在呼叫付費工具之前加入支出控制。CLI 會引導儲存庫完成 sandbox 登入、guardrail 骨架與驗證，之後才會嘗試任何正式工作流程。
跨執行環境標準化代理設定
操作人員希望有一條可在 TypeScript 與 Python 之間通用的設定路徑。共用命令樹與 JSON 合約讓兩種執行環境都能標準化設定與自動化。
為編碼代理準備 MCP 存取
團隊需要為 MCP 用戶端完成接線，並在代理執行前驗證設定。CLI 可以產生主機設定、指向 `PAYBOND_ENV_FILE`，並協助驗證端到端路徑。
在 CI 中自動化設定與檢查
建置或自動化工作需要機器可讀輸出。CLI 的 JSON 封裝與一致的退出碼讓它可在腳本與 CI 流水線中使用，而不必擷取面向人類的文字。

Pros and Cons

Pros

將登入、guardrail 骨架、MCP 安裝、診斷與自動化整合在同一個 CLI 中。
讓 TypeScript 與 Python 共享相同的命令樹與 JSON 合約。
採用以 sandbox 為先的設定，避免在初始整合時進行真實資金流動。
提供可供腳本、CI 與代理自動化使用的機器可讀 JSON 輸出。
包含如 `doctor --agent` 與 MCP 安裝驗證等文件化驗證步驟。

Cons

第一個整合流程僅限 sandbox；正式結算通道不屬於初始骨架的一部分。
產品頁本身沒有顯示完整命令參考，因此部分細節需查看文件。
MCP 伺服器啟動仍依賴主機設定或 `npx`，而不是在登入步驟中完全內嵌。

FAQ

我需要同時使用 TypeScript 和 Python 嗎？

不需要。文件說明指出，你可以選擇 TypeScript 或 Python，兩者都提供相同的 `paybond` 命令樹與 JSON 合約。

我可以在哪裡找到完整的命令參考？

CLI 合約文件是旗標、子命令、JSON 封裝，以及兩種執行環境之間一致性保證的來源。

CLI 與 MCP 伺服器有什麼關係？

CLI 會安裝並驗證 MCP 主機設定。MCP 伺服器本身會在登入後，透過 `npx` 或主機的 stdio 設定另外啟動。

編碼代理的典型設定流程是什麼？

針對編碼代理的一般設定流程是：使用 `paybond login` 或登入套件入口將 sandbox `PAYBOND_API_KEY` 寫入 `.env.local`，接著執行 `paybond mcp install` 產生主機設定，最後用 `paybond doctor --agent` 驗證設定。

Paybond CLI 是否綁定付費方案？

文件將 Free Developer 定位為僅限 sandbox，而 Starter 是第一個付費生產方案。Team、Business 與 Enterprise 則提供更高上限、超額選項與更廣泛的控制。

Quick Facts

類別: Developer Tool
主要用途: 從終端機安全管理代理支出與付費工具 guardrail
執行環境: TypeScript 與 Python
安裝選項: Node 使用 `npx` 或安裝 Python 套件
價格: Free Developer 僅限 sandbox；Starter 是第一個付費生產方案
來源網域: paybond.ai