---
url: /docs/coding-agents/codex.md
---
# Codex

Codex is OpenAI's CLI coding agent. Point it at Hyper's [Responses API
endpoints](/api/openai-responses.md) and use the same models with your
Hypercredits.

## Prerequisites

* A Hyper account with an API key
* [Codex](https://github.com/openai/codex) installed

## Configuration

Add this to `~/.codex/config.toml`:

```toml
model = "deepseek-v4-pro"
model_provider = "hyper"
model_context_window = 131072

[model_providers.hyper]
name = "Hyper"
base_url = "https://hyper.charm.land/v1"
env_key = "HYPER_API_KEY"
wire_api = "responses"
```

## Running Codex

### Codex CLI

```bash
export HYPER_API_KEY="sk-hyper-xxxxxxxxxxxxxxxxxxxxxxxx"
codex
```

### Codex Desktop

```bash
export HYPER_API_KEY="sk-hyper-xxxxxxxxxxxxxxxxxxxxxxxx"
open /Applications/Codex.app
```