1. 프로젝트 개요
OpenCodex는 개발자가 Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama 등 모든 대규모 언어 모델을 Codex, Claude Code, Claude Desktop, Grok Build와 같은 코딩 어시스턴트를 통해 라우팅할 수 있게 해주는 경량 로컬 프록시입니다. 이러한 어시스턴트는 기본적으로 단일 제공업체에 고정되어 있습니다.
2. 배경 및 포지셔닝
독점 코딩 어시스턴트는 일반적으로 하나의 모델 제공업체에 하드와이어링되어 있어, 특정 작업에 더 적합한 모델이 있더라도 개발자는 전체 워크플로우를 위해 단일 벤더를 선택해야 합니다. OpenCodex는 이러한 고정을 제거하기 위해 만들어졌습니다. 제공업체 형식 간 API 요청을 변환하는 범용 어댑터 역할을 하면서 스트리밍 응답, 도구 호출, 추론 토큰, 이미지 입력에 대한 기능 호환성을 유지합니다.
단순한 API 키 전환기나 단일 제공업체 래퍼와 달리 OpenCodex는 프로토콜 수준 변환(Responses API 형식 간 변환), 할당량 인식 다중 계정 풀링, 운영 도구(웹 대시보드, 백그라운드 서비스 관리, 상태 확인)에 중점을 둡니다. 이는 일회성 스크립트보다는 소규모 자체 호스팅 게이트웨이에 가깝습니다.
3. 기능 카테고리
🔀 모델 라우팅 — 40개 이상 제공업체, 무제한 모델
간단한 provider/model 구문을 사용하여 구성된 모든 제공업체와 모델을 라우팅합니다. 대표적인 예: anthropic/claude-opus-5, OpenAI, Google, xAI, 사용자 정의 OpenAI 호환 엔드포인트. 목적: 코드 변경 없이 하나의 코딩 어시스턴트가 모든 백엔드 모델을 호출할 수 있게 합니다.
👥 계정 관리 — ChatGPT/Codex 계정 풀링
여러 ChatGPT/Codex 계정을 풀링하고, 할당량 사용량을 추적하며, 대화가 중간에 계정을 전환하지 않도록 스레드 선호도를 유지합니다. 최저 사용량, 라운드로빈, 선입선출 자동 라우팅 정책을 포함합니다. 목적: 여러 계정에서 처리량을 극대화하고 속도 제한 중단을 방지합니다.
🛡️ 안정성 기능 — 장애 조치 및 중복성
가중 라운드로빈 "콤보"와 모델 간 자동 장애 조치, 동일한 라우팅 규칙을 상속하는 하위 에이전트 지원을 제공합니다. 목적: 특정 제공업체나 계정을 사용할 수 없게 되어도 코딩 세션이 계속 실행되도록 합니다.
🔑 인증 및 확장 — OAuth 및 사이드카 기능
xAI, Anthropic, Kimi에 대한 기본 OAuth 통합과 ChatGPT 사이드카를 통한 비OpenAI 모델의 웹 검색 및 비전 지원을 제공합니다. 목적: OpenAI 독점 기능(비전, 웹 브라우징 등)을 다른 제공업체로 확장합니다.
⚙️ 운영 — 대시보드 및 서비스 관리
localhost:10100의 웹 대시보드, systemd/launchd/Task Scheduler 서비스 통합, 상태/준비 엔드포인트를 제공합니다. 목적: OpenCodex를 일회성 CLI 호출이 아닌 지속적이고 모니터링 가능한 로컬 서비스로 실행합니다.
4. 주요 특징
- 제공업체 무관 라우팅 —
provider/model문자열로 기본 모델을 교체하며, 어시스턴트 측 재구성이 필요 없습니다. - 기능 호환 변환 — 스트리밍, 도구 호출, 추론 토큰, 이미지가 제공업체 형식 변환 간에 일반 텍스트뿐만 아니라 보존됩니다.
- 할당량 인식 계정 풀링 — 구성 가능한 라우팅 정책을 사용하여 여러 ChatGPT/Codex 계정에 부하를 자동으로 분산합니다.
- 메모리 제한 상태 관리 — 제거 정책, 60초 만료 스윕, 세대 기반 조정을 통한 바이트 계산 저장소로 오래된 데이터를 방지합니다.
- 크로스 플랫폼 네이티브 서비스 — macOS, Linux, Windows에서 포그라운드 프로세스가 아닌 적절한 백그라운드 서비스로 설치됩니다.
- 내장 웹 대시보드 — 구성 파일을 수동 편집하는 대신 로컬 UI를 통해 제공업체, 계정, 콤보를 구성합니다.
5. 역할별 사용 사례
일반 개발자 — 도구를 전환하지 않고 동일한 코딩 어시스턴트 내에서 작업에 맞는 모델(예: 상용구에는 저렴한 모델, 어려운 버그에는 강력한 모델)을 사용합니다.
DevOps/SRE — OpenCodex를 모니터링을 위한 상태/준비 엔드포인트가 있는 관리형 백그라운드 서비스로 실행하고, 장애 조치 콤보를 사용하여 제공업체 중단 중에도 코딩 어시스턴트를 계속 사용할 수 있게 합니다.
프로젝트 관리자 — 수동 조정 없이 팀 전체의 사용량과 비용을 제어하기 위해 할당량 추적과 함께 팀 ChatGPT/Codex 계정을 풀링합니다.
6. 시작하기
필요한 것 찾기
제공업체 설정 가이드 및 구성 참조는 문서 사이트를 참조하세요:
https://opencodex.me/
설치 / 통합
npm install -g @bitkyc08/opencodex
ocx start # 프록시 + 대시보드 실행
Node 18+ 필요(Bun 런타임은 자동으로 번들됨). 그런 다음 코딩 어시스턴트를 통해 요청을 라우팅합니다:
codex -m "anthropic/claude-opus-5" "프롬프트 입력"
기여하기
저장소의 CONTRIBUTING.md를 읽은 후 풀 리퀘스트를 열어주세요:
https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
7. 프로젝트 구조
opencodex/
├── bin/ # 바이너리 실행 파일
├── dist/bin/ # 배포용 바이너리
├── docs/ # 문서 파일
├── docs-site/ # 공개 문서 사이트 소스
├── gui/ # 웹 대시보드 인터페이스
├── readme/ # 지역화된 README 파일
├── src/ # 소스 코드
├── structure/ # 관리자 노트 및 아키텍처
└── tests/ # 테스트 스위트
src/는 핵심 프록시 및 변환 로직을 보유하고, gui/는 로컬 웹 대시보드를 구현하며, docs-site/는 opencodex.me의 공개 문서를 제공합니다.
8. 관련 생태계
OpenCodex는 코딩 어시스턴트(Codex, Claude Code, Claude Desktop, Grok Build)와 LLM 제공업체(OpenAI, Anthropic, Google, xAI, Ollama, DeepSeek, Qwen, GLM, Kimi와 같은 오픈소스/자체 호스팅 옵션) 사이에 위치합니다. OpenRouter와 같은 도구와 정신적으로 보완적입니다. 둘 다 제공업체 차이를 추상화하는 것을 목표로 하지만, OpenCodex는 호스팅 API 게이트웨이가 아닌 코딩 어시스턴트 CLI 및 데스크톱 앱과의 로컬 통합을 구체적으로 대상으로 합니다.
9. 라이선스
✅ 소프트웨어 사용, 복사, 수정, 병합, 게시, 배포, 서브라이선스 허용(MIT 라이선스)
✅ 상업 및 개인 프로젝트에 사용 가능
❌ 소프트웨어 사용으로 인한 손해에 대해 작성자에게 책임을 물을 수 없음
ℹ️ OpenCodex는 독립 프로젝트이며 OpenAI, Anthropic 또는 기타 모델 제공업체와 제휴하지 않습니다. 제3자 프록시를 통한 API 트래픽 라우팅은 일부 제공업체의 서비스 약관을 위반할 수 있으므로 사용 전에 각 제공업체의 정책을 검토하세요.
10. FAQ
Q: OpenCodex는 어떤 코딩 어시스턴트와 작동하나요?
A: ocx start로 시작된 로컬 프록시를 통해 Codex, Claude Code, Claude Desktop, Grok Build와 작동합니다.
Q: OpenAI가 아닌 모델을 사용할 수 있나요?
A: 네 — OpenCodex는 Anthropic, Google, xAI, DeepSeek, Qwen, GLM, Kimi, Ollama와 같은 오픈소스 모델을 포함한 40개 이상의 제공업체를 지원하며, provider/model 구문(예: anthropic/claude-opus-5)으로 선택합니다.
Q: OpenCodex를 통해 제공업체 계정을 라우팅하는 것이 안전한가요?
A: 기능적으로는 안전하지만, 일부 제공업체는 제3자 프록시를 통해 트래픽을 라우팅하는 계정을 제한할 수 있습니다. 계정을 연결하기 전에 각 제공업체의 서비스 약관을 검토하세요.
Q: 여러 ChatGPT/Codex 계정을 어떻게 관리하나요?
A: ocx account <...>를 사용하여 계정을 풀링합니다. OpenCodex는 계정별 할당량을 추적하고 최저 사용량, 라운드로빈, 선입선출 정책으로 자동 라우팅할 수 있습니다.
Q: 어떤 플랫폼을 지원하나요?
A: macOS(arm64/x64), Linux(x64/arm64), Windows(x64)를 지원하며, 각각 네이티브 백그라운드 서비스 통합(launchd, systemd, Task Scheduler)을 제공합니다.
11. 빠른 링크
- 저장소: https://github.com/lidge-jun/opencodex
- 공식 사이트 / 문서: https://opencodex.me/
- 기여 가이드: https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
- npm 패키지: https://www.npmjs.com/package/@bitkyc08/opencodex
12. 요약
OpenCodex는 40개 이상의 LLM 제공업체를 완전한 기능 호환성으로 지원하는 로컬 프로토콜 변환 프록시 역할을 통해 인기 코딩 어시스턴트의 단일 제공업체 고정을 제거합니다. 작업 간 모델을 혼합하고, 여러 계정을 효율적으로 풀링하며, 제공업체별 중단이나 할당량 제한에 강력한 코딩 워크플로우를 유지하려는 개발자와 팀에게 가장 가치 있습니다.