Change the IP country of a Codex-controlled browser

This page as markdown: https://aluvia.io/geo/codex.md

Updated 2026-09-08 · Aluvia

The IP a website sees belongs to the machine making the browser request. Before setting up Aluvia for a Codex task, identify that machine.

Check where the browser runs

These instructions apply when Codex can run commands on the host of the Chrome browser used for the task. Running setup in a repository container does not configure a browser hosted on a different machine.

Start with setup

npx aluvia-cli setup

First 10 MB free without an account, API key or payment; then 2 USD per GB. Requires Node.js 18 or later, a usable local Chrome or Chromium browser, and command access to its host. No target page URL is required. Initial configuration can restart Chrome. Quickstart, setup changes, runtime evidence.

Check setup before continuing

Read the JSON result. ready: true confirms the browser/proxy path and upstream check, not target-site access. Follow next if recovery is needed. Successful setup already enables proxy traffic. If aluvia is not on PATH, use npx aluvia-cli instead.

Check country availability

Choose the country the task needs from the current list. The command below is an example; substitute an available country or skip selection if the global pool is suitable.

aluvia geos

Verify the browser task

After setup reports readiness, choose a country and reload the page using the same browser tool. Check the page's regional content, not only the CLI status. If the browser tool is remote and you cannot configure its host, these local setup steps do not apply.

aluvia proxy-on --geo US

Limits

Aluvia does not change OpenAI model availability or access permissions. It also does not automatically proxy every shell command or built-in web search tool.

Reload and verify

Reload the target using the same browser tool and check the required content. Run status and follow its next field. For a suspected IP refusal, rotate once and reload; stop if it still fails. For a rate limit, wait and reduce requests.

aluvia status

Undo the IP change

When finished, return to the machine's IP. After setup, this keeps Chrome running.

aluvia proxy-off

When the trial ends

Show the actual claim_url from payment_required to the operator. They can claim the account and buy data at 2 USD per GB. Run aluvia auth login to wait, inspect the response and retry. Never invent a claim URL or reveal a key. Payment handoff.