Claude Platform Docs

CLI 빠른 시작

ant 명령줄 도구를 설치하고, 인증한 다음, Claude API에 첫 번째 요청을 보냅니다.

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

동작 중인 ant CLI.

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

설치

brew install anthropics/tap/ant

설치를 확인하세요:

ant --version

인증

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

CLI
ant auth login

첫 번째 요청 보내기

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

ant messages create \
  --model claude-opus-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'
Output
{
  "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

다음 단계

CLI 인증 옵션

API 키, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필

CLI 사용하기

명령 구조, 출력 형식, GJSON 변환, 요청 본문

CLI 스크립팅 및 자동화

API 리소스 버전 관리, 스크립팅 패턴, Claude Code에서의 사용

Was this page helpful?