Codex

Get started with Codex

To use Codex, you need to install and activate it using one of the supported authentication methods. For instructions, refer to:

• JetBrains AI subscription

• API key

• ChatGPT account

After setup, select Codex in AI Chat to start using it.

Collect IDE context

Codex can automatically receive context about your current editing session, so you don't have to attach it manually with every prompt. When automatic context is enabled, each request you send includes:

• The file currently open in the editor.

• The text you have selected in that file, if any.

An indicator in the chat input field shows the current state of automatic context. Click it to switch between the two states:

• IDE context enabled – the active file name and any selected text are attached to each prompt.

• IDE context disabled – no editor context is attached automatically.

Select operation mode

Codex has several operation modes that you can use:

• Read-only – Codex can browse and explain the codebase but cannot modify files or run commands.

• Agent – Codex can modify files within the project workspace but cannot make changes outside the project without approval.

• Agent (full access) – Codex can modify files anywhere on the machine and run commands with minimal restrictions, enabling system-level edits, installs, and full workflows.

To switch between modes, use the mode picker dropdown in the prompt window.

Select a processing model

To select a model that Codex uses to process your requests, click and select the model from the list.

You can also select the Reasoning level for the model. Model reasoning refers to a model's ability to perform multi-step analysis and solve complex tasks. The selected level controls how much analytical processing the model applies when generating responses.

Approve operations

In the Read-only mode, Codex requests your permission to run suggested bash commands, introduce changes, perform file operations, or use external tools. In this case, you can either approve or reject the operation.

• Allow Once – allows Codex to execute the command this time only. You will be asked again if the command is requested later.

• Allow for Session – allows Codex to execute this command for the current session without asking again.

• Reject – prevents Codex from executing this command.

Before you decide, you can review what the agent is about to do:

• For a suggested file change, click to review the changes the agent introduces.

• For a suggested command, click Open in editor in the top-right corner of the widget to review the complete command the agent suggests to run.

Rollback operations

If the changes introduced by Codex do not suit you, you can roll them back. To do this:

You can also roll back to a checkpoint, restoring your project to an earlier point in the conversation to undo changes or retry with different instructions. To do this:

View Codex status and configuration

Codex provides informational / commands to view the current agent configuration and manage the active session:

• /mcp – provides the list of configured MCP servers.

• /skills – provides the list of available skills. For more information about skills, refer to Use Codex skills.

• /logout – ends the current session and logs out of the ChatGPT account.

• /status – displays information about the current session, including token usage and the available context window.

Use Codex skills

Skills give Codex additional capabilities to handle specific tasks and structured workflows. Each skill consists of instructions, supporting resources, and scripts that define how the agent performs the task.

You can add skills in two ways:

• Install curated skills from public repositories, such as openai/skills. They can be installed by invoking the $skill-installer skill, which adds them to the Codex environment.

• Create custom skills by using the $skill-creator skill and describing the required functionality.

Once installed or created, skills can be invoked:

• Automatically, when a skill is relevant to the task you describe.

• Explicitly, by referencing a specific skill with the $ prefix in your prompt.

To view the skills currently available to Codex, use the /skills command.

Use database-specific tools with Codex

Available in: DataGrip and IDEs with Database Tools and SQL plugin

Currently, Codex requires the following configuration to work with database-specific tools: