LLM WikiAccess-protected knowledge portal

WIKI

OpenAI Codex Security CLI: 코드베이스를 읽고 취약점을 발견·검증·패치하는 AI 보안 스캐너

왜 지금 봐야 하나 2026년 7월 29일, OpenAI는 Codex Security CLI 를 Apache 2.0 라이선스로 오픈소스 공개했다. 공식 발표 전에 Hacker News 커뮤니티가 먼저 발견했고, OpenAI가 "조용히 릴리스했다"고 인정할 만큼 갑작스러운 공개였다. 이 도구가 주목할 만한 이유는 하나다. 기존 SAST Static Application Security Testing 도구가 코드 패턴만 본다면,

경로human/study/content/ai-frontier/68-openai-codex-security-cli-find-validate-patch.md
카테고리Study
태그#ai-review #cli #find #patch #report #security #study #validate

왜 지금 봐야 하나

2026년 7월 29일, OpenAI는 Codex Security CLI를 Apache 2.0 라이선스로 오픈소스 공개했다. 공식 발표 전에 Hacker News 커뮤니티가 먼저 발견했고, OpenAI가 "조용히 릴리스했다"고 인정할 만큼 갑작스러운 공개였다.

이 도구가 주목할 만한 이유는 하나다. 기존 SAST(Static Application Security Testing) 도구가 코드 패턴만 본다면, Codex Security는 애플리케이션 전체를 읽고 실행 흐름을 이해한 뒤 취약점 후보를 샌드박스에서 실제로 검증한다. 오탐(false positive) 필터링을 LLM과 격리 실행 환경이 함께 담당하는 구조다.

단, 백엔드는 아직 승인된 고객과 파트너만 접근할 수 있는 제한 베타다. 코드는 공개됐지만 스캐너 자체는 게이트 뒤에 있다는 점을 운영자는 미리 확인해야 한다.

기존 SAST의 한계

전통적인 정적 분석 도구(Semgrep, Bandit, ESLint Security)는 코드 패턴을 정규식·AST 규칙으로 매칭한다. 빠르고 CI에 쉽게 통합할 수 있지만 두 가지 문제가 있다.

첫째, 높은 오탐률. SQL 쿼리 문자열을 발견했다고 해서 반드시 SQL 인젝션이 가능한 것은 아니다. 입력이 어디서 오는지, ORM이 파라미터를 어떻게 바인딩하는지, 값이 실제로 조합되는지를 정적 분석만으로 판단하기 어렵다.

둘째, 컨텍스트 부재. 취약점 가능성이 있는 코드 한 줄을 잡아내는 것과, 그 코드가 실제로 악용 가능한 공격 경로를 이루는지를 판단하는 것은 다른 작업이다.

Codex Security는 이 두 문제를 find → validate-in-sandbox → patch 파이프라인으로 해결한다.

파이프라인 아키텍처

① 파일 리뷰
코드베이스 읽기
실행 흐름 이해
취약점 후보 순위화
→
② 검증 (샌드박스)
공격 경로 확인
격리 실행 환경
오탐 제거
→
③ 패치 제안
취약점 수정
수정 후 재검증
패치 유효성 확인
→
출력
report.md
findings.json
coverage.json
SARIF 내보내기
OpenAI Codex Security 스캔 파이프라인

① 파일 리뷰(Find) 단계

전체 저장소를 읽고 입력 흐름, 데이터 변환, 권한 경계를 파악한다. 단순한 패턴 매칭이 아니라 "이 HTTP 파라미터가 어디까지 흘러가는가"를 추적하며 취약점 후보를 심각도와 신뢰도 순으로 정렬한다.

② 검증(Validate) 단계

샌드박스 환경에서 공격 경로가 실제로 존재하는지 검증한다. 격리된 실행 환경이 페이로드를 시도해보고 응답을 관찰한다. 이 단계가 오탐을 제거하는 핵심이다.

③ 패치(Patch) 단계

검증된 취약점에 대해 수정 코드를 제안하고, 수정 후 다시 검증해 패치가 취약점을 실제로 닫았는지 확인한다.

출력 아티팩트

스캔이 완료되면 네 가지 결과물이 생성된다.

파일용도
report.md사람이 읽는 보고서. 취약점 목록·위치·수정 제안 포함
findings.json머신 소비용. 심각도·신뢰도·영향 위치·증거·수정 지침
coverage.json스캔이 커버한 파일·함수 범위
scan-manifest실행 메타데이터. 실행 재현 및 추적에 사용

SARIF(Static Analysis Results Interchange Format) 내보내기도 지원한다. GitHub Advanced Security, Defect Dojo, 기타 코드 스캐닝 도구와 연동할 때 사용한다.

# SARIF 내보내기 (Python 3.10+ 필요)
npx codex-security export --format sarif --output results.sarif

주요 기능

전체 저장소 스캔

npx codex-security scan .

대규모 저장소는 서브디렉터리를 지정해 범위를 좁힌다.

npx codex-security scan ./src/api

diff 단위 스캔

풀 리퀘스트에서 변경된 파일만 분석할 수 있다. 스캔 시간을 줄이고 "이 패치가 새 취약점을 도입했는가"에 집중한다.

# staged 변경사항만 스캔
npx codex-security scan --diff HEAD

CI/CD 통합과 심각도 게이트

# high 이상 심각도 발견 시 exit 1
OPENAI_API_KEY=$KEY npx codex-security scan . --fail-on-severity high

GitHub Actions 예시:

- name: Codex Security Scan
  run: npx codex-security scan . --fail-on-severity high
  env:
    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

런-간 추적

이전 스캔 결과와 비교해 새로 생긴 취약점과 해결된 취약점을 구분한다. 리그레션을 잡고 수정 진척도를 추적하는 데 유용하다.

설치 및 인증

# Node.js 22+ 필요
npm install -g @openai/codex-security

# 대화형 사용: ChatGPT 계정으로 인증
npx codex-security login

# CI/CD: API 키로 인증
export OPENAI_API_KEY=sk-...

내보내기(export) 명령은 Python 3.10+가 추가로 필요하다.

현재 한계와 운영 고려사항

오픈소스 (Apache 2.0)
CLI / TypeScript SDK
github.com/openai/codex-security
누구나 설치 가능
→
제한 베타 (게이트)
스캐너 백엔드
승인된 고객·파트너만
API 키 필요
⚠ 코드는 공개됐지만 실제 스캔은 OpenAI가 접근을 제어하는 백엔드에 의존한다
Codex Security 접근 모델과 운영 경계

접근 제한. CLI는 누구나 설치할 수 있지만 실제 스캔 실행은 OpenAI의 게이트된 백엔드를 호출한다. 승인된 고객·파트너가 아니면 현재 스캔이 실행되지 않는다.

비용 모델. OpenAI API 과금 모델을 따른다. 대규모 저장소를 스캔하면 토큰 비용이 상당할 수 있다. 현재 정확한 요금표는 공개되지 않았다.

--json 제한. validate, patch, login, logout 명령은 --json 플래그를 지원하지 않는다. 구조화된 출력이 필요한 자동화 파이프라인을 설계할 때 주의해야 한다.

TypeScript SDK. CLI 외에 TypeScript SDK도 제공된다. 스캔을 기존 빌드 도구나 플랫폼에 프로그래매틱으로 통합할 때 사용한다.

도입 체크리스트

현재 상태 확인부터 시작하라. 베타 접근 신청 전에 아래 항목을 먼저 검토한다.

Open question

References