К основному содержанию
скилл Claude Code CX Codex Cursor GitHub Copilot

config-codex-cli — скилл для Codex: настройка OmniRoute

Автоматическая настройка OpenAI Codex CLI для работы с OmniRoute на любой ОС. Скилл определяет систему и оболочку, пишет конфиг, создаёт 7 профилей и проверяет подключение.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cheaper-inference/OmniRoute --skill config-codex-cli -a claude-code
Открыть на GitHub

Что делает config-codex-cli

Скилл автоматизирует подготовку Codex CLI к использованию OmniRoute как OpenAI-совместимого бэкенда. Он определяет операционную систему (Linux, macOS, Windows) и командную оболочку, затем генерирует config.toml с 7 именованными профилями, устанавливает переменные окружения и проверяет, что всё работает.

Для многочасовых сессий важно учитывать два параметра OmniRoute. По умолчанию affinity TTL отключен (0), что может разорвать continuity при переходах между аккаунтами. Для длительных задач установите sessionAffinityTtlMs выше ожидаемого времени работы (например, 43200 мс для 12 часов). Также проверьте STREAM_IDLE_TIMEOUT_MS — если он меньше 10 минут, тихие reasoning-туры могут быть прерваны таймаутом.

Шаг за шагом скилл пишет конфиг в стандартное место, проверяет синтаксис и сообщает о готовности.

Какие задачи решает

  • установить Codex CLI с поддержкой OmniRoute на машину с любой ОС
  • создать несколько именованных профилей для разных моделей и настроек
  • настроить переменные окружения для длительных сессий без разрыва
  • проверить, что подключение к OmniRoute работает корректно

Примеры запросов агенту

  • Настрой Codex CLI для работы с OmniRoute
  • Создай конфигурацию Codex с 7 профилями для OmniRoute
  • Проверь, что Codex подключается к OmniRoute правильно

Как установить config-codex-cli

1Через Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill config-codex-cli -a claude-code

2Вручную: положить файлы

~/.claude/skills/config-codex-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/config-codex-cli/

Из того же набора34

Весь набор →
cli-setup cheaper-inference Помогает агенту настроить OmniRoute, управлять автозапуском демона, обновлять CLI и менять параметры текущей сессии. Claude Code CX Codex Cursor +1 1 200установок omni-combos-routing cheaper-inference Скилл создаёт и настраивает связки моделей с разными стратегиями маршрутизации, цепочками fallback и метриками. Пригодится для управления OmniRoute через API. Claude Code CX Codex Cursor +1 1 200установок omni-inference cheaper-inference Скилл подключает эндпоинты для чат-комплишенов, эмбеддингов, аудио и изображений в стиле OpenAI. Пригодится агентам для прямого доступа к API вывода моделей. Claude Code CX Codex Cursor +1 1 100установок cli-providers cheaper-inference Помогает управлять подключениями провайдеров через OmniRoute: смотреть список, проверять настройки и менять ключи. Пригодится для работы с подключениями из терминала. Claude Code CX Codex Cursor +1 1 100установок omni-auth cheaper-inference Скилл для управления API-ключами и сессиями в OmniRoute. Настраивает Bearer-токены для запросов, получает сессионные куки и конфигурирует вход в Dashboard через пароль или OIDC. Claude Code CX Codex Cursor +1 1 100установок cli-routing cheaper-inference Скилл помогает настраивать маршрутизацию языковых моделей через утилиту omniroute прямо из терминала. Позволяет создавать комбинации и переключать цепочки вызовов. Claude Code CX Codex Cursor +1 1 100установок omni-mcp cheaper-inference Подключает MCP-сервер OmniRoute к агенту для маршрутизации запросов, работы с памятью, кэшем и аудитом. Нужен, когда эти операции требуется вызывать через MCP-инструменты. Claude Code CX Codex Cursor +1 1 100установок omni-providers cheaper-inference Управляет подключениями к 375 AI-провайдерам через REST API: добавляет ключи, тестирует соединения, синхронизирует модели. Claude Code CX Codex Cursor +1 1 100установок

Похожие

kr-whois-lookup NomaDamas Скилл проверяет регистрационные данные доменов .kr, IP-адресов и номеров автономных систем через k-skill-proxy. Claude Code CX Codex Cursor +1 4 200установок apple-notes Hermes Agent Скилл подключает Apple Notes к агенту через терминальную утилиту memo: список, поиск, создание и правка заметок с синхронизацией по iCloud. Claude Code CX Codex Cursor +1 381установок gif-search Hermes Agent Ищет и скачивает GIF-анимации через Tenor API с помощью curl и jq. Пригодится, когда агенту нужно подобрать реакцию для чата или найти медиафайл. Claude Code CX Codex Cursor +1 379установок superdesign superdesigndev Создаёт и дорабатывает интерфейсы, презентации и графику на холсте Superdesign. Пригодится для новых макетов и сравнения вариантов от разных моделей. Claude Code CX Codex Cursor +1 11 200установок setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. Claude Code 1 052 851установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. Claude Code 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. Claude Code CX Codex 282 859установок stitch-loop официальный google-labs-code Организует автономную сборку страниц через Stitch MCP. Агент берёт задачу из файла-эстафеты, создаёт экран, переносит код в проект и сразу пишет задание для следующей итерации. Claude Code CX Codex Cursor +1 56 300установок

Вопросы о config-codex-cli

Как установить config-codex-cli в Codex?

Запусти npx skills add cheaper-inference/OmniRoute --skill config-codex-cli -a codex, затем скилл будет доступен в .agents/skills/config-codex-cli/SKILL.md.

Что делает config-codex-cli?

Скилл автоматически настраивает OpenAI Codex CLI на работу с OmniRoute. Он определяет ОС и оболочку, создаёт конфиг с профилями, устанавливает переменные окружения и проверяет подключение.

Почему многочасовые сессии могут прерваться?

По умолчанию OmniRoute отключает session affinity и устанавливает idle timeout в 10 минут. Для длительной работы увеличьте sessionAffinityTtlMs выше ожидаемого времени задачи и установите STREAM_IDLE_TIMEOUT_MS=0.

Исходный текст

SKILL.md · MIT
---
name: config-codex-cli
description: Step-by-step agent workflow to configure the OpenAI Codex CLI on any machine (Linux, macOS, Windows) to use OmniRoute as an OpenAI-compatible backend. Detects OS and shell, writes config.toml and 7 named profiles, sets environment variables, and verifies the setup.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Step-by-step agent workflow to configure the OpenAI Codex CLI on any machine (Linux, macOS, Windows) to use OmniRoute as an OpenAI-compatible backend. Detects OS and shell, writes config.toml and 7 named profiles, sets environment variables, and verifies the setup.

## Quick install

```bash
npm install -g omniroute   # or: npx omniroute
omniroute --version
```

## Subcommands

_No CLI subcommands mapped for this family yet._

<!-- skill:custom-start -->

## Long-running Codex tasks (#7287)

Two OmniRoute defaults silently break multi-hour Codex sessions. Document them whenever configuring Codex for overnight / multi-hour work. Full guide: `docs/guides/CODEX-CLI-CONFIGURATION.md` → **Long-running tasks**.

### Session affinity (default off)

- Setting: `sessionAffinityTtlMs` (ms; UI shows **Affinity TTL (seconds)** under Dashboard → Settings → Routing → Session affinity). Legacy alias: `codexSessionAffinityTtlMs`.
- Default `0` = disabled. Each turn can land on a different account and break prompt-cache / session continuity.
- Codex session keys (`x-codex-session-id`, `x-session-id`, `x-omniroute-session`, body `prompt_cache_key` / `session_id`) are only used for pinning when TTL > 0.
- Max: `86400` seconds / `86400000` ms (24h). Set TTL **above** the expected task length (e.g. `43200` s for ~12h).

### Stream idle timeout (default 10 minutes)

- Env: `STREAM_IDLE_TIMEOUT_MS` (default `600000`). Also consider `FETCH_BODY_TIMEOUT_MS` (same baseline; `0` disables).
- Synthetic SSE heartbeats do **not** reset the idle clock — only real upstream chunks do.
- A quiet reasoning turn past the idle window is force-closed (`stream_idle_timeout` / `StreamIdleTimeoutError`). Grep logs for `Idle timeout: no data from`.

### Recommended multi-hour recipe

1. Dashboard → Settings → Routing → Session affinity → Affinity TTL = `43200` (12h) or `86400` (24h max).
2. OmniRoute environment:

```bash
STREAM_IDLE_TIMEOUT_MS=0
FETCH_BODY_TIMEOUT_MS=0
```

3. Restart OmniRoute. Leave Codex `config.toml` as usual (`wire_api = "responses"`, correct `base_url`).

### Defaults decision

Do **not** flip ship defaults in code for this skill: `sessionAffinityTtlMs` stays `0` and `STREAM_IDLE_TIMEOUT_MS` stays `600000`. Long-running operators must opt in. See Discussion #5718 and issue #7287.
<!-- skill:custom-end -->

© cheaper-inference · MIT · cheaper-inference/OmniRoute

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой