vulnhawk

pip install vulnhawk

# Claude Code CLI - サブスクライバーは無料 (推奨)
vulnhawk scan ./src -b claude-code

# Codex CLI - ChatGPT Pro/Plus サブスクライバーは無料
vulnhawk scan ./src -b codex

# Claude API
export ANTHROPIC_API_KEY=sk-ant-...
vulnhawk scan ./src

# OpenAI API
vulnhawk scan ./src -b openai -m gpt-4o

# Ollama - 無料、ローカル、完全プライベート
vulnhawk scan ./src -b ollama -m llama3.1

vulnhawk scan ./src                      # フルスキャン (デフォルト)
vulnhawk scan ./src --mode auth          # 認証バイパス、チェックの欠落、セッションの欠陥
vulnhawk scan ./src --mode injection     # SQLi、コマンドインジェクション、SSTI、XSS
vulnhawk scan ./src --mode secrets       # ハードコードされたキー、トークン、パスワード
vulnhawk scan ./src --mode config        # デバッグモード、緩いCORS、安全でないクッキー
vulnhawk scan ./src --mode crypto        # 弱いハッシュ、ハードコードされたキー、悪い乱数生成

vulnhawk scan ./src -o json -f results.json        # JSON
vulnhawk scan ./src -o sarif -f results.sarif       # SARIF (GitHub Code Scanning)
vulnhawk scan ./src -o markdown -f report.md        # Markdown レポート

vulnhawk scan ./src --severity high      # Critical + High のみ
vulnhawk scan ./src --severity info      # すべて

# 最初に Semgrep を実行し、次に VulnHawk で拡張
semgrep --config auto ./src -o semgrep.sarif --sarif
vulnhawk scan ./src --sarif-input semgrep.sarif

vulnhawk info ./src    # ファイル、チャンク、言語の内訳をプレビュー

name: VulnHawk Security Scan
on:
  push:
    branches: [main, master]
  pull_request:

permissions:
  security-events: write
  contents: read

jobs:
  vulnhawk:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: momenbasel/vulnhawk@main
        with:
          target: '.'
          backend: 'claude-code'
          claude-code-oauth-token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          severity: 'medium'
          fail-on-findings: 'true'

steps:
  - uses: actions/checkout@v4

  - name: Semgrep (高速パターンスキャン)
    uses: returntocorp/semgrep-action@v1
    with:
      config: auto
      generateSarif: true

  - name: VulnHawk (深い AI 分析)
    uses: momenbasel/vulnhawk@main
    with:
      target: '.'
      backend: 'claude-code'
      claude-code-oauth-token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
      sarif-input: 'semgrep.sarif'

コードベース ──> 探索 ──> チャンク化 ──> 拡張 ──> 分析 ──> 検証 ──> レポート
                │            │          │           │           │
           .gitignore を 関数     関連コード   セキュリティ  重複除去 +
           尊重        クラス    (同じディレ  プロンプト    信頼度
           .vulnhawk- ルート    クトリ + 認 を持つ LLM    スコアリング
           ignore     モジュール 可パターン)

generated/
vendor/
third_party/
*.gen.go

git clone https://github.com/momenbasel/vulnhawk.git
cd vulnhawk
uv venv .venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest