> ## 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.

# ブラウザモードを選択

> Octoparse CLIのrunとdetectで、独立Chromeまたはログイン済みChrome・Edgeプロファイルを選択します。

Octoparse CLIの `run` と `detect` では2種類のブラウザモードを使用できます。

| モード           | ブラウザとプロファイル                 | 適した用途                 |
| ------------- | --------------------------- | --------------------- |
| `independent` | 一時プロファイルのChrome for Testing | 再現性の高いローカル実行、ヘッドレス自動化 |
| `user`        | 既存プロファイルのシステムChromeまたはEdge  | Cookieやログイン状態が必要なサイト  |

userモードはWindowsとmacOSで利用できます。Linuxではindependent Chromeを使用します。

## 選択優先順位

```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
```

## userブラウザ拡張をインストールする

インストール中は対象ブラウザを完全に終了する必要があります。

```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
```

userモードは `--headless` をサポートしません。

## 環境変数

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

問題が発生した場合は[トラブルシューティング](../reference/troubleshooting#chromeおよびブラウザエラー)を参照してください。