> 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/install-and-set-up-the-cli.md).

# CLI 설치 및 설정

필요합니다 `Python >=3.10` Roboflow Python 패키지를 사용하려면.

Python을 설치한 후, 다음 명령을 실행하여 설치하세요:

```bash
pip install roboflow
```

설치한 후, CLI가 작동하는지 테스트하세요:

```bash
roboflow --help
```

## 인증

인증하는 방법은 세 가지가 있습니다:

### 옵션 1: 환경 변수(스크립트와 에이전트에 권장)

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

CI/CD, 자동화, AI 코딩 에이전트에 권장되는 방법입니다. 대화형 프롬프트가 필요하지 않습니다.

### 옵션 2: API 키 플래그

```bash
roboflow --api-key rf_xxxxx project list
```

키를 모든 명령에 직접 전달합니다. 한 번만 실행하는 명령에 유용합니다.

### 옵션 3: 대화형 로그인

```bash
roboflow login
```

브라우저에서 링크를 열고 토큰을 받은 뒤 터미널에 붙여넣으세요. 자격 증명은 다음 위치에 저장됩니다 `~/.config/roboflow/config.json` 그래서 한 번만 하면 됩니다.

다음과 같이 비대화형으로도 로그인할 수 있습니다:

```bash
roboflow auth login --api-key rf_xxxxx
```

## 인증 확인

```bash
roboflow auth status
```

현재 작업 공간과 마스킹된 API 키를 표시합니다.

## 기본 작업 공간 설정

여러 작업 공간에 접근할 수 있는 경우, 기본으로 사용할 작업 공간을 설정하세요:

```bash
roboflow auth set-workspace my-workspace-id
```

## 셸 자동 완성(선택 사항)

명령, 옵션, 인수에 대한 탭 자동 완성을 활성화하세요:

```bash
# Zsh
eval "$(roboflow completion zsh)"

# Bash(bash >= 4.4 필요)
eval "$(roboflow completion bash)"

# Fish
roboflow completion fish | source
```

영구적으로 사용하려면 `eval` 줄을 셸 프로필에 추가하세요(`~/.zshrc`, `~/.bashrc`, 등).