OpenAI 공식 CLI 도구 공개
원제 OpenAI CLI
108 포인트댓글 66
Key Point
개발자들이 터미널에서 직접 OpenAI API를 호출할 수 있게 되어 스크립트 자동화와 CI/CD 파이프라인 통합이 가능해졌다.
핵심 요약
- OpenAI REST API를 사용하기 위한 공식 CLI를 깃허브에 공개했으며, Homebrew 또는 Go 1.26 이상으로 설치할 수 있다.
- 리소스 기반 명령 구조를 따르며 일반 API는 OPENAI_API_KEY, 관리자 기능은 OPENAI_ADMIN_KEY로 인증한다.
- 텍스트 기본 출력을 제공하고 --format으로 json, jsonl, yaml, raw 등으로 변환 가능하며, --transform으로 GJSON 문법을 이용한 데이터 추출이 가능하다.
- 이미지 생성 시 자동으로 ~/Downloads/gpt-images/에 저장되고 gpt-image-2.5-sunburst 모델을 기본값으로 사용하며, 저장된 이미지는 openai images preview로 재표시할 수 있다.
- 파일 업로드/다운로드, 관리자 엔드포인트 접근, mTLS 인증(베타), HTTP/SOCKS 프록시 지원 등의 기능을 갖춘다.
- @filename 문법으로 로컬 파일을 JSON 값으로 읽을 수 있으며, OPENAI_UNTRUSTED_STDIN=1로 신뢰할 수 없는 파일 참조를 차단할 수 있다.
- --header로 커스텀 요청 헤더를 추가할 수 있고, 자격증명 헤더는 OPENAI_CUSTOM_HEADERS 환경변수로 관리하여 셸 히스토리에 기록되지 않도록 한다.
- 오류는 기본적으로 읽기 쉬운 요약으로 출력되며 --format-error json으로 API 원본 오류 상세정보를 볼 수 있고, --transform-error로 추출이 가능하다.
- 스크립트의 ./scripts/link로 다른 버전의 OpenAI Go SDK를 연동할 수 있으며, 버그 보고와 기능 요청은 깃허브 이슈로 받는다.
- Apache License 2.0으로 배포되며, 풀 리퀘스트는 저장소 협력자만 가능하고 보안 취약점은 SECURITY.md 정책을 따른다.