Codex

Перед началом

• Установите Codex CLI или расширение Codex для VS Code, Cursor или Windsurf, затем создайте API-ключ в консоли.
• Codex работает только через OpenAI Responses API (/v1/responses), а на этом эндпоинте NezhaGate отдаёт только модели GPT. Для Claude, Gemini и остальных моделей используйте эндпоинт чата или инструмент вроде Claude Code.

Модели, которые можно использовать в Codex:

gpt-5.6-sol · gpt-5.6-terra · gpt-5.6-luna · gpt-5.5 · gpt-6-astra · gpt-6.1-sol · gpt-6-sol · gpt-6-luna

Добавьте провайдера в config.toml

Откройте ~/.codex/config.toml (на Windows — %USERPROFILE%\.codex\config.toml), создайте файл, если его нет, и добавьте:

model = "gpt-6.1-sol"
model_provider = "nezhagate"
web_search = "disabled"

[model_providers.nezhagate]
name = "NezhaGate"
base_url = "https://nezhagate.com/v1"
wire_api = "responses"
env_key = "NEZHAGATE_API_KEY"

• Ключи верхнего уровня, такие как model и model_provider, должны идти до первой таблицы [...], иначе Codex примет их за часть этой таблицы.
• web_search = "disabled": встроенный веб-поиск Codex использует инструмент, который работает на серверах OpenAI и через другого провайдера не гарантирован, — отключите его.
• Провайдер нужно задавать в пользовательском config.toml: model_provider в файле .codex/config.toml внутри проекта игнорируется. ID провайдера не может быть openai, ollama или lmstudio — эти имена зарезервированы Codex.

Задайте API-ключ

Codex берёт ключ из переменной окружения NEZHAGATE_API_KEY (это значение env_key выше) и отправляет его как Authorization: Bearer; codex login не нужен.

export NEZHAGATE_API_KEY=YOUR_API_KEY
codex

setx NEZHAGATE_API_KEY "YOUR_API_KEY"

На macOS и Linux допишите строку с export в ~/.zshrc или ~/.bashrc, чтобы она сохранилась. На Windows после setx заново откройте терминал или VS Code, чтобы переменная подхватилась.

Запуск и проверка

Выполните команду ниже — ответ gateway-ok означает, что подключение работает:

codex exec "Reply with exactly: gateway-ok"

• Введите /status в Codex, чтобы увидеть текущую модель и провайдера.
• Чтобы сменить модель, запустите Codex с codex -m gpt-6.1-sol или измените model в config.toml. Меню /model в Codex показывает только его встроенные модели, а не список NezhaGate.
• Затем попросите выполнить что-то, для чего нужен инструмент (например, «покажи список файлов здесь»), чтобы проверить работу вызова инструментов.

Расширение для IDE

Расширение Codex для VS Code, Cursor и Windsurf читает тот же config.toml: значок шестерёнки на панели расширения → Codex Settings → Open config.toml. После правки перезапустите редактор; если он запущен не из терминала, убедитесь, что он видит переменную с API-ключом.

Частые ошибки