> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ko/platform/cli.md).

# CLI

Roboflow CLI 명령, 전역 플래그, JSON 출력, 리소스 축약형, 편의 별칭 참고 자료.

Roboflow Python 패키지에는 CLI(`pip install roboflow`)이 포함되어 있어 명령줄에서 Roboflow 플랫폼을 사용할 수 있습니다. 이는 일관된 `roboflow <noun> <verb>` 패턴을 따르며, AI 코딩 에이전트와 자동화 도구에서 사용할 수 있도록 구조화된 JSON 출력을 지원합니다.

## 명령어

<table data-search="false"><thead><tr><th>명령어</th><th>설명</th></tr></thead><tbody><tr><td><code>인증</code></td><td>로그인, 로그아웃, 상태 확인, 기본 작업공간 설정</td></tr><tr><td><code>작업공간</code></td><td>작업공간 목록 조회 및 검사</td></tr><tr><td><code>프로젝트</code></td><td>프로젝트 목록 조회, 가져오기, 생성</td></tr><tr><td><code>버전</code></td><td>데이터셋 버전 목록 조회, 가져오기, 다운로드, 내보내기</td></tr><tr><td><code>이미지</code></td><td>이미지 업로드, 가져오기, 검색, 태그 지정, 삭제, 주석 추가</td></tr><tr><td><code>모델</code></td><td>학습된 모델 목록 조회, 가져오기, 업로드</td></tr><tr><td><code>학습</code></td><td>모델 학습 시작</td></tr><tr><td><code>추론</code></td><td>이미지에서 추론 실행</td></tr><tr><td><code>검색</code></td><td>작업공간 이미지 검색 및 결과 내보내기</td></tr><tr><td><code>배포</code></td><td>전용 배포 관리</td></tr><tr><td><code>워크플로</code></td><td>워크플로 관리</td></tr><tr><td><code>폴더</code></td><td>작업공간 폴더 관리</td></tr><tr><td><code>주석</code></td><td>주석 배치 및 작업</td></tr><tr><td><code>자동 라벨링</code></td><td>기반 모델 또는 Roboflow 모델로 배치 자동 라벨링</td></tr><tr><td><code>Universe</code></td><td>Roboflow Universe 검색</td></tr><tr><td><code>비디오</code></td><td>비디오 추론</td></tr><tr><td><code>배치</code></td><td>실행 및 관리 <a href="https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing#asset-library-images">Asset Library 이미지에서 배치 처리 작업</a></td></tr><tr><td><code>자동 완성</code></td><td>셸 자동 완성 스크립트 생성(bash, zsh, fish)</td></tr></tbody></table>

실행 `roboflow <command> --help` 를 사용하면 각 명령의 세부 정보를 확인할 수 있습니다.

## 전역 플래그

이 플래그는 모든 명령에서 작동하며 하위 명령 앞이나 뒤에 올 수 있습니다:

<table data-search="false"><thead><tr><th>플래그</th><th>축약형</th><th>설명</th></tr></thead><tbody><tr><td><code>--json</code></td><td><code>-j</code></td><td>결과를 구조화된 JSON으로 출력(에이전트 및 파이핑용)</td></tr><tr><td><code>--api-key</code></td><td><code>-k</code></td><td>API 키 재정의</td></tr><tr><td><code>--workspace</code></td><td><code>-w</code></td><td>작업공간 재정의</td></tr><tr><td><code>--quiet</code></td><td><code>-q</code></td><td>진행 표시줄과 상태 메시지 표시 안 함</td></tr><tr><td><code>--version</code></td><td></td><td>패키지 버전 표시</td></tr></tbody></table>

## 에이전트를 위한 JSON 출력

모든 명령은 `--json` 파이프 처리와 프로그래밍 방식 파싱에 안전한 구조화된 출력을 위해 지원합니다:

```bash
roboflow --json project list | jq '.[0].id'
```

JSON 모드의 오류는 빈 stdout과 함께 stderr로 출력되므로 파이핑에 안전합니다:

```bash
roboflow --json project get nonexistent 2>error.json
# stdout는 비어 있고, stderr에는 다음이 포함됩니다: {"error": {"message": "...", "hint": "..."}}
```

종료 코드는 일관됩니다: 0 = 성공, 1 = 오류, 2 = 인증 오류, 3 = 찾을 수 없음.

## 리소스 축약형

리소스는 간단한 식별자로 지정할 수 있습니다:

<table data-search="false"><thead><tr><th>축약형</th><th>의미</th></tr></thead><tbody><tr><td><code>my-project</code></td><td>기본 작업공간을 사용</td></tr><tr><td><code>my-ws/my-project</code></td><td>명시적 작업공간</td></tr><tr><td><code>my-project/3</code></td><td>기본 작업공간, 버전 3</td></tr><tr><td><code>my-ws/my-project/3</code></td><td>명시적 작업공간, 버전 3</td></tr></tbody></table>

버전 번호는 항상 숫자이므로 `x/y` y가 숫자일 때는 프로젝트 버전을 식별하고 `y` 그렇지 않으면 작업공간/프로젝트 쌍입니다.

## 편의 별칭

일반적인 작업에는 짧은 최상위 별칭이 있습니다:

<table data-search="false"><thead><tr><th>별칭</th><th>동일한 명령</th></tr></thead><tbody><tr><td><code>roboflow login</code></td><td><code>roboflow auth login</code></td></tr><tr><td><code>roboflow whoami</code></td><td><code>roboflow auth status</code></td></tr><tr><td><code>roboflow upload</code></td><td><code>roboflow image upload</code></td></tr><tr><td><code>roboflow download</code></td><td><code>roboflow version download</code></td></tr></tbody></table>
