agentleFS
HiyokoSauna37HiyokoSauna37/claudecode-re-toolkit/CLAUDE.md

claudecode-re-toolkit

CLAUDE.md17 starsChanged 2 months agoMITView on GitHub

Claude Codeを利用したマルウェア解析ツールキット。 静的解析(Ghidra Headless)、動的解析(VMware Sandbox)、Webフォレンジック(Proxy Web)、脅威インテリ問合せ(threat-intel)の4つのスキルを統合し、Claude Codeからワンストップでマルウェア解析を実行できる。 リポジトリルートに .env を作成(.env.example を参照): malware-fetch.exeはリポジトリに同梱済み。Goビルド不要。 tools/malware-sandbox/docs/VM-SETUP.md を参照してVM環境を構築。

  • Reads credentials

The file

Files
CLAUDE.md

CLAUDE.md

About This Repository

Claude Codeを利用したマルウェア解析ツールキット。 静的解析(Ghidra Headless)、動的解析(VMware Sandbox)、Webフォレンジック(Proxy Web)、脅威インテリ問合せ(threat-intel)の4つのスキルを統合し、Claude Codeからワンストップでマルウェア解析を実行できる。

Repository Structure

claudecode-re-toolkit/
├── .claude/skills/              # Claude Code スキル定義
│   ├── ghidra-headless/          # 静的解析(Ghidra Docker)
│   │   └── references/           #   deep-static-analysis.md 等
│   ├── malware-fetch/            # Web安全アクセス&フォレンジック
│   ├── malware-sandbox/          # VMware動的解析
│   │   └── references/
│   │       ├── guides/           #   操作手順 (post-execution-audit, x64dbg-mcp 等)
│   │       └── knowledge/        #   マルウェア族情報 (vidar, donutloader 等)
│   ├── android-sandbox/           # Android動的解析(SDK Emulator + Frida + CDP)
│   │   └── references/
│   │       ├── guides/           #   セットアップ、Frida、CDP手順
│   │       └── knowledge/        #   NMMPパッカー等のナレッジ
│   ├── threat-intel/             # OSINT/脅威インテリ統合 (18 services)
│   └── toolkit-setup/            # 環境構築ガイド
├── tools/
│   ├── android-sandbox/          # Android Sandbox (SDK Emulator + Frida scripts)
│   ├── ghidra-headless/          # Ghidra Headless (Docker + scripts/)
│   ├── malware-fetch/            # Proxy Web (Go + Docker)
│   ├── malware-sandbox/          # VMware Sandbox (sandbox.sh + guest-scripts/)
│   ├── threat-intel/             # 脅威インテリ CLI (Python)
│   ├── dotnet-decompiler/        # .NET デコンパイラ (Docker + ILSpy)
│   ├── quarantine/               # Defender Quarantine 復号 (Go)
│   ├── mergen/                   # Mergen スキャナ (Docker)
│   └── gui-prototype/            # ツールキット GUI (Flask)
├── reports/
│   ├── campaigns/                # 解析レポート (.md)
│   ├── screenshots/              # 証拠スクリーンショット (.png)
│   └── writeups/                 # Zenn記事・評価文書
└── notes/
    └── bug_bounty/               # 脆弱性調査・PoC

Setup

前提条件

  • Windows 10/11(Linux/macOSは未サポート)
  • Claude Code がインストール済み
  • Docker Desktop がインストール・起動済み
  • VMware Workstation Pro(malware-sandboxスキルに必要、vmrun CLI利用)
  • Go 1.26+ (Go版ツールをソースからビルドする場合のみ。ビルド済み .exe は同梱)
  • Python 3.10+

環境変数

リポジトリルートに .env を作成(.env.example を参照):

cp .env.example .env
# .env を編集して各APIキー・パスワードを設定

各ツールのセットアップ

malware-fetch(Docker必須)

docker build -t malware-fetch-browser:latest tools/malware-fetch/

malware-fetch.exeはリポジトリに同梱済み。Goビルド不要。

ghidra-headless(Docker必須)

docker compose -f tools/ghidra-headless/docker-compose.yml up -d

malware-sandbox(VMware Workstation必須)

tools/malware-sandbox/docs/VM-SETUP.md を参照してVM環境を構築。

android-sandbox(Android SDK必須)

# Android SDK cmdline-tools をダウンロードし、.env の ANDROID_SDK_PATH を設定
# 詳細は .claude/skills/android-sandbox/SKILL.md の「前提条件」を参照

Skills

malware-fetch

危険なWebサイト(マルウェア配布サイト、フィッシングサイト等)にDockerコンテナ経由で安全にアクセスし、スクリーンショット・HTML・ダウンロードファイルを暗号化取得。VirusTotal / MalwareBazaar / ThreatFox連携。

ghidra-headless

Ghidra Headless AnalyzerをDockerコンテナで実行し、バイナリの静的解析(インポート分析、文字列抽出、デコンパイル、YARA/CAPA/IOC抽出、マルウェア分類)を自動化。

malware-sandbox

VMware Workstation上のWindows VMをvmrun CLIで操作し、Windows PEマルウェアの動的解析を実行。3-Level Unpacking System(memdump-racer / TinyTracer / mal_unpack)、Frida DBI、FakeNet-NGによるC2通信キャプチャに対応。

android-sandbox

Android SDK エミュレータ上でAPKマルウェアの動的解析を実行。Frida serverによるランタイムフック(DEXダンプ、API監視)、CDP(Chrome DevTools Protocol)によるWebViewインスペクション、logcat/ネットワーク監視に対応。NMMPパッカー等で保護されたAPKのランタイムアンパックに対応。

threat-intel

18 OSINTサービス統合CLI(VirusTotal / Hybrid Analysis / Triage / MalwareBazaar / ThreatFox / OTX / URLHaus / URLScan.io / Shodan / AbuseIPDB / GreyNoise / IPInfo / BGPView / Whois/RDAP / NIST NVD / VulnCheck / Malpedia / Malshare)。correlate-hash / correlate-ip で複数サービス横断問合せ、IOC抽出(pdf/eml/url, SSRF防御)、MITRE ATT&CK マッピング、HTML/PDFレポート対応。

Analysis Workflow

Windows PE マルウェア

1. malware-fetch でURLアクセス → バイナリ取得(暗号化)
2. ghidra-headless で静的解析 → パッカー/ファミリー判定
3. パック済み or 静的解析限界 → malware-sandbox で動的解析
4. アンパック後バイナリ → ghidra-headless で再解析
5. 平行: threat-intel で hash/IP/URL/CVE を相関問合せ → 帰属判定

Android APK マルウェア

1. malware-fetch でフィッシングURL → APK取得(暗号化)
2. android-sandbox apk-triage で静的トリアージ → パッカー/権限/JNI文字列
3. ghidra-headless で native lib (.so) 解析 → パッカー内部構造
4. android-sandbox でエミュレータ動的解析 → logcat/CDP/Frida
5. NMMPパッカー → frida-dump-dex でランタイムDEXダンプ → jadx/Ghidra再解析
6. 平行: threat-intel で hash/IP/URL を相関問合せ → 帰属判定

Security Notes

  • マルウェアファイルはコンテナ内でAES-256-CBC暗号化。ホストに生バイナリは出現しない
  • VM動的解析は必ずネットワーク隔離(Host-Only)で実行
  • Quarantine / output ディレクトリはGitignore設定済み
  • ホストOS上でマルウェアを復号化しないこと — 必ずDocker/VM内で復号

Claudeへの指示

回答スタイル

  • 結論ファースト、簡潔に
  • 段階報告不要

マルウェアファイルの復号化

  • ホストOS上で絶対にマルウェアを復号化しない
  • 暗号化ファイルはそのままDocker/VMにコピーし、内部で復号する
  • この規則は絶対に破らないこと

Git管理

  • 解析ツールのコード変更があればコミット&プッシュ
  • Quarantine / output / logs ディレクトリはコミットしない

個人情報(PII)漏洩防止 — 絶対厳守

このリポジトリは公開GitHub repo (HiyokoSauna37/claudecode-re-toolkit)。過去に実メール・ホストユーザー名がcommit/blobに混入し、履歴書き換え+force-pushで除去した経緯がある。再発させない。

書き込み禁止パターン(具体値は書かず抽象化して理解する)

カテゴリ置換先
ホストWindowsの絶対パス(C:\Users\<本名系>\...)<host-user> / %USERPROFILE% / ~
VMゲストOSの絶対パス(C:\Users\<ゲスト名>\...)<guest-user> / <GUEST_PROFILE> / <GUEST_TOOLS> / <GUEST_ANALYSIS_DIR>
個人メールアドレス(各種 ISP/プロバイダドメインの普通のメール)<ID>+<username>@users.noreply.github.com
個人Obsidianパス(notes/*)、ホスト上の外部プロジェクトパスリポ内相対パスのみ使用

プレースホルダの使い分け(ホスト/ゲスト共通):

  • プロファイル(ホーム相当)単位で参照: %USERPROFILE% / ~ / <GUEST_PROFILE>(シェルで展開される既存変数を優先)
  • 意味的に名前だけ欲しい時: <host-user> / <guest-user>(プレーンテキスト説明内)
  • ツール/解析ディレクトリなど 派生パス を指す時: <GUEST_TOOLS> / <GUEST_ANALYSIS_DIR>

派生式は CLAUDE.md に書かない。実際の導出 (GUEST_ANALYSIS_DIR=${GUEST_PROFILE}\Desktop\analysis など) は .env.example と tools/malware-sandbox/sandbox.sh が single source of truth。CLAUDE.md では placeholder の意味と方針のみを示し、実値は環境変数/既存ツールに委ねる。

許容される公開識別子: GitHubハンドル・コミッター表示名のみ。具体的な値は git config user.email / git log --format=%an | sort -u で確認できるコミッターエイリアスの範囲にとどめる。

Go バイナリは -trimpath 必須

go build はソースファイルの絶対パスをバイナリに埋め込む。この repo では 全 Go バイナリを -trimpath -ldflags="-s -w" でビルドする。

go build -trimpath -ldflags="-s -w" -o foo.exe .

確認: strings foo.exe | grep -iE "C:/Users/|@gmail|@outlook" で 0 ヒットになることを検証(ホストユーザー名・個人メールが埋め込まれていないか)

コミット前チェック(必ず実行)

ローカル環境のホスト/ゲストユーザー名を環境変数にセットしてから走らせる(このCLAUDE.md自体に具体値を書かないため):

# 環境変数セット(実値は各自の環境に合わせる、CLAUDE.md には書かない)
export HOST_USER="$(whoami)"
export GUEST_USER="<your-vm-guest-username>"

# 1. tracked ファイルに個人情報が混入していないか
git ls-files | xargs -I{} grep -lE "C:\\\\+Users\\\\+(${HOST_USER}|${GUEST_USER})|@(outlook|gmail|yahoo|hotmail|icloud)\." "./{}" 2>/dev/null
# → 空出力が期待値(このCLAUDE.md自体もヒットしないこと)

# 2. Go バイナリに埋め込みパスがないか
for f in $(git ls-files '*.exe'); do
  hits=$(strings "$f" 2>/dev/null | grep -cE "C:/Users/(${HOST_USER}|${GUEST_USER})|@gmail|@outlook")
  [ "$hits" -eq 0 ] || echo "LEAK in $f: $hits hits"
done

# 3. コミット identity が noreply ドメインか
git config user.email | grep -q "users.noreply.github.com" && echo OK || echo "WARNING: non-noreply email"

test_out.txt / uploads/ 等の実行時成果物

Claude Agent SDK 経由のテスト出力や GUI のアップロードファイルは ホストの絶対パス(cwd 等)を含む。.gitignore で除外済みだが、新規の test/debug 出力ファイルを追加する際は必ず gitignore に追加する。

コミットメッセージにも注意

メッセージ本文に C:\Users\<host-user> のような literal を書かないこと(過去にverificationログで混入した)。プレースホルダ表記に統一。

新規 skill / ツール追加時のチェック

  • SKILL.md 内に個人ユーザー名・実メール・具体的な C:\Users\<本名系>\... パスを書かない
  • skill が他のskillに依存する際の参照は ~/.claude/skills/<skill>(Unix風)で統一
  • ゲストVMのパスは <GUEST_TOOLS> / <GUEST_ANALYSIS_DIR> プレースホルダで書く

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.