duolahypercho/codex-router

External-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.

Codex Router란 무엇인가?

Codex Router는 클라이언트 측 라우팅 계층으로, Codex 데스크톱/CLI 애플리케이션이 다양한 대규모 언어 모델(LLM) 제공업체(Anthropic, Kimi, DeepSeek, xAI(Grok), GitHub Copilot, Claude, Gemini 등 수십 개)와 통신할 수 있게 해주며, 앱을 전환하거나 API 키를 수동으로 관리할 필요가 없습니다.

이 도구는 작은 백그라운드 서비스, Electron 기반 컨트롤 센터(트레이/메뉴바 앱 및 macOS Dynamic Island 위젯 포함), 그리고 명령줄 도구(model-router)를 설치합니다. 서비스는 제공업체 자격 증명을 로컬에 저장하고(숨겨진 프롬프트를 통해) 통합 모델 카탈로그를 Codex 내부에 표시하므로, 작업을 시작할 때 "라우팅된 모델"을 선택할 수 있습니다.

주요 기능(README에 설명된 대로)

다중 제공업체 지원 – OAuth 기반 세션(예: Kimi Code, Grok, Claude)과 일반 API 키 제공업체(DeepSeek, StepFun, Qwen 등)에서 작동합니다.
구독 에이전트 브리지(실험적) – 기존 Claude, Cursor, Gemini CLI 에이전트에 대한 선택적 읽기 전용 브리지로, OAuth 토큰을 노출하지 않고 Codex가 해당 도구를 통해 프롬프트를 라우팅할 수 있게 합니다.
안전한 자격 증명 처리 – 자격 증명은 기기를 벗어나지 않으며, 라우터는 최소한의 메타데이터(세션 ID, 타임스탬프)만 저장하고 프롬프트 텍스트를 기록하지 않습니다.
크로스 플랫폼 설치 프로그램 – macOS/Linux용 안내 설치 스크립트, Windows용 PowerShell 설치 프로그램, Homebrew 포뮬러, 향후 npm 패키지 계획이 포함됩니다.
데스크톱 통합 – 메뉴바/트레이 앱과 이동 가능한 macOS 위젯(Dynamic Island)이 제공업체 활성화/비활성화, 사용량 확인, 라우팅 정책 구성을 위한 "컨트롤 센터" 역할을 합니다.
광범위한 모델 카탈로그 – README에는 수십 개의 모델 ID가 나열되어 있으며, 각각 필수 인증 방법(OAuth 세션, API 키 또는 Ollama Cloud)과 연결되어 있습니다. 라우터는 유효한 자격 증명이 있는 모델만 표시합니다.
가짜 구독 프록시 없음 – OpenAI의 토큰-엔드포인트 동작을 에뮬레이션하지 않으며, 단순히 선택한 제공업체로 요청을 전달합니다.

누구를 위한 도구인가?

Codex UI를 벗어나지 않고 다양한 LLM 백엔드를 실험하려는 Codex 사용자.
다양한 LLM 서비스의 API 키/OAuth 세션을 한 곳에서 관리해야 하는 개발자.
자격 증명을 로컬에 유지하고 제3자 프록시에 노출하지 않으려는 팀.

설치 방법(빠른 시작)

# macOS / Linux (트레이 위젯 포함, 안내 방식)
curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
  | sh -s -- --target codex --guided --with-tray

# Windows
$installer = Join-Path $env:TEMP "codex-router-install.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.ps1 -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Target codex -Guided -WithTray

스크립트는 제공업체 선택, 로그인(예: kimi login), 백그라운드 서비스 설치 과정을 안내합니다. 완료 후 Codex 앱을 종료하고 다시 열고 새 작업을 시작하면 선택기에 라우팅된 모델이 표시됩니다.

일반적인 워크플로우

설치 프로그램 실행 – 원하는 제공업체를 선택합니다.
인증 – 설치 프로그램이 API 키 또는 OAuth 로그인을 위한 숨겨진 터미널 프롬프트를 엽니다.
Codex Router 컨트롤 센터 열기 – Spotlight(macOS) 또는 트레이 아이콘에서.
Codex 작업 생성 시 라우팅된 모델 선택.
(선택 사항) 브리지 사용 – 예: ./bin/model-router codex agents probe anthropic로 Claude 또는 Gemini 브리지를 확인합니다.

예시 명령줄 사용법

# 사용 가능한 에이전트 나열
./bin/model-router codex agents status

# 브리지를 통해 Anthropic에 프롬프트 전송(stdin에서 읽음)
printf '%s' '이 저장소에 대해 설명해 주세요.' |
  ./bin/model-router codex agents prompt anthropic --cwd "$PWD"

프로젝트 상태

커뮤니티 유지 관리 프로젝트이며, 나열된 제공업체와 제휴하지 않습니다.
Claude, Cursor, Gemini에 대한 실험적 브리지 지원.
macOS 위젯은 SwiftUI/WidgetKit로 구축되었으며, Windows와 Linux는 Electron UI에 의존합니다.
CLI 전용 설치를 위한 Homebrew 탭 사용 가능, npm 패키지 계획 중.

위의 모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다.