> 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 Python 패키지에는 CLI(`pip install roboflow`)가 포함되어 있으며, 이를 사용해 명령줄에서 Roboflow 플랫폼과 작업할 수 있습니다. 이 CLI는 일관된 `roboflow <noun> <verb>` 형식을 따르며, AI 코딩 에이전트 및 자동화 도구에서 사용할 수 있도록 구조화된 JSON 출력을 지원합니다.

## 명령

| 명령          | 설명                                 |
| ----------- | ---------------------------------- |
| `인증`        | 로그인, 로그아웃, 상태 확인, 기본 워크스페이스 설정     |
| `workspace` | 워크스페이스 목록 조회 및 검사                  |
| `프로젝트`      | 프로젝트 목록 조회, 조회 및 생성                |
| `버전`        | 데이터셋 버전 목록 조회, 조회, 다운로드 및 내보내기     |
| `image`     | 이미지 업로드, 조회, 검색, 태그 지정, 삭제 및 주석 처리 |
| `모델`        | 학습된 모델 목록 조회, 조회 및 업로드             |
| `학습`        | 모델 학습 시작                           |
| `infer`     | 이미지에서 추론 실행                        |
| `검색`        | 워크스페이스 이미지를 검색하고 결과를 내보내기          |
| `배포`        | 전용 배포 관리                           |
| `워크플로로`     | 워크플로 관리                            |
| `폴더`        | 워크스페이스 폴더 관리                       |
| `주석`        | 주석 배치 및 작업                         |
| `유니버스`      | Roboflow Universe 검색               |
| `비디오`       | 비디오 추론                             |
| `배치`        | 배치 처리 작업 *(출시 예정)*                 |
| `자동 완성`     | 셸 자동 완성 스크립트 생성(bash, zsh, fish)   |

실행 `roboflow <command> --help` 를 실행하세요.

## 전역 플래그

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

| 플래그           | 단축   | 설명                              |
| ------------- | ---- | ------------------------------- |
| `--json`      | `-j` | 결과를 구조화된 JSON으로 출력(에이전트 및 파이핑용) |
| `--api-key`   | `-k` | API 키 재정의                       |
| `--workspace` | `-w` | 워크스페이스 재정의                      |
| `--quiet`     | `-q` | 진행 표시줄과 상태 메시지를 숨김              |
| `--version`   |      | 패키지 버전 표시                       |

## 에이전트를 위한 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 = 찾을 수 없음.

## 리소스 축약 표기

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

| 축약 표기                | 의미               |
| -------------------- | ---------------- |
| `my-project`         | 기본 워크스페이스를 사용합니다 |
| `my-ws/my-project`   | 명시적 워크스페이스       |
| `my-project/3`       | 기본 워크스페이스, 버전 3  |
| `my-ws/my-project/3` | 명시적 워크스페이스, 버전 3 |

버전 번호는 항상 숫자입니다. 이것이 `x/y` 가 구분되는 방식입니다 `워크스페이스/프로젝트` 및 `프로젝트/버전`.

## 편의 별칭

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

| 별칭                  | 동일 명령                       |
| ------------------- | --------------------------- |
| `roboflow login`    | `roboflow auth login`       |
| `roboflow whoami`   | `roboflow auth status`      |
| `roboflow upload`   | `roboflow image upload`     |
| `roboflow download` | `roboflow version download` |