Codex подключается к Guard через пользовательский config.toml. Для надёжного холодного старта ему также нужен локальный каталог моделей: без него первый запрос иногда формируется раньше, чем Codex успевает получить /v1/models, и часть инструментов может не включиться.
Mac / Linux:
mkdir -p ~/.codex
curl -fsSL https://docs.guardrelay.ai/assets/guard-codex-models.json \
-o ~/.codex/guard-codex-models.jsonWindows (PowerShell):
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Invoke-WebRequest https://docs.guardrelay.ai/assets/guard-codex-models.json `
-OutFile "$HOME\.codex\guard-codex-models.json"Откройте (или создайте) файл ~/.codex/config.toml — на Windows это %USERPROFILE%\.codex\config.toml — и вставьте:
model = "claude-sonnet-5"
model_provider = "guard"
model_catalog_json = "~/.codex/guard-codex-models.json"
[model_providers.guard]
name = "Guard AI"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
wire_api = "responses"Каталог Codex содержит шесть Claude: claude-sonnet-5, claude-opus-5, claude-opus-4-8, claude-haiku-4-5, claude-fable-5-1 и claude-fable-5. Укажите нужный id в model; по умолчанию выбран Sonnet 5. Fable работает без фактически применённого серверного промпта. Если подходящий промпт должен примениться, запрос к Fable отклоняется до списания.
Windows (PowerShell):
$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexMac / Linux:
export GUARD_API_KEY="gd-ваш-ключ-из-бота"
codex$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexРазовый запуск без интерактивного режима:
codex exec "проверь связь: ответь 'ok'"Конфигурация выше использует wire_api = "responses", то есть POST /v1/responses.
| Семейство | На /v1/responses |
|---|---|
| Kimi | доступен: принимает model, input, instructions, stream, tools, tool_choice, parallel_tool_calls, max_output_tokens, reasoning, text, temperature, top_p, prompt_cache_key, include, store, truncation и metadata |
| Composer, Grok | Доступны: model, input, instructions, max_output_tokens, stream и клиентские tools. Поддержанные дополнительные поля совместимости перечислены ниже. |
model = "cursor-grok-4.6-high"
model_provider = "guard"
[model_providers.guard]
name = "Guard AI"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
wire_api = "responses"Codex ходит на поверхность Responses, и Kimi её обслуживает. Настройка та же, что у Claude, отличий два: в поле model точный id Kimi, а каталог моделей не подключается. Скачанный guard-codex-models.json описывает только модели Claude, поэтому строку model_catalog_json для Kimi просто не пишите: с чужим каталогом Codex посчитает модель неизвестной.
model = "k3"
model_provider = "guard"
[model_providers.guard]
name = "Guard AI"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
wire_api = "responses"Ключ передаётся переменной GUARD_API_KEY. Mac / Linux:
export GUARD_API_KEY="gd-ваш-ключ-из-бота"
codex$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexWindows (PowerShell):
$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexРазовая проверка связи без интерактивного режима:
codex exec "проверь связь: ответь 'ok'"Каталог моделей скачивать не нужно, строку model_catalog_json просто не пишите. В поле model укажите точный id: у Composer это composer-2.5, у Grok — cursor-grok-4.6-low, -medium, -high, -xhigh. У каждого id есть вариант с -fast: тот же ответ быстрее и дороже.
Ключ передаётся той же переменной GUARD_API_KEY. Mac / Linux:
export GUARD_API_KEY="gd-ваш-ключ-из-бота"
codex$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexWindows (PowerShell):
$env:GUARD_API_KEY = "gd-ваш-ключ-из-бота"
codexРазовая проверка связи без интерактивного режима:
codex exec "проверь связь: ответь 'ok'"