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

9bow · 7월 27, 2026, 11:30오전

opencodex 소개

OpenAI의 Codex CLI나 Claude Code 같은 코딩 에이전트는 특정 백엔드 API에 맞춰 통신합니다. 그래서 Claude, Gemini, Grok, DeepSeek 같은 다른 모델을 쓰고 싶어도, 도구가 해당 제공자를 공식 지원할 때까지 기다려야 하는 경우가 많습니다. 로컬 모델을 붙이거나 여러 계정을 번갈아 쓰는 것도 도구마다 방식이 달라 손이 많이 갑니다.

opencodex는 이 문제를 프록시 계층으로 푸는 도구입니다. Codex의 Responses API 요청을 각 제공자가 이해하는 형식으로 번역해 전달하는 가벼운 로컬 프록시로, 스트리밍, 도구 호출(tool call), 추론 토큰(reasoning token), 이미지가 양방향으로 모두 동작합니다. 덕분에 Codex의 워크플로우는 그대로 두고 뒤에 있는 모델만 바꿀 수 있습니다.

opencodex는 Codex뿐 아니라 Claude Code에서도 같은 방식으로 동작하며, Anthropic, Google, xAI, DeepSeek, Kimi, Qwen, GLM, Ollama를 비롯한 여러 제공자를 지원합니다. OpenAI 자신도 대상 제공자 중 하나로 포함됩니다.

opencodex의 동작 구조

opencodex의 핵심은 하나의 OpenAI 호환 엔드포인트로 여러 모델을 라우팅하는 통합 프록시 계층이라는 점입니다. 아래 그림은 Codex 클라이언트에서 opencodex를 거쳐 각 제공자로 요청이 흘러가는 구조를 보여줍니다.

Codex CLI, 앱, SDK 등 Responses API로 통신하는 클라이언트는 /v1/responses 로 요청을 보내고, opencodex는 이를 받아 Anthropic의 Messages API, Google의 Gemini, 그 외 제공자의 Chat Completions API로 각각 변환해 전달합니다. 이 프록시 계층은 OpenAI 호환 API 표면(surface), 스마트 라우팅과 장애 조치(failover), 사용량 추적과 관측성(observability) 을 제공한다고 설명합니다.

opencodex는 여기에 더해 Codex 인증을 위한 ChatGPT 계정 풀(pool) 을 관리할 수 있습니다. 여러 ChatGPT/Codex 계정을 등록해 대시보드에서 5시간·주간·30일 할당량을 갱신하고, 새 세션은 사용량이 가장 적은 정상 계정으로 자동 배정합니다. 이미 시작된 Codex 스레드는 처음 사용한 계정에 고정(pin) 되므로, 긴 SSH나 tmux, 모바일 연결 세션이 대화 도중에 계정을 바꾸지 않습니다.

opencodex의 모델 라우팅

특정 제공자와 모델은 provider/model 형식으로 지정합니다. Codex를 평소처럼 실행하되 -m 옵션으로 대상 모델만 바꾸면 됩니다.

# Anthropic을 통해 Claude 사용
codex -m "anthropic/claude-opus-5" "이 스택 트레이스를 설명해줘"

# Google을 통해 Gemini 사용
codex -m "google/gemini-3-pro" "auth.ts의 단위 테스트를 작성해줘"

# Ollama로 로컬 모델 사용
codex -m "ollama/llama3" "이 함수를 리팩터링해줘"

provider/ 접두어를 생략하면 기본 제공자로 라우팅하거나, 모델 이름 패턴으로 자동 매칭합니다. 예를 들어 claude-* 는 Anthropic으로, gpt-* 는 OpenAI로 연결됩니다.

opencodex 설치 및 사용법

opencodex는 Node 18 이상 환경에서 동작하며, 설치 시 Bun 런타임이 자동으로 함께 설치됩니다. macOS, Linux, Windows를 모두 네이티브로 지원합니다.

# 설치 (Node 18+ 필요, Bun은 자동 번들)
npm install -g @bitkyc08/opencodex

# 대화형 초기 설정 (설정 작성 + Codex에 주입 + 자동 시작 설정)
ocx init

# 프록시 시작
ocx start

# 이제 Codex를 평소대로 쓰면 opencodex를 거쳐 라우팅됩니다
codex "Rust로 hello world 작성"

제공자 추가는 웹 대시보드에서 가장 빠릅니다. ocx gui 를 실행하면 http://localhost:10100 에 대시보드가 열리고, Add Provider 에서 40개 이상의 내장 제공자 중 하나를 고르거나 OpenAI 호환 커스텀 엔드포인트를 직접 입력할 수 있습니다. API 키를 붙여넣거나 Anthropic, xAI, Kimi는 OAuth로 로그인하면, 제공자의 /v1/models 엔드포인트에서 모델이 자동으로 검색됩니다. 재시작 없이 바로 사용할 수 있습니다.

opencodex의 라이선스

opencodex는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

opencodex 공식 문서

opencodex 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~