---
title: "使用 Alchemy CLI 更快完成的 12 件事"
description: "Alchemy CLI 將每個鏈上工作流程都變成單一指令：驗證、代理錢包、多鏈讀取、轉帳、交換、跨鏈橋接，以及 AI 代理整合。"
---

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-hero-v2.png"
  alt="用 Alchemy CLI 更快完成的 12 件事"
  width={1920}
  height={900}
  priority
/>

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

這篇文章會介紹 CLI 用一行指令就能完成的十二件事：登入、建立 agent wallet、讀取任意鏈上資料、模擬寫入交易、發送 token、swap、bridge，以及把同一套工具接進 Cursor、Claude Code 或 Codex。文中展示的每一條指令現在都可以直接使用。

## 什麼是 Alchemy CLI？

Alchemy CLI 是單一的 [npm package](https://www.npmjs.com/package/@alchemy/cli)，`@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` 清除。

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-auth.png"
  alt="授權登入畫面，授予 Alchemy CLI 對帳戶的範圍存取權"
  width={1580}
  height={1190}
/>

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

### 2. 用 `alchemy wallet connect` 建立 agent wallet

CLI 內建 [使用 Privy 託管的 agent wallet](https://www.alchemy.com/blog/agent-wallets-alchemy-cli)。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 也從不離開你的裝置。

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

從 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](https://docs.x402.org/)，請求就能完成。x402 是 Coinbase 提出的開放規格，用於 HTTP-native payments；結算以 Base 上的 USDC 進行。agent 只要 [1 美元](https://www.alchemy.com/blog/ai-agents-can-now-sign-up-for-alchemy) 的 compute credits 就能開始，不需要註冊 dashboard。

<CodeSnippet
  language="bash"
  code={`# Pay per call with the wallet you connected in step 2
alchemy evm rpc eth_blockNumber -n base-mainnet --x402

# Or make it the default so you can drop the flag:
alchemy config set x402 true`}
/>

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

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm rpc eth_blockNumber -n base-mainnet --json
alchemy evm rpc eth_getLogs '[{"fromBlock":"0x123","topics":["0x..."]}]' \\
  -n arb-mainnet --json`}
/>

對 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`。

<CodeSnippet
  language="bash"
  code={`alchemy evm data portfolio tokens --json --body '{
  "addresses":[{
    "address":"vitalik.eth",
    "networks":["eth-mainnet","base-mainnet","arb-mainnet"]
  }]
}'`}
/>

搭配 `portfolio nfts`，同樣的技巧也能用在 NFT collection 上。這些端點跟我們 [Data API](https://www.alchemy.com/docs/data) 在生產環境用的 indexer 是同一組。

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm data tokens balances 0xabc... --metadata -n base-mainnet --json
alchemy evm data history 0xabc... -n eth-mainnet --json
alchemy evm data nfts 0xabc... --limit 20 -n eth-mainnet --json`}
/>

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

## 直接從 shell 發送交易

### 7. 發送前先模擬

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

<CodeSnippet
  language="bash"
  code={`alchemy evm simulate asset-changes --json --tx '{
  "from":"vitalik.eth",
  "to":"0x...",
  "data":"0x..."
}'`}
/>

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm send vitalik.eth 0.01 -n base-mainnet
alchemy evm send 0xabc... 100 --token 0xUsdcAddress -n base-mainnet`}
/>

`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。

<CodeSnippet
  language="bash"
  code={`alchemy evm approve 0xPool --token-address 0xUsdc --amount 100 -n base-mainnet
alchemy evm swap execute --from 0xUsdc --to 0xEth --amount 100 -n base-mainnet
alchemy xchain bridge execute --from 0xUsdcBase --to 0xUsdcArb \\
  --amount 0.2 --to-network arb-mainnet -n base-mainnet`}
/>

根據 [Alchemy CLI 文件](https://www.alchemy.com/docs/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 名稱。

<CodeSnippet
  language="bash"
  code={`alchemy agent-prompt > .alchemy-prompt.json`}
/>

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

### 11. 安裝 Alchemy Skills

`alchemy install skills` 會把 [Alchemy Skills bundle](https://github.com/alchemyplatform/skills) 安裝進你的 agent client。Skills 是機器可讀的工作流程，讓 coding agent 不用在執行期讀文件，就知道怎麼使用 CLI。

<CodeSnippet
  language="bash"
  code={`alchemy install skills`}
/>

這個 bundle 涵蓋四個介面：CLI 本身、透過 API key 的應用整合、MCP，以及以 wallet 為基礎的付款流程。一行指令就把「agent 每個 session 都得重新翻文件」變成「agent 早就知道整套流程」。

### 12. 接上 MCP

`alchemy install mcp` 會把 [Alchemy MCP server](https://www.alchemy.com/docs/alchemy-mcp-server) 接進你的 agent client。MCP（Model Context Protocol）是一個開放規格，讓 agent 能在執行期發現並呼叫工具。這個託管 server 位於 `https://mcp.alchemy.com/mcp`，提供超過 150 個工具，涵蓋 100 多條鏈：admin、每一種 RPC method，以及 Data API 介面。

<CodeSnippet
  language="bash"
  code={`alchemy install mcp`}
/>

如果特別是用 Claude Code：

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

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

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

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-demo.png"
  alt="代理程式使用 Alchemy CLI 比較各 L2 上的 Aave USDC 收益率，將資產從 Base 橋接到 Arbitrum，並存入 Aave，全程在終端機中完成，無需使用原始私鑰"
  width={1058}
  height={1292}
  caption="Source: https://x.com/uttam_singhk/status/2054540200874025224"
/>

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

## 開始你的第一個指令

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

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth
alchemy wallet connect --mode session
alchemy evm send vitalik.eth 0.001 -n base-mainnet`}
/>

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