> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 브라우저 모드 선택

> 독립 Chrome 또는 로그인된 Chrome이나 Edge 프로필을 선택하고 우선순위를 구성한 뒤 Octoparse CLI 브라우저 준비 상태를 확인하세요.

Octoparse CLI는 `run`과 `detect`에 두 가지 브라우저 모드를 지원합니다.

| 모드            | 브라우저 및 프로필                      | 적합한 용도                       |
| ------------- | ------------------------------- | ---------------------------- |
| `independent` | 임시 프로필을 사용하는 Chrome for Testing | 깔끔하고 반복 가능한 로컬 실행 및 헤드리스 자동화 |
| `user`        | 기존 프로필을 사용하는 시스템 Chrome 또는 Edge | 저장된 쿠키나 로그인 상태가 필요한 사이트      |

사용자 모드는 Windows와 macOS에서 지원됩니다. Linux는 독립 Chrome을 사용합니다.

## 브라우저 선택 우선순위

CLI는 다음 순서로 브라우저를 선택합니다.

```text theme={null}
1. --browser 플래그
2. OCTOPARSE_BROWSER 환경 변수
3. 저장된 octoparse browser use 설정
4. independent
```

## 사용 가능한 프로필 확인

```bash theme={null}
octoparse browser status --browser-id chrome --json
octoparse browser profiles --browser-id chrome --json
```

## 사용자 브라우저 확장 프로그램 설치

설치 중에는 선택한 브라우저를 완전히 닫아야 합니다.

```bash theme={null}
octoparse browser install \
  --browser-id chrome \
  --profile "Default" \
  --force-close \
  --json
```

브라우저를 한 번 다시 열고 확장 프로그램이 활성화되었는지 확인한 후 상태를 다시 확인하세요.

```bash theme={null}
octoparse browser status --browser-id chrome --profile "Default" --json
```

JSON 모드에서는 `readyForUserBrowserRun`이 `true`가 될 때까지 `data.nextActions` 또는 `error.details.nextActions`를 따르세요.

## 브라우저 모드 저장 또는 재정의

```bash theme={null}
octoparse browser use user --browser-id chrome --profile "Default" --json
octoparse browser use status
octoparse browser use independent
```

명령 하나에 대해 저장된 선택을 재정의합니다.

```bash theme={null}
octoparse run <taskId> --browser user --profile "Default"
octoparse detect <url> --browser independent --auto
```

사용자 모드는 `--headless`를 지원하지 않습니다.

## 환경 변수

```bash theme={null}
OCTOPARSE_BROWSER=user octoparse run <taskId>
OCTOPARSE_BROWSER=user OCTOPARSE_BROWSER_ID=chrome OCTOPARSE_BROWSER_PROFILE=Default octoparse run <taskId>
```

## 문제 해결

```bash theme={null}
octoparse browser close --browser-id chrome --profile "Default" --json
octoparse browser status --browser-id chrome --profile "Default" --json
octoparse doctor --json
```

Chrome 다운로드, Linux 디스플레이 요구 사항 및 사용자 브라우저 설정 오류는 [문제 해결](../reference/troubleshooting#chrome-and-browser-errors)을 참고하세요.