Awnexa を使う理由
Claude Code は AWS CLI を実行できます。それでも Awnexa を加える理由は、AWS 上のシステム全体を CLI の呼び出し 1 回ずつで調べると時間がかかり、会話が JSON で埋まり、実際には確認していないことを AI が断定しやすくなるからです。
Awnexa なしの場合
Section titled “Awnexa なしの場合”AWS CLI だけで Claude Code に「このサブネットを消したら何が壊れる?」と聞くと、Claude Code は次のことをする必要があります。
- 多くの API を順番に呼ぶ。 インスタンス、ネットワークインターフェース、ロードバランサー、データベース、Lambda 関数、エンドポイント……を、関係するリージョンごとに、ページングしながら呼びます。
- 大きな JSON を読む。 出力の大半は質問と関係ありませんが、会話のコンテキストを消費し、考えるための余地が減ります。
- 見ていない範囲を推測で埋める。 失敗・拒否された呼び出しのエラーはツールの出力に一度出るだけで、最終的な回答にはまず残りません。そもそも呼ばなかった API は跡も残りません。「そのサブネットにデータベースは見つかりません」が、実は「RDS を確認していません」の意味になることがあります。
- あなたの認証情報をそのまま使う。 AI はプロファイルが持つ権限でコマンドを実行します。読み取り専用になるかは、そのプロファイルの設定次第です。
Awnexa ありの場合
Section titled “Awnexa ありの場合”Awnexa は読み取り専用の API でアカウントを 1 回スキャンし、結果を手元に保存します。Claude Code は AWS ではなく Awnexa に問い合わせます。
| Claude Code が必要なもの | Awnexa が返すもの |
|---|---|
| 全体像 | awnexa overview: 入口、その後ろにあるもの、スタックごとのまとまりを 1 回で |
| 依存関係と影響範囲 | awnexa impact: スキャンの中であるリソースに依存しているものと、その経路・つながりの根拠 |
| 確認できなかった範囲 | awnexa coverage: API とリージョンごとに complete / partial / access_denied / failed / unsupported などの状態 |
| 何が変わったか | awnexa snapshot diff: 2 回のスキャンの間のリソースと関係の作成・変更・削除(部分的なスキャンからの削除は unknown のまま) |
| 必要な詳細だけ | --fields と --limit で、聞いたプロパティと行だけを返す |
| 事実の出どころ | すべてのリソースと関係が、取得元の API と確からしさ(direct / derived / inferred など)を持つ |
その結果:
- 呼び出しが少なく、小さい。 システム全体についての質問に、多くの API 呼び出しではなく手元のデータベースから答えるので、会話の多くを考えることに使えます。
- 事実と推測を分けた回答。 Claude Code は「Awnexa が見つけたリソースは 3 つ(10:42 のスキャン)」「ここは未確認: RDS はアクセスが拒否された」と言え、そのうえで自分の推論を区別して書けます。
- 読み取り専用の設計。 Awnexa は読み取りの API(
Describe*/List*/Get*/BatchGet*/Search*)だけを呼び、秘密の値は読みません。スキャンの後、Claude Code は手元のスキャン結果から答えるので AWS へのアクセスは要りません。それでも AWS CLI を実行できるかは、Claude Code の権限の設定次第です。
Awnexa がしないこと
Section titled “Awnexa がしないこと”Awnexa は構成情報を集め、整理し、比較します。構成のレビュー、改善の提案、IaC の作成、障害の原因の特定はしません。それは Awnexa が渡す事実をもとに Claude Code が行います。ログ・データは読みません。メトリクスは任意の利用状況の要約(scan --metrics)としてだけ読みます。詳しくはしくみを参照してください。