Настройка Codex CLI

Команды и поля config.toml основаны на официальном репозитории Codex и справочнике custom provider. NexusAPI предоставляет URL, ключ и ID модели.

1. Установка

Выберите один официальный способ:

Windows PowerShell

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

macOS, Linux или WSL

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

Если Node.js уже установлен

npm install -g @openai/codex
codex --version

После установки также проверьте версию в новом терминале:

codex --version

2. Создайте совместимый ключ

В Управлении токенами → Добавить токен выберите группу с нужной моделью. Затем проверьте /v1/models и матрицу возможностей: supported_endpoint_types должен содержать openai-response.

3. Настройте custom provider

Система	Файл
Windows	`%USERPROFILE%\\.codex\\config.toml`
macOS / Linux	`~/.codex/config.toml`

model_provider = "nexusapi"
model = "YOUR_MODEL_ID"

[model_providers.nexusapi]
name = "NexusAPI"
base_url = "https://nexusapi.link/v1"
env_key = "NEXUSAPI_API_KEY"
wire_api = "responses"

Храните NexusAPI Key в переменной окружения, а не в этом файле. ~/.codex/auth.json может содержать состояние учётных данных Codex; NexusAPI Key туда добавлять не нужно.

4. Укажите ключ через окружение

Windows PowerShell

setx NEXUSAPI_API_KEY "YOUR_NEXUSAPI_KEY"

macOS, Linux или WSL

export NEXUSAPI_API_KEY='YOUR_NEXUSAPI_KEY'

После setx откройте новый терминал. export действует только в текущей оболочке. Для постоянного хранения используйте менеджер учётных данных или управляемые переменные окружения, не репозиторий.

5. Проверка

В каталоге проекта выполните:

cd your-project-folder
codex

Для первой проверки задайте задачу без записи:

Объясни структуру репозитория, не меняя файлы.

Затем проверьте журнал использования в консоли. При ошибке проверьте новый терминал, ключ, группу и ID модели, сохраните Request ID и используйте самопроверку.

Устранение неполадок

Используйте терминал, открытый после задания NEXUSAPI_API_KEY.
Проверьте, что ключ включён, аккаунт имеет кредит, а группа содержит выбранную модель.
Снова скопируйте точный ID из каталога или /v1/models.
Сохраните исходную ошибку и Request ID, затем используйте самопроверку.

VS Code / Cursor

Установите расширение Codex, опубликованное OpenAI, из marketplace. Оно использует ту же пользовательскую конфигурацию Codex; не добавляйте в VS Code устаревшие параметры chatgpt.apiBase или chatgpt.config.

Начало работы

Модели и оплата

Клиентские инструменты

Устранение неполадок

API для разработчиков

Настройка Codex CLI

1. Установка

Windows PowerShell

macOS, Linux или WSL

Если Node.js уже установлен

2. Создайте совместимый ключ

3. Настройте custom provider

4. Укажите ключ через окружение

Windows PowerShell

macOS, Linux или WSL

5. Проверка

Устранение неполадок

VS Code / Cursor

Официальные источники

​1. Установка

​Windows PowerShell

​macOS, Linux или WSL

​Если Node.js уже установлен

​2. Создайте совместимый ключ

​3. Настройте custom provider

​4. Укажите ключ через окружение

​Windows PowerShell

​macOS, Linux или WSL

​5. Проверка

​Устранение неполадок

​VS Code / Cursor

​Официальные источники

1. Установка

Windows PowerShell

macOS, Linux или WSL

Если Node.js уже установлен

2. Создайте совместимый ключ

3. Настройте custom provider

4. Укажите ключ через окружение

Windows PowerShell

macOS, Linux или WSL

5. Проверка

Устранение неполадок

VS Code / Cursor

Официальные источники