duolahypercho/codex-router

Codex Router – Codex 앱을 위한 다중 제공자 LLM 게이트웨이

무엇인가요

• Codex 데스크톱/CLI 애플리케이션에서 API 키를 Codex 앱에 노출하지 않고도 Anthropic, Kimi, DeepSeek, xAI/Grok, Gemini, GitHub Copilot, Ollama Cloud 등 여러 외부 대규모 언어 모델(LLM) 제공자와 통신할 수 있게 해주는 커뮤니티 유지 보수 도구입니다.
• 백그라운드 서비스, 선택적 Electron 기반 제어 센터(맥OS Dynamic Island 위젯 포함 트레이/메뉴바 앱), 그리고 제공자 자격 증명, 모델 카탈로그, 선택적 검색 사이드카를 관리하는 CLI 헬퍼를 설치합니다.

다양한 설치 방법

• 권장 원클릭 설치 프로그램 (macOS/Linux/Windows) – 쉘/PowerShell 스크립트를 실행하여 로컬에서 Electron UI를 빌드하고, 제공자를 선택하도록 유도하며, 자격 증명을 개인적이고 숨겨진 프롬프트에 저장합니다.
• Homebrew 포뮬러 – CLI(codex-router 명령어)와 Node/Python 종속성만 설치합니다. 이후 codex-router setup --guided를 실행하여 제공자 선택을 완료해야 합니다.
• 가이드된 설치 프로그램 – 권장 설치 프로그램과 동일한 스크립트이지만, 트레이/위젯은 포함되지 않습니다(--guided만).

핵심 기능

기능	설명
제공자 라우팅	설정 후 Codex 작업을 시작하고 피커에서 라우팅된 모델을 선택할 수 있습니다. 라우터는 요청을 선택된 외부 API로 전달하고, 필요한 OAuth 또는 API 키 헤더를 추가합니다.
자격 증명 보안	API 키와 OAuth 토큰은 채팅 UI에 직접 입력되지 않습니다. 한 번만 숨겨진 터미널 프롬프트를 통해 입력되며, 사용자별 소유자 전용 상태 디렉터리에 저장됩니다.
모델 카탈로그	라우터는 동적 모델 목록을 구축합니다(README의 상세 표 참조). 해당 자격 증명이 존재할 때만 모델이 표시됩니다. 네이티브 OpenAI 모델은 codex login 성공 후에만 표시됩니다.
검색 사이드카	내장 웹 검색 기능이 없는 모델에 대해 Perplexity Search 제공자를 바인딩할 수 있습니다. 사이드카는 모델별이며, 자격 증명도 개인적으로 보관됩니다.
크로스플랫폼 UI	맥OS에서는 제어 센터가 메뉴바에 있으며, 이동 가능한 "Dynamic Island" 데스크톱 위젯을 표시할 수 있습니다. 리눅스는 CLI만 제공; 윈도우는 PowerShell 래퍼(codex-router.ps1) 제공.
확장 가능한 제공자 시스템	model-router codex providers generic add …를 사용해 일반 제공자(예: Perplexity)를 추가하고, 특정 모델에 바인딩할 수 있습니다.
안전성 검사	설치 프로그램은 자격 증명 없음 모드(--no-provider --no-discovery)로 실행 가능하며, 키를 전혀 읽지 않고 서비스만 설치할 수 있어, 설치/제거 라이프사이클을 먼저 검증할 수 있습니다.

지원되는 제공자 및 인증 방식

• OAuth 기반 (Kimi, Grok, Antigravity) – 공식 CLI의 OAuth 세션을 재사용합니다.
• API 키 기반 (DeepSeek, MiniMax, Qwen, ClinePass, Xiaomi MiMo 등) – 키는 안전하게 저장되며 명령줄에 전달되지 않습니다.
• Ollama Cloud – Ollama Cloud API 키를 사용합니다.
• GitHub Copilot – Copilot Requests 권한이 있는 세부 권한 GitHub PAT가 필요합니다. 라우터는 공식 Copilot CLI 저장소를 읽지 않습니다.
• Antigravity (Google Gemini 내부) – 선택 사항이며, 운영자로부터 제공되는 비공개 클라이언트 시크릿이 필요합니다. 공개 빌드에서는 사용 불가.

일반적인 워크플로우

1. 설치 프로그램 실행 (curl … | sh -s -- --target codex --guided --with-tray).
2. 사용할 제공자를 선택하고, 필요한 OAuth 로그인 또는 API 키를 입력하라는 프롬프트가 표시됩니다.
3. Codex 앱을 종료하고 다시 열어줍니다.
4. 새 작업을 만들고 드롭다운에서 라우팅된 모델을 선택합니다.
5. (옵션) 메뉴바에서 Codex Router를 열어 상태 확인, 제공자 변경, 검색 사이드카 관리가 가능합니다.

제한 사항 / 참고 사항

• 이 프로젝트는 OpenAI, Anthropic, Google 등 언급된 제공자들과 아무런 관계가 없습니다.
• 맥OS에는 아직 사전 빌드된 .dmg가 제공되지 않습니다. 설치 프로그램은 로컬에서 Electron 앱을 컴파일합니다.
• Homebrew 포뮬러에는 Electron UI가 포함되지 않습니다. codex-router CLI만 제공합니다.
• 일부 제공자(예: Antigravity)는 공개적으로 배포되지 않는 비공개 클라이언트 시크릿이 필요합니다.
• 검색 사이드카는 모델별로만 가능하며, 글로벌 백업 검색은 활성화할 수 없습니다.
• 라우터는 기본 Codex 클라이언트의 네이티브 GPT 모델을 수정하지 않습니다. 이들은 기존 OpenAI 로그인을 통해 직접 접근됩니다.

자세한 정보 확인 방법

• 전체 설치 가이드: docs/INSTALL.md
• Homebrew 기여 가이드: docs/HOMEBREW_CORE.md
• 제공자별 노트는 README의 큰 모델/자격 증명 표에 포함되어 있습니다.

---

위의 모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.