apk-reverseスキル入門：Claude CodeでAndroid APK解析を自動化する方法

GitHubで3409⭐を獲得しているapk-reverseは、Claude Code・CodexなどのAIエージェントにAndroid APKリバースエンジニアリング能力を付与する「エージェントスキル」です。単なるスクリプト集ではなく、AIが迷子にならないための「ゲート」「症状インデックス」「2ストライクルール」を備えた高度に設計されたスキルアーキテクチャを採用しています。

apk-reverseとは — エージェントスキルという新しいアーキテクチャ

従来のAPK解析ツール（jadx, apktool, Frida等）は個別のコマンドラインツールです。エンジニアが手動でツールを組み合わせ、問題が起きたら自分でデバッグする必要がありました。apk-reverseは**AIエージェント（Claude Code・Codex）がこれらのツールを自律的に組み合わせて実行できる「スキルパッケージ」**です。

エージェントスキルの仕組み

従来: エンジニア → ツールを手動実行 → 失敗 → 原因調査 → 再実行
apk-reverse: エンジニア → Claude Codeにロード → AIが自律実行
                └── SKILL.md読み込み
                    ├── 4つのゲート（G1-G4）で前提確認
                    ├── 症状インデックス（既知の失敗パターンを先に確認）
                    └── 2ストライクルールで無限ループ防止

SKILL.md、references/（参考資料）、scripts/（実行スクリプト）の三層構造で、AIが「詳細を読むべき場面」と「実行すべき場面」を明確に区別できるよう設計されています。

Android APK解析 Claude Code 自動化 — インストールと基本使用法

必要なツール

ツール	用途	入手先
jadx	APK/DEX逆コンパイル	GitHub: skylot/jadx
apktool	APKアンパック・リパック	apktool.org
Frida	動的フッキング	frida.re
adb	Androidデバイス操作	Android SDK
keytool/apksigner	署名	JDK同梱

Claude Codeへの統合

# リポジトリのクローン
git clone https://github.com/newliver666/apk-reverse

# まず環境診断（必須）
python skills/apk-reverse/scripts/doctor.py

doctor.pyは使用可能なツールの存在確認・スクリプト実行可能性・環境汚染チェックを行います。これが最初に実行すべき最もコストの低いコマンドです。

# Claude Codeでスキルを使用
# セッション内で以下のように指示:
# "skills/apk-reverse/SKILL.mdを読んで、target.apkの解析を始めてください"

APKリバースエンジニアリング Python 使い方 — 主要ワークフロー

G1-G4 ゲートとは

4つのゲートは作業前に必ず確認すべきチェックポイントです：

ゲート	確認内容	通過条件
G1	APKの分類（通常/パック済み/ハードニング済み）	ターゲットタイプが確定
G2	環境の真実（ツールが実際に動作するか）	doctor.pyでPASS
G3	コントロールビルド（変更前の成功する最小ビルド）	変更なしで再ビルド成功
G4	成果物の形式（APK/システムモジュール/RPC）	最終成果物の形式が確定

対応する解析シナリオ

通常APKの広告除去・脱ブロート:

Claude Code: target.apkの広告を除去してリパックしてください
→ SKILL.mdロード → G1-G4確認 → smali改変 → 再ビルド → 署名

パッカー解除: READMEが明示するように、パッカーの解除は「何がpaywallサーバー側で制御されているか」を先に確認することから始まります。クライアント側でどれだけ努力しても突破できない制御はサーバー側にあります。

Frida動的フッキング:

# スクリプト例（scripts/ 配下に用意済み）
# TLSピンニング回避、ルート検出回避、認証バイパス

jadx/apktoolとの違い — なぜapk-reverseを使うのか

jadxやapktoolは優秀なツールですが、個別のツールです。APK解析プロジェクトでは：

ツールの組み合わせ判断（この状況では何を使うべきか）
失敗のデバッグ（なぜリパックが失敗するか）
先進的なケースへの対応（OLLVM難読化、Dex VMP、Split APK等）

これらを毎回手動で解決する代わりに、apk-reverseはAIエージェントがこれらの判断を行うためのガイダンスを提供します。

「症状インデックス」の価値

READMEが「同じ失敗に2回支払わない」と表現するように、症状インデックスは既知の失敗パターンをデータベース化したものです：

「一致する行は停止シグナルです。さらにいくつかのコマンドを実行してからではなく、そのファイルをロードしてください。」

これは「AIが既知の問題で時間を浪費しない」という設計思想です。

こんな人に向いている

モバイルセキュリティエンジニア

Androidアプリのペネトレーションテスト・脆弱性診断を行うセキュリティエンジニアに最適です。TLSピンニング解析、ルート検出バイパス、API通信の解明など、Claude Codeに「このAPKの認証フローを解析してください」と指示するだけで、ツールチェーン全体を自律管理します。

Android開発者・QAエンジニア

競合アプリの技術スタック調査（Flutter/React Native/Unity判定）、自社アプリのセキュリティ強化確認、難読化後のコード品質チェックなど、日常的なAndroid解析タスクをClaude Codeで効率化したい開発者に有用です。

セキュリティリサーチャー

CTF（Capture the Flag）のAndroid問題、マルウェア解析、バグバウンティでのAndroidアプリ調査など、高度なリバースエンジニアリングが必要な研究者にとって、apk-reverseの参照ドキュメント（references/）は価値ある知識ベースになります。

使う前に知っておきたいこと

法的・倫理的な注意事項

APKリバースエンジニアリングは法的・倫理的に複雑な領域です。READMEも「免責事項」セクションを設けています。**自分が権利を持つアプリ、または明示的な許可を得たアプリ以外への使用は違法になる可能性があります。**セキュリティリサーチ・ペネトレーションテスト目的での使用は、対象組織の書面による許可が必要です。

ツールチェーンのインストールが別途必要

apk-reverseはスキルパッケージのみで、jadx・apktool・Frida・adb等の実際のツールは別途インストールが必要です。doctor.pyでどのツールがインストール済みかを確認してから始めましょう。

高難易度の操作には専門知識が必要

OLLVM難読化解除、Dex VMP解析、Split APK処理など、高度なシナリオはAndroidセキュリティの専門知識が必要です。スキルはガイダンスを提供しますが、理解なしの実行は非推奨です。

Pythonバージョン

Python 3.9以上が必要です。

まとめ

apk-reverseは「AIエージェントにAndroid解析能力を付与する」というアプローチで、Android APKリバースエンジニアリングの学習コストと実行コストを大幅に下げるスキルパッケージです。特にClaude Codeとの組み合わせで、複雑な解析ワークフローをAIが自律的に管理します。

こんな方に強くおすすめ:

Claude Code・Codexを使ったAndroid解析の自動化に興味があるエンジニア
APK解析の全工程をAIに委任したいモバイルセキュリティ研究者
Frida・jadx・apktoolの使い方を学びながら実践したいAndroid開発者

この技術を学ぶ

Androidセキュリティとリバースエンジニアリングに興味を持った方には、UdemyのAndroid・セキュリティ関連コースもおすすめです。

🎓 Android・セキュリティコース一覧 — セール時（最大90%OFF）を狙うとお得です