CLI 快速入門

ant CLI 讓您可以從終端機存取 Claude API。每個 API 資源都以子命令的形式提供，並支援輸出格式化、回應篩選，以及 YAML 或 JSON 檔案輸入。

相較於 curl，ant 會從具型別的旗標或透過管道傳入的 YAML 建構請求主體，而非手寫的 JSON，並可透過 @path 參照將檔案內容內嵌至字串欄位中。它使用內建的 --transform 查詢來擷取回應欄位，因此您不需要另外使用 jq 等工具，而且會自動對列表端點進行分頁處理。



安裝

brew install anthropics/tap/ant

檢查安裝是否成功：

ant --version



身份驗證

ant auth login 會開啟基於瀏覽器的 OAuth 流程，連線至 Claude Console 並將產生的憑證儲存在本機，因此您無需建立或管理 API 金鑰即可呼叫 API。

ant auth login



發送您的第一個請求

安裝二進位檔並完成身份驗證後，即可呼叫 Messages API：

ant messages create \
  --model claude-opus-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

{
  "model": "claude-opus-5",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}

回應是完整的 API 物件，由於 stdout 是終端機，因此會以美化格式輸出。



Shell 自動補全

CLI 隨附適用於 bash、zsh、fish 和 PowerShell 的自動補全指令碼。請為您的 shell 產生並安裝對應的指令碼：

ant @completion zsh > "${fpath[1]}/_ant"
# 重新啟動您的 shell 或執行：autoload -U compinit && compinit



後續步驟