Codex 모바일·Hooks·액세스 토큰: 2026년 5월 업데이트 설정 가이드

2026년 5월에 OpenAI가 Codex 인프라 업데이트를 여러 건 발표했습니다. 이 글에서는 각 기능의 내용과 설정 방법을 정리합니다.

업데이트 요약

모바일 액세스

Codex가 ChatGPT 모바일 앱(iOS/Android)에서 프리뷰로 사용 가능해졌습니다. Mac에서 실행 중인 Codex 세션에 스마트폰으로 연결해 diff 확인, 커맨드 승인, 모델 전환, 터미널 출력 실시간 확인이 가능합니다.

설정: 최신 ChatGPT 앱 + Mac용 Codex → QR 코드로 페어링. 코드와 크레덴셜은 호스트 머신에 남습니다.

Hooks 설정

~/.codex/config.toml에서 에이전트 루프의 6개 지점에 커스텀 스크립트를 삽입할 수 있습니다:

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/scan_credentials.py"
timeout = 30
statusMessage = "크레덴셜 스캔 중"

지원 이벤트: SessionStart, PreToolUse, PostToolUse, PermissionRequest, UserPromptSubmit, Stop.

스크립트는 stdin으로 JSON을 받고, 차단 시 {"decision": "block", "reason": "..."} 를 stdout으로 출력합니다.

참고: 문서에 따르면 아직 모든 shell 호출을 인터셉트하지는 못합니다.

액세스 토큰

Business/Enterprise 워크스페이스에서 CI/CD 파이프라인 등 비대화형 Codex 실행이 가능합니다:

export CODEX_ACCESS_TOKEN="<token>"
codex exec --json "저장소를 리뷰하고 보안 이슈를 보고"

ChatGPT 관리 콘솔에서 생성. 만료 기간은 1일~무기한. 생성한 사용자의 워크스페이스 ID를 갖고, 거버넌스 로그에 기록됩니다.

여러 코딩 CLI를 하나의 게이트웨이로

Codex CLI, Claude Code, Gemini CLI 모두 커스텀 엔드포인트를 지원합니다:

Codex CLI — ~/.codex/config.toml:

[api]
base_url = "https://api.evolink.ai/v1"

Claude Code — 환경 변수:

export ANTHROPIC_BASE_URL="https://api.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="your-evolink-key"

Gemini CLI — ~/.gemini/.env:

GEMINI_API_KEY=your-evolink-key
GOOGLE_GEMINI_BASE_URL=https://api.evolink.ai/

하나의 게이트웨이로 통합하면: 비용 통합 대시보드, 429/5xx 자동 폴백, 라우팅 룰을 통한 모델 전환이 가능합니다.

설정 가이드: 3개 코딩 CLI를 하나의 엔드포인트로 통합

참고 링크

• Codex Changelog

• Hooks 문서

• 액세스 토큰