# Paybond CLI Paybond CLI 用于搭建安全的代理支出流程，支持沙盒登录、护栏配置、MCP 设置、诊断和 JSON 自动化，兼容 TypeScript 与 Python。 - Findings24: - 网站: - 价格: Freemium - 分类: AI编程助手, AI开发者工具 ## 什么是 Paybond CLI？ Paybond CLI 是一款以终端为中心的工具，用于在命令行配置安全的 agent 支出流程。它在一个共享命令树中涵盖 sandbox 登录、guardrail 脚手架、MCP 配置、诊断检查和机器可读自动化。 TypeScript 和 Python 包的设计目标是保持一致，因此无论运行时如何，代理和运维人员都可以使用相同的命令、JSON 封装和退出码契约。文档将该 CLI 定位为在工作流调用付费 API、供应商操作或结算步骤之前，添加付费工具 guardrail 的默认入口。 设置流程从 sandbox 开始，使用租户范围的凭据，并将首次集成重点放在 guardrail 上，而不是实际结算通道上。之后，CLI 可以生成主机配置、通过 doctor 检查验证路径，并通过 JSON 输出支持脚本化使用。 ## Paybond CLI 能做什么？ ### 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 流水线中使用，而无需抓取面向人工的文本。 ## 常见问题 ### 我需要同时使用 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 提供更高额度、超额选项和更广泛的控制。 ## 快速信息 - **Category**: 开发者工具 - **Primary use**: 从终端进行安全的 agent 支出和付费工具 guardrail - **Runtimes**: TypeScript 和 Python - **Install options**: Node 使用 npx 或 Python 包安装 - **Pricing**: Free Developer 仅限 sandbox；Starter 是第一个付费生产计划 - **Source domain**: paybond.ai