60 秒內完成 Claude Code 與 Alchemy 的設定

Claude Code 很擅長寫出與區塊鏈溝通的程式碼。問題出在後面。它會猜測該呼叫哪個 RPC 方法、自己捏造回應的格式，也沒辦法查詢餘額、價格，或是一筆交易實際做了什麼。於是它針對自己看不到的資料，寫出看似合理的程式碼。

一個指令就能解決這個問題。把 Claude Code 連接到 Alchemy 後，它就不用再用猜的了。它可以讀取 100+ 條鏈上的即時資料，在交易執行前先模擬結果，而如果你允許的話，還能簽署並送出交易。一個指令，就能讓 Claude Code 變成一個 onchain agent，而設定過程只需要大約一分鐘。

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

這個連接是透過 MCP（Model Context Protocol）運作的，這是一種開放標準，讓 agent 可以在執行期發現並呼叫外部工具。我們的 Alchemy MCP server 是託管服務，不需要在本機執行任何東西。只要設定一次讓 Claude Code 連上它，就能取得 涵蓋 100+ 網路的 168 個工具，分成三大類：admin（管理你的應用程式）、RPC（每條鏈上的每個 JSON-RPC 方法），以及 data（價格、代幣與 NFT 餘額、轉帳紀錄、多鏈資產組合，還有交易模擬）。

這個差異在你問第一個真正的問題時就會顯現出來。如果沒有連接資料來源，問「ETH 現在的價格是多少？」得到的數字會來自訓練資料，而這份資料在模型發佈當天就已經過時了。連接伺服器之後，Claude Code 會呼叫工具，從即時端點讀取價格。同樣的情況也適用於錢包餘額、NFT 擁有者，或是一筆待處理交易會造成哪些資產變動。你的 agent 從「寫程式碼去描述鏈上狀態」變成「直接讀取鏈上狀態」。

60 秒完成設定

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

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

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

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

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

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

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

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

託管伺服器是最快的入門方式。如果你想要打包好的版本，Alchemy plugin for Claude Code 把同一個 MCP server、/alchemy:balance 這類 slash command，以及 Agent Skills 打包在單一安裝流程裡。而 Alchemy CLI 則是深入探索的路徑，因為它多提供了前兩者都沒有的兩項功能：可以串接、腳本化的指令，以及由你自己掌控的錢包簽署交易。

安裝它、登入，然後把它接到 Claude Code：

alchemy install skills 會加入 Alchemy Skills，這是機器可讀的工作流程，讓 coding agent 知道如何使用 CLI，不需要在執行期間掃描文件。這個套件涵蓋四個層面：CLI 本身、用 API key 整合應用程式、MCP，以及以錢包為基礎的付款流程。另外還有一個指令 alchemy agent-prompt，會產生一份 JSON manifest，列出每個指令、旗標、錯誤代碼和可執行的範例，你可以直接把它放進 Claude Code 的 context 裡。有了 Skills 和這份 manifest，agent 在看到任何一頁文件之前就已經了解整個介面了。完整參考資料請見 Alchemy CLI docs 和 build with AI overview。

Claude Code 可以簽署並送出交易嗎？

讀取預設就是安全的。寫入則需要錢包，而每位開發者都應該先問的問題是：私鑰放在哪裡。用 CLI 的話，私鑰永遠不會進到你的 agent context 裡。

這會連接 agent wallets with Privy custody。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。

如果你想進一步探索，可以參考以下示範：

60 秒開始使用

用一個指令把 Claude Code 連接到即時鏈上資料：

瀏覽器開啟時登入，然後就可以開始發問。不需要 API key、不需要註冊 dashboard、不需要本機安裝。想要同時具備簽署和可腳本化指令的功能嗎？安裝 Alchemy CLI，執行 alchemy auth login，你的 agent 就能在同一套設定下讀取、模擬並送出交易。你的 coding agent 已經會寫 onchain 程式碼了，現在它也能執行了。