Skip to main content
Version: 11.5.0

Codex CLI

Codex CLI reaches HYPR AgentPass™ through an OpenAI connector. You can configure it in two ways:

  • From the console's agent configuration, on workstations the Endpoint Guard manages. The Endpoint Guard routes inference to your OpenAI connector and provisions your MCP connectors. It can also block Codex's direct provider hosts, so its traffic cannot bypass the gateway.

  • With the connector script, on workstations the Endpoint Guard does not manage.

If Endpoint Guard manages the workstation, configure Codex from the console's agent configuration. Otherwise, use the connector script. Both paths end the same way: restart Codex CLI, approve the first connection and verify it in the Request Log.

Both ways end the same: restart Codex CLI, approve its first connection, and verify it in the Request Log.

Before You Begin​

  • Your administrator has created an OpenAI connector.

  • Codex CLI is installed on the workstation.

  • For managed configuration, the workstation is enrolled with Endpoint Guard for macOS or Windows.

  • For managed configuration, your administrator has enabled Codex in Managed Desktop Tools.

  • If the connector requires approval, your supervisor is available to approve the first connection.

Configure Codex from the Console​

Use the agent configuration on workstations the Endpoint Guard manages.

The agent configuration for Codex: model traffic routed to the first OpenAI connector, MCP servers provided and direct traffic blocked
  1. In the console, open Desktops, click the Desktop configuration tab, and choose Configuration.

  2. If Configure agents from AgentPass is off, turn it on, and click Turn on to confirm.

  3. Turn on Configure Codex.

  4. Keep Route model traffic through AgentPass selected.

  5. Choose the OpenAI connector for Codex. To use the first OpenAI connector, leave the Auto option.

  6. Keep Provide MCP servers selected.

    To keep a connector from Codex, turn off Publish to endpoint catalog on that connector.

  7. Optional: After the workstation reports routing as applied, select Block direct traffic.

  8. Click Save.

  9. After the workstation applies the configuration, restart Codex CLI.

The Endpoint Guard then updates the Codex configuration:

Configure Codex with the Connector Script​

Use the connector script on workstations the Endpoint Guard does not manage.

  1. Open the OpenAI connector, and find Codex CLI Setup.
  2. Download the Bash or PowerShell script for the workstation.
  3. Give the script to the Codex user through your approved software-delivery process.
  4. On the workstation, run the script.
  5. Restart Codex CLI.

The script updates the Codex configuration:

  • It sets the AgentPass openai_base_url.

  • It adds the built-in hyprmcp MCP server.

  • It keeps other settings.

If the connector address changes, run the script again.

Approve and Verify the Connection​

  1. Start Codex, and send a prompt.
  2. If the connector uses Require Approval, the supervisor approves the first connection with their passkey. See Onboarding Your Agent.
  3. If the client asks you to retry after approval, send another prompt.
  4. Confirm the request appears in the supervisor's Request Log.