OpenAI 외의 다양한 LLM을 사용할 수 있게 해주는 로컬

작업 성격에 따라 Claude나 Gemini 같은 타사 모델로 교체하고 싶어 하는 Codex(AI 코딩 도구) 사용자가 많다. opencodex(LLM 연결 로컬 프록시)는 Codex에서 OpenAI 외의 다양한 LLM을 사용할 수 있게 하는 로컬 프록시다. 이 도구는 Codex와 LLM 프로바이더 사이에 위치하여 두 지점의 프로토콜을 실시간으로 번역하는 방식으로 작동한다.

기술적 지원 범위는 단순한 텍스트 전송을 넘어선다. 스트리밍과 도구 호출, 추론 토큰, 이미지 기능이 모두 양방향으로 작동한다. 이를 통해 사용자는 Codex의 인터페이스와 작업 흐름을 그대로 유지하면서도, 연결된 외부 LLM 프로바이더가 제공하는 고도화된 기능들을 제약 없이 사용할 수 있다.

시스템 복구 및 제거 절차는 명확하게 정의되어 있다. `ocx stop` 명령어를 실행하면 Codex의 설정과 카탈로그, 세션 히스토리가 전부 원본 상태로 복원된다. 이 과정에서 시스템 내에 어떠한 잔여물도 남지 않는다. 대시보드에 배치된 Stop 버튼을 누르거나 `ocx service uninstall` 명령어를 입력해도 동일하게 원본 상태로 돌아간다.

마이그레이터를 통해 opencodex 전환 후에도 기존

사용자가 더 나은 성능의 모델을 찾아 도구를 교체하는 속도는 빠르지만, 기존 데이터의 이전 비용은 늘 병목이 된다. SQLite(관계형 데이터베이스 엔진) 마이그레이터는 opencodex(Codex의 로컬 프록시) 전환 후에도 기존 세션 히스토리를 유지한다. Codex가 각 쓰레드의 model_provider를 DB에 저장하는 구조 때문에 전환 시 기존 세션이 보이지 않는 문제를 해결했다. SQLite를 직접 열어 inject/restore 시점에 model_provider 태그를 강제로 변경하는 방식을 사용한다. 파일 mtime(최종 수정 시간)을 보존해 세션 재개 순서가 유지되도록 구현했다. 데이터 손실 없이 환경을 전환할 수 있는 기술적 장치를 마련한 것이다.

기능적 제약은 모델의 지능보다 인터페이스의 한계에서 오는 경우가 많다. 사이드카 기능을 통해 OpenAI 외 모델에서도 웹 검색과 이미지 이해 기능을 사용할 수 있다. ChatGPT 로그인을 거쳐 gpt-5.4-mini 사이드카로 기능을 라우팅하는 구조를 채택했다. 이를 통해 Claude나 GLM 같은 타사 모델을 사용하면서도 실제 웹 검색 기능을 수행할 수 있다. 특정 모델이 가진 기능적 결여를 외부 경로로 보완해 인터페이스의 일관성을 유지했다. 모델 종속성 없이 Codex 환경에서 최적의 모델과 기능을 선택해 사용할 수 있는 유연성을 확보했다.

확인해야 할 핵심 지점

최신 모델의 성능 우위가 유지되는 기간이 극단적으로 짧아졌다. Codex 환경을 사용하면서도 Claude나 Gemini 같은 타사 모델을 즉시 도입하고 싶어 하는 요구가 늘어난 배경이다. Codex는 Responses API(/v1/responses)라는 자체 프로토콜만 사용하는데, 시중의 대부분 LLM은 이 규격을 구현하지 않는다. opencodex는 이 전용 API를 실시간으로 번역해 40개 이상의 LLM 프로바이더를 연결함으로써 모델 교체에 드는 기술적 허들을 제거했다.

번역 체계는 5종의 프로토콜 어댑터를 중심으로 작동한다. Anthropic Messages, Google Gemini, Azure, OpenAI passthrough, OpenAI-compatible Chat Completions로 각각 변환하여 데이터를 전달한다. 40개 이상의 프로바이더가 기본적으로 내장되어 있어 사용자는 복잡한 API 재작성 과정 없이 다양한 모델을 즉시 호출할 수 있다. 이는 특정 모델 종속성 없이 Codex 환경 내에서 작업 성격에 최적화된 모델을 선택해 사용할 수 있는 실질적인 유연성을 확보한 결과다.

설치 및 운영 환경의 접근성 또한 고려했다. MIT 라이선스로 공개되어 있으며 macOS, Linux, Windows 모든 주요 OS에서 네이티브로 작동한다. 특히 Windows 환경에서 필수적으로 요구되던 WSL(Windows Subsystem for Linux, 윈도우 내 리눅스 실행 환경) 설치 과정이 필요 없다는 점이 특징이다. `npm install -g @bitkyc08/opencodex` 명령어를 통해 npm 패키지 매니저에서 즉시 설치하고 효율적으로 업데이트를 관리할 수 있다.

Codex 환경에서 Claude나 Gemini 같은 타사 모델을 사용하려던 시도는 opencodex의 API 실시간 번역으로 실현된다. 5종의 프로토콜 어댑터와 SQLite 기반 세션 마이그레이션은 40개 이상의 LLM 프로바이더를 연결하는 기술적 근거가 된다. 특정 모델에 종속되지 않고 작업 성격에 맞는 최적의 모델을 선택하는 유연성을 확보한 셈이다.

`npm install -g @bitkyc08/opencodex` 명령어로 즉시 설치하여 모델 선택의 주도권을 가져올 수 있다. 이제 도구의 교체가 아니라 모델의 조합이 개발 효율을 결정한다.