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

# Scegli una modalità browser

> Scegli Chrome indipendente o un profilo Chrome o Edge con accesso effettuato, configura la priorità di selezione e verifica che il browser sia pronto per la CLI.

La CLI di Octoparse supporta due modalità browser per `run` e `detect`.

| Modalità      | Browser e profilo                                 | Ideale per                                                                 |
| ------------- | ------------------------------------------------- | -------------------------------------------------------------------------- |
| `independent` | Chrome for Testing con un profilo temporaneo      | Esecuzioni locali pulite e ripetibili e automazione headless               |
| `user`        | Chrome o Edge di sistema con un profilo esistente | Siti che dipendono da Cookie salvati o da uno stato con accesso effettuato |

La modalità utente è supportata su Windows e macOS. Linux usa Chrome indipendente.

## Priorità di selezione del browser

La CLI seleziona il browser in questo ordine:

```text theme={null}
1. flag --browser
2. variabile di ambiente OCTOPARSE_BROWSER
3. impostazione octoparse browser use salvata
4. independent
```

## Controlla i profili disponibili

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

## Installa l'estensione browser utente

Il browser selezionato deve essere completamente chiuso durante l'installazione.

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

Riapri il browser una volta, verifica che l'estensione sia abilitata e controlla nuovamente lo stato:

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

In modalità JSON, segui `data.nextActions` o `error.details.nextActions` finché `readyForUserBrowserRun` non è `true`.

## Salva o sostituisci la modalità browser

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

Sostituisci la scelta salvata per un singolo comando:

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

La modalità utente non supporta `--headless`.

## Variabili di ambiente

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

## Risoluzione dei problemi

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

Consulta [Risoluzione dei problemi](../reference/troubleshooting#chrome-and-browser-errors) per i download di Chrome, i requisiti di visualizzazione di Linux e gli errori di configurazione del browser utente.