CLI、SDK 與函式庫ant CLI

CLI 快速入門

安裝 ant 命令列工具、進行身份驗證，並向 Claude API 發送您的第一個請求。

ant CLI 讓您可以從終端機存取 Claude API。每個 API 資源都以子命令的形式提供，並具備輸出格式化、回應過濾，以及支援 YAML 或 JSON 檔案輸入等功能，使其在互動式探索和自動化方面都相當實用。

相較於使用 curl 呼叫 API，ant 讓您可以透過型別化的旗標或管線傳入的 YAML 來建構請求主體，而非手寫 JSON；可使用 @path 參照將檔案內容內嵌到字串欄位中；並透過內建的 --transform 查詢從回應中擷取欄位（無需額外的 JSON 工具）。列表端點會自動分頁。Claude Code 原生支援 ant。

如需特定端點的參數和回應結構描述，請參閱 API 參考文件。本頁面將引導您執行一個可運作的命令。關於 CLI 的其他所有功能，請參閱使用 CLI 和 CLI 腳本編寫與自動化。

安裝

檢查安裝：

ant --version

身份驗證

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

CLI

ant auth login

如需其他身份驗證方式（API 金鑰環境變數、無周邊主機、多個工作區、具名設定檔，以及 Workload Identity Federation），請參閱 CLI 身份驗證選項。

發送您的第一個請求

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

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

Output

{
  "model": "claude-opus-4-8",
  "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 產生並安裝一個：

後續步驟

CLI 身份驗證選項：API 金鑰、無周邊主機、多個工作區和具名設定檔
使用 CLI：命令結構、輸出格式、GJSON 轉換和請求主體
CLI 腳本編寫與自動化：對 API 資源進行版本控制、腳本編寫模式，以及從 Claude Code 使用

Was this page helpful?

身份驗證

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

CLI

ant auth login

如需其他身份驗證方式（API 金鑰環境變數、無周邊主機、多個工作區、具名設定檔，以及 Workload Identity Federation），請參閱 CLI 身份驗證選項。

發送您的第一個請求

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

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

Output

{
  "model": "claude-opus-4-8",
  "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 是終端機，因此會以美化格式列印。

後續步驟

CLI 身份驗證選項：API 金鑰、無周邊主機、多個工作區和具名設定檔

使用 CLI：命令結構、輸出格式、GJSON 轉換和請求主體

CLI 腳本編寫與自動化：對 API 資源進行版本控制、腳本編寫模式，以及從 Claude Code 使用

Was this page helpful?