Codex Security 플러그인 빠른 시작

Codex Security 플러그인을 설치한 뒤 로컬 리포지터리에서 표준 스캔을 실행하고 발견된 보안 이슈를 검토하세요. 스캔은 소스 코드를 변경하지 않으며, 보안 이슈의 근거와 해결 방법을 담은 보고서를 저장합니다.

플러그인 설치

버전 및 업데이트 확인

시간이 오래 걸리는 스캔을 시작하기 전에 플러그인 변경 로그를 확인하세요. 설치한 플러그인은 데스크톱 앱의 플러그인 메뉴나 Codex CLI의 /plugins에서 관리할 수 있습니다. 자세한 내용은 플러그인 가이드를 참고하세요. 플러그인을 업데이트한 뒤에는 새 채팅을 시작해 플러그인의 스킬과 도구를 불러오세요. Codex CLI에서는 /new를 입력하세요.

Codex와 Codex Security 플러그인의 버전은 별도로 관리됩니다. Codex CLI에서 다음 명령어로 호스트 버전과 설치된 플러그인의 버전을 확인하세요.

codex --version
codex plugin list --json

installed 목록에서 Codex Security를 찾으세요. 스캔을 시작할 때 두 버전을 모두 기록해 두면 스캔 실패를 보고할 때 함께 전달할 수 있습니다.

독립 실행형 @openai/codex-security 패키지에는 자체 플러그인이 포함되어 있습니다. 이 패키지를 업데이트해도 Codex에서 사용하는 마켓플레이스 플러그인은 업데이트되지 않습니다. 패키지 설치 및 버전 확인 방법은 CLI 빠른 시작을 참고하세요.

Amazon Bedrock을 사용하려면 Codex Bedrock 가이드에 따라 Codex 호스트를 설정하세요. 독립 실행형 패키지는 별도의 Security CLI 공급자 설정을 사용합니다.

첫 스캔 실행

최상의 스캔 결과를 얻으려면 gpt-5.6-sol 모델을 사용하고 추론 수준을 xhigh로 설정하세요.

1. 스캔 설정 열기

   사이드바에서 보안을 선택하고 스캔을 연 뒤 + 스캔을 선택하세요.

2. 코드베이스와 스캔 범위 선택

   기존 리포지터리를 선택하거나 다른 폴더를 사용하세요. 코드베이스를 선택하고 심층 스캔은 끈 상태로 두세요. 리포지터리 전체 또는 폴더 하나를 선택하세요. 브랜치와 리비전이 스캔하려는 코드를 가리키는지 확인하세요.

3. 보안 컨텍스트 추가

   모델과 추론 수준을 선택하세요. 검토에 참고할 공격 벡터, 보안에 민감한 영역 또는 리포지터리의 특성을 설명해야 할 때만 추가 컨텍스트를 여세요.

   

4. 스캔 시작

   스캔 시작을 선택하고 보안 작업 화면에서 단계별 진행 상황을 확인하세요. 스캔을 수행하는 Codex 작업을 살펴보려면 활동 보기를 선택하세요.

5. 결과 검토

   완료된 스캔을 열어 보안 이슈, 검토 범위, 생성된 보고서 파일을 확인하세요. 여러 스캔에서 발견된 이슈를 검토하려면 보안 이슈를 열고, 특정 리포지터리의 스캔 기록을 확인하려면 리포지터리를 여세요.

   

결과 해석

먼저 스캔 대상과 리비전을 확인하세요. 그런 다음 어느 영역을 검토했고 어느 영역의 검토를 보류했는지 살펴보세요. 스캔이 완료되어도 검토하지 못한 영역이 있을 수 있습니다. 보고된 보안 이슈가 없어도 취약점이 남아 있을 수 있습니다.

보안 이슈를 열어 소스 코드에서 찾은 근거, 공격에 필요한 조건, 검증 내용, 아직 불확실한 점을 확인하세요. 재현 코드를 실행하지 않고 소스 코드 분석만으로 검증하는 경우도 있습니다. 기록된 검증 방법과 근거를 바탕으로 해당 이슈가 자신의 시스템에도 적용되는지 판단하세요.

스캔 결과물

데스크톱 앱에서는 완료된 스캔이 스캔 목록에 남습니다. Codex CLI에서는 대화에 표시된 스캔 디렉터리를 여세요. report.md를 열면 보고서 형식으로 결과를 읽을 수 있습니다. 필요하면 findings/에 취약점 상세 보고서를, hardening/에 보안 강화를 위한 설계 제안서를 생성하도록 요청할 수 있습니다.

스캔 디렉터리에는 도구와 자동화에 사용할 수 있는 scan-manifest.json, findings.json, coverage.json도 있습니다. 보고서의 링크가 계속 작동하도록 결과를 공유하거나 보관할 때는 디렉터리 전체를 하나로 유지하세요.

다음 워크플로우 선택

• 다음 스캔의 범위와 보안 컨텍스트를 설정하거나 코드 변경 사항을 검토하세요.
• 보안 이슈의 근거가 타당하다고 판단하면 보안 이슈를 해결하고 수정 결과를 검증하거나 이슈로 등록해 추적하세요.

다른 스캔 모드와 워크플로우를 살펴보려면 Codex Security 개요로 돌아가세요.