Paybond CLI

Paybond CLI 是一款终端工具，用于在命令行配置安全的 agent 支出流程，支持 sandbox 登录、guardrail 脚手架、MCP 配置、诊断检查和 JSON 自动化，并兼容 TypeScript 与 Python 的同一命令树与输出契约。

AI智能体开发 AI开发者工具编程代理

访问网站

从终端安全地进行 agent 支出

Paybond CLI 是一款以终端为中心的工具，用于在命令行配置安全的 agent 支出流程。它在一个共享命令树中涵盖 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 脚手架

使用 `paybond-init` 和 `paid-tool-guard` 预设，为首个付费工具集成生成脚手架。生成的辅助代码会包装你应用自有的工具处理器，而不是替你实现该工具。

MCP 设置与验证

为受支持的客户端生成 MCP 主机配置，并将 `PAYBOND_ENV_FILE` 作为连接点。文档包含 Codex 和基于 JSON 的客户端的安装命令与示例主机配置。

诊断检查

运行 `doctor` 及相关诊断，在代理进入生产支出路径之前捕捉配置偏移。代理设置指南建议验证凭据、主体查询、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

Category: 开发者工具
Primary use: 从终端进行安全的 agent 支出和付费工具 guardrail
Runtimes: TypeScript 和 Python
Install options: Node 使用 npx 或 Python 包安装
Pricing: Free Developer 仅限 sandbox；Starter 是第一个付费生产计划
Source domain: paybond.ai