anthropic-cli (ant) 完整教學

1brew install anthropics/tap/ant
2ant --version

1go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'
2
3# 確認 Go bin 在 PATH 中
4export PATH="$PATH:$(go env GOPATH)/bin"
5ant --version

1git clone https://github.com/anthropics/anthropic-cli.git
2cd anthropic-cli
3./scripts/bootstrap   # 安裝 Go 依賴
4./scripts/build       # 產出 ./ant binary
5./ant --version
6
7# 或直接用 scripts/run（不產出 binary）
8./scripts/run messages create --help

1# 必要：至少設定一種認證方式
2export ANTHROPIC_API_KEY="sk-ant-..."
3
4# 選用：OAuth token（ant auth login 會自動處理）
5export ANTHROPIC_AUTH_TOKEN="..."
6
7# 選用：Webhook 驗證
8export ANTHROPIC_WEBHOOK_SIGNING_KEY="..."

 1# 基本用法
 2ant messages create \
 3  --model claude-sonnet-4-5-20250929 \
 4  --max-tokens 1024 \
 5  --message '{"content": [{"text": "Hello Claude", "type": "text"}], "role": "user"}'
 6
 7# 帶 system prompt
 8ant messages create \
 9  --model claude-sonnet-4-5-20250929 \
10  --max-tokens 2048 \
11  --system "You are a helpful coding assistant." \
12  --message '{"content": [{"text": "Write a Python hello world", "type": "text"}], "role": "user"}'
13
14# Streaming 模式
15ant messages create \
16  --model claude-sonnet-4-5-20250929 \
17  --max-tokens 1024 \
18  --stream \
19  --message '{"content": [{"text": "Explain quantum computing", "type": "text"}], "role": "user"}'
20
21# 計算 token 數
22ant messages count-tokens \
23  --model claude-sonnet-4-5-20250929 \
24  --message '{"content": [{"text": "Count my tokens", "type": "text"}], "role": "user"}'

 1# 自動偵測格式（binary→base64 / text→string）
 2ant messages create \
 3  --model claude-sonnet-4-5-20250929 \
 4  --max-tokens 1024 \
 5  --message '{"content": [{"type": "image", "source": {"data": "@photo.jpg"}}], "role": "user"}'
 6
 7# 強制 base64 編碼
 8ant messages create --arg @data://binary-file.dat
 9
10# 強制字串編碼
11ant messages create --arg @file://text-file.txt

 1# OAuth 登入（開瀏覽器走 PKCE 流程）
 2ant auth login
 3
 4# 登入到指定 profile
 5ant auth login --profile work
 6
 7# 查看認證狀態
 8ant auth status
 9
10# 登出
11ant auth logout

 1# 列出所有 profile
 2ant profile list
 3
 4# 切換 active profile
 5ant profile activate work
 6
 7# 查看 profile 設定
 8ant profile get
 9
10# 設定 profile 欄位
11ant profile set api_key sk-ant-...
12ant profile set base_url https://custom-api.example.com

 1# JSON 格式輸出
 2ant messages create ... --format json
 3
 4# YAML 格式
 5ant messages create ... --format yaml
 6
 7# GJSON 轉換——只取 content 欄位
 8ant messages create ... --transform "content"
 9
10# 只看 error 內容
11ant messages create ... --format-error json --transform-error "error.message"
12
13# 互動式瀏覽（explore 模式）
14ant messages create ... --format explore

 1# 設定環境變數
 2export ANTHROPIC_ENVIRONMENT_ID="env_..."
 3export ANTHROPIC_ENVIRONMENT_KEY="envkey_..."
 4
 5# 啟動長輪詢 worker
 6ant beta:worker poll \
 7  --environment-id "$ANTHROPIC_ENVIRONMENT_ID" \
 8  --environment-key "$ANTHROPIC_ENVIRONMENT_KEY"
 9
10# 執行單一工作項目
11ant beta:worker run \
12  --environment-id "$ANTHROPIC_ENVIRONMENT_ID" \
13  --environment-key "$ANTHROPIC_ENVIRONMENT_KEY" \
14  --work-id "work_..."

 1# GitHub Actions 用法
 2ant messages create \
 3  --identity-token "$ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
 4  --federation-rule "fdrl_..." \
 5  --organization-id "org-uuid" \
 6  --model claude-sonnet-4-5-20250929 \
 7  --max-tokens 1024 \
 8  --message '...'
 9
10# K8s Projected SA Token
11ant messages create \
12  --identity-token-file /var/run/secrets/tokens/anthropic \
13  --federation-rule "fdrl_..." \
14  --model claude-sonnet-4-5-20250929 \
15  --max-tokens 1024 \
16  --message '...'

 1jobs:
 2  review:
 3    runs-on: ubuntu-latest
 4    steps:
 5      - uses: actions/checkout@v4
 6      - name: Install ant
 7        run: go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'
 8      - name: Review PR diff
 9        env:
10          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
11        run: |
12          git diff origin/main...HEAD | ant messages create \
13            --model claude-sonnet-4-5-20250929 \
14            --max-tokens 4096 \
15            --system "Review this code diff. List issues and suggestions." \
16            --message "{\"content\": [{\"text\": \"$(cat)\", \"type\": \"text\"}], \"role\": \"user\"}"

1# 建立 batch
2ant message-batches create \
3  --requests '[{"custom_id": "req1", "params": {"model": "claude-sonnet-4-5-20250929", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}}]'
4
5# 查詢狀態
6ant message-batches retrieve --id "batch_..."
7
8# 取得結果
9ant message-batches results --id "batch_..."

1# 快速問答（配合 alias）
2alias ask='ant messages create --model claude-sonnet-4-5-20250929 --max-tokens 2048 --message'
3
4ask '{"content": [{"text": "What is the capital of France?", "type": "text"}], "role": "user"}' \
5  --transform "content.0.text"

1# 顯示完整 HTTP 請求 / 回應
2ant messages create ... --debug

1# 指向代理或自建服務
2ant messages create ... --base-url https://my-proxy.example.com
3
4# 或用環境變數
5export ANTHROPIC_BASE_URL=https://my-proxy.example.com

1# 取得第一個 content block 的 text
2ant messages create ... --transform "content.0.text"
3
4# 取得所有 content block 的 type
5ant messages create ... --transform "content.#.type"
6
7# 條件篩選
8ant messages create ... --transform 'content.#(type=="text").text'

1# Bash
2ant @completion bash > /etc/bash_completion.d/ant
3
4# Zsh
5ant @completion zsh > "${fpath[1]}/_ant"
6
7# Fish
8ant @completion fish > ~/.config/fish/completions/ant.fish

1# 連結到本地 SDK 目錄
2./scripts/link ../anthropic-go
3
4# 連結到指定版本
5./scripts/link github.com/anthropics/anthropic-sdk-go@v1.46.0
6
7# 取消連結
8./scripts/unlink

1# 只取回覆文字
2ant messages create ... --format json | jq -r '.content[0].text'
3
4# 取 usage 統計
5ant messages create ... --format json | jq '.usage'

1# 將檔案內容送入 Claude
2cat code.py | ant messages create \
3  --model claude-sonnet-4-5-20250929 \
4  --max-tokens 4096 \
5  --system "Review this code" \
6  --message "{\"content\": [{\"text\": \"$(cat)\", \"type\": \"text\"}], \"role\": \"user\"}"

1.PHONY: review
2review:
3	@git diff --staged | ant messages create \
4		--model claude-sonnet-4-5-20250929 \
5		--max-tokens 4096 \
6		--format json \
7		--transform "content.0.text" \
8		--system "Review this diff. Be concise." \
9		--message '{"content": [{"text": "$(shell git diff --staged)", "type": "text"}], "role": "user"}'