> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyway.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents 快速开始

> 创建智能体钱包、添加资金并调用一个付费 API。

## 1. 安装 CLI

```bash theme={null}
npm install -g @anyway-sh/cli
```

## 2. 创建第一个智能体钱包

```bash theme={null}
anyway login --agent-wallet
```

该命令会打开一个浏览器流程，并依次：

1. 完成登录；
2. 按需创建所有者钱包；
3. 创建智能体钱包；
4. 把智能体钱包密钥安全地传回 CLI。

<Warning>
  密钥只展示一次。请安全保存浏览器下载的备份，不要提交到代码仓库、粘贴到聊天中或写入日志。
</Warning>

在非交互环境中，可以先启动设备授权，再由所有者批准后继续：

```bash theme={null}
anyway login --agent-wallet --non-interactive
anyway login --continue
anyway wallets agents create --continue
```

请按顺序执行两条继续命令：第一条完成登录，第二条保存智能体钱包密钥。状态为 `pending` 时，请重复对应命令。

## 3. 为钱包添加资金

打开[智能体钱包](https://app.anyway.sh/wallets?view=agent)，然后：

1. 为缓冲余额添加资金；
2. 选择**分配资金**；
3. 选择智能体钱包和金额。

额度与 USDC 不同：

* 额度由组织共享，符合条件的超级 API 调用会优先使用。
* USDC 会被分配到指定智能体钱包。

## 4. 确认智能体身份

```bash theme={null}
export ANYWAY_AGENT_WALLET_KEY="<your key>"
anyway wallets agents whoami
anyway wallets agents policies
anyway wallets agents credit-balance
```

`whoami` 显示智能体和钱包身份；`credit-balance` 显示组织级美元额度，不是智能体钱包的 USDC 余额。

## 5. 发现并调用付费 API

```bash theme={null}
curl https://marketplace-prod.anyway.sh/v1/api/directory
curl https://marketplace-prod.anyway.sh/v1/api/info/{upstream_id}
```

把目录条目的 `id` 作为 `upstream_id`，再从服务信息响应的 `curl_x402` 字段复制可调用的 x402 URL：

```bash theme={null}
anyway superapi call "<x402 endpoint URL>"
```

CLI 会发起初次请求、读取 402 报价、请求确认、签名付款、重试调用，并输出 API 响应。

<Warning>
  只有在明确允许自动批准付款的智能体运行环境中才使用 `--yes`。钱包余额和支出策略仍然是最后的保护措施。
</Warning>