---
title: "60 秒内为 Claude Code 配置 Alchemy"
description: "通过一条命令将 Claude Code 连接到 Alchemy。你的编码代理即可获取 100+ 条链上的实时数据：价格、余额、NFT、转账记录和模拟。"
---

# 60 秒内为 Claude Code 配置 Alchemy

<ImageBlock
  src="https://media.alchemy.com/blog/setup-claude-code-alchemy-hero-16x9-20260821.png"
  alt="60 秒内在 Claude Code 中配置 Alchemy"
  width={1920}
  height={1080}
  priority
/>

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

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

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

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

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

## 60秒完成设置

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

<CodeSnippet
  language="bash"
  code={`claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp`}
/>

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

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

## 连接之后可以问什么？

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

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

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

## 如何用CLI和Skills走得更远？

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

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

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth login
alchemy install mcp
alchemy install skills`}
/>

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy wallet connect --mode session`}
/>

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

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

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

<a
  href="https://x.com/uttam_singhk/status/2054540200874025224"
  target="_blank"
  rel="noopener noreferrer"
>
  <ImageBlock
    src="https://media.alchemy.com/blog/setup-claude-code-alchemy-tweet-aave.png"
    alt="一个使用 Alchemy CLI 的代理，可在 Aave 上寻找最佳 USDC 收益率、比较各 Ethereum L2 之间的利率、将资产从 Base 桥接到 Arbitrum 并完成供应，全部通过终端完成，无需暴露私钥"
    width={1036}
    height={1322}
    caption="Source: https://x.com/uttam_singhk/status/2054540200874025224"
  />
</a>

<a
  href="https://x.com/uttam_singhk/status/2071581970807902420"
  target="_blank"
  rel="noopener noreferrer"
>
  <ImageBlock
    src="https://media.alchemy.com/blog/setup-claude-code-alchemy-tweet-solana.png"
    alt="一个基于新闻驱动的 Solana 交易代理：通过 phoenix-cli 使用 Phoenix 执行交易，接入实时新闻源，搭配你选择的模型，并使用 Alchemy 提供快速、可靠的 RPC"
    width={1036}
    height={1322}
    caption="Source: https://x.com/uttam_singhk/status/2071581970807902420"
  />
</a>

## 60秒即可开始

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

<CodeSnippet
  language="bash"
  code={`claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp`}
/>

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