使用 Alchemy CLI 更快完成的 12 件事

過去每個 onchain 專案的起手式都一樣：打開 dashboard、複製一組 API key、把 private key 貼進 .env、npm install 三個 SDK，最後才終於能寫出你真正想寫的那行程式碼。你的 coding agent 也花了半個 session 才搞清楚該呼叫哪個 RPC method。Alchemy CLI 把這整套設定成本壓縮成可以 pipe、寫進腳本、或直接交給 coding agent 執行的指令。你的終端機就是上鏈最快的路徑。

這篇文章會介紹 CLI 用一行指令就能完成的十二件事：登入、建立 agent wallet、讀取任意鏈上資料、模擬寫入交易、發送 token、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，同一組 flag 可以用在每一個指令上。把 --json pipe 進 jq，用 --no-interactive 來管控腳本執行——同一套在終端機上跑的介面，也能在 AI coding agent 內部執行。

重點就是：原本要透過 dashboard 或 SDK 才能跑的工作流程，現在收斂成一行指令，開發者能寫進腳本，agent 也能直接呼叫。

一個終端機搞定驗證與身分

1. 用 alchemy auth 登入一次就好

alchemy auth 會開啟瀏覽器，幫你登入帳號，並把 session 存在本機。不用再把 API key 貼進每個專案裡的每一個 .env。用 alchemy auth login --force 切換 team，用 alchemy auth status 檢查狀態，用 alchemy auth logout 清除。

一行指令就取代了每個專案都要重複一次的「複製 key、貼上 key、gitignore key、輪替 key」流程。

2. 用 alchemy wallet connect 建立 agent wallet

CLI 內建 使用 Privy 託管的 agent wallet。Privy 是一個 embedded-wallet 供應商，由它保管 wallet 的 private key。alchemy wallet connect --mode session 會在本機產生一組新的 P-256 keypair，向 Privy 後端註冊一個有時效限制的 session，並分兩步完成簽署：CLI 簽署 session-key payload，Privy 簽署 wallet。private key 從不離開 Privy，session key 也從不離開你的裝置。

從 dashboard 或用 alchemy wallet disconnect 撤銷後，該 session 會立即失效。如果想用本機 key 的工作流程：alchemy wallet connect --mode local --chain evm --import ~/.wallet/key。不論哪種方式，private key 都不會出現在 .env 裡。

3. 用 --x402 隨用隨付

在任何指令上設定 --x402，CLI 就會用連接的 wallet 對我們的 API 進行驗證，而不是用 API key。當請求打到付費端點時，該端點會回傳 HTTP 402，CLI 會簽署 x402 payment payload，請求就能完成。x402 是 Coinbase 提出的開放規格，用於 HTTP-native payments；結算以 Base 上的 USDC 進行。agent 只要 1 美元 的 compute credits 就能開始，不需要註冊 dashboard。

現在，agent（或從未註冊過的開發者）也能打到跟你生產環境工作負載相同的 API。不用 API key，不用 dashboard，不用合約。

不寫 fetch 樣板程式碼也能讀取任意鏈

4. 對任意鏈呼叫任意 JSON-RPC method

alchemy evm rpc 會把任何 JSON-RPC method 直接傳給你用 -n 選定的網路。不用手寫 fetch envelope，也不用為了五行腳本跳一輪 SDK 安裝流程。

對 Solana，JSON-RPC 用 alchemy solana rpc，Digital Asset Standard method 用 alchemy solana das。在我們支援的每一條鏈上，格式都維持一致。

5. 一次呼叫取得多鏈投資組合

alchemy evm data portfolio tokens 會回傳一個 wallet 曾經接觸過的每一條鏈上的 token 餘額。不用自己把七個 RPC provider 拼在一起，也不用一條鏈一條鏈地對每個 ERC-20 合約呼叫 eth_call。

搭配 portfolio nfts，同樣的技巧也能用在 NFT collection 上。這些端點跟我們 Data API 在生產環境用的 indexer 是同一組。

6. 把餘額、轉帳、NFT 查詢都變成一行指令

餘額、token metadata、轉帳紀錄和 NFT，在 Data API 介面裡各自都是單一子指令。加上 --metadata，呼叫就會直接回傳 name、symbol、decimals 和 logo URL。

以前要跨四個不同 SDK client 才能完成的讀取操作，現在變成同一個 CLI 上的四個 flag。

直接從 shell 發送交易

7. 發送前先模擬

alchemy evm simulate asset-changes 會回傳一份人類可讀的 diff，列出該交易會造成的每一筆 token 和 ETH 變動。simulate execution 則會回傳完整的 trace。使用者在交易真正上鏈之前，就能確切看到這筆呼叫會做什麼。

在任何會動到 mainnet 資金的 evm send 或 contract call 之前都先跑這個。省下「我剛把熱錢包搞壞了」的重跑麻煩。

8. 一行指令發送到 ENS 名稱

alchemy evm send 會解析 ENS、處理 gas，並用目前啟用中的 wallet（session、本機、或 Privy 託管）簽署。搭配 --x402，同樣的呼叫就會走你在步驟 2 連接的那個 wallet。

9. 在同一個 shell 完成 approve、swap、bridge

alchemy evm swap execute 能把同鏈 swap 從報價一路走到執行。alchemy xchain bridge execute 則是跨鏈版本。alchemy evm approve 負責處理每次 DEX swap 之前都需要的 ERC-20 allowance。

根據 Alchemy CLI 文件，同鏈 swap 已在 11 條 EVM mainnet 上線，包括 Ethereum、Base、Arbitrum、Optimism、Polygon 和 BSC。跨鏈 bridge 現在也已經在 CLI 中提供。原本的 dashboard 精靈流程，現在收斂成三行 shell 指令。

把 CLI 接進你的 coding agent

10. 用 alchemy agent-prompt 輸出完整的 agent manifest

alchemy agent-prompt 會輸出一份 JSON 文件，描述每一個指令、flag、錯誤代碼和範例。把它 pipe 進你的 agent system prompt，agent 就不用再猜 flag 名稱。

這份 manifest 包含執行政策、preflight 檢查、驗證矩陣、附選項的指令樹、含重試語意的錯誤目錄，以及可直接執行的範例。不論是 Cursor、Claude Code、Codex，還是其他 coding agent，這個檔案都可以直接放進 system prompt。實際案例可參考：How to build onchain agents。

11. 安裝 Alchemy Skills

alchemy install skills 會把 Alchemy Skills bundle 安裝進你的 agent client。Skills 是機器可讀的工作流程，讓 coding agent 不用在執行期讀文件，就知道怎麼使用 CLI。

這個 bundle 涵蓋四個介面：CLI 本身、透過 API key 的應用整合、MCP，以及以 wallet 為基礎的付款流程。一行指令就把「agent 每個 session 都得重新翻文件」變成「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 method，以及 Data API 介面。

如果特別是用 Claude Code：

Skills、agent-prompt manifest 和 MCP 三者結合，讓 CLI 成為 agent 工具庫裡的一級能力，而不是外掛的附屬依賴。

五次呼叫的 agent demo：比較收益、bridge、供應

隨 Alchemy Skills repo 附上的標準 demo，會讀取 Polygon、Arbitrum、Optimism 上的 USDC 供應 APY，把 0.2 USDC 從 Base bridge 到收益最高的鏈，再供應進 Aave V3。五次 CLI 呼叫，用的是跟這篇文章其他部分相同的介面。

在上面的 demo 中，agent 會找出 USDC 最佳的 Aave 市場，把資金 bridge 到對的鏈上，再存入該資金池。在此之前，這類工作流程要不是需要自訂的 agent 程式碼持有 private key，就是得手動打造 wallet SDK 和 coding assistant 之間的整合。現在只需要幾條指令和一次 dashboard 點擊。

開始你的第一個指令

你剛剛看過十二個指令。這裡是兩分鐘的上手流程：安裝、登入、連接 wallet、發送。

不用一堆 SDK，不用把 private key 放進 .env，也不用來回跑 dashboard。不管你的 onchain 工作流程長什麼樣子，CLI 都能從一個 prompt 開始執行。你的終端機就是上鏈最快的路徑。