---
title: "60 秒內完成 Claude Code 與 Alchemy 的設定"
description: "只要一個指令，就能將 Claude Code 連接到 Alchemy。你的 coding agent 可取得 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 變成一個 onchain agent，而設定過程只需要大約一分鐘。

## 把 Claude Code 連接到 Alchemy 後能做什麼？

這個連接是透過 MCP（Model Context Protocol）運作的，這是一種開放標準，讓 agent 可以在執行期發現並呼叫外部工具。我們的 [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 現在的價格是多少？」得到的數字會來自訓練資料，而這份資料在模型發佈當天就已經過時了。連接伺服器之後，Claude Code 會呼叫工具，從即時端點讀取價格。同樣的情況也適用於錢包餘額、NFT 擁有者，或是一筆待處理交易會造成哪些資產變動。你的 agent 從「寫程式碼去描述鏈上狀態」變成「直接讀取鏈上狀態」。

## 60 秒完成設定

最快的方式是使用託管伺服器。在終端機執行一個指令：

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

重新啟動 Claude Code（或開啟新的對話），執行 `/mcp` 確認 `alchemy` 出現在啟用中伺服器的清單裡。第一次 Claude Code 呼叫 Alchemy 工具時，會開啟瀏覽器視窗讓你用帳號登入。驗證方式使用 OAuth，所以不需要貼上 API key，不需要本機安裝，`.env` 檔案裡也不會有任何東西。

之後，讓你的 agent 指向你的其中一個應用程式（「select an Alchemy app」），就可以開始發問了。整個設定就是這樣：一個指令、一次瀏覽器登入，你的 coding agent 就能讀取即時鏈上資料。

## 連接之後可以問哪些問題？

這個連接的重點在於，你可以用日常語言發問，Claude Code 會自己選出正確的工具。以下是伺服器連接好之後立刻可用的幾個範例：

- 「ETH 和 USDC 現在的價格是多少？」會從 [Data API](https://www.alchemy.com/docs/data) 的 Prices 介面讀取即時價格。
- 「顯示 vitalik.eth 在 Ethereum、Base 和 Arbitrum 上持有的代幣。」會在一次呼叫中取得跨多鏈的資產組合，不需要手動逐一查詢每條鏈。
- 「交易 0xabc... 實際上做了什麼？」會執行模擬，並回傳每一筆代幣與 ETH 變動的易讀差異，讓 agent 能針對「效果」進行推理，而不是原始的 calldata。
- 「這個地址在最近 100 個區塊內互動過哪些合約？」會直接讀取轉帳紀錄與事件日誌。

每個答案回傳的都是 agent 可以直接使用的結構化資料，而不是需要自行解析的文字敘述。這正是連接 agent 的價值所在。它先讀取自己的事實依據，然後基於當下為真的資料撰寫程式碼或提出建議。

## 如何用 CLI 和 Skills 走得更深入？

託管伺服器是最快的入門方式。如果你想要打包好的版本，[Alchemy plugin for Claude Code](https://www.alchemy.com/blog/alchemy-claude-plugin-now-live) 把同一個 MCP server、`/alchemy:balance` 這類 slash command，以及 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)，這是機器可讀的工作流程，讓 coding agent 知道如何使用 CLI，不需要在執行期間掃描文件。這個套件涵蓋四個層面：CLI 本身、用 API key 整合應用程式、MCP，以及以錢包為基礎的付款流程。另外還有一個指令 `alchemy agent-prompt`，會產生一份 JSON manifest，列出每個指令、旗標、錯誤代碼和可執行的範例，你可以直接把它放進 Claude Code 的 context 裡。有了 Skills 和這份 manifest，agent 在看到任何一頁文件之前就已經了解整個介面了。完整參考資料請見 [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 的話，私鑰永遠不會進到你的 agent context 裡。

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

這會連接 [agent wallets with Privy custody](https://www.alchemy.com/blog/agent-wallets-alchemy-cli)。Privy 在它那一端保管錢包的私鑰。CLI 會在你的裝置上產生一把全新、有時效限制的 session key 並用它來簽署，因此即使 prompt 被入侵也無法把錢包掏空，原始私鑰也不會接觸到模型。你可以在 dashboard 上或用 `alchemy wallet disconnect` 撤銷該 session，它會立即失效。之後 agent 可以模擬交易、顯示差異給你看，等你核准後才送出。不論你選哪種模式，這個規則都不會變：agent 永遠不會看到原始私鑰，如果你的設計把私鑰放進 context 裡，那你打造出來的就不是 agent，而是一個漏洞。

這也是值得教給你的工具的模式。一個沒有 Alchemy context 的 coding agent，在你要求它簽署時，往往會傾向直接處理原始私鑰。接上 CLI 之後，受管理的 session 流程就會變成它預設採用的做法，這既是更安全的答案，也是你希望它學會的做法。完整架構請參見 [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`，你的 agent 就能在同一套設定下讀取、模擬並送出交易。你的 coding agent 已經會寫 onchain 程式碼了，現在它也能執行了。