Codex CLI 연동

OpenAI의 터미널 코딩 에이전트 Codex CLI를 베이즈 Gateway와 함께 사용해보세요!

설정 파일에 프로바이더 하나만 등록하면 파일 생성·수정, 셸 명령 실행, 테스트 실행까지 Codex의 에이전트 루프 전체가 Gateway를 통해 동작합니다. 사용량은 베이즈 계정의 크레딧으로 집계됩니다.

시작하기 전에 베이즈 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.

설치

Codex CLI는 ChatGPT 로그인 대신 커스텀 프로바이더 + API 키 방식으로 Gateway에 연결합니다. ~/.codex/config.toml을 만들거나 아래 내용을 추가합니다.

그리고 API 키를 환경 변수로 설정합니다.

base_url에 /responses를 붙이면 안 되나요?

인터랙티브 모드는 codex만 입력하면 실행됩니다.

셸 도구 호출을 포함한 에이전트 루프가 Gateway 경유로 그대로 동작합니다.

실행 결과 — 모델이 파일을 직접 생성하고, 셸로 실행한 뒤 출력까지 확인해 돌려줍니다.

Codex는 기본적으로 read-only 샌드박스로 실행되므로 파일을 쓰지 못합니다. 파일을 생성·수정하려면 -s workspace-write를 지정하세요. Git 저장소가 아닌 디렉터리에서는 --skip-git-repo-check가 필요합니다.

사용 가능한 모델 목록은 Gateway에서 조회할 수 있습니다.

Codex 전용 튜닝 모델(gpt-5.x-codex 계열)은 기관 설정에 따라 노출되지 않을 수 있습니다. 목록에 없으면 기관 관리자에게 모델 사용 허용을 요청해주세요. 일반 gpt-5.x 모델은 Codex CLI에서 동일하게 동작합니다.

크레딧 잔액은 아래로 확인할 수 있습니다.

401 Unauthorized

404 Not Found

모델을 찾을 수 없음

ChatGPT 로그인 화면으로 이동함

model_provider = "factchat"가 최상단에 설정돼 있는지 확인. 프로바이더가 지정되지 않으면 Codex는 기본 OpenAI 인증을 시도합니다.

응답이 차단되거나 알 수 없는 형식으로 돌아옴

기관 관리자 설정의 데이터 보안 > Gateway API 항목이 켜져 있으면 PII·금칙어 정책이 Gateway 트래픽에도 적용됩니다. 관리자에게 정책 적용 범위를 확인해주세요.

~/.codex/config.toml에서 model_provider 줄을 제거하거나 아래처럼 실행 시점에만 우회합니다.

codex exec가 아무것도 출력하지 않고 멈출 때

codex exec는 표준 입력에서 추가 입력을 읽습니다. 터미널이 붙어 있지 않으면 — 스크립트, CI 작업, 백그라운드 프로세스 — 무한히 기다립니다. 표준 입력을 넘겨주세요.

Request blocked by content policy (400)

조직이 게이트웨이 개인정보 필터를 켠 경우입니다. Codex는 프롬프트와 함께 프로젝트 파일을 보내는데, 여기에는 이메일 주소가 흔히 들어 있습니다. 필터는 메시지 전체를 검사하므로 주소 하나만 있어도 거절됩니다. 조직 단위 설정이므로 관리자에게 문의하세요.

마지막 수정 날짜: Sep 18, 2026

Claude Code

GitHub Copilot CLI