Codex 연동 | API 문서

Codex는 OpenAI Responses 프로토콜로 모델을 호출합니다. 이 페이지에 표시된 OpenAI 호환 기본 URL로 모델 공급자를 설정하세요.

text

Codex base_url: https://api.apihop.ai/openai

사전 준비

먼저 유효한 RequestBeam API 키를 준비하세요. 키는 로컬 Codex 설정 디렉터리에 기록됩니다. 저장소, 로그 또는 스크린샷에 포함하지 마세요.

Codex는 일반적으로 다음 위치에 설정 파일을 저장합니다:

macOS / Linux: ~/.codex/
Windows: %userprofile%\.codex\

디렉터리나 설정 파일이 없다면 먼저 생성하세요:

bash

mkdir -p ~/.codex
touch ~/.codex/config.toml

Windows CMD에서는 다음을 사용하세요:

bat

mkdir %userprofile%\.codex
type nul > %userprofile%\.codex\config.toml

설정 백업

Codex를 사용한 적이 있다면 현재 설정을 먼저 백업하세요:

bash

cp ~/.codex/config.toml ~/.codex/config.toml.bak
cp ~/.codex/auth.json ~/.codex/auth.json.bak

config.toml 업데이트

~/.codex/config.toml을 열고 다음 설정을 추가하거나 업데이트하세요:

toml

model_provider = "requestbeam"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.requestbeam]
name = "RequestBeam"
base_url = "https://api.apihop.ai/openai"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
responses_websockets = true

base_url 규칙은 이 페이지의 공개 API 기본 URL + /openai입니다.

config.toml에 [marketplaces.*], [plugins.*] 또는 다른 도구 설정이 이미 있다면 이를 유지하고 위의 Codex 모델 공급자 설정만 추가하거나 업데이트하세요.

WebSocket 모드

supports_websockets = true와 responses_websockets = true를 활성화하면 Codex는 다음 Responses WebSocket 엔드포인트를 사용합니다:

text

https://api.apihop.ai/openai/responses

API 기본 URL이 https://이면 Codex는 대응하는 wss:// 연결을 사용합니다.

이 WebSocket 모드는 Codex 전용 Responses-over-WebSocket 브리지입니다:

response.create 지원
response.cancel 지원
response.completed 반환
response.processed 호환 이벤트도 유지

response.cancelled는 로컬 취소 요청을 확인합니다. 상위 공급자의 환불을 확인하는 것은 아닙니다. 상위 공급자 결과가 불명확한 요청은 사용량이나 실패가 확인될 때까지 예약 금액을 유지합니다.

이는 OpenAI Realtime API가 아닙니다. session.update, conversation.item.*, input_audio_buffer.*, 오디오 스트리밍, 바이너리 메시지 또는 Realtime 메시지 봉투를 지원하지 않습니다.

네트워크 프록시, 기업 게이트웨이 또는 이전 Codex 버전이 WebSocket 연결을 설정하지 못하면 일시적으로 다음 설정을 사용하세요:

toml

[model_providers.requestbeam]
supports_websockets = false

[features]
responses_websockets = false

그러면 Codex는 HTTP POST https://api.apihop.ai/openai/responses로 전환합니다. Compact는 별도의 기능이며 현재 나열된 다섯 GPT 모델에는 검증된 Compact 채널이 없습니다. HTTP/WebSocket 모드를 바꿔도 압축은 활성화되지 않습니다. 모델의 컨텍스트 한도를 넘기 전에 새 대화를 시작하세요. 이 경로에서는 긴 컨텍스트의 자동 압축에 의존하지 마세요.

API 키 기록

YOUR_REQUESTBEAM_API_KEY를 자신의 RequestBeam API 키로 바꾸세요:

bash

echo '{"OPENAI_API_KEY":"YOUR_REQUESTBEAM_API_KEY"}' > ~/.codex/auth.json

Windows CMD에서는 다음을 사용하세요:

bat

echo {"OPENAI_API_KEY":"YOUR_REQUESTBEAM_API_KEY"} > %userprofile%\.codex\auth.json

재시작 및 테스트

설정을 저장하고 Codex를 완전히 종료한 뒤 다시 여세요.

다음으로 CLI를 테스트할 수 있습니다:

bash

codex "Reply in one sentence whether the current model is available."

VS Code 확장이나 데스크톱 앱은 앱을 완전히 종료한 뒤 다시 열고 일반 채팅을 시작하세요.

문제 해결

base_url은 이 페이지의 공개 API 기본 URL에 /openai를 더한 값이어야 합니다.
wire_api는 responses여야 하며 chat으로 바꾸지 마세요.
Compact를 사용할 수 없다는 오류는 검증된 Compact 채널이 없다는 뜻입니다. 로컬 토큰 임계값을 바꿔도 활성화되지 않습니다.
RequestBeam은 HTTP Responses와 Codex Responses WebSocket을 모두 지원합니다. 기본적으로 supports_websockets = true와 responses_websockets = true를 유지하세요. Codex 버전이나 네트워크 프록시가 WebSocket을 사용할 수 없다면 일시적으로 supports_websockets = false로 설정해 HTTP로 전환하세요.
auth.json은 유효한 JSON이어야 하며 키 이름은 OPENAI_API_KEY여야 합니다.
401 또는 invalid key가 발생하면 API 키가 유효하고 이전 로컬 키로 덮어써지지 않았는지 확인하세요.
모델을 사용할 수 없다면 GET https://api.apihop.ai/v1/models를 확인하고 model과 review_model을 표시된 GPT 모델로 설정하세요. 기본 예제는 gpt-5.4를 사용하며 gpt-5.3-codex와 gpt-5.6-luna는 현재 활성화되어 있지 않습니다.
설정 변경 후 Codex를 완전히 종료하고 다시 여세요. 창만 닫으면 auth.json이 다시 로드되지 않을 수 있습니다.

POST https://api.apihop.ai/openai/responses: 권장 RequestBeam Responses 호환 엔드포인트입니다.
POST https://api.apihop.ai/openai/responses/compact: 명시적으로 활성화된 Compact 채널이 필요하며, 없으면 예약 전에 503을 반환합니다. 지원 채널은 response.compaction을 반환합니다.
WS /openai/responses: Responses WebSocket 호환 엔드포인트입니다. response.create와 response.cancel을 지원하고 response.completed를 반환하며 response.processed 호환 이벤트를 유지합니다.
WS /openai/responses/compact: 동일한 Compact 기능 확인과 엔드포인트를 사용합니다. WebSocket 핸드셰이크만으로 모델 지원이 입증되지는 않습니다.