한 줄 정의

opencodex는 OpenAI Codex CLI·앱·SDK 앞에 끼어서, Codex가 보내는 Responses API 요청을 다른 프로바이더가 알아듣는 형식으로 바꿔주는 로컬 프록시야. Codex 클라이언트는 그대로 두고 뒤에 붙는 모델만 갈아 끼우는 자리에 있어. 저장소 기준 별 85개에 MIT 라이선스고 TypeScript로 짰어.

실제로 무엇을 하나

Codex는 원래 OpenAI 모델만 받는데, opencodex가 중간에서 요청과 응답을 양쪽으로 번역해 다른 LLM을 물려줘. 어댑터는 5종류고, OpenAI 호환까지 합치면 40여 개 프로바이더를 받아.

스트리밍, 도구 호출, 추론 토큰, 이미지까지 다 양쪽으로 넘어가. 설치는 npm install -g @bitkyc08/opencodex로 하고, ocx init으로 프로바이더를 고른 뒤 ocx start로 프록시를 띄우면 돼.

왜 중요한가

코딩 에이전트는 도구마다 단축키, 설정, 작업 흐름이 달라서 갈아탈 때마다 다시 익혀야 해. opencodex는 Codex라는 클라이언트 하나를 고정하고 그 뒤의 모델만 바꾸니까, 같은 작업을 모델 여러 개로 비교하거나 특정 프로바이더에 묶이고 싶지 않은 사람이 익숙한 도구를 그대로 쓸 수 있어. 클라이언트 쪽 프로토콜은 안 건드리는 게 다른 방식이랑 갈리는 지점이야.

주의해서 볼 점

OpenAI나 Anthropic 공식 제품이 아니라 독립 커뮤니티 프로젝트야. 특히 Anthropic은 서드파티 프록시로 API 트래픽을 우회하는 계정을 정지하거나 제한할 수 있다고 안내하니까, 프로바이더 약관을 먼저 보는 게 좋아. claude-code-proxy처럼 반대 방향(다른 클라이언트로 Claude를 쓰게 하는) 프록시랑 역할이 다르다는 점도 헷갈리지 않는 게 나아. opencodex가 고정하는 클라이언트는 어디까지나 Codex야.