app/browser.md Codex Docs, 2026-04-18 18:18 UTC → 2026-05-13 00:57 UTC

6 6 

7Use it for local development servers, file-backed previews, and public pages7Use it for local development servers, file-backed previews, and public pages

8that don't require sign-in. For anything that depends on login state or browser8that don't require sign-in. For anything that depends on login state or browser

9extensions, use your regular browser.9extensions, use your regular browser or the

10[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension).

10 11 

11Open the in-app browser from the toolbar, by clicking a URL, by navigating12Open the in-app browser from the toolbar, by clicking a URL, by navigating

12manually in the browser, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>13manually in the browser, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>

18 19 

19Treat page content as untrusted context. Don't paste secrets into browser flows.20Treat page content as untrusted context. Don't paste secrets into browser flows.

20 21 

21![Codex app showing a browser comment on a local web app preview](/images/codex/app/in-app-browser-light.webp)22<CodexScreenshot

23 alt="Codex app showing a browser comment on a local web app preview"

24 lightSrc="/images/codex/app/in-app-browser-light.webp"

25 darkSrc="/images/codex/app/in-app-browser-dark.webp"

26 maxHeight="420px"

27 variant="no-wallpaper"

28/>

29 

30## Browser use

31 

32Browser use lets Codex operate the in-app browser directly. Use it for local

33development servers and file-backed previews when Codex needs to click, type,

34inspect rendered state, take screenshots, or verify a fix in the page.

35 

36To use it, install and enable the Browser plugin. Then ask Codex to use the

37browser in your task, or reference it directly with `@Browser`. The app keeps

38browser use inside the in-app browser and lets you manage allowed and blocked

39websites from settings.

40 

41Example:

42 

43```text

44Use the browser to open http://localhost:3000/settings, reproduce the layout

45bug, and fix only the overflowing controls.

46```

47 

48Codex asks before using a website unless you've allowed it. Removing a site from

49the allowed list means Codex asks again before using it; removing a site from the

50blocked list means Codex can ask again instead of treating it as blocked.

51 

52For signed-in websites in Chrome, see

53[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension).

22 54 

23## Preview a page55## Preview a page

24 56