# Codex

> FreshRouter как провайдер моделей в Codex — для CLI, приложения и расширения IDE: одна команда или один промпт для ИИ-агента.

Настроить Codex можно двумя способами, и ни один не просит выбирать модель: выполнить одну команду или вставить один промпт в ИИ-агента. Сразу после создания ключа консоль показывает оба варианта с уже подставленным ключом, а позже они всегда есть на странице **«Подключение»**.

## Выполните одну команду

Запустите её в терминале (на Windows — в PowerShell) и вставьте API-ключ, когда установщик его попросит:

**macOS / Linux**

```bash
curl -fsSL https://freshrouter.com/install/codex.sh | bash
```

Чтобы не вводить ключ вручную, укажите его после `bash -s --`. Консоль подставляет его сама.

```bash
curl -fsSL https://freshrouter.com/install/codex.sh | bash -s -- sk-your-freshrouter-key
```

**Windows**

```powershell
irm https://freshrouter.com/install/codex.ps1 | iex
```

Чтобы не вводить ключ вручную, сначала задайте его в `$env:FRESHROUTER_API_KEY`. Консоль подставляет его сама.

```powershell
$env:FRESHROUTER_API_KEY="sk-your-freshrouter-key"; irm https://freshrouter.com/install/codex.ps1 | iex
```

Установщик добавляет FreshRouter в `~/.codex/config.toml` как провайдера по умолчанию, не трогает остальные настройки и сначала делает резервную копию файла. Ключ он сохраняет в `~/.codex/freshrouter-api-key` — файле, доступном только вам; Codex читает его каждый раз, когда нужен ключ. Эти настройки общие для Codex CLI, приложения Codex и расширения для IDE, поэтому один запуск настраивает все три. Затем перезапустите Codex.

> На Windows ключ сохраняется в переменной среды пользователя `FRESHROUTER_API_KEY`. С Codex старше 0.118 так же происходит на macOS и Linux, в профиле оболочки: терминал его видит, а приложение — нет. Обновите Codex и выполните команду ещё раз.

## Или поручите это ИИ-агенту

Вставьте этот промпт в ИИ-агента на том же компьютере. Он спросит у вас ключ, выполнит команду выше, а если не получится — внесёт те же изменения вручную.

```text title="Промпт"
Настрой Codex на этом компьютере для работы через FreshRouter. Сначала спроси у меня API-ключ FreshRouter (он начинается с sk-) и подставь его ниже вместо <key>.

Выполни эту команду в терминале (macOS или Linux):

curl -fsSL https://freshrouter.com/install/codex.sh | bash -s -- <key>

На Windows выполни в PowerShell:

$env:FRESHROUTER_API_KEY="<key>"; irm https://freshrouter.com/install/codex.ps1 | iex

Она добавляет FreshRouter в ~/.codex/config.toml как провайдера по умолчанию, сохраняет мой ключ в файле ~/.codex/freshrouter-api-key (на Windows — в переменных среды пользователя) и сначала делает резервную копию настроек. Эти настройки читают и Codex CLI, и приложение Codex, и расширение для IDE. Запускать её повторно безопасно.

Если выполнить команду не получается, сделай то же вручную: в файле ~/.codex/config.toml поставь первые две строки выше первой [таблицы] файла и добавь две таблицы:

model = "gpt-6.1-sol"
model_provider = "freshrouter"

[model_providers.freshrouter]
name = "FreshRouter"
base_url = "https://freshrouter.com/v1"
wire_api = "responses"

[model_providers.freshrouter.auth]
command = "/bin/cat"
args = ["/full/path/to/.codex/freshrouter-api-key"]

Сохрани мой ключ, и только его, в файле ~/.codex/freshrouter-api-key, доступном только мне, и укажи полный путь к этому файлу в args. На Windows (%USERPROFILE%\.codex\config.toml) не добавляй таблицу auth, добавь в таблицу провайдера env_key = "FRESHROUTER_API_KEY" и сохрани мой ключ в этой переменной командой setx.

Не спрашивай, какую модель выбрать: команда оставит мою текущую модель, если она есть в FreshRouter, а иначе поставит gpt-6.1-sol. Когда закончишь, скажи мне перезапустить Codex.
```

## Смена модели

Заранее ничего выбирать не нужно: установщик оставляет вашу текущую модель, если она есть в FreshRouter, а иначе ставит `gpt-6.1-sol`. Чтобы выбрать другую, добавьте к команде `--model` (в PowerShell — `-Model`) или поменяйте `model` в `~/.codex/config.toml`:

**macOS / Linux**

```bash
curl -fsSL https://freshrouter.com/install/codex.sh | bash -s -- sk-your-freshrouter-key --model gpt-6.1-sol
```

**Windows**

```powershell
& ([scriptblock]::Create((irm https://freshrouter.com/install/codex.ps1))) -Key sk-your-freshrouter-key -Model gpt-6.1-sol
```

## Настройка вручную

Codex поддерживает собственных провайдеров в `~/.codex/config.toml`. Поставьте первые две строки выше первой таблицы файла, добавьте две таблицы и укажите в `args` полный путь к файлу с ключом:

```toml title="~/.codex/config.toml"
model = "gpt-6.1-sol"
model_provider = "freshrouter"

[model_providers.freshrouter]
name = "FreshRouter"
base_url = "https://freshrouter.com/v1"
wire_api = "responses"

[model_providers.freshrouter.auth]
command = "/bin/cat"
args = ["/Users/you/.codex/freshrouter-api-key"]
```

Затем сохраните ключ в этом файле и перезапустите Codex:

```bash
printf '%s\n' "sk-your-freshrouter-key" > ~/.codex/freshrouter-api-key
chmod 600 ~/.codex/freshrouter-api-key
```

На Windows файл лежит в `%USERPROFILE%\.codex\config.toml`. Таблицу `auth` не добавляйте, а укажите переменную среды, затем сохраните ключ командой `setx FRESHROUTER_API_KEY sk-…` и перезапустите Codex:

```toml title="config.toml"
[model_providers.freshrouter]
name = "FreshRouter"
base_url = "https://freshrouter.com/v1"
env_key = "FRESHROUTER_API_KEY"
wire_api = "responses"
```
