---
title: CLI 빠른 시작
url: https://platform.claude.com/docs/ko/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`는 손으로 작성한 JSON 대신 타입이 지정된 플래그나 파이프로 전달된 YAML로부터 요청 본문을 구성하며, `@path` 참조를 사용해 파일 내용을 문자열 필드에 인라인으로 삽입합니다. 내장된 `--transform` 쿼리로 응답 필드를 추출하므로 `jq`와 같은 별도의 도구가 필요 없으며, 목록 엔드포인트를 자동으로 페이지네이션합니다.

<Info>
  엔드포인트별 매개변수와 응답 스키마는 [API 레퍼런스](https://platform.claude.com/docs/ko/api/cli/messages/create)를 참조하세요. 이 페이지는 동작하는 명령을 실행하는 단계까지 안내합니다. CLI가 수행하는 그 밖의 모든 기능은 [CLI 사용하기](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/using) 및 [CLI 스크립팅 및 자동화](https://platform.claude.com/docs/ko/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`은 Claude Console에 대해 브라우저 기반 OAuth 흐름을 열고 결과 자격 증명을 로컬에 저장하므로, API 키를 생성하거나 관리하지 않고도 API를 호출할 수 있습니다.

```bash CLI
ant auth login
```

<Note>
  다른 인증 방법(API 키 환경 변수, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필, Workload Identity Federation)은 [CLI 인증 옵션](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/authentication)을 참조하세요.
</Note>

## 첫 번째 요청 보내기

바이너리를 설치하고 인증을 마쳤다면, [Messages API](https://platform.claude.com/docs/ko/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이 터미널이므로 보기 좋게 정렬되어 출력됩니다.

## 셸 자동 완성

CLI에는 bash, zsh, fish, PowerShell용 자동 완성 스크립트가 포함되어 있습니다. 사용하는 셸에 맞는 스크립트를 생성하고 설치하세요:

<Tabs>
  <Tab title="zsh">
    ```bash
    ant @completion zsh > "${fpath[1]}/_ant"
    # 셸을 다시 시작하거나 다음을 실행하세요: 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/ko/cli-sdks-libraries/cli/authentication">
    API 키, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필
  </Card>

  <Card title="CLI 사용하기" icon="terminal" href="https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/using">
    명령 구조, 출력 형식, GJSON 변환, 요청 본문
  </Card>

  <Card title="CLI 스크립팅 및 자동화" icon="code" href="https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/scripting">
    API 리소스 버전 관리, 스크립팅 패턴, Claude Code에서의 사용
  </Card>
</CardGroup>