ユースケース
それぞれの例では、あなたが聞くこと、Claude Code が Awnexa で調べること、よい回答の形を示します。アカウント・名前・ID は架空のもので、awnexa init --sample が作るサンプルデータと同じです。AWS なしで同じ質問を試せます。awnexa skills install で入る Skill がこれらの作業に対応しているので、普段の言葉で聞けます。
どの回答も同じ確認から始まります。Claude Code は最初に awnexa status とカバレッジを読み、データがいつのものか、何を取得できなかったかを把握します。
awnexa status --compactawnexa coverage --status partial,failed,access_denied,unsupported,unknown --compactシステムを説明して構成図を描く
Section titled “システムを説明して構成図を描く”あなた: この AWS 環境を説明して、構成図を描いて。
Claude Code は 1 回の呼び出しで全体像をつかみ、必要な詳細だけを取ります。
awnexa overview --compactawnexa resources show orders-db --fields Engine,MultiAZ,StorageEncrypted --compactClaude 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 APIorders-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 からカバレッジの注意書きを残したまま設計書も書きます。
変更の影響を調べる
Section titled “変更の影響を調べる”あなた: セキュリティグループ
sg-0a1b2c3d4e5f60718を消したら何が壊れる?
awnexa impact sg-0a1b2c3d4e5f60718 --depth 3 --compactClaude 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がこのグループへの送信を許可しているので、それらのルールもこのグループに依存しています。これらを通じて、ALBalb-web、APIorders-api、RDS インスタンスreportingにも影響が及びます。限界: 見えるのはスキャンしたサービスの中の参照だけです。IP アドレスで接続しているアプリケーションや、Awnexa がまだ対応していないサービスのリソースは、ここに現れません。
障害を調べる
Section titled “障害を調べる”あなた: 今朝から決済が失敗している。
checkout関数につながっているものと、最近の変更を調べて。
awnexa graph checkout --depth 2 --compactawnexa snapshot list --compactawnexa 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 の推論であり、回答でもそう区別します。
設定をレビューする
Section titled “設定をレビューする”あなた: インターネットから到達できるリソースや、暗号化されていないリソースは?
awnexa resources list --type AWS::RDS::DBInstance --fields PubliclyAccessible,StorageEncrypted --compactawnexa resources list --type AWS::EC2::SecurityGroup --fields IpPermissions --limit 100 --compactawnexa resources list --type AWS::S3::Bucket --fields PublicAccessBlockConfiguration,ServerSideEncryptionConfiguration,UnretrievedConfigurations --compactClaude 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)。「暗号化されていない」ではなく「不明」です。
既存のリソースを IaC にする
Section titled “既存のリソースを IaC にする”あなた: この VPC とサブネットを Terraform にして。
awnexa resources list --type AWS::EC2::VPC --compactawnexa resources list --parent vpc-0123456789abcdef0 --compactawnexa resources show vpc-0123456789abcdef0 --full --compactClaude Code は取得したプロパティから Terraform を書き、見えなかった値(Awnexa がマスクする秘密の値など)を明記します。
運用ドキュメントを書く
Section titled “運用ドキュメントを書く”あなた: このシステムの Runbook の下書きを作って。
awnexa overview --compactawnexa report --out ./docs/aws --doc overview,network,securityClaude Code は、インベントリ、依存関係、定常の確認、よくある障害の初動を下書きし、取得できなかった範囲に依存する部分に印を付けます。
そのまま貼り付けられる質問
Section titled “そのまま貼り付けられる質問”理解する
- 「この AWS 環境を説明して、構成図を描いて。」
- 「VPC とサブネット、インターネットへの出口を整理して。」
- 「このロードバランサーの後ろには何がある?」
- 「
ordersシステム(タグapp=orders)に含まれるリソースは?」
安全に変更する
- 「このセキュリティグループに依存しているものは?消したら何が壊れる?」
- 「このサブネットを消しても大丈夫?」
- 「この IAM ロールを使っている Lambda 関数は?」
調べる
- 「先週のスキャンから何が変わった?」
- 「
checkout関数につながっているものと、最近の変更を見せて。」
レビューする
- 「インターネットから到達できるリソースや、暗号化されていないリソースは?」
- 「インターネットからの通信を許可しているセキュリティグループをレビューして。」
- 「スキャンできなかったサービスと、その理由は?」
文書化・自動化する
- 「今のネットワーク構成を Terraform にして。」
- 「このシステムの Runbook の下書きを作って。」
- 「このアカウントの設計書を書いて。」