OpenAI 공식 오픈소스 'Codex Security' CLI 및 TypeScript SDK 둘러보기
코드 내 보안 취약점 탐지와 패치 검증, 위협 모델 수립을 지원하는 OpenAI 공식 보안 스캐너 CLI와 TypeScript SDK의 주요 기능, 설치 환경, 멀티 모델 연동 방식을 정리했습니다.
OpenAI가 코드베이스의 보안 취약점을 탐지하고 수정 패치를 검증하는 오픈소스 도구 'Codex Security'를 CLI와 TypeScript SDK 형태로 공개해 운영하고 있습니다. 2026년 7월 저장소 개설 이후 꾸준히 업데이트가 이어지고 있으며, Apache 2.0 라이선스 기반으로 개발자 터미널과 CI/CD 파이프라인에서 자유롭게 활용할 수 있습니다.

대표 이미지: TAU HOME 편집부 제작 주제별 콘셉트 일러스트. 실제 제품 화면이 아닙니다. Codex Security는 정적 분석과 LLM 기반 심층 조사를 결합해 취약점 후보를 선별하고, 실제 재현 가능성을 검증하며, 대응 패치 초안까지 생성하도록 설계되었습니다. 최근 배포 버전에서는 로컬 웹 대시보드(serve) 명령을 정리하고 파일 기반 아티팩트와 표준 리포트 중심으로 도구 구조를 간소화했습니다.
CLI 설치 및 스캔 워크플로
Codex Security CLI는 cs 또는 codex-security 명령어로 실행합니다. Node.js와 Python 런타임이 모두 준비된 환경에서 전역 npm 패키지로 설치할 수 있습니다.
- 런타임 요구사항: Node.js 22.13.0 이상(22.x 제품군) 또는 24.x, 26.x 버전이 필요하며, Python 3.10 이상이 함께 설치되어 있어야 합니다. Python 3.10 환경에서는 설정 파싱을 위해
tomli패키지를 추가로 설치해야 합니다. - 설치 및 로그인:
npm install --global @openai/codex-security cs login - 스캔 실행:
# 저장소 전체 기본 스캔 cs scan . # 특정 디렉터리 경로 지정 스캔 cs scan . --path src --path tests # 기준 브랜치 대비 Git 변경사항만 스캔 cs scan . --diff origin/main # 심층 분석 모드 실행 cs scan . --mode deep
스캔이 끝나면 터미널에 마크다운 형식의 리포트 파일 경로가 출력됩니다. 동일 저장소에서 cs scans show를 실행하면 가장 최근 완료된 스캔 내역을 다시 조회할 수 있습니다. 파이프라인 연동을 위해 스캔 결과를 SARIF, JSON, CSV 형식으로 내보내는 기능도 기본 제공합니다.
멀티 모델 프로바이더와 외부 이슈 트래커 연동
Codex Security는 OpenAI API에만 종속되지 않는 유연한 모델 공급자 설정을 지원합니다.
OpenAI 외에도 Amazon Bedrock, OpenRouter, Fireworks AI, Cheaper Inference 등을 백엔드로 지정할 수 있습니다. 특히 Amazon Bedrock을 사용할 경우 AWS 자격 증명(Credentials)을 직접 활용하므로 별도의 OpenAI 계정 로그인 없이 사내 클라우드 인프라 정책에 맞춰 스캔을 구동할 수 있습니다.
발견된 보안 이슈를 실무 워크플로에 연결하는 통합 기능도 갖추고 있습니다.
- 이슈 트래커 연동: Linear, Jira, GitHub Issues와 직접 연동해 스캔 결과를 티켓으로 발행하고 추적할 수 있습니다.
- 타사 스캐너 결과 병합: 타 보안 도구의 진단 리포트를 가져와 Codex Security Cloud 또는 로컬 스토리지에 통합 저장할 수 있습니다.
- 권한 제약 사항: 고위험 사이버 공격 벡터 분석이나 일부 민감한 취약점 요청은 OpenAI의 'Trusted Access for Cyber' 승인 계정(Daybreak 프로그램)이 요구됩니다.
보안 정책(SECURITY.md) 자동 생성 및 위협 모델 관리
단순 코드 검사를 넘어 저장소 전반의 보안 거버넌스를 정립하는 보조 명령어도 포함되어 있습니다.
cs policy . 명령을 실행하면 저장소 아키텍처와 기존 설정을 분석해 SECURITY.md 초안을 작성합니다. 이때 정책 생성기는 원본 저장소 파일을 직접 덮어쓰지 않고 외부 경로에 초안과 위협 모델(Threat Model) 문서를 별도로 생성합니다. 개발자는 변경 내역을 검토한 뒤 필요한 보안 정책 파일만 저장소 루트에 반영할 수 있습니다.
이미 완료된 스캔에서 도출된 위협 모델은 재분석 없이 즉시 마크다운으로 추출할 수 있습니다.
cs export --scan SCAN_ID --artifact threat-model --output threatmodel.md
기존 로컬 웹 뷰어 방식에서 벗어나 표준 파일 아티팩트와 CLI 중심으로 정비된 만큼, 대규모 저장소의 주기적 보안 점검과 DevSecOps 자동화 구축에 실질적인 대안을 제공합니다.
출처
- GitHub 저장소: openai/codex-security
- OpenAI 공식 문서: Codex Security CLI Reference