This article covers Codex, OpenAI's coding agent. ChatGPT Work is the separate ChatGPT experience for longer research and deliverable tasks. For a comparison, see ChatGPT Work and Codex; for technical Codex details, see the Codex page.
For information on ChatGPT features such as Sora, ChatGPT Images, or Voice mode, please refer to other articles in our Help Center.
Codex is included across ChatGPT plans. ChatGPT Work availability varies by plan, surface, and rollout. For current eligibility, see ChatGPT Work and Codex. The Plugins Directory is visible across plans, while installation and use can still depend on plan, workspace settings, role, surface, and app permissions.
What is Codex?
Codex is an AI agent that helps you write, review, and ship code.
Getting started
How to connect Codex with your ChatGPT account
To start using Codex with your ChatGPT plan:
Sign in with your ChatGPT account.
Codex is included across ChatGPT plans, including Free and Go. Usage limits vary by plan.
For more information, including higher-usage options for individuals and Codex credit plans for business users, visitchatgpt.com/pricing.
Launch your preferred Codex client and follow the instructions to sign in with ChatGPT:
Follow the setup steps shown in the selected client.
What terms govern your use of Codex?
When you sign in to Codex using an existing ChatGPT account, the ChatGPTTerms of Use andPrivacy Policy—or the correspondingonline services agreement for OpenAI API and ChatGPT Enterprise, Education or Business Users—apply to data shared between Codex and ChatGPT.
Enterprise setup and controls
Setup
For an in-depth guide to get your workspace up and running with Codex, please refer to our
guide here:Enterprise Admin Guide
Plugins
The Plugins Directory is visible across ChatGPT plans. Whether a member can install or use a plugin depends on their plan, workspace settings, role, surface, and any app permissions the plugin requires. For Business and Enterprise/Edu workspaces, admins and owners manage plugin installation in Workspace settings > Plugins and underlying app access in Workspace settings > Apps.
A plugin can include skills, apps, and app templates. If a plugin requires an app, that app must be enabled for the member's role before Codex can use the app-backed capability. Existing app settings continue to apply, including role access, action controls, approval settings, sync settings, domain restrictions, and provider authentication.
Workspace plugin controls can choose whether a plugin is Available or Installed for eligible roles. Installed installs the plugin for that role by default; Available lets members install it themselves. These controls apply across ChatGPT web, ChatGPT mobile, ChatGPT desktop, and Codex when the plugin is available on that surface. Admins do not set a separate per-surface app or plugin toggle.
Some local or Codex-specific plugins may be usable only in Codex. If a plugin was created locally, it may need to be uploaded, imported, or made available by an admin before it can be used by the broader workspace.
Sites in Codex
Sites is available on paid ChatGPT plans except Free and Go in supported regions. Sites is not currently available in the European Economic Area, Switzerland, or the United Kingdom. Workspace admins control whether members can create Sites or publish them publicly.
Where Sites is available in Codex, describe what you want to build, review the generated preview, and use the available sharing controls. For the full build and deployment workflow, see the Codex Sites developer guide.
Workspace admins can control Sites creation and public publishing through the settings available to their plan.
Available controls depend on plan and workspace configuration. If you cannot find the expected control, contact OpenAI Support.
Developer mode for Browser use and in-app browser
Developer mode works with Browser use in Chrome and the Codex in-app browser. It gives Codex controlled access to Chrome DevTools Protocol (CDP) for deeper browser debugging, such as inspecting console output, network traffic, page state, and JavaScript performance.
You can enable the feature locally in the ChatGPT desktop app by opening Settings > Browser and turning on Enable full CDP access under Developer mode. Full CDP access lets Codex inspect and control sensitive browser internals that may put your data at risk, and Codex asks for explicit approval before it uses full CDP access to inspect a website.
Admins/owners can turn off the feature for their workspace by accessing the Policies & Configurations inCodex cloud settings, and by setting browser_use_full_cdp_access to false. Disabling Browser use overall will disable CDP, as well.
For setup and approval details, seeDeveloper mode. Note admins/owners will first need to enable thein-app browser before enabling developer mode.
RBAC (Role-based access control)
Access to Codex is able to be granted to specific user roles. For more information on setting up RBAC, please refer to our guide here:RBAC
Compliance API
Codex usage, including local clients such as the CLI and IDE extension as well as web or cloud-delegated usage, is available in theCompliance API. This log surface covers supported Codex clients, separate from cloud-task-specific endpoints.
Usage limits by plan
Usage from Codex, ChatGPT Work, ChatGPT for Excel, and Workspace Agents draws from the same agentic usage and credit pool when those features are available on your plan. The amount a Codex task uses varies with the size and complexity of the work, the model, and where the task runs. Small scripts may use only a fraction of your allowance, while larger codebases, long-running tasks, and extended sessions use more.
If you are nearing or have reached your Codex limit, check the Codex usage page or the limit banner for the options available on your plan. Some Plus and Pro users can add credits to continue using Codex; other users may need to upgrade or wait for the limit to reset.
For a full list of Codex limits, rates, and credit options, refer to thepricing page on the OpenAI developer website.
Context and Data Controls
Some Codex features can make Codex more helpful by letting it remember context, continue work over time, and connect with tools you choose to use. These include Memories, Scheduled Tasks, Codex’s in-app browser, and Computer Use. For more information on these and other features, including how to manage the data that these features store and interact with, see our developer center.
Record & Replay
Record & Replay is available in the ChatGPT desktop app while using Codex on macOS for eligible users. It lets you demonstrate a workflow once and turn it into a reusable skill. It is useful for stable, repeatable workflows that are easier to show than describe.
Record & Replay requires Computer Use to be available and enabled, and initial availability excludes the European Union, Switzerland and the UK. During recording, Codex observes the actions and window content needed to learn the workflow. Keep recordings focused on the task, and avoid entering secrets or sensitive data during the recording.
To learn more, see theRecord & Replay guide.
Data controls
Your ChatGPT training data controls apply to content processed through Codex, including screenshots taken by Computer Use. Local workflows run on your device; cloud tasks run in OpenAI-managed environments. Connected services may be available across supported ChatGPT and Codex surfaces, and you can disconnect them at any time.
FAQ
Which model does the Codex CLI or IDE extension use?
The model Codex uses by default will depend on your version of the CLI or IDE extension and configuration. Check out theCodex documentation for available models and how to configure different models.
Does OpenAI train on my Codex usage?
Business, Enterprise, and Edu
By default, OpenAI does not use any inputs or outputs from our products for business users, including ChatGPT Business, ChatGPT Enterprise, and the API, to improve our models. However, API organization owners can choose to opt-in to share API data with OpenAI. This setting is not available to certain organizations, including Enterprise and customers with Zero Data Retention enabled.
Learn more aboutSharing feedback, evaluation and fine-tuning data, and API inputs and outputs with OpenAI.
Pro and Plus
Conversations may be used to improve models unless you turn off training inChatGPT data controls. For more information, seehow your data is used to improve model performance.
Can I run Codex in my IDE?
Yes, the Codex VS Code extension is compatible with most VS Code forks. For other IDEs, you can also run the Codex CLI in the IDE’s terminal.
How do workspace permissions apply to Codex in the ChatGPT desktop app?
Yes. Managed workspaces can control Codex local use and Codex cloud tasks separately. Codex Local covers the CLI, IDE extension, and desktop workflows, while Codex Cloud covers delegated cloud tasks. Remote Control may also require workspace enablement or RBAC permission, and the device must allow discovery and control in ChatGPT desktop settings.
For an in-depth guide to get your workspace up and running with Codex, please refer to our guide here:Enterprise Admin Guide
Where can I find help troubleshooting Codex in the ChatGPT desktop app?
Refer to our platform guide if you run into issues using Codex in the ChatGPT desktop app. If you need additional help, contact us.
How can I get access to Codex Enterprise Analytics?
Access to Codex Enterprise Analytics is available to Enterprise workspaces with Codex enabled. To use the Codex Enterprise Analytics API, use an organization API key that has Codex Enterprise Analytics access. If your API request is rejected because the key is missing access, ask your workspace or organization administrator to provide a key with Codex Enterprise Analytics access.
For setup details and API access, refer to ourAPI documentation.
Do ChatGPT related rate limits for file upload limits, image limits and voice caps apply to Codex?
ChatGPT file uploads, image generation, or voice have separate usage limits, reset periods, and banners. For example, if you see banners like “50 images in the last day”, “resets in 720 hours”, reach voice caps, or see upload-limit banners while uploading files in ChatGPT, those limits do not apply to Codex.
For details on image and video limits and voice limits, seeimage & video generation limits andvoice usage limits. For information about ChatGPT file upload limits and troubleshooting, seeFile Uploads FAQ. For information on the status of various ChatGPT services, including file uploads, refer to theOpenAI status page.
How do Codex referral invitations and banked resets work?
Eligible users may see Codex referral invitations in the profile menu. Personal plan users may see Invite a friend, and eligible Business workspace members may see Invite a coworker. The invitation dialog shows the current reward, recipient requirements, invite limits, and expiration for that offer.
For some Plus and Pro promotions, a successful referral can add a banked Codex rate-limit reset. To use a banked reset, open the profile menu and select the usage summary showing the available reset count, such as 1 reset available.
Referral rewards vary by offer and plan. For current reward, limit, and eligibility details, seeInvite friends and coworkers andCodex Referral Promotions.
How can I create project instructions in Codex?
Use /init in the ChatGPT desktop app while using Codex to generate an AGENTS.md scaffold for the current project. This uses the same initialization workflow as the Codex CLI. For other commands, see App commands.
What happens if I reach a usage limit while Codex is working?
If you reach a usage limit during an active turn, Codex can continue working on that turn, subject to fair-use limits. After that turn, check the Codex usage page or the limit banner for the options available on your plan, such as adding credits, applying an available reset, upgrading, or waiting for the limit to reset.
For more details, seeCodex usage limits.