60 秒内为 Claude Code 配置 Alchemy

Claude Code擅长编写与区块链交互的代码。问题出在这之后。它会猜测该调用哪个RPC方法，凭空构造响应的结构,也没有办法查询余额、价格,或者一笔交易到底做了什么。于是它针对自己看不到的数据,写出了看似合理的代码。

一条命令就能解决这个问题。将Claude Code连接到Alchemy后,它就不再靠猜测了。它可以读取100多条链上的实时数据,在任何操作执行前先模拟交易,如果你允许,还可以签名并发送交易。一条命令就能把Claude Code变成一个链上智能体,而且设置只需要大约一分钟。

将Claude Code连接到Alchemy之后能做什么？

这个连接通过MCP（Model Context Protocol）运行,这是一个开放标准,允许智能体在运行时发现并调用外部工具。我们的Alchemy MCP server是托管的,不需要在本地运行任何东西。只需将Claude Code指向它一次,它就能获得跨100多个网络的168个工具,分为三类：admin（管理你的应用）、RPC（每条链上的每个JSON-RPC方法）,以及data（价格、代币和NFT余额、转账历史、多链资产组合、交易模拟）。

这个差异在你第一次提出真实问题时就会显现出来。如果没有数据连接,“ETH目前的价格是多少？”得到的答案来自训练数据中的一个数字,而这个数字在模型发布那天就已经过时了。连接了server之后,Claude Code会调用一个工具,从实时端点读取价格。钱包余额、NFT持有者,或者一笔待处理交易会造成的资产变化,情况都是一样的。你的智能体从“编写关于链的代码”变成了“直接读取链上数据”。

60秒完成设置

最快的方式是使用托管server。在终端运行一条命令：

重启Claude Code（或打开一个新对话）,运行/mcp,确认alchemy出现在活动server列表中。Claude Code第一次调用Alchemy工具时,会打开一个浏览器窗口,让你用账号登录。认证使用OAuth,因此不需要粘贴API key,不需要本地安装,也不需要在.env文件里写任何东西。

之后,让你的智能体指向你的某个应用（“选择一个Alchemy应用”）,就可以开始提问了。设置到此为止：一条命令,一次浏览器登录,你的编码智能体就能读取实时链上数据。

连接之后可以问什么？

这个连接的意义在于,你用日常语言提问,Claude Code会自行选择合适的工具。下面这些提示词,在server接入的那一刻就能用：

• “ETH和USDC现在的价格是多少？”会从Data API的Prices接口读取现货价格。
• “列出vitalik.eth在Ethereum、Base和Arbitrum上持有的代币。”一次调用就能拉取多链资产组合,而不需要手动逐条链查询。
• “交易0xabc...实际做了什么？”会运行一次模拟,返回每一笔代币和ETH转移的人类可读diff,让智能体根据实际影响推理,而不是根据原始calldata。
• “这个地址在最近100个区块里和哪些合约有过交互？”直接读取转账历史和事件日志。

每个答案返回的都是智能体可以直接使用的结构化数据,而不是需要它自己解析的文字。这正是一个连接了数据源的智能体真正有用的地方。它先读取自己的事实依据,再基于当下真实的数据去编写代码或给出建议。

如何用CLI和Skills走得更远？

托管server是最快的接入方式。如果你希望把它打包使用,Alchemy plugin for Claude Code把同一个MCP server和/alchemy:balance这样的斜杠命令,以及Agent Skills打包在一次安装里。而Alchemy CLI是更进一步的选择,因为它加入了前两者都没有的两样东西：可编写脚本、可管道化和串联的命令,以及由你自己掌控的钱包进行交易签名。

安装它,登录,并接入Claude Code：

alchemy install skills会加入Alchemy Skills,这是一套机器可读的工作流,让编码智能体无需在运行时翻阅文档就能学会使用CLI。这个包覆盖四个层面：CLI本身、带API key的应用集成、MCP,以及基于钱包的支付流程。再运行一条命令,alchemy agent-prompt,会生成一份JSON清单,列出每个命令、参数、错误代码和可运行示例,可以直接放进Claude Code的上下文里。有了Skills和这份清单,智能体在看到任何一页文档之前,就已经了解了整个接口。完整参考见Alchemy CLI docs和build with AI overview。

Claude Code能签名并发送交易吗？

读取操作默认是安全的。写入操作需要一个钱包,而每个开发者首先应该问的问题是：私钥存放在哪里。用了CLI之后,私钥永远不会出现在智能体的上下文里。

这会连接带有Privy托管的agent wallets。Privy在其一侧保管钱包的私钥。CLI会在你的设备上生成一个全新的、有时效限制的会话密钥,并用它来签名,这样即使prompt被攻破也无法掏空钱包,原始私钥也从不会接触模型。你可以从dashboard或用alchemy wallet disconnect撤销该会话,它会立即失效。之后智能体可以模拟一笔交易,把diff展示给你看,只有在你批准后才会发送。无论你选择哪种模式,这条规则都成立：智能体永远不会看到原始私钥,如果你的设计把私钥放进上下文,那你构建的就不是智能体,而是一个漏洞。

这也是值得教给你的工具的模式。一个没有Alchemy上下文的编码智能体,在你要求它签名时,往往会倾向于直接处理原始私钥。接入CLI之后,受管理的会话流程就会成为它默认采用的方式,这是更安全的答案,也是你希望它学会的答案。完整架构参见how to build onchain agents。

如果你想进一步了解,可以看看这些演示：

60秒即可开始

用一条命令,将Claude Code连接到实时链上数据：

浏览器打开后登录,即可开始提问。不需要API key,不需要注册dashboard,不需要本地安装。还想要签名和可编写脚本的命令？安装Alchemy CLI,运行alchemy auth login,你的智能体就能在同一套设置下读取、模拟并发送交易。你的编码智能体已经能写出链上代码了。现在,它也能执行了。