1# Codex Chrome extension – Codex app1# Chrome extension
2 2
3The Codex Chrome extension lets Codex use Chrome for browser tasks that need3Use ChatGPT with Chrome for browser tasks that need your signed-in browser
4your signed-in browser state. Use it when Codex needs to read or act on sites4state. Use it when ChatGPT needs to read or act on sites such as LinkedIn,
5such as LinkedIn, Salesforce, Gmail, or internal tools.5Salesforce, Gmail, or internal tools.
6 6
7For local development servers, file-backed previews, and public pages that do7For local development servers, file-backed previews, and public pages that do
8not require sign-in, use the [in-app browser](https://developers.openai.com/codex/app/browser) first. The8not require sign-in, use the [built-in browser](https://learn.chatgpt.com/docs/browser?surface=app) first. The
9in-app browser keeps preview and verification work inside Codex without using9built-in browser keeps preview and verification work inside ChatGPT without using
10your Chrome profile.10your Chrome profile.
11 11
12Codex can also switch between tools as a task requires, using plugins when a12ChatGPT can also switch between tools as a task requires, using plugins when a
13dedicated integration is available, Chrome when it needs logged-in browser13dedicated integration is available, Chrome when it needs logged-in browser
14context, and the in-app browser for localhost.14context, and the built-in browser for localhost.
15 15
16Treat page content as untrusted context, and review the website before allowing Codex to continue.16<div className="not-prose my-4">
17 <Alert
18 client:load
19 color="warning"
20 variant="soft"
21 description="Treat page content as untrusted context, and review the website before allowing ChatGPT to continue."
22 />
23</div>
17 24
18## Set up Chrome from Plugins25## Set up Chrome from Plugins
19 26
20Set up the extension from Codex:27Install the Chrome plugin to start setup:
21 28
221. Open Codex and go to **Plugins**.291. Open the ChatGPT desktop app, select ChatGPT Work or Codex, and go to **Plugins**.
232. Add the **Chrome** plugin.302. Add the **Chrome** plugin.
243. Follow the setup flow. It guides you through installing the [Codex Chrome313. Follow the setup flow. It guides you through installing the [Chrome
25 extension](https://chromewebstore.google.com/detail/codex/hehggadaopoacecdllhhajmbjkdcmajg)32 extension](https://chromewebstore.google.com/detail/codex/hehggadaopoacecdllhhajmbjkdcmajg)
26 and approving Chrome’s permission prompts.33 and approving Chrome's permission prompts.
274. Open Chrome and confirm the Codex extension shows **Connected**.344. Open Chrome and confirm the extension shows **Connected**.
28 35
29After the plugin setup is complete, start a new Codex thread. Codex can suggest36After the plugin setup is complete, start a new task in Work or Codex. ChatGPT
30Chrome when a task needs a signed-in website. You can also invoke it directly in37can suggest Chrome when a task needs a signed-in website. You can also invoke it
31a prompt:38directly in a prompt:
32 39
33```40```text
34@Chrome open Salesforce and update the account from these call notes.41@Chrome open Salesforce and update the account from these call notes.
35```42```
36 43
37If Chrome isn’t already open, Codex can open it. Chrome browser tasks run in44If Chrome isn't already open, ChatGPT can open it. Chrome browser tasks run in
38Chrome tab groups so the work for a thread stays grouped together.45Chrome tab groups so the work for a task stays grouped together.
39 46
40## Control website access47## Control website access
41 48
42By default, Codex asks before it interacts with each new website. Codex bases49By default, ChatGPT asks before it interacts with each new website. ChatGPT bases
43the prompt on the website host, such as `example.com`.50the prompt on the website host, such as `example.com`.
44 51
45When Codex asks to use a website, you can choose the option that matches the52When ChatGPT asks to use a website, you can choose the option that matches the
46task and your risk tolerance:53task and your risk tolerance:
47 54
48- Allow the website for the current chat.55- Allow the website for the current task.
49- Always allow the host so Codex can use that website again without asking.56- Always allow the host so ChatGPT can use that website again without asking.
50- Decline the website.57- Decline the website.
51 58
52### Manage the allowlist and blocklist59### Manage the allowlist and blocklist
53 60
54In Computer Use settings, you can manage an allowlist and blocklist for61In Computer Use settings, you can manage an allowlist and blocklist for
55domains. The allowlist contains domains Codex can use without asking again. The62domains. The allowlist contains domains ChatGPT can use without asking again. The
56blocklist contains domains Codex shouldn’t use.63blocklist contains domains ChatGPT shouldn't use.
57 64
58Removing a domain from the allowlist means Codex asks again before using it.65Removing a domain from the allowlist means ChatGPT asks again before using it.
59Removing a domain from the blocklist means Codex can ask again instead of66Removing a domain from the blocklist means ChatGPT can ask again instead of
60treating the domain as blocked.67treating the domain as blocked.
61 68
62#### Always allow browser content [Elevated Risk](https://help.openai.com/articles/20001061)69#### Always allow browser content <ElevatedRiskBadge class="ml-2" />
63 70
64If you turn on always allow browser content, Codex no longer asks for71If you turn on always allow browser content, ChatGPT no longer asks for
65confirmation before using websites.72confirmation before using websites.
66 73
67#### Browser history [Elevated Risk](https://help.openai.com/articles/20001061)74#### Browser history <ElevatedRiskBadge class="ml-2" />
68 75
69Browser history can include sensitive telemetry, internal URLs, search terms,76Browser history can include sensitive telemetry, internal URLs, search terms,
70and activity from Chrome sessions on signed-in devices. If you allow Codex to77and activity from Chrome sessions on signed-in devices. If you allow ChatGPT to
71access browser history, relevant history entries can become part of the context78access browser history, relevant history entries can become part of the context
72Codex uses for the task. Malicious or misleading page content can increase the79ChatGPT uses for the task. Malicious or misleading page content can increase the
73risk that Codex copies this data somewhere unintended.80risk that ChatGPT copies this data somewhere unintended.
74 81
75Codex asks when it wants to use browser history. Codex scopes history access to82ChatGPT asks when it wants to use browser history. ChatGPT scopes history access to
76the request, and history doesn’t have an always-allow option.83the request, and history doesn't have an always-allow option.
77 84
78## Data and security85## Data and security
79 86
92- View and manage your tab groups99- View and manage your tab groups
93 100
94These Chrome permissions make the extension capable of operating browser101These Chrome permissions make the extension capable of operating browser
95workflows. Codex still uses its own confirmations, settings, allowlists, and102workflows. ChatGPT still uses its own confirmations, settings, allowlists, and
96blocklists before using websites or browser history during a task.103blocklists before using websites or browser history during a task.
97 104
98### Memories105### Memories
99 106
100Browser use follows your Codex Memories setting. If Memories is on, Codex can107Computer Use follows your Memories setting. If Memories is on, ChatGPT can
101use relevant saved memories while working in Chrome. If Memories is off, browser108use relevant saved memories while working in Chrome. If Memories is off, browser
102use doesn’t use memories.109control doesn't use memories.
103 110
104### What OpenAI stores from browsing111### What OpenAI stores from browsing
105 112
106OpenAI doesn’t store a separate complete record of your Chrome actions from the113OpenAI doesn't store a separate complete record of your Chrome actions from the
107extension. OpenAI stores browser activity only when it becomes part of the Codex114extension. OpenAI stores browser activity only when it becomes part of the ChatGPT
108context, such as text Codex reads from a page, screenshots, tool calls,115context, such as text ChatGPT reads from a page, screenshots, tool calls,
109summaries, messages, or other content included in the thread.116summaries, messages, or other content included in the task.
110 117
111Your ChatGPT and Codex data controls apply to content processed in context.118Your ChatGPT data controls apply to content processed in context.
112Avoid sending secrets or highly sensitive data through browser tasks unless119Avoid sending secrets or highly sensitive data through browser tasks unless
113they’re required and you are present to review each prompt.120they're required and you are present to review each prompt.
114 121
115## Troubleshooting122## Troubleshooting
116 123
117If Codex can’t connect to Chrome, first confirm the website Codex is trying to124If ChatGPT can't connect to Chrome, first confirm the website ChatGPT is trying to
118access isn’t in the blocklist in Settings. If the website isn’t blocked, work125access isn't in the blocklist in Settings. If the website isn't blocked, work
119through these checks:126through these checks:
120 127
1211. Open the Codex extension from the Chrome toolbar or Chrome’s extensions1281. Open the extension from the Chrome toolbar or Chrome's extensions
122 menu. Make sure it shows **Connected**. If it shows disconnected or mentions129 menu. Make sure it shows **Connected**. If it shows disconnected or mentions
123 a missing native host, remove and re-add the Chrome plugin from **Plugins**130 a missing native host, remove and re-add the Chrome plugin from **Plugins**
124 in Codex, then follow the setup flow again.131 in Work or Codex in the ChatGPT desktop app, then follow the setup flow
1252. In Codex, open **Plugins** and confirm that the Chrome plugin is on. If the132 again.
126 plugin is off, turn it on and try the task again.1332. In the app, select Work or Codex, open **Plugins**, and confirm that the
1273. Make sure you are using the same Chrome profile where the Codex extension is134 Chrome plugin is on. If the plugin is off, turn it on and
135 try the task again.
1363. Make sure you are using the same Chrome profile where the extension is
128 installed. If you use more than one Chrome profile, install and enable the137 installed. If you use more than one Chrome profile, install and enable the
129 extension in the active profile.138 extension in the active profile.
1304. Start a new Codex thread and try the Chrome task again. This can clear a1394. Start a new task in Work or Codex and try the Chrome task again. This can
131 thread-specific connection state.140 clear task-specific connection state.
1325. Restart Chrome and Codex, then try again. If the extension still doesn’t1415. Restart Chrome and the app, then try again. If the extension
133 connect, uninstall the Codex Chrome extension, remove and re-add the Chrome142 still doesn't connect, uninstall the Chrome extension, remove and re-add the Chrome
134 plugin from **Plugins**, and follow the setup flow again.143 plugin from **Plugins**, and follow the setup flow again.
1356. If the extension shows **Connected** but Codex still can’t use Chrome, run1446. If the extension shows **Connected** but ChatGPT still can't use Chrome, run
136 `/feedback` in the Codex app and include the thread ID when you contact145 `/feedback` in the app and include the task ID when you contact
137 support.146 support.
138 147
139148<CodexScreenshot
149 alt="Chrome extension showing connected status"
150 lightSrc="/images/codex/app/chrome-connected-light.png"
151 darkSrc="/images/codex/app/chrome-connected-dark.png"
152 maxHeight="300px"
153 class="mt-4"
154/>
140 155
141### Upload Files156### Upload files
142 157
143If a Chrome task needs to upload a file from your computer, allow the Codex158If a Chrome task needs to upload a file from your computer, allow the Chrome
144extension to access file URLs in Chrome:159extension to access file URLs in Chrome:
145 160
1461. In Chrome, open the extensions icon in the toolbar, then click **Manage1611. In Chrome, open the extensions icon in the toolbar, then click **Manage
147 Extensions**.162 Extensions**.
1482. On the Codex extension card, click **Details**.1632. On the extension card, click **Details**.
1493. Turn on **Allow access to file URLs**.1643. Turn on **Allow access to file URLs**.
150 165
151After you change the setting, start the Chrome task again.166After you change the setting, start the Chrome task again.
152 167
153168<CodexScreenshot
154 169 alt="Chrome extension settings showing Allow access to file URLs enabled for ChatGPT"
170 lightSrc="/images/codex/app/chrome-file-url-access-light.webp"
171 darkSrc="/images/codex/app/chrome-file-url-access-dark.webp"
172 maxHeight="420px"
173 class="mt-4"
174/>