AppSec 에이전트

코드 리뷰, PR 스캔, 위협 모델링, 수정 생성 등을 위한 AI 기반 보안 에이전트입니다.

AppSec 에이전트는 세 가지 방법으로 사용할 수 있습니다:

npm에서 설치: npm install appsec-agent

사전 준비 사항

1. Node.js 18+ — nodejs.org
2. API 키 — 기본적으로 Claude 제공자는 ANTHROPIC_API_KEY를 사용합니다 (Anthropic 콘솔). 선택 사항인 Codex 제공자는 CODEX_API_KEY를 사용합니다 — 구성 참조.
3. 터미널 — 아래 명령은 npx를 사용합니다. 전역 설치한 경우 npx 접두어를 생략하세요.

빠른 시작 (5분)

1. 설치

npm install appsec-agent

또는 전역 설치하여 agent-run이 PATH에 추가되도록 하세요:

npm install -g appsec-agent

2. API 키 설정

셸 프로필(.zshrc, .bashrc 등)에 추가한 후 새 터미널을 여세요:

export ANTHROPIC_API_KEY="your-key-here"

3. 첫 번째 에이전트 실행

# Interactive security Q&A (default role)
npx agent-run

# List every available role
npx agent-run -l

# Review code in the current project
npx agent-run -r code_reviewer -s ./src

이것으로 끝입니다. 단계별 설정, 문제 해결, git 클론에서 실행하는 방법은 시작하기 를 참조하세요.

에이전트 선택

각 역할(role) 은 특화된 워크플로우입니다. -r / --role로 전달하세요.

전체 설명: 에이전트 가이드
복사-붙여넣기 명령 및 JSON 파일 형식: 예제

자주 사용하는 명령

# PR security review (JSON report)
npx agent-run -r pr_reviewer --diff-context pr-diff.json -s ./repo -f json -o report.json

# Threat model (JSON)
npx agent-run -r threat_modeler -s ./src -f json -o threat_model_report.json

# Use OpenAI Codex instead of Claude (opt-in)
npx agent-run -r threat_modeler -s ./src -f json --provider codex -m gpt-4.1

# Add deployment context (helps prioritize findings)
npx agent-run -r code_reviewer -s ./src -c "Production API on AWS, handles PII"

# Version and help
npx agent-run -v
npx agent-run --help

문서

한눈에 보는 기능

• 다중 특화 에이전트 (리뷰, PR 스캔, 위협 모델, 수정, QA, 적대적(adversarial) 검토)
• Claude(기본) 또는 Codex(--provider codex) 백엔드
• 상위 앱 통합을 위한 스키마가 포함된 구조화된 JSON 출력
• PR diff 모드 및 대형 PR 자동 청크 분할
• 실시간 발견 기록, 임포트 그래프, 코드베이스 그래프를 위한 선택적 MCP 도구
• 웹 서버용 스레드 세이프 라이브러리 설계

관련 프로젝트

AI Threat Modeler 는 이 패키지를 인증, 위협 모델 캔버스, PDF/CSV 내보내기, 채팅이 포함된 Docker화된 Next.js 앱으로 묶어 제공합니다 — 통합 코드를 작성하고 싶지 않다면 가장 쉬운 방법입니다.

git clone https://github.com/yangsec888/ai-threat-modeler.git
cd ai-threat-modeler
docker-compose up -d --build
# Open http://localhost:3000  (default: admin / admin)

라이선스 및 저자

Apache 2.0에 따라 라이선스가 부여됩니다.

Sam Li — [email protected]

참고 자료: Claude Agent SDK · Anthropic API