使用 Alchemy CLI 更快完成的 12 件事
作者：Uttam Singh
以前每个链上项目都从同样的流程开始：打开面板，复制一个 API key，把私钥粘贴进 .env，npm install 三个 SDK，最后才能写出你真正想写的那行代码。你的编码 agent 花了半个会话去确定该调用哪个 RPC 方法。Alchemy CLI 把这套搭建成本压缩成可以 pipe、可以脚本化、也可以交给编码 agent 的命令。你的终端是上链最快的路径。
这篇文章会介绍 CLI 用一条命令就能完成的十二件事：登录、拉起一个 agent 钱包、读取任意链、模拟写操作、发送代币、swap、bridge，以及把同一个工具接入 Cursor、Claude Code 或 Codex。文中展示的每条命令今天都可以直接使用。
什么是 Alchemy CLI？
Alchemy CLI 是一个单独的 npm package，即 @alchemy/cli，它把我们提供的每个 API 层（Core RPC、Data API、swap、bridge、simulate、webhook、admin 和 wallet）都封装在一套一致的子命令之下。用 npm i -g @alchemy/cli@latest 安装一次，运行 alchemy auth，同一组参数在每条命令上都适用。把 --json pipe 进 jq，用 --no-interactive 给脚本加上门控——同一套在你终端运行的接口，也能在 AI 编码 agent 内部运行。
核心要点：以前需要通过面板或 SDK 才能完成的工作流程，现在压缩成一条命令行，开发者可以脚本化，agent 也可以直接调用。
一个终端搞定认证与身份
1. 用 alchemy auth 登录一次
alchemy auth 会打开浏览器，把你登录到账户，并把会话存到本地磁盘。不用再在每个项目的每个 .env 里粘贴 API key。用 alchemy auth login --force 切换团队，用 alchemy auth status 查看状态，用 alchemy auth logout 清除。
npm i -g @alchemy/cli@latest
alchemy auth
一条命令取代了每个项目都要重复一遍的“复制 key、粘贴 key、gitignore key、轮换 key”循环。
2. 用 alchemy wallet connect 拉起一个 agent 钱包
CLI 提供了由 Privy 托管的 agent 钱包。Privy 是 embedded-wallet 提供方，钱包的私钥保存在它那一侧。alchemy wallet connect --mode session 会在本地生成一个全新的 P-256 密钥对，向 Privy 后端注册一个有时效的会话，然后分两步签名：CLI 对 session-key 载荷签名，Privy 对钱包签名。私钥不会离开 Privy，session key 也不会离开你的设备。
alchemy wallet connect --mode session从面板撤销，或者用 alchemy wallet disconnect 撤销，会话会立即失效。如果想用本地密钥的工作流程：alchemy wallet connect --mode local --chain evm --import ~/.wallet/key。无论哪种方式，私钥都不会出现在 .env 里。
3. 用 --x402 按需付费
在任何命令上设置 --x402，CLI 就会用已连接的钱包对我们的 API 进行认证，而不是用 API key。当请求命中一个付费端点时，端点返回 HTTP 402，CLI 对 x402 payment payload 签名，请求随即完成。x402 是 Coinbase 提出的一套面向 HTTP 原生支付的开放规范；结算以 USDC 在 Base 上进行。agent 只需最低 $1 的计算额度就能起步，不需要注册面板账号。
# Pay per call with the wallet you connected in step 2
alchemy evm rpc eth_blockNumber -n base-mainnet --x402
# Or make it the default so you can drop the flag:
alchemy config set x402 true现在，一个 agent（或者从未注册过的开发者）也能调用你生产环境所使用的同一批 API。不需要 API key，不需要面板，不需要合同。
无需编写 fetch 样板代码即可读取任意链
4. 对任意链调用任意 JSON-RPC 方法
alchemy evm rpc 会把任意 JSON-RPC 方法透传到你用 -n 选定的网络。无需手写 fetch 请求体，也无需为一个五行的脚本经历一遍 SDK 安装流程。
alchemy evm rpc eth_blockNumber -n base-mainnet --json
alchemy evm rpc eth_getLogs '[{"fromBlock":"0x123","topics":["0x..."]}]' \
-n arb-mainnet --json对于 Solana，JSON-RPC 用 alchemy solana rpc，Digital Asset Standard 方法用 alchemy solana das。在我们支持的每条链上，形式都保持一致。
5. 一次调用拉取多链资产组合
alchemy evm data portfolio tokens 会返回一个钱包在所有接触过的链上的代币余额。无需把七个 RPC 提供方拼接起来，也无需逐链用 eth_call 去查每一个 ERC-20 合约。
alchemy evm data portfolio tokens --json --body '{
"addresses":[{
"address":"vitalik.eth",
"networks":["eth-mainnet","base-mainnet","arb-mainnet"]
}]
}'搭配 portfolio nfts 可以在 NFT 收藏品上实现同样的效果。生产环境中驱动我们 Data API 索引器的正是这些相同的端点。
6. 用一行命令查询余额、转账和 NFT
余额、代币元数据、转账历史和 NFT 在 Data API 层各自以一个单独的子命令提供。加上 --metadata，返回的调用结果里会直接包含 name、symbol、decimals 和 logo URL。
alchemy evm data tokens balances 0xabc... --metadata -n base-mainnet --json
alchemy evm data history 0xabc... -n eth-mainnet --json
alchemy evm data nfts 0xabc... --limit 20 -n eth-mainnet --json以前需要横跨四个不同 SDK client 的读取操作，现在都变成了一个 CLI 上的四个 flag。
从你的 shell 里发送交易
7. 发送前先模拟
alchemy evm simulate asset-changes 会返回一份人类可读的 diff，展示一笔交易会引发的每一笔代币和 ETH 的变动。simulate execution 返回完整的 trace。使用者在交易真正上链之前就能确切看到这次调用会做什么。
alchemy evm simulate asset-changes --json --tx '{
"from":"vitalik.eth",
"to":"0x...",
"data":"0x..."
}'在任何涉及主网资金的 evm send 或 contract call 之前，先运行这个。它能省去“我刚把热钱包搞坏了”之后的重来一遍。
8. 一行命令发送到 ENS 名称
alchemy evm send vitalik.eth 0.01 -n base-mainnet
alchemy evm send 0xabc... 100 --token 0xUsdcAddress -n base-mainnetalchemy evm send 会解析 ENS、处理 gas，并用当前活跃的钱包（session、本地或由 Privy 托管）进行签名。配合 --x402，同样的调用会走你在第 2 步连接的那个钱包。
9. 在同一个 shell 里完成 approve、swap 和 bridge
alchemy evm swap execute 能把一次同链 swap 从报价一路带到执行。alchemy xchain bridge execute 做的是跨链版本。alchemy evm approve 负责处理每次 DEX swap 之前都需要的 ERC-20 授权。
alchemy evm approve 0xPool --token-address 0xUsdc --amount 100 -n base-mainnet
alchemy evm swap execute --from 0xUsdc --to 0xEth --amount 100 -n base-mainnet
alchemy xchain bridge execute --from 0xUsdcBase --to 0xUsdcArb \
--amount 0.2 --to-network arb-mainnet -n base-mainnet根据 Alchemy CLI 文档，同链 swap 已经在 11 条 EVM 主网上上线，包括 Ethereum、Base、Arbitrum、Optimism、Polygon 和 BSC。跨链 bridge 今天也已经在 CLI 中提供。面板向导被压缩成了三行 shell 命令。
把 CLI 接入你的编码 agent
10. 用 alchemy agent-prompt 导出完整的 agent manifest
alchemy agent-prompt 会输出一份 JSON 文档，描述每条命令、每个 flag、每个错误码和示例。把它 pipe 进你 agent 的系统提示词，agent 就不用再猜 flag 名字了。
alchemy agent-prompt > .alchemy-prompt.json这份 manifest 包含一套执行策略、preflight 检查、认证矩阵、带选项的命令树、带重试语义的错误目录，以及可运行的示例。对于 Cursor、Claude Code、Codex 或其他任何编码 agent，这个文件可以直接放进系统提示词。实际应用模式参见：How to build onchain agents。
11. 安装 Alchemy Skills
alchemy install skills 会把 Alchemy Skills 合集安装到你的 agent client 里。Skills 是机器可读的工作流程，能让编码 agent 学会如何使用 CLI，而不用在运行时去读文档。
alchemy install skills这个合集覆盖四个层面：CLI 本身、通过 API key 的应用集成、MCP，以及基于钱包的支付流程。一条命令就把“agent 每次会话都得扫一遍文档”换成了“agent 已经知道这套工作流程”。
12. 接入 MCP
alchemy install mcp 会把 Alchemy MCP server 接入你的 agent client。MCP（Model Context Protocol）是一套开放规范，让 agent 能在运行时发现并调用工具。托管的 server 地址是 https://mcp.alchemy.com/mcp，暴露了超过 150 个工具，覆盖 100 多条链：admin、每一个 RPC 方法，以及 Data API 层。
alchemy install mcp对于 Claude Code，具体操作是：
claude mcp add alchemy --transport http https://mcp.alchemy.com/mcpSkills、agent-prompt manifest 和 MCP 三者结合，让 CLI 成为 agent 工具清单里的一等能力，而不是一个附带的依赖项。
五次调用的 agent 演示：收益比较、bridge、供给
Alchemy Skills 仓库里附带的这个典型演示会读取 Polygon、Arbitrum 和 Optimism 上 USDC 的供给 APY，把 0.2 USDC 从 Base bridge 到收益最高的链上，然后供给到 Aave V3。五次 CLI 调用，用的是支撑本文其余内容的同一套接口。
在上面这个演示中，agent 找到了 USDC 最佳的 Aave 市场，把资金 bridge 到正确的链上，然后存入资金池。在此之前，这套流程要么需要持有私钥的自定义 agent 代码，要么需要手工搭建 wallet SDK 与编码助手之间的集成。现在，只需几条命令和面板上的一次点击。
开始你的第一条命令
你刚才看到了十二条命令。这里是两分钟的上手方式：安装、登录、连接钱包、发送。
npm i -g @alchemy/cli@latest
alchemy auth
alchemy wallet connect --mode session
alchemy evm send vitalik.eth 0.001 -n base-mainnet不需要一堆 SDK，不需要把私钥放进 .env，也不需要往返面板。无论你的链上工作流程是什么样子，CLI 都能从一个 prompt 把它跑起来。你的终端是上链最快的路径。
Alchemy 新闻通讯
第一时间获取发布信息
订阅我们的新闻通讯
获取 Alchemy 的最新产品更新和资源
填写您的电子邮箱地址即表示您同意接收我们的营销通讯和产品更新。您确认 Alchemy 按照我们的隐私声明处理我们收到的信息。您可以随时取消订阅。
