Primary navigation

Suggested
API Dashboard

OpenAI Developers plugin for Codex

Install the OpenAI Developers plugin in Codex to build, troubleshoot, and ship apps on top of the OpenAI API.

The OpenAI Developers plugin helps you build AI applications and agents in Codex with OpenAI Platform access and OpenAI API setup guidance. It works together with the OpenAI Docs Skill that comes bundled with your Codex install.

It includes:

  • OpenAI API Platform: connect Codex to the OpenAI API Platform.
  • API key setup: create, save, and connect a project API key from Codex when your app needs OpenAI API access.
  • Troubleshooting: identify common OpenAI API failures and route you to the right next step.

For API key setup, the plugin creates new API keys in your Default Org under the Default project. You can set your default organization in your profile settings.

Get started with Codex

If you are new to Codex, start here before installing the plugin:

  1. Download the Codex app for macOS or Windows.
  2. Follow the Codex quickstart to sign in, choose a project, and send your first message.

Install the plugin

Choose an option

  1. Open the plugin directory

    In the Codex app, open Plugins.

  2. Find the plugin

    Search for OpenAI Developers, then open the plugin details.

  3. Add it to Codex

    Select the plus button or Add to Codex.

  4. Connect the OpenAI Platform

    If Codex prompts you to connect the bundled OpenAI Platform app, finish that setup so the plugin can interact with the OpenAI Platform, such as creating and setting project API keys when needed.

  5. Start a new thread

    Open a new thread before using the plugin for the first time.

For general plugin behavior, permissions, and removal steps, see Plugins.

Use the plugin

After installation, start building with Codex! Codex can use the plugin automatically when the task calls for OpenAI Platform interactions, such as creating API keys, or troubleshooting API issues.

The plugin is useful when you want Codex to:

  • build an app or agent that uses the OpenAI API
  • create an OpenAI API key for the app you are building
  • diagnose common OpenAI API errors and explain the next step.

Sample prompts

Start with one of these prompts:

Create a project API key to use in this project.
Build an app that uses AI to generate haikus.
Build an agent with the Agents SDK.

You can also invoke the plugin explicitly by typing @ in the prompt composer and choosing OpenAI Developers. After selecting the plugin, you can ask for more specific help:

Diagnose this OpenAI API error and explain what I should change in the code.
Create a project API key for this project, wire it into the local environment, and tell me how to run the app.