---
title: "Подключение Codex к AI-агентам"
description: "Подробная информация о подключении AI-агента или AI Gateway к Codex в справочном центре Timeweb Cloud. Настройка конфигурации, базового URL, модели, API-ключа и переменной окружения для работы с Codex CLI и десктопным приложением."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Codex — это AI-ассистент для разработки от OpenAI. С его помощью можно работать с проектом из десктопного приложения или терминала: задавать вопросы по коду, вносить изменения и запускать команды.

К Codex можно подключить как AI-агента, так и AI Gateway. В первом случае вы работаете с уже настроенным агентом, во втором — обращаетесь к модели напрямую.

## Установка Codex

Codex Desktop доступен для macOS и Windows. Скачать версию для своей ОС можно на [официальном сайте OpenAI](https://openai.com/ru-RU/codex/get-started/).

Codex CLI можно установить на macOS или Linux командой:

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

Для установки Codex CLI на Windows используйте PowerShell:

```shell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```

Codex CLI также можно установить через пакетные менеджеры:

npm

```bash
npm install -g @openai/codex
```

brew

```bash
brew install --cask codex
```

## Предварительные требования

Подключить к Codex можно как AI-агента, так и AI Gateway.

Если вы хотите подключить AI-агента, вам потребуется:

-   [Базовый URL агента](https://timeweb.cloud/docs/ai-agents/api-usage/openai-compatible-api#bazovyj-url);
    
-   [API-ключ](https://timeweb.cloud/docs/ai-agents/manage-agents/api-access-key).
    

Для подключения AI Gateway понадобится:

-   Базовый URL: `https://api.timeweb.ai/v1`;
    
-   [API-ключ](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#sozdanie-api-klucha).
    

## Настройка подключения

Настройка выполняется в файле `~/.codex/config.toml`.

Если вы ранее использовали Codex, сохраните текущую версию конфигурации:

```bash
mv ~/.codex/config.toml ~/.codex/config.toml_old
```

Переименовав файл конфигурации обратно, вы сможете вернуть прежние настройки.

Создайте или откройте файл конфигурации:

```bash
nano ~/.codex/config.toml
```

Добавьте в файл конфигурацию подключения:

```bash
model_provider = "timeweb_cloud"
model = "openai/gpt-5-mini"

[model_providers.timeweb_cloud]
name = "Timeweb Cloud"

base_url = "https://api.timeweb.ai/v1" 
env_key = "TIMEWEB_CLOUD_API_KEY"
```

В конфигурации измените:

-   `base_url` — базовый URL зависит от типа подключения. Для AI Gateway используйте `https://api.timeweb.ai/v1`, для AI-агента — базовый URL вашего агента;
    
-   `model` — если используете AI-агента, укажите имя модели из настроек агента. При использовании AI Gateway укажите имя нужной модели, например `openai/gpt-5-nano`. Корректное имя модели можно найти в разделе «[Подключение](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#poluchenie-parametrov-podklucheniya)»;
    
-   `env_key` — укажите название переменной окружения, в которой будет храниться API-ключ;
    
-   `name` — при необходимости измените отображаемое имя провайдера.
    

Codex берет ключ из переменной окружения, указанной в параметре `env_key`. Если в конфигурации используется `TIMEWEB_CLOUD_API_KEY`, выполните:

Linux

```shell
export TIMEWEB_CLOUD_API_KEY="ваш_API-ключ"
```

macOS

```bash
launchctl setenv TIMEWEB_CLOUD_API_KEY "ваш_API-ключ"
```

Windows

```bash
setx TIMEWEB_CLOUD_API_KEY "ваш_API-ключ"
```

После этого запустите Codex:

```bash
codex
```

При использовании десктопной версии перезапустите приложение.

Добавленная модель будет доступна как в Codex CLI, так и в десктопном приложении Codex. В десктопной версии модель отобразится в окне чата.

![Выбор модели в Codex](https://content.timeweb.com/assets/ce3dd717-18d3-49e4-bd17-e7b2734d34fa.png?width=2522&height=1546)

_Выбор модели в интерфейсе [Codex](https://openai.com/ru-RU/codex/)_