anthropics/anthropic-cli

ant – 공식 Claude Platform CLI

정의

ant는 Anthropic의 Claude Platform용 커맨드라인 클라이언트입니다. 터미널에서 Claude API를 직접 호출하여 채팅 메시지 전송, 에이전트, 세션, 파일, 그리고 플랫폼이 제공하는 기타 모든 엔드포인트를 관리할 수 있습니다.

중요성

원시 HTTP API에 대해 코드를 작성하지 않고도 Claude를 로컬 워크플로우, CI 파이프라인, 자동화 스크립트에 통합할 수 있는 가볍고 스크립트 가능한 방법을 제공합니다.
플랫폼의 전체 기능(에이전트, 스킬, 환경, 볼트, 배포 등)을 미러링하여 AI 리소스를 코드로 취급할 수 있습니다.

설치

Homebrew (macOS/Linux): brew install anthropics/tap/ant
Go: go install github.com/anthropics/anthropic-cli/cmd/ant@latest (Go 1.22+ 필요). 바이너리는 $(go env GOPATH)/bin에 배치됩니다.

시작하기

빠른 메시지를 보냅니다:

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

Google Cloud 호스팅 워크스페이스의 경우 gcloud auth application-default login으로 로그인하고 필요한 ANTHROPIC_GOOGLE_CLOUD_* 변수를 내보냅니다.

핵심 명령 스타일

리소스는 ant <resource>[:<subresource>] <command> [flags]로 지정합니다.
예:
- ant models list – 사용 가능한 Claude 모델 목록.
- ant messages create … – 채팅 완성 생성.
- ant beta:agents list – 베타 단계 에이전트 목록.
- ant apply … – 로컬 파일과 원격 리소스 조정(아래 참조).

에이전트 및 기타 리소스를 코드로 관리

ant apply는 Markdown(에이전트, 배포) 및 YAML(환경, 볼트, 스킬 정의) 파일의 디렉토리 트리를 읽고 Claude에서 해당 객체를 생성/업데이트합니다.
잠금 파일(claude-lock.json)은 원격 ID와 버전 해시를 기록하여 반복 가능한 배포와 안전한 CI 실행을 가능하게 합니다.
파일은 원시 ID 대신 경로로 서로 참조하므로 구성이 이식 가능하고 버전 관리됩니다.
--dry-run, --prune, --force, --upgrade 같은 플래그로 적용할 변경 사항을 세밀하게 제어할 수 있습니다.

CI 통합

README에는 main에 푸시할 때마다 ant apply를 실행하는 GitHub Actions 워크플로우가 포함되어 있으며, API 키 저장을 피하기 위해 워크로드 ID 연합을 사용합니다. 적용 성공 후 업데이트된 잠금 파일을 커밋합니다.

지원 플랫폼

라이선스

요약 ant는 Claude의 강력한 LLM 및 에이전트 기능을 일급 개발자 도구로 전환하여 다른 인프라와 마찬가지로 AI 리소스를 스크립트화, 자동화, 버전 관리할 수 있게 합니다.