무료GitHub에 공개한국어 소개

config-codex-cli

Codex CLI가 OmniRoute에 연결되도록 설정합니다. 운영체제와 셸을 감지하고 설정 파일과 일곱 가지 프로필을 만든 뒤 환경 변수 설정과 동작 확인을 진행합니다.

원문원문 설명 보기

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.

cheaper-inference/OmniRoute

연동 도구OpenAI

AI 평가70점/ 100 설치 방법 보기

이럴 때 유용합니다

Codex CLI를 OmniRoute에 연결
여러 운영체제에서 Codex 설정
이름이 있는 일곱 가지 프로필 생성
밤새 실행할 작업의 연결 설정 확인

한국어 소개

할 수 있는 일

config-codex-cli는 Codex CLI가 OpenAI 호환 연결 대상으로 OmniRoute를 사용하도록 설정합니다. Linux, macOS, Windows를 지원하며 운영체제와 셸을 감지합니다. config.toml과 이름이 있는 일곱 가지 프로필을 만들고, 환경 변수 설정부터 동작 확인까지 단계별 절차를 제공합니다.

이럴 때 유용합니다

Codex CLI의 연결 대상을 OmniRoute로 통일하거나 서로 다른 운영체제의 컴퓨터에서 설정할 때 유용합니다. 밤새 실행하는 작업처럼 수 시간이 걸리는 작업에 앞서 연결 유지와 시간 초과 설정을 검토할 때도 도움이 됩니다.

사용 예시

“이 컴퓨터의 Codex CLI가 OmniRoute에 연결되도록 설정해 주세요.”
“설정 파일과 일곱 가지 프로필을 만들고 동작을 확인해 주세요.”
“밤새 실행할 작업에 맞게 연결 설정을 확인해 주세요.”

주의 사항

OmniRoute를 사용하는 구성이 전제입니다. 장시간 작업에서는 같은 계정으로 연결을 유지하는 설정과 응답이 끊겼을 때의 시간 초과 설정을 확인해야 합니다. 기본적으로 계정 연결 유지는 꺼져 있고 스트림 무응답 제한은 10분입니다. 장시간 작업용 환경 변수를 바꾼 뒤에는 OmniRoute를 다시 시작해야 합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호개요에 Codex CLI를 OmniRoute에 연결하는 목적과 지원 운영체제가 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: B일부 부족장시간 작업의 설정값과 절차는 구체적이지만 프로필 생성 절차는 기재되어 있지 않습니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: B일부 부족설정 파일 쓰기와 시간 초과 해제를 다루지만 덮어쓰기 확인 절차는 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족OmniRoute 설치 방법은 있지만 필요한 Codex CLI의 설치 절차는 없습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 22일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md2.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Overview

Quick install

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

Subcommands

No CLI subcommands mapped for this family yet.

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

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

STREAM_IDLE_TIMEOUT_MS=0
FETCH_BODY_TIMEOUT_MS=0

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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬