CLI 빠른 시작

ant CLI는 터미널에서 Claude API에 접근할 수 있게 해줍니다. 모든 API 리소스가 하위 명령으로 제공되며, 출력 포맷팅, 응답 필터링, YAML 또는 JSON 파일 입력을 지원합니다.

curl과 비교하면, ant는 직접 작성한 JSON 대신 타입이 지정된 플래그나 파이프로 전달된 YAML로부터 요청 본문을 구성하고, @path 참조를 사용하여 파일 내용을 문자열 필드에 인라인으로 삽입합니다. 내장된 --transform 쿼리로 응답 필드를 추출하므로 jq와 같은 별도의 도구가 필요 없으며, 목록 엔드포인트의 페이지네이션을 자동으로 처리합니다.



설치

brew install anthropics/tap/ant

설치를 확인하세요:

ant --version



인증

ant auth login은 Claude Console에 대한 브라우저 기반 OAuth 흐름을 열고 결과로 얻은 자격 증명을 로컬에 저장하므로, API 키를 생성하거나 관리하지 않고도 API를 호출할 수 있습니다.

ant auth login



첫 번째 요청 보내기

바이너리를 설치하고 인증을 완료했다면, Messages API를 호출하세요:

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

{
  "model": "claude-opus-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용 자동 완성 스크립트를 제공합니다. 사용 중인 셸에 맞는 스크립트를 생성하고 설치하세요:

ant @completion zsh > "${fpath[1]}/_ant"
# 셸을 다시 시작하거나 다음을 실행하세요: autoload -U compinit && compinit



다음 단계