LLM Wiki

opencodex: 어떤 LLM이든 Codex와 Claude Code에서 쓰게 해주는 범용 프록시

Properties2
descriptionPyTorchKR 9bow 게시글의 핵심 내용과 실무적 의미를 원문에 근거해 정리한다.
tagsai-models, open-source, research

5 min read

출처

개요

opencodex는 OpenAI Codex CLI·앱·SDK와 Claude Code에서 다양한 LLM 제공자를 사용할 수 있도록 연결하는 로컬 프록시입니다. Codex의 Responses API 요청을 Anthropic Messages API, Google Gemini API, Chat Completions API 등 제공자별 형식으로 변환합니다. 스트리밍, 도구 호출, 추론 토큰, 이미지 입출력을 지원한다고 소개되어 있습니다. 하나의 OpenAI 호환 엔드포인트를 통해 Anthropic, Google, xAI, DeepSeek, Kimi, Qwen, GLM, Ollama 등으로 모델을 라우팅할 수 있습니다. 프로젝트는 MIT 라이선스로 공개되어 있습니다.

핵심 포인트

  • provider/model 형식으로 사용할 제공자와 모델을 지정할 수 있으며, codex -m 옵션으로 Codex의 기존 워크플로우를 유지한 채 모델을 변경합니다.
  • 제공자 접두어를 생략하면 기본 제공자 또는 모델명 패턴에 따라 자동 라우팅할 수 있습니다.
  • OpenAI 호환 엔드포인트, 스마트 라우팅, 장애 조치(failover), 사용량 추적 및 관측성 기능을 제공합니다.
  • 여러 ChatGPT/Codex 계정을 계정 풀로 관리하고, 새 세션을 사용량이 적은 정상 계정에 배정할 수 있습니다. 이미 시작한 Codex 스레드는 기존 계정에 고정됩니다.
  • Node.js 18 이상에서 동작하며 macOS·Linux·Windows를 지원합니다. npm install -g @bitkyc08/opencodex로 설치하고 ocx init, ocx start로 초기화·실행합니다.
  • ocx gui를 사용하면 http://localhost:10100에서 제공자와 모델을 관리할 수 있으며, 40개 이상의 내장 제공자와 OpenAI 호환 커스텀 엔드포인트를 지원한다고 설명합니다.
  • Anthropic, xAI, Kimi는 OAuth 로그인을 지원하며, 제공자의 /v1/models 엔드포인트에서 모델 목록을 자동 검색할 수 있습니다.

왜 중요한가

코딩 에이전트와 모델 제공자 사이에 호환 계층을 두면 특정 에이전트가 공식 지원하는 백엔드에만 의존하지 않고 여러 상용·로컬 모델을 동일한 작업 흐름에서 시험할 수 있습니다. 특히 Codex나 Claude Code의 클라이언트 사용법을 크게 바꾸지 않고 모델을 교체하거나 라우팅할 수 있다는 점이 핵심입니다. 다만 실제 지원 범위와 기능 호환성은 제공자별 API 차이, 인증 방식, 모델의 도구 호출·멀티모달 지원 여부에 따라 달라질 수 있으므로 사용 전 검증이 필요합니다.

설치 예시

npm install -g @bitkyc08/opencodex
ocx init
ocx start
 
codex -m "anthropic/claude-opus-5" "이 스택 트레이스를 설명해줘"
codex -m "google/gemini-3-pro" "auth.ts의 단위 테스트를 작성해줘"
codex -m "ollama/llama3" "이 함수를 리팩터링해줘"

후속으로 볼 링크 및 키워드

원문

https://discuss.pytorch.kr/t/opencodex-llm-codex-claude-code/11408

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-07-27-pytorchkr-topic-11408-opencodex-llm-codex-claude-code에 source_url 및 HTML 원문과 함께 저장되어 있습니다.