CLI, SDK 및 라이브러리ant CLI

CLI 빠른 시작

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

ant CLI는 터미널에서 Claude API에 접근할 수 있게 해줍니다. 모든 API 리소스가 하위 명령어로 제공되며, 출력 형식 지정, 응답 필터링, YAML 또는 JSON 파일 입력 지원 기능을 통해 대화형 탐색과 자동화 모두에 실용적으로 사용할 수 있습니다.

curl로 API를 호출하는 것과 비교하면, ant는 직접 작성한 JSON 대신 타입이 지정된 플래그나 파이프로 전달된 YAML로 요청 본문을 구성할 수 있고, @path 참조로 파일 내용을 문자열 필드에 인라인으로 삽입할 수 있으며, 내장된 --transform 쿼리로 응답에서 필드를 추출할 수 있습니다(별도의 JSON 도구가 필요하지 않음). 목록 엔드포인트는 자동으로 페이지네이션됩니다. Claude Code는 ant를 기본적으로 지원합니다.

엔드포인트별 매개변수와 응답 스키마는 API 레퍼런스를 참조하세요. 이 페이지는 작동하는 명령어를 실행하는 데까지 안내합니다. CLI가 제공하는 그 외 모든 기능은 CLI 사용하기와 CLI 스크립팅 및 자동화를 참조하세요.

설치

설치를 확인하세요:

ant --version

인증

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

CLI

ant auth login

다른 인증 방법(API 키 환경 변수, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필, Workload Identity Federation)은 CLI 인증 옵션을 참조하세요.

첫 번째 요청 보내기

바이너리가 설치되고 인증이 완료되면 Messages API를 호출하세요:

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

Output

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

다음 단계

CLI 인증 옵션: API 키, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필
CLI 사용하기: 명령어 구조, 출력 형식, GJSON 변환, 요청 본문
CLI 스크립팅 및 자동화: API 리소스 버전 관리, 스크립팅 패턴, Claude Code에서의 사용

Was this page helpful?

CLI, SDK 및 라이브러리ant CLI

CLI 빠른 시작

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

설치

설치를 확인하세요:

ant --version

인증

CLI

ant auth login

다른 인증 방법(API 키 환경 변수, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필, Workload Identity Federation)은 CLI 인증 옵션을 참조하세요.

첫 번째 요청 보내기

바이너리가 설치되고 인증이 완료되면 Messages API를 호출하세요:

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

Output

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

다음 단계

CLI 인증 옵션: API 키, 헤드리스 호스트, 여러 워크스페이스, 명명된 프로필
CLI 사용하기: 명령어 구조, 출력 형식, GJSON 변환, 요청 본문
CLI 스크립팅 및 자동화: API 리소스 버전 관리, 스크립팅 패턴, Claude Code에서의 사용

Was this page helpful?