CLI 快速入門
安裝 ant 命令列工具、進行驗證,並向 Claude API 傳送您的第一個請求。
ant CLI 讓您可以從終端機存取 Claude API。每個 API 資源都以子命令的形式提供,並支援輸出格式化、回應篩選,以及 YAML 或 JSON 檔案輸入。
與 curl 相比,ant 會從具型別的旗標或透過管道傳入的 YAML 建構請求主體,而不需要手寫 JSON,並且可以透過 @path 參照將檔案內容內嵌到字串欄位中。它使用內建的 --transform 查詢來擷取回應欄位,因此您不需要 jq 之類的額外工具,而且它會自動對列表端點進行「pagination」(分頁)。
安裝
brew install anthropics/tap/ant在 Linux 環境中,請直接下載發行版本的二進位檔。
VERSION=2.3.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin ant您可以在 GitHub 發行版本頁面上找到所有發行版本。
您也可以使用 go install 從原始碼安裝 CLI。需要 Go 1.25 或更新版本。
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest二進位檔會放置在 $(go env GOPATH)/bin 中。如果它尚未在您的 PATH 中,請將其加入:
export PATH="$PATH:$(go env GOPATH)/bin"檢查安裝:
ant --version驗證
ant auth login 會針對 Claude Console 開啟以瀏覽器為基礎的 OAuth 流程,並將取得的憑證儲存在本機,因此您無需建立或管理 API 金鑰即可呼叫 API。
ant auth login傳送您的第一個請求
安裝二進位檔並完成驗證後,呼叫 Messages API:
ant messages create \
--model claude-opus-5-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello, Claude"}'{
"model": "claude-opus-5-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 completion」(Shell 自動完成)腳本。為您的 shell 產生並安裝一個:
ant @completion zsh > "${fpath[1]}/_ant"
# 請重新啟動您的 shell,或執行:autoload -U compinit && compinitant @completion bash > /etc/bash_completion.d/antant @completion fish > ~/.config/fish/completions/ant.fishant @completion powershell | Out-String | Invoke-Expression
# 若要在各工作階段間保留設定:
# ant @completion powershell >> $PROFILE後續步驟
API 金鑰、無頭主機、多個工作區和具名設定檔
命令結構、輸出格式、GJSON 轉換和請求主體
對 API 資源進行版本控制、腳本模式,以及從 Claude Code 使用
Was this page helpful?