---
title: CLI 快速入門
url: https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/quickstart
description: 安裝 ant 命令列工具、進行驗證，並向 Claude API 傳送您的第一個請求。
---

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

<Frame caption="ant CLI 實際運作情形。">
  <video aria-label="ant CLI 在終端機中執行的螢幕錄影。">
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.webm" type="video/webm" />
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.mp4" type="video/mp4" />
  </video>
</Frame>

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

<Info>
  如需端點專屬的參數與回應結構描述，請參閱 [API 參考文件](https://platform.claude.com/docs/zh-TW/api/cli/messages/create)。本頁面將帶您完成一個可運作的命令。關於 CLI 的其他所有功能，請參閱[使用 CLI](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/using) 以及 [CLI 腳本與自動化](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/scripting)。
</Info>

## 安裝

<Tabs>
  <Tab title="Homebrew (macOS)">
    ```bash
    brew install anthropics/tap/ant
    ```
  </Tab>

  <Tab title="curl (Linux/WSL)">
    在 Linux 環境中，請直接下載發行版二進位檔。

    ```bash
    VERSION=1.42.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 發行頁面](https://github.com/anthropics/anthropic-cli/releases)找到所有發行版本。
  </Tab>

  <Tab title="Go">
    您也可以使用 `go install` 從原始碼安裝 CLI。需要 Go 1.25 或更新版本。

    ```bash
    go install github.com/anthropics/anthropic-cli/cmd/ant@latest
    ```

    二進位檔會放置於 `$(go env GOPATH)/bin`。若尚未加入，請將其加入您的 `PATH`：

    ```bash
    export PATH="$PATH:$(go env GOPATH)/bin"
    ```
  </Tab>
</Tabs>

檢查安裝結果：

```bash
ant --version
```

## 驗證

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

```bash CLI
ant auth login
```

<Note>
  如需其他驗證方式（API 金鑰環境變數、無頭主機、多個工作區、具名設定檔，以及 Workload Identity Federation），請參閱 [CLI 驗證選項](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/authentication)。
</Note>

## 傳送您的第一個請求

安裝二進位檔並完成驗證後，呼叫 [Messages API](https://platform.claude.com/docs/zh-TW/api/cli/messages/create)：

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

```text Output wrap
{
  "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 產生並安裝一份：

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

  <Tab title="bash">
    ```bash
    ant @completion bash > /etc/bash_completion.d/ant
    ```
  </Tab>

  <Tab title="fish">
    ```bash
    ant @completion fish > ~/.config/fish/completions/ant.fish
    ```
  </Tab>

  <Tab title="PowerShell">
    ```powershell
    ant @completion powershell | Out-String | Invoke-Expression
    # 若要跨工作階段持續生效：
    # ant @completion powershell >> $PROFILE
    ```
  </Tab>
</Tabs>

## 後續步驟

<CardGroup cols={3}>
  <Card title="CLI 驗證選項" icon="lock" href="https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/authentication">
    API 金鑰、無頭主機、多個工作區，以及具名設定檔
  </Card>

  <Card title="使用 CLI" icon="terminal" href="https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/using">
    命令結構、輸出格式、GJSON 轉換，以及請求主體
  </Card>

  <Card title="CLI 腳本與自動化" icon="code" href="https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/scripting">
    對 API 資源進行版本控制、腳本撰寫模式，以及從 Claude Code 使用
  </Card>
</CardGroup>