> 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/environment-variables.md).

# 환경 변수

Roboflow CLI와 Python SDK는 소수의 환경 변수를 읽습니다. 셸이나 CI 환경에 이를 설정하면 모든 명령마다 자격 증명과 구성을 전달할 필요가 없습니다.

{% hint style="info" %}
자체 호스팅된 [추론 서버](https://docs.roboflow.com/deployment/self-hosted/self-hosted) 는 별도로, 훨씬 더 많은 변수 집합으로 구성됩니다. 참조: [추론 서버 환경 변수](https://docs.roboflow.com/deployment/self-hosted/inference-server/configuration/environment-variables).
{% endhint %}

## `ROBOFLOW_API_KEY`

Roboflow API 키입니다. 다음에서 사용됩니다:

* **CLI** - 모든 명령은 다음 경우에 이것으로 대체됩니다 `--api-key` / `-k` 가 전달되지 않았을 때.
* **Python SDK** - `roboflow.Roboflow()` (인수 없이)와 대부분의 어댑터 함수는 명시적인 키가 제공되지 않을 때 이를 읽습니다.

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

```python
import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY를 자동으로 가져옵니다
```

키는 다음에서 찾을 수 있습니다: [Roboflow 웹 앱의 Settings → API Key에서](https://app.roboflow.com/settings/api).

## `ROBOFLOW_CONFIG_DIR`

CLI가 인증 자격 증명과 설정된 기본 작업공간을 저장하는 위치를 재정의합니다. 기본값: `~/.config/roboflow/`.

```bash
export ROBOFLOW_CONFIG_DIR=/etc/roboflow
roboflow login
# 자격 증명은 /etc/roboflow/config.json에 저장됩니다
```

CI, 컨테이너 빌드, 또는 동일한 머신에서 여러 Roboflow 계정을 나란히 실행할 때 유용합니다.

## `API_URL`

SDK와 CLI가 REST API 요청을 보내는 기본 URL을 재정의합니다. 기본값: `https://api.roboflow.com`.

이것을 설정할 필요는 없습니다. 이는 사전 프로덕션 환경에 대한 Roboflow 내부 테스트용으로 존재합니다.

## `DEDICATED_DEPLOYMENT_URL`

dedicated-deployments 서비스의 기본 URL을 재정의합니다. 기본값: `https://roboflow.cloud`.

이것을 설정할 필요는 없습니다. 이는 사전 프로덕션 환경에 대한 Roboflow 내부 테스트용으로 존재합니다.

## 우선순위

같은 값을 여러 방식으로 제공할 수 있을 때, 우선순위 순서는 다음과 같습니다(높은 순서부터):

1. **명시적 플래그** - 예: `--api-key` CLI 명령에서, 또는 `api_key` Python 함수의 인수.
2. **환경 변수** - 예: `ROBOFLOW_API_KEY`.
3. **디스크에 저장된 구성** - 예: `~/.config/roboflow/config.json` CLI가 저장한 자격 증명용.
4. **내장 기본값** - 다음과 같은 비밀이 아닌 값에만 해당: `API_URL`.

## CI / 에이전트 권장 사항

CI 또는 AI 에이전트 환경에서는 다음을 사용하는 것이 좋습니다: `ROBOFLOW_API_KEY` 보다 `roboflow login`. 환경 변수 경로는 대화형 프롬프트가 필요 없고, 디스크 상태도 남기지 않으며, 비밀 저장소에서 키를 교체하면 깔끔하게 회전됩니다.

```yaml
# GitHub Actions 예시
env:
  ROBOFLOW_API_KEY: ${{ secrets.ROBOFLOW_API_KEY }}
```