コンテンツにスキップ

ユースケース

それぞれの例では、あなたが聞くこと、Claude Code が Awnexa で調べること、よい回答の形を示します。アカウント・名前・ID は架空のもので、awnexa init --sample が作るサンプルデータと同じです。AWS なしで同じ質問を試せます。awnexa skills install で入る Skill がこれらの作業に対応しているので、普段の言葉で聞けます。

どの回答も同じ確認から始まります。Claude Code は最初に awnexa status とカバレッジを読み、データがいつのものか、何を取得できなかったかを把握します。

ターミナルウィンドウ
awnexa status --compact
awnexa coverage --status partial,failed,access_denied,unsupported,unknown --compact

システムを説明して構成図を描く

Section titled “システムを説明して構成図を描く”

あなた: この AWS 環境を説明して、構成図を描いて。

Claude Code は 1 回の呼び出しで全体像をつかみ、必要な詳細だけを取ります。

ターミナルウィンドウ
awnexa overview --compact
awnexa resources show orders-db --fields Engine,MultiAZ,StorageEncrypted --compact

Claude Code: Awnexa の取得結果(2026-10-06 10:42 のスキャン。ap-northeast-3 の RDS はアクセス拒否で未取得、2 つの S3 バケットは暗号化の設定を取得できず): パブリックな入口は 3 つです。ALB alb-web が HTTPS をターゲットグループ web-tg 経由で、サブネット orders-app-a と orders-app-c にある ECS サービス web に転送します。HTTP API orders-api は 3 つの Lambda 関数(orders-create、orders-get、checkout)を呼びます。EC2 インスタンス orders-bastion はパブリック IP アドレスを持っています。セキュリティグループは、これらの経路のコンピュートから Aurora クラスタ orders-db と RDS インスタンス reporting への接続を許可しています(許可であって、通信を観測したものではありません)。3 つの関数のロールには SQS キュー orders-events への送信が、web のタスクロールにはバケット orders-assets-111122223333 の読み取りが許可されています。checkout の環境変数は orders-events と orders-db を、orders-create の環境変数は orders-events を、web と orders-worker の環境変数はバケット orders-assets-111122223333 を指しています(構成からの推定)。別に、関数 orders-worker が orders-events を読み、失敗したメッセージは orders-events-dlq に送られます。(続いて Mermaid の構成図)

未確認: ap-northeast-3 の RDS。そこにデータベースがあっても、今回のスキャンでは見えていません。コードが実際にこれらの権限や環境変数を使っているかは構成情報に含まれません。関数のロールに付いた AWS 管理ポリシーは評価していません。

aws-architecture の Skill は、awnexa report からカバレッジの注意書きを残したまま設計書も書きます。

あなた: セキュリティグループ sg-0a1b2c3d4e5f60718 を消したら何が壊れる?

ターミナルウィンドウ
awnexa impact sg-0a1b2c3d4e5f60718 --depth 3 --compact

Claude Code: Awnexa の取得結果: このセキュリティグループ(orders-app)を直接使っているのは 8 つです(ECS サービス web、2 つのネットワークインターフェース、Lambda 関数 checkout、Aurora クラスタ orders-db とその 2 つのインスタンス、Secrets Manager の VPC エンドポイント orders-secrets-endpoint)。セキュリティグループ orders-db と reporting-db がこのグループからの受信を、alb-web がこのグループへの送信を許可しているので、それらのルールもこのグループに依存しています。これらを通じて、ALB alb-web、API orders-api、RDS インスタンス reporting にも影響が及びます。

限界: 見えるのはスキャンしたサービスの中の参照だけです。IP アドレスで接続しているアプリケーションや、Awnexa がまだ対応していないサービスのリソースは、ここに現れません。

あなた: 今朝から決済が失敗している。checkout 関数につながっているものと、最近の変更を調べて。

ターミナルウィンドウ
awnexa graph checkout --depth 2 --compact
awnexa snapshot list --compact
awnexa snapshot diff --compact

スキャン ID を省くと、snapshot diff は最新のスキャンとその前のスキャンを比べます。ほかのスキャンを比べるときは、snapshot list の出力から 2 つのスキャン ID を指定します。

Claude Code: Awnexa の取得結果: 昨日と今日のスキャンの間で 2 つのリソースが変わりました。Lambda 関数 checkout は環境変数名が変わり(DB_HOST と DB_NAME が DATABASE_HOST と DATABASE_NAME に変わり、PAYMENT_TIMEOUT_MS が追加。値はマスクされています)、2 つ目のセキュリティグループ orders-app が付きました。セキュリティグループ sg-checkout からは、データベースのサブネットへの送信ルール(TCP 5432)が削除されています。

私の推論(スキャンの事実ではありません): 削除されたルールだけでは checkout から orders-db への接続は断たれません。追加された orders-app はすべての送信を許可し、orders-db は orders-app からの受信を許可しているためです。より疑わしいのは環境変数名の変更で、コードがまだ DB_HOST を読んでいれば、データベースのアドレスを得られません。関数のログとデプロイされたコードで確かめてください。

Awnexa は変更とつながりを渡します。原因の特定は Claude Code の推論であり、回答でもそう区別します。

あなた: インターネットから到達できるリソースや、暗号化されていないリソースは?

ターミナルウィンドウ
awnexa resources list --type AWS::RDS::DBInstance --fields PubliclyAccessible,StorageEncrypted --compact
awnexa resources list --type AWS::EC2::SecurityGroup --fields IpPermissions --limit 100 --compact
awnexa resources list --type AWS::S3::Bucket --fields PublicAccessBlockConfiguration,ServerSideEncryptionConfiguration,UnretrievedConfigurations --compact

Claude Code: Awnexa の取得結果: RDS インスタンス reporting が PubliclyAccessible: true です。ap-northeast-1 の 3 つの RDS インスタンスはすべて暗号化されています。セキュリティグループ sg-bastion が 0.0.0.0/0 から TCP 22 を許可しています(通信を「許可する」ルールで、誰かが接続した証拠ではありません)。alb-web は 0.0.0.0/0 から TCP 443 を許可しており、パブリックなロードバランサーとしては想定どおりです。S3 は 3 つのバケットすべてでパブリックアクセスをブロックしています。

未確認: ap-northeast-3 の RDS はアクセス拒否で取得できず(resultCoverage)、そこのインスタンスは不明です。orders-logs-111122223333 と orders-exports-111122223333 は暗号化の設定を取得できませんでした(UnretrievedConfigurations)。「暗号化されていない」ではなく「不明」です。

あなた: この VPC とサブネットを Terraform にして。

ターミナルウィンドウ
awnexa resources list --type AWS::EC2::VPC --compact
awnexa resources list --parent vpc-0123456789abcdef0 --compact
awnexa resources show vpc-0123456789abcdef0 --full --compact

Claude Code は取得したプロパティから Terraform を書き、見えなかった値(Awnexa がマスクする秘密の値など)を明記します。

あなた: このシステムの Runbook の下書きを作って。

ターミナルウィンドウ
awnexa overview --compact
awnexa report --out ./docs/aws --doc overview,network,security

Claude Code は、インベントリ、依存関係、定常の確認、よくある障害の初動を下書きし、取得できなかった範囲に依存する部分に印を付けます。

理解する

  • 「この AWS 環境を説明して、構成図を描いて。」
  • 「VPC とサブネット、インターネットへの出口を整理して。」
  • 「このロードバランサーの後ろには何がある?」
  • 「orders システム(タグ app=orders)に含まれるリソースは?」

安全に変更する

  • 「このセキュリティグループに依存しているものは?消したら何が壊れる?」
  • 「このサブネットを消しても大丈夫?」
  • 「この IAM ロールを使っている Lambda 関数は?」

調べる

  • 「先週のスキャンから何が変わった?」
  • 「checkout 関数につながっているものと、最近の変更を見せて。」

レビューする

  • 「インターネットから到達できるリソースや、暗号化されていないリソースは?」
  • 「インターネットからの通信を許可しているセキュリティグループをレビューして。」
  • 「スキャンできなかったサービスと、その理由は?」

文書化・自動化する

  • 「今のネットワーク構成を Terraform にして。」
  • 「このシステムの Runbook の下書きを作って。」
  • 「このアカウントの設計書を書いて。」