opencodex 정리: Codex와 Claude Code에서 2026년 아무 LLM이나 쓰는 법

OpenAI Codex는 강력한 코딩 에이전트예요. 그런데 기본값으로는 OpenAI 모델에 묶여 있어서, Claude나 Gemini로 같은 작업을 하고 싶으면 공식 지원을 기다려야 했죠. opencodex는 그 사이에 얇은 로컬 프록시를 끼워서, Codex 워크플로는 그대로 두고 "두뇌"만 바꿔 끼우게 해 주는 오픈소스 도구예요. 2026년 7월 기준으로 어떤 상태인지, 무엇이 특별한지 정리했어요.

용어: 프록시(proxy) — 두 프로그램 사이에 서서 요청을 대신 전달·번역해 주는 중개 서버예요. 여기서는 Codex가 보내는 요청을 다른 회사 AI가 알아듣는 말로 바꿔 전달하는 역할을 합니다.

opencodex가 뭔가요

한 줄로 말하면 **"Codex와 Claude Code용 유니버설 프로바이더 프록시"**예요. npm install -g @bitkyc08/opencodex로 설치하고 ocx start를 실행하면 내 컴퓨터의 localhost:10100에 작은 프록시가 뜹니다. Codex가 보내는 요청은 이제 이 프록시를 거쳐서 내가 고른 AI 회사로 전달돼요.

내장 프로바이더가 40개가 넘어요. Anthropic(Claude), Google(Gemini), xAI(Grok), DeepSeek, Kimi, Qwen, Ollama, OpenRouter, Azure, Groq, 그리고 OpenAI 자체까지. 스트리밍, 툴 호출, reasoning 토큰, 이미지 처리까지 양방향으로 다 동작합니다. Claude Code도 ocx claude 명령으로 이 프록시에 물려 쓸 수 있어요.

어떻게 동작하나요

원리는 생각보다 단순해요. Codex는 자기만의 API 형식(Responses API)으로 요청을 보내는데, 다른 회사 모델들은 저마다 형식이 조금씩 달라요. opencodex는 이 둘 사이에서 실시간 번역기 역할을 합니다.

Codex CLI / App / SDK ──▶ opencodex ──▶ 원하는 AI 프로바이더
                              │
   Anthropic · Google · xAI · Kimi · Ollama · Groq · OpenRouter · Azure …

덕분에 "누가 Codex에 Claude 지원을 붙여줄 때까지" 기다릴 필요가 없어졌어요. 프록시가 그 번역을 대신 해 주니까요.

진짜 강점 — ChatGPT 계정 풀 자동 관리

opencodex를 단순한 번역기 이상으로 만드는 기능이 바로 계정 풀이에요. Codex를 오래 쓰다 보면 "쿼터(사용 한도)가 다 찼습니다" 하고 막히는 경험을 하게 되죠. opencodex는 여러 ChatGPT/Codex 계정을 등록해 두고 이걸 알아서 굴려 줍니다.

자동 배정: 새 작업이 들어오면 5시간·주간·30일 쿼터를 비교해서, 가장 여유 있는 정상 계정으로 세션을 보내요.
계정 고정(affinity): 이미 진행 중인 대화는 시작한 계정에 그대로 묶여 있어요. 그래서 긴 SSH·tmux·모바일 세션이 대화 도중에 계정을 갈아타는 사고가 없습니다.
자동 복구: 한도(429)에 걸리면 잠깐 쿨다운했다가 다른 계정으로 넘어가고, 로그인이 풀리면(401/403) "재인증 필요"로 표시해 줘요.
쿼터 조회 내장: 대시보드에서 모든 계정의 남은 쿼터를 한 번에 갱신해 볼 수 있어요.

여러 도구를 오가며 AI 에이전트를 오래 돌리는 사람이라면, 이 부분이 왜 반가운지 바로 와닿을 거예요.

설치와 첫 설정 (명령어 세 줄)

준비물은 Node 18 이상 하나예요. Bun 런타임은 설치할 때 자동으로 함께 들어오니까 따로 깔 필요가 없어요.

npm install -g @bitkyc08/opencodex
ocx init      # 대화형 설정 — config 작성 + Codex 연결
ocx start     # 프록시 시작 (localhost:10100)

프로바이더를 추가하는 가장 쉬운 방법은 웹 대시보드예요. ocx gui를 실행하면 브라우저에서 대시보드가 열리고, "Add Provider"를 눌러 API 키를 붙여넣으면 됩니다. Anthropic·xAI·Kimi는 OAuth 로그인도 지원해요. macOS·Linux·Windows 모두 네이티브로 돌아가고, 윈도우에서도 WSL이 필요 없습니다.

지원 모델과 라우팅

모델은 provider/model 형식으로 직접 고를 수 있어요.

codex -m "anthropic/claude-opus-4-8" "이 스택 트레이스 설명해 줘"
codex -m "google/gemini-3-pro" "유닛 테스트 작성해 줘"
codex -m "ollama/llama3" "이 함수 리팩터링해 줘"

provider/ 접두사를 빼면 기본 프로바이더로 가거나 이름 패턴으로 자동 매칭돼요(claude-*는 Anthropic, gpt-*는 OpenAI 식으로요). 비-OpenAI 모델도 gpt-5.4-mini 사이드카를 통해 실제 웹 검색과 이미지 이해를 쓸 수 있게 해 둔 점이 세심해요.

쓰기 전에 꼭 알아둘 점

솔직하게 짚고 갈 부분이 하나 있어요. 여러 ChatGPT/Codex 계정을 풀로 묶어 쿼터를 분산·로테이션하는 건 OpenAI 이용약관과 부딪힐 소지가 있습니다. 학습·실험 목적으로 도구를 이해하는 것과, 실제 업무에서 계정 로테이션에 상시 의존하는 것은 다른 문제예요. 후자를 계획한다면 OpenAI 정책을 먼저 확인하는 게 안전합니다.

도구 자체는 MIT 라이선스로 자유롭게 쓸 수 있지만, 그 도구를 어떻게 쓰느냐에 대한 책임은 사용자에게 있다는 점을 기억하면 돼요.

지금 어떤 상태인가요

2026년 6월 18일 공개(이 글 기준 약 한 달 전)
GitHub 별 1,868개 · 포크 112개 · 오픈 이슈 22개
npm 다운로드 최근 한 달 23,633회(주간 5,244회)
최신 버전 v2.7.30(2026-07-21 발행), 릴리스가 거의 매일 나올 만큼 개발이 빠름
한국 개발자 커뮤니티 GeekNews에도 소개됨

한 달 만에 이 정도 속도면, Codex·Claude Code 생태계에서 눈여겨볼 만한 도구인 건 분명해요.

자주 묻는 질문

Q. Claude Code에서도 쓸 수 있나요? 네. ocx claude 명령으로 Claude Code를 프록시에 연결해 실행할 수 있어요.

Q. 로컬 모델(Ollama)도 되나요? 됩니다. ollama/llama3처럼 로컬 모델을 지정하면 내 컴퓨터에서 돌아가는 모델로 Codex를 쓸 수 있어요.

Q. 유료인가요? opencodex 자체는 MIT 오픈소스라 무료예요. 다만 연결하는 각 AI 프로바이더의 사용료는 별도로 발생합니다.

opencodex 정리: Codex와 Claude Code에서 2026년 아무 LLM이나 쓰는 법