> 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/python-sdk/authenticate-with-the-python-sdk.md).

# Python SDK로 인증하기

Python SDK는 API 키를 세 가지 방식으로 받습니다. 런타임에 맞는 방법을 선택하세요. 모두 결국 같은 `Roboflow` 객체.

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

설정 `ROBOFLOW_API_KEY` 쉘 또는 CI 환경에서:

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

```python
import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY를 가져옴
```

이 방법은 스크립트, 노트북, AI 코딩 에이전트에 가장 깔끔한 경로입니다. 대화형 프롬프트도 없고 디스크에 상태도 남지 않습니다.

## 옵션 2: 키를 명시적으로 전달

```python
import roboflow

rf = roboflow.Roboflow(api_key="rf_xxxxx")
```

같은 프로세스에서 여러 작업 공간에 대해 여러 키를 사용할 때 유용합니다.

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

```python
import roboflow

roboflow.login()
```

브라우저에서 인증 URL을 열고, 토큰 입력을 요청한 뒤 자격 증명을 다음 위치에 저장합니다 `~/.config/roboflow/config.json`. 이후의 `Roboflow()` 호출은(인수가 없을 때) 해당 파일에서 읽습니다.

다른 계정으로 다시 인증하거나 토큰을 새로 고치려면:

```python
roboflow.login(force=True)
```

CLI의 `roboflow login` 동일한 디스크 상 위치에 기록하므로, 어느 도구든 한 번 인증하면 다른 도구도 자격 증명을 사용합니다.

## API 키를 찾는 곳

에서 [Roboflow 웹 앱](https://app.roboflow.com/), 이동하세요 **설정 → API 키**. 각 작업 공간에는 고유한 키가 있습니다. 사용하는 키에 따라 코드가 인증되는 작업 공간이 결정됩니다.

에 대해서는 [범위가 지정된 API 키](/reference/ko/authentication/authentication/scoped-api-keys.md) (키를 특정 리소스나 작업으로 제한), 인증 섹션을 참고하세요.

## 구성 위치 재정의

자격 증명을 다음이 아닌 다른 위치에 저장해야 한다면 `~/.config/roboflow/`, 다음을 설정하세요 `ROBOFLOW_CONFIG_DIR`:

```bash
export ROBOFLOW_CONFIG_DIR=/etc/roboflow
```

다음을 참조하세요 [환경 변수](/reference/ko/environment-variables.md) 에 대해 SDK와 CLI가 인식하는 변수 전체 목록을 확인하세요.