コンテンツにスキップ

Awnexa を使う理由

Claude Code は AWS CLI を実行できます。それでも Awnexa を加える理由は、AWS 上のシステム全体を CLI の呼び出し 1 回ずつで調べると時間がかかり、会話が JSON で埋まり、実際には確認していないことを AI が断定しやすくなるからです。

AWS CLI だけで Claude Code に「このサブネットを消したら何が壊れる?」と聞くと、Claude Code は次のことをする必要があります。

  • 多くの API を順番に呼ぶ。 インスタンス、ネットワークインターフェース、ロードバランサー、データベース、Lambda 関数、エンドポイント……を、関係するリージョンごとに、ページングしながら呼びます。
  • 大きな JSON を読む。 出力の大半は質問と関係ありませんが、会話のコンテキストを消費し、考えるための余地が減ります。
  • 見ていない範囲を推測で埋める。 失敗・拒否された呼び出しのエラーはツールの出力に一度出るだけで、最終的な回答にはまず残りません。そもそも呼ばなかった API は跡も残りません。「そのサブネットにデータベースは見つかりません」が、実は「RDS を確認していません」の意味になることがあります。
  • あなたの認証情報をそのまま使う。 AI はプロファイルが持つ権限でコマンドを実行します。読み取り専用になるかは、そのプロファイルの設定次第です。

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 は構成情報を集め、整理し、比較します。構成のレビュー、改善の提案、IaC の作成、障害の原因の特定はしません。それは Awnexa が渡す事実をもとに Claude Code が行います。ログ・データは読みません。メトリクスは任意の利用状況の要約(scan --metrics)としてだけ読みます。詳しくはしくみを参照してください。