agent-payment-x402 Skill：让 Claude Code 学会自主链上支付

Skill超级捕获手 技术创作者 2026-07-28 20 阅读

让 AI Agent 自己付钱：agent-payment-x402 让 Claude 学会刷卡

x402 是 HTTP 402 “Payment Required” 协议的行业级扩展，正在成为 AI Agent 经济系统的基石。agent-payment-x402 是 ECC（The Agent Harness Performance Optimization System） skill 家族中最年轻、最硬核的成员之一——它给 Claude Code 等 AI 编程 Agent 装上了钱包：让 Agent 能在链上完成 API 付费、调用付费工具、向其他 Agent 结算，且全程由智能合约和非托管钱包保驾护航，没有任何中心化资金托管风险。这个 skill 的出现，意味着 AI Agent 从「免费执行」正式走向「有偿服务」——一个真正自主的 AI 经济闭环正在成型。

核心能力与设计原则

agent-payment-x402 的核心是把 x402 支付协议落地为 MCP 工具，让 Agent 在执行任务时能主动发起链上支付，而非等待人类授权。设计上遵循三条原则：

  • 非托管：Agent 持有自己的 ERC-4337 智能合约钱包私钥，资金完全由合约控制，无平台托管风险
  • 策略前置：消费策略（per-task 预算、per-session 上限、接收方白名单）由编排层在派发任务前设置，Agent 自身无法修改策略
  • 失败封闭：支付服务不可达时，付费操作直接阻断——不降级为无限免费使用

认可度

  • GitHub Star：ECC 母库截至 2026-07-28 约 234,437 star，fork 35,733，是目前最大规模的 AI Coding Agent 工具集之一
  • agent-payment-x402 作为独立 skill 位于 ECC/skills/agent-payment-x402，从属于这个 star 量级的超级项目
  • ECC 曾在 GitHub Trending 多个编程语言榜占据头部，x402 支付 skill 近期跟随 ECC 整体热度进入社区视野

链接

GitHub：https://github.com/affaan-m/ECC/tree/main/skills/agent-payment-x402

原作者

  • 作者：@affaan-m（全网最高产的 AI Agent 工具开发者之一）
  • 项目定位：「The Agent Harness Performance Optimization System」——为 Claude Code、Codex、Cursor 等主流 Coding Agent 提供性能优化、安全护栏、记忆管理、支付执行等全链路 skill 包

介绍

AI Coding Agent 发展到今天，一个核心瓶颈逐渐暴露：当 Agent 需要调用付费 API——比如使用 OpenAI 的 GPT-4o、访问版权代码库、或者调用第三方机器学习服务——现有方案要么让人类手动刷卡授权，要么把密钥直接交给 Agent 产生巨大安全风险。x402 协议提供了一条中间路线：服务器返回 HTTP 402，Agent 的支付工具自动谈判价格、验证预算、签署交易、重试请求——全程在预设策略内自动完成，无需人工介入。

agent-payment-x402 将这套机制封装成可直接加载的 Claude Code Skill。加载后，Agent 获得 get_balance、send_payment、check_spending、list_transactions 四个标准 MCP 工具，可以查询余额、向指定地址转账、核查剩余预算、审计历史流水。编排层（Orchestrator）通过 set_policy 接口设定每任务预算上限（如单次不超过 $0.50）、总会话预算（如不超过 $5.00）、接收方白名单和每分钟交易频率限制。Agent 在这些硬边界内自主决策，不存在超支可能。

该 skill 支持两条支付路径：agentwallet-sdk（Base 链，Sepolia 测试网开发、Mainnet 生产）和 OKX Agent Payments Protocol（X Layer，适合 USDT0 结算场景）。此外还覆盖 TypeScript、Go、Rust、Java 四种语言的服务商侧（Seller Side）SDK 集成指南——意味着你不仅可以「让 Agent 付钱」，也可以「让 Agent 收钱」，打造完整的付费 API 服务。

特点

  • x402 协议原生集成：遵循 x402.org 标准规范，HTTP 402 响应触发标准支付协商流程
  • per-task / per-session 双层预算：任务级和会话级双重预算墙，防止单次操作或累积消耗超限
  • ERC-4337 非托管智能钱包：私钥在 Agent 端，合约控制资金，平台无法冻结或挪用
  • 接收方白名单 + 频率限制：编排层可精确指定 Agent 只能向哪些地址付款，以及每分钟最多几笔
  • 全链路审计日志：每次支付自动记录，事后可查 list_transactions 追溯每分钱去向
  • MCP 标准工具接口：与任何支持 MCP 的 Agent 客户端（Claude Code、Codex、Cursor 等）开箱即用
  • 多链支持：agentwallet-sdk（Base）+ OKX Payments Protocol（X Layer），覆盖主流 Layer-2 与交易所生态

使用方法

安装

在 Claude Code 的 MCP 配置中注册 agentwallet-sdk（以 Base 链为例）：

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentwallet-sdk@6.0.0"]
    }
  }
}

⚠️ 安全注意：必须锁定版本号（如 @6.0.0），不锁定版本的 npx 安装存在供应链风险

编排层设置策略

在任何付费操作前，由编排层（Orchestrator）设置消费策略：

const policyResult = await agentpay.callTool({
  name: "set_policy",
  arguments: {
    per_task_budget: 0.50,       // 单任务上限 $0.50
    per_session_budget: 5.00,    // 总会话上限 $5.00
    allowlisted_recipients: ["api.example.com"]
  }
});

预算核查（前置钩子）

在调用任何付费工具前，建议运行预算检查：

async function preToolCheck(agentpay: Client, apiCost: number) {
  const result = await agentpay.callTool({ name: "check_spending" });
  const parsed = JSON.parse(result.content[0].text);
  if (parsed.remaining < apiCost) {
    throw new Error(`Budget exceeded: need $${apiCost} but only $${parsed.remaining} left`);
  }
}

最小示例：查询余额

Ask Claude: "Check my agent wallet balance"
→ Agent calls get_balance MCP tool
→ Returns: { "balance": "1.234 ETH", "remaining": "5.00 USD" }

使用场景与人群

适用场景：

  • AI Agent 调用付费 API（GPT-4o、版权代码库、科学数据接口）
  • 多 Agent 系统内部结算（任务执行 Agent 向调度 Agent 支付调度费）
  • 开发者为 AI Coding Agent 开通按需付费的 API 访问权限，无需共享密钥
  • AI 服务商构建「机器可读」的商业化接口，Agent 直接消费无需人工干预

目标用户：

  • AI Agent 开发者 / 框架构建者
  • 区块链支付开发者（x402 协议、ERC-4337）
  • 构建 AI 经济系统的产品/工程团队
  • 研究 Agent 自主性（Agentic AI）安全边界的研究者

输入与输出案例

场景一：单次 API 付费调用

输入（Agent Prompt）：

“Use the paid search API to find the latest research on RLHF. Budget is $0.10.”

Agent 内部流程：
1. preToolCheck → check_spending 返回 remaining: 5.00 USD ✓
2. 调用付费搜索 API，服务器返回 HTTP 402
3. send_payment → 签署并发送 0.10 USD 等值 ETH 到对方地址
4. API 服务器确认收款，重试请求，返回搜索结果

输出：
搜索结果 + 交易哈希 { txHash: "0x..." } 写入审计日志

场景二：超预算阻断

输入（Agent Prompt）：

“Call the premium code search API (costs $2.00) to find similar implementations.”

Agent 内部流程：
1. preToolCheck → check_spending 返回 remaining: 0.50 USD
2. remaining (0.50) < apiCost (2.00) → 抛出异常，阻断操作

输出：

Error: Budget exceeded: need $2.00 but only $0.50 remaining

完全不产生超支，任务直接终止并报告原因。

GitHub: https://github.com/affaan-m/ECC/tree/main/skills/agent-payment-x402

评论区

0 条评论

登录后可评论。

Skill超级捕获手 20 阅读