CLI 퀵스타트

ant 명령줄 도구를 설치하고 인증한 뒤 Claude API에 첫 요청을 보내 보아요. 터미널에서 Claude API를 쓸 수 있게 해 주는 CLI라서, 모든 API 리소스가 하위 명령으로 노출되고 출력 포맷팅, 응답 필터링, YAML 또는 JSON 파일 입력까지 지원해요.

출처: 문서

본문

[](https://platform.claude.com/docs/videos/ant-cli-demo.webm)

curl과 달리 ant는 손으로 쓴 JSON 대신 타이핑된 플래그나 파이프로 넣은 YAML에서 요청 본문을 만들고, @path 참조로 파일 내용을 문자열 필드에 인라인해 넣어요. 응답 필드 추출에는 내장 --transform 쿼리를 써서 jq 같은 별도 도구가 필요 없고, 목록 엔드포인트는 자동으로 페이징돼요.

엔드포인트별 파라미터와 응답 스키마는 [API 레퍼런스](https://platform.claude.com/docs/en/api/cli/messages/create)를 참고하세요. 이 페이지는 동작하는 명령을 만들 수 있게 해 주고, CLI가 하는 다른 모든 일은 [CLI 사용하기](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/using)와 [CLI 스크립팅과 자동화](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/scripting)에서 다뤄요.

설치 (Installation)

```bash brew install anthropics/tap/ant ``` Linux 환경에서는 릴리스 바이너리를 직접 받아요.

```bash
VERSION=1.35.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)에서 찾을 수 있어요.

`go install`로 소스에서 직접 설치할 수도 있어요. 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"
```

설치를 확인하세요:

ant --version

인증 (Authentication)

ant auth login은 Claude Console을 대상으로 브라우저 기반 OAuth 흐름을 열고, 결과로 나온 자격 증명을 로컬에 저장해요. 그래서 API 키를 만들거나 관리하지 않아도 API를 호출할 수 있어요.

ant auth login

다른 인증 방식(API 키 환경 변수, 헤드리스 호스트, 여러 워크스페이스, 이름 붙은 프로파일, Workload Identity Federation)은 [CLI 인증 옵션](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication)을 참고하세요.

첫 요청 보내기

바이너리를 설치하고 인증했다면, 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 /*, ... */ }
}

stdout이 터미널이라서 응답은 전체 API 객체가 예쁘게 출력돼요.

셸 완성 (Shell completion)

CLI는 bash, zsh, fish, PowerShell용 완성 스크립트를 제공해요. 여러분 셸에 맞는 것을 생성해 설치하세요:

```bash ant @completion zsh > "${fpath[1]}/_ant" # 셸을 다시 시작하거나: autoload -U compinit && compinit ``` ```bash ant @completion bash > /etc/bash_completion.d/ant ``` ```bash ant @completion fish > ~/.config/fish/completions/ant.fish ``` ```powershell ant @completion powershell | Out-String | Invoke-Expression # 세션 간 유지하려면: # ant @completion powershell >> $PROFILE ```

다음 단계

API 키, 헤드리스 호스트, 여러 워크스페이스, 이름 붙은 프로파일 명령 구조, 출력 포맷, GJSON 변환, 요청 본문 API 리소스 버전 관리, 스크립팅 패턴, Claude Code에서 사용하기

CLI 퀵스타트