> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-cursor-proxy-indicator-and-text-6cda.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxies & Stealth

> Configure anti-detect browsers with CAPTCHA solving and residential proxies in 195+ countries.

## Stealth by default

Every Browser Use Cloud session runs on stealth infrastructure. No configuration needed.

* **Anti-detect browser fingerprinting** — undetectable as automation
* **Automatic CAPTCHA solving** — CAPTCHAs are handled transparently
* **Ad and cookie banner blocking** — clean pages, faster execution
* **Cloudflare / anti-bot bypass** — works on protected sites

<Info>
  Stealth is always on. You do not need to configure anything. If you are searching for "captcha" — it is handled automatically.
</Info>

## Country proxies

A US residential proxy is always active by default — no configuration needed. To route through a different country, set `proxyCountryCode` on the session or inline via `sessionSettings`.

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk import AsyncBrowserUse

  client = AsyncBrowserUse()

  # Via session — US proxy is the default, override to route through Germany
  session = await client.sessions.create(proxy_country_code="de")
  result = await client.run("Get the price of iPhone 16 on amazon.de", session_id=session.id)

  # Or inline via session_settings (auto-creates session)
  result = await client.run(
      "Get the price of iPhone 16 on amazon.de",
      session_settings={"proxyCountryCode": "de"},
  )
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk";

  const client = new BrowserUse();

  // Via session — US proxy is the default, override to route through Germany
  const session = await client.sessions.create({ proxyCountryCode: "de" });
  const result = await client.run("Get the price of iPhone 16 on amazon.de", {
    sessionId: session.id,
  });

  // Or inline
  const result = await client.run("Get the price of iPhone 16 on amazon.de", {
    sessionSettings: { proxyCountryCode: "de" },
  });
  ```
</CodeGroup>

Common country codes: `us`, `gb`, `de`, `fr`, `jp`, `au`, `br`, `in`, `kr`, `ca`, `es`, `it`, `nl`, `se`, `sg`.

<Warning>
  The default is always `us`. This applies to auto-sessions (`run()` without a `session_id`), manually created sessions, and browser sessions — unless you explicitly set a different country code.
</Warning>

## Custom proxy

Bring your own proxy server (HTTP or SOCKS5).

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk import AsyncBrowserUse, CustomProxy

  client = AsyncBrowserUse()
  session = await client.sessions.create(
      custom_proxy=CustomProxy(
          url="http://proxy.example.com:8080",
          username="user",
          password="pass",
      ),
  )
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk";

  const client = new BrowserUse();
  const session = await client.sessions.create({
    customProxy: {
      url: "http://proxy.example.com:8080",
      username: "user",
      password: "pass",
    },
  });
  ```
</CodeGroup>

Proxy is a session-level setting. All tasks in the same session use the same proxy. See [Models & Pricing](/cloud/pricing) for proxy costs.

## Disabling proxies

<Warning>
  Only disable proxies for localhost testing or sites that allowlist your server IP. They reduce blocks and fingerprinting.
</Warning>

To disable the built-in proxy, set `proxyCountryCode` to `null` on sessions, tasks (via `sessionSettings`), or browser sessions.

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk import AsyncBrowserUse, SessionSettings

  client = AsyncBrowserUse()

  # Session — no proxy
  session = await client.sessions.create(proxy_country_code=None)

  # Task with inline session settings — no proxy
  result = await client.run(
      "Go to http://localhost:3000 and check the homepage",
      session_settings=SessionSettings(proxy_country_code=None),
  )

  # Browser session — no proxy
  browser = await client.browsers.create(proxy_country_code=None)
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk";

  const client = new BrowserUse();

  // Session — no proxy
  const session = await client.sessions.create({ proxyCountryCode: null });

  // Task with inline session settings — no proxy
  const result = await client.run("Go to http://localhost:3000 and check the homepage", {
    sessionSettings: { proxyCountryCode: null },
  });

  // Browser session — no proxy
  const browser = await client.browsers.create({ proxyCountryCode: null });
  ```
</CodeGroup>

For the V3 API:

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk.v3 import AsyncBrowserUse

  client = AsyncBrowserUse()
  result = await client.run(
      "Go to http://localhost:3000 and check the homepage",
      proxy_country_code=None,
  )
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk/v3";

  const client = new BrowserUse();
  const result = await client.run("Go to http://localhost:3000 and check the homepage", {
    proxyCountryCode: null,
  });
  ```
</CodeGroup>

<Info>
  The US proxy is active by default on every session. To disable it for an auto-session (v2), pass `sessionSettings` with `proxyCountryCode: null` — omitting `sessionSettings` entirely leaves the default US proxy on.
</Info>