icebear0828/codex-proxy

Codex Proxy – 로컬 AI 프로그래밍 어시스턴트 중계소

개요 – Codex Desktop 프로그래밍 어시스턴트 API를 표준 OpenAI, Anthropic, Gemini, Ollama 호환 엔드포인트로 변환하는 경량 로컬 서버입니다. 이러한 프로토콜을 사용하는 모든 클라이언트(Cursor, Claude Code, Continue, Pi 등)가 클라이언트를 변경하지 않고 Codex 모델을 사용할 수 있습니다.

주요 기능

프로토콜 변환 – /v1/chat/completions (OpenAI), /v1/messages (Anthropic), Gemini, Codex /v1/responses, 선택적 Ollama /api/chat을 수용합니다. SSE 스트리밍, WebSocket 폴백, 함수 호출/도구 호출 및 구조화된 출력 형식을 처리합니다.
계정 풀 및 스마트 라우팅 – OAuth PKCE 로그인, 여러 ChatGPT 계정, 자동 순환(최소 사용, 라운드 로빈, 스티키), 플랜 인식 라우팅, 토큰 갱신, 사용량 추적, 금지 감지 및 구성 가능한 폴백 API 키.
프록시 풀 – 계정별 업스트림 프록시 구성, 상태 확인, 연결할 수 없는 프록시 자동 제외.
탐지 방지/핑거프린팅 – Rust 네이티브 TLS 애드온(reqwest + rustls)이 공식 Codex 데스크톱 클라이언트의 정확한 요청 헤더와 TLS 핑거프린트를 재현하며, 계정별 장치 ID 및 쿠키 재생을 포함합니다.
모델 카탈로그 – 전체 Codex 모델 목록(예: gpt-5.6-sol, gpt-6-astra, 오픈소스 gpt-oss-120b)을 플랜 기반 라우팅, 추론 수준 접미사(-fast, -high, -ultra) 및 풍부한 메타데이터와 함께 노출합니다.
이미지 생성 – /v1/responses 엔드포인트의 image_generation 도구를 통해 내부 gpt-image-2 모델로 전달합니다.

획득 방법

데스크톱 설치 프로그램 – Releases 페이지에서 플랫폼별 .exe, .dmg 또는 AppImage를 다운로드하고 실행한 후 ChatGPT 계정으로 로그인하고 http://localhost:8080을 엽니다.
Node 불필요 "라이트" 번들 – 동일한 백엔드를 포함하지만 Node 20+가 필요한 zip입니다. 제공된 codex-proxy.exe/codex-proxy.sh를 실행합니다(헤드리스 작업에는 --mode=server 사용).
npm 스타일 패키지 – 오프라인 zip을 다운로드하고 node install.mjs를 실행한 다음 codex-proxy 명령으로 시작합니다(Node 22+ 필요).

Docker – 한 줄 명령:

docker run -d --name codex-proxy -p 127.0.0.1:8080:8080 \
  -v codex-proxy-data:/app/data -v codex-proxy-config:/app/config \
  ghcr.io/icebear0828/codex-proxy:latest-lite

더 많은 옵션(메모리 제한, Watchtower 자동 업데이트, Ollama 브리지 등)을 위해 compose 파일도 제공됩니다.

소스에서 – git clone … && npm install && cd web && npm install && npm run dev(개발) 또는 npm run build && npm start(프로덕션). 네이티브 TLS 애드온을 컴파일하려면 Rust 툴체인이 필요하지만 Docker 및 바이너리 릴리스에는 사전 빌드된 바이너리가 포함되어 있습니다.

일반적인 사용법

# 로그인 후 웹 UI에서 프록시 API 키를 얻습니다.
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-proxy-key>" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello!"}],"stream":true}'

응답은 일반 OpenAI 엔드포인트처럼 스트리밍됩니다.

클라이언트 통합 예시

Claude Code (CLI) – ANTHROPIC_BASE_URL 및 ANTHROPIC_API_KEY를 프록시를 가리키도록 설정합니다.
Codex CLI – ~/.codex/config.toml에 공급자 항목을 추가하고 base_url = "http://localhost:8080/v1" 및 wire_api = "responses"를 사용합니다.
Claude Desktop – 개발자 모드를 활성화하고 http://127.0.0.1:8080을 가리키는 타사 추론 게이트웨이를 프록시 키로 구성합니다.
모든 OpenAI 호환 SDK – SDK의 기본 URL을 http://localhost:8080/v1로 설정하고 제공된 키를 사용하기만 하면 됩니다.

중요성

많은 AI 코딩 도구에 단일 로컬 게이트웨이를 제공하여 각 클라이언트가 자체 ChatGPT 로그인을 관리할 필요가 없습니다.
트래픽을 기기에서 유지하고 사용할 계정을 제어할 수 있어 무료 티어 제한 내에 머물거나 여러 유료 계정 간에 부하를 분산하는 데 도움이 됩니다.
Rust TLS 핑거프린팅으로 프록시가 공식 Codex 데스크톱 클라이언트와 구별할 수 없게 되어 업스트림 차단 가능성을 줄입니다.

라이선스 – 비상업적 용도로만 사용(배지에 표시됨).

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.

icebear0828/codex-proxy

Codex Proxy – 로컬 AI 프로그래밍 어시스턴트 중계소

관련