Codex · 릴레이(중계)

Codex 릴레이(중계): 중국에서 Codex API 접속

Codex CLI, VS Code 확장 프로그램, 데스크톱 앱은 모두 사용자 지정 모델 공급자를 지원합니다. base_url을 AICodeWith로 지정하고 키를 auth.json에 넣으면 중국 본토 네트워크에서 Codex를 바로 사용할 수 있습니다. ChatGPT 요금제 없이 선불 잔액에서 토큰 단위로 청구됩니다.

마지막 확인

Codex 릴레이 작동 방식

기본적으로 Codex는 ChatGPT 계정 로그인 또는 OpenAI API 키를 사용합니다. 또한 config.toml에서 model_provider를 선언할 수 있습니다. Codex는 해당 공급자의 base_url로 요청을 보내고 auth.json의 키로 인증합니다. 릴레이(중계)는 호환 인터페이스를 제공하므로 Codex 자체를 수정할 필요가 없습니다.

이 방식은 API 사용량 기준으로 청구되며 유료 ChatGPT 요금제를 거치지 않습니다.

설정 단계 (CLI, VS Code, 데스크톱)

  1. 1. Codex 설치

    npm으로 명령줄에서 @openai/codex를 설치하세요. VS Code 확장 프로그램과 데스크톱 앱은 다운로드 페이지를 참고하세요.

    터미널
    npm install -g @openai/codex
  2. 2. 키 발급

    AICodeWith 콘솔의 API Keys 페이지에서 키를 생성하세요.

  3. 3. auth.json 작성

    키를 ~/.codex/auth.json에 넣으세요(Windows: %USERPROFILE%\.codex\auth.json).

    ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "你的_API_KEY"
    }
  4. 4. config.toml 작성 후 재시작

    다음 섹션의 예시로 config.toml을 작성한 뒤 터미널, VS Code 또는 데스크톱 앱을 재시작하세요. 세 가지 모두 동일한 ~/.codex 디렉터리를 읽습니다.

Codex 다운로드 (CLI / 데스크톱 / VS Code)auth.json 참고

config.toml 예시

~/.codex/config.toml
model_provider = "codex"
model = "gpt-5.6-sol"

[model_providers.codex]
name = "codex"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

model은 모델 페이지에 나열된 다른 Codex 호환 모델로 변경할 수 있습니다. 파일을 저장한 뒤 Codex를 다시 열어야 변경 사항이 적용됩니다.

config.toml 전체 참고

가격 및 청구

입력 및 출력 토큰은 실제 사용량에 따라 선불 잔액에서 차감되며, 요청별 사용량은 콘솔에서 확인할 수 있습니다. 잔액은 12개월 동안 유효하며 매월 초기화되지 않습니다. 모델별 실시간 가격은 모델 페이지에 나와 있습니다.

OpenAI 모델 및 가격충전 및 요금제

릴레이 공급자 선택 방법

  • 릴레이가 Codex에 필요한 responses API(wire_api = "responses")를 지원하는지 확인하세요. 지원하지 않는 릴레이는 곧바로 오류를 반환합니다.
  • 청구가 투명한지: 요청별 토큰 사용량을 볼 수 있고, 각 키마다 지출 한도를 설정할 수 있는지 확인하세요.
  • 피크 시간에도 안정적으로 유지되는지, 여러 채널 간 전환이 가능한지 확인하세요.
  • 명확한 환불 정책이 있는지 확인하세요. AICodeWith는 미사용 잔액을 90일 이내에 환불할 수 있으며, 10% 처리 수수료가 차감됩니다. 자세한 내용은 환불 정책을 참고하세요.

자주 발생하는 오류

오류일반적인 원인해결 방법
401 Unauthorizedauth.json의 키가 잘못되었거나 공백이 포함되어 있거나, 환경 변수에 이전 OPENAI_API_KEY가 남아 있는 경우키를 다시 복사하고 환경 변수를 확인한 뒤 Codex를 재시작하세요
429 Too Many Requests동시성 또는 요청 속도가 너무 높거나, 잔액/지출 한도가 부족한 경우동시성을 낮추고 잠시 후 다시 시도하며, 잔액과 키의 지출 한도를 확인하세요
Connection timeoutbase_url이 잘못되었거나 로컬 프록시가 간섭하는 경우base_url을 확인하고 프록시를 잠시 비활성화한 뒤 다시 시도하세요

Codex 401 문제 해결Codex 429 문제 해결

FAQ

Codex 릴레이는 어떻게 사용하나요?

콘솔에서 키를 생성해 ~/.codex/auth.json에 넣고, ~/.codex/config.toml의 model_provider에 있는 base_url을 AICodeWith로 설정한 뒤 Codex를 재시작하세요.

ChatGPT 계정 키가 아닌 키를 사용할 수 있나요?

네. Codex는 사용자 지정 모델 공급자를 지원하므로 릴레이 API 키를 대신 사용할 수 있으며, ChatGPT 계정이나 유료 요금제가 필요 없습니다.

어떤 모델을 지원하나요?

Codex에서 사용할 수 있는 GPT 계열 모델을 지원합니다. 정확한 목록과 실시간 가격은 OpenAI 모델 페이지를 참고하고, config.toml의 model 필드로 전환하세요.

401 / 429가 발생하면 어떻게 해야 하나요?

401은 보통 키가 잘못되었거나 이전 환경 변수가 남아 있을 때 발생합니다. 키를 다시 복사하고 재시작하세요. 429는 동시성이 너무 높거나 잔액/한도가 부족할 때 발생합니다. 동시성을 낮추고 잔액을 확인하세요.

크레딧은 어떻게 구매하나요?

등록 후 충전 페이지에서 중국 내 현지 결제 수단으로 충전하거나 선불 요금제를 구매하세요. 사용량 기준으로 청구되며, 잔액은 12개월 동안 유효하고 매월 초기화되지 않습니다.

지금 사용해 보세요

요금은 선불 잔액에서 토큰 단위로 청구됩니다. 속도 및 동시성 제한이 적용되며, 각 API 키에 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다.

관련 항목

AICodeWith는 독립적인 제3자 API 서비스이며 Anthropic 또는 OpenAI와 제휴 관계가 없습니다. Claude, Claude Code, Codex 및 유사 명칭은 각 소유자에게 속합니다. 가격은 모델 페이지의 실시간 데이터를 기준으로 하며, 속도 및 동시성 제한이 적용됩니다. 환불 시 10% 처리 수수료가 부과됩니다. 자세한 내용은 환불 정책을 참고하세요.