0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@hidetarou2013@github(Hidetoshi Maekawa)

AWSインフラエンジニアのための Claude Code 完全活用ガイド 2026 — Context 肥大化を制する者がAI開発を制す

0
Last updated at Posted at 2026-04-20

AWSインフラエンジニアのための Claude Code 完全活用ガイド 2026

— Context 肥大化を制する者がAI開発を制す —

対象読者: AWS CDK / ECS / Lambda を日常的に扱うインフラエンジニア
前提知識: Claude Code を使いこなしている（Skills / Agent Teams 経験済み）
情報源: Claude Code 公式ドキュメント (code.claude.com/docs) / 2026年4月時点

目次

  1. なぜ今 Claude Code が AWS エンジニアに刺さるのか
  2. 全機能マップ — 俯瞰から始める
  3. AWSエンジニア必須機能 TOP 5
  4. 最大の弱点：Context 肥大化とその対策
  5. MCP を恐れずに使うための戦略
  6. 実践ワークフロー：CDK 開発での使い方
  7. まとめ・実践チェックリスト

1. はじめに

AWS インフラエンジニアにとって Claude Code は単なる「コード補完ツール」ではありません。
CDK スタック設計からセキュリティレビュー（cdk-nag 対応）、PR 作成、ドキュメント化まで、
開発ライフサイクル全体を一人のシニアエンジニアとして担えるのが Claude Code の本質です。

しかし、長期利用で多くの人が直面する壁があります。それが Context 肥大化です。

本記事では、公式ドキュメントに基づいた正確な情報をベースに、
AWS エンジニアが即日使えるノウハウをまとめます。

2. 全機能マップ

実行環境の選択指針

環境 向いているシーン
CLI（ターミナル） CI/CD 組み込み、スクリプト連携
VSCode 拡張 日常的なコーディング、インラインレビュー
デスクトップアプリ 長期セッション、プロジェクト管理
ブラウザ 外出先・サブ端末からのアクセス

3. AWSエンジニア必須機能 TOP 5

3-1. MCP（Model Context Protocol）— AWS 公式ドキュメントを直接参照

MCP は外部データソースを Claude に接続するオープンスタンダードです。
AWS エンジニアにとって最重要の MCP サーバーはこの 3 つです。

設定例（.mcp.json）:

{
  "mcpServers": {
    "aws-docs": {
      "type": "stdio",
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"]
    },
    "cdk": {
      "type": "stdio",
      "command": "uvx",
      "args": ["awslabs.cdk-mcp-server@latest"],
      "env": { "AWS_PROFILE": "default" }
    }
  }
}

使い方の例:

# Claude に直接聞く
「ECS タスクロールに必要な最小 IAM 権限を aws-docs で調べて」
「AwsSolutions-RDS10 の違反を修正する CDK コードを書いて」

3-2. Hooks — 自動化の要

Hooks は Claude Code のライフサイクルイベントにシェルコマンドを紐付ける機能です。

AWS エンジニア向け Hooks 活用例:

// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [{
      "type": "command",
      "command": "bash .claude/hooks/check-aws-destructive.sh"
    }],
    "PostToolUse": [{
      "type": "command",
      "command": "bash .claude/hooks/audit-log.sh"
    }]
  }
}

# check-aws-destructive.sh — 危険な AWS CLI コマンドをブロック
COMMAND=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.command // empty')
if echo "$COMMAND" | grep -qE 'aws (ec2 terminate|rds delete|s3 rb|iam delete)'; then
  echo '{"permissionDecision":"block","reason":"Destructive AWS command requires manual confirmation"}'
  exit 2
fi
exit 0

主要な Hook イベント:

イベント タイミング AWS 活用例
SessionStart セッション開始 AWS プロファイル・リージョン確認
UserPromptSubmit プロンプト送信時 コンテキスト自動追加
PreToolUse ツール実行前 破壊的 AWS 操作のブロック
PostToolUse ツール実行後 監査ログ記録
SessionEnd セッション終了 サマリー生成

3-3. Sub-agents / Agent Teams — コンテキスト保護の切り札

Sub-agents はメインセッションとは別のコンテキストウィンドウで動作します。
これが Context 肥大化対策の最重要テクニックです（後述）。

カスタム Sub-agent 定義例（.claude/agents/cdk-reviewer.md）:

---
name: cdk-reviewer
description: CDK コードの cdk-nag ルール違反とセキュリティ問題をレビューする
model: claude-sonnet-4-6
tools: ["Read", "Grep", "Glob"]
---

あなたは AWS CDK セキュリティ専門家です。
以下の観点でコードをレビューしてください：
- cdk-nag AwsSolutions ルール準拠
- IAM 最小権限原則
- リソースの削除保護設定
- シークレット管理（Secrets Manager 使用）

3-4. CLAUDE.md 設計 — 200行ルールを守れ

効果的な CLAUDE.md 設計原則:

原則 悪い例 良い例
200行以下 500行の詳細なガイドライン 核心ルールのみ記載し、詳細は @import
具体性 「適切にフォーマットすること」 「インデントは2スペース。TypeScript は strict: true 必須」
分割管理 1ファイルにすべて @.claude/rules/01-workflow.md で分割
矛盾回避 複数ファイルで矛盾する設定 定期的に /memory で確認・整合

@import でモジュール化:

# CLAUDE.md（メイン）
@.claude/rules/01-workflow.md
@.claude/rules/02-git.md
@.claude/rules/03-coding.md
@.claude/rules/05-cdk.md

3-5. カスタムスキル（/commands）— 繰り返し作業を自動化

.claude/commands/ または ~/.claude/commands/ に Markdown ファイルを置くだけで
スラッシュコマンドとして使えます。

AWS エンジニア向けスキル例:

# .claude/commands/review-cdk.md
CDK スタックを以下の観点でレビューしてください：
1. cdk-nag AwsSolutions ルール準拠チェック
2. IAM 最小権限（ワイルドカード禁止）
3. リソース削除保護（本番環境）
4. シークレット管理（ハードコード禁止）

対象: $ARGUMENTS

# 使い方
/review-cdk infra/lib/stacks/database-stack.ts

4. Context 肥大化とその対策

「Context が溢れると Claude は過去を忘れ、ルールを無視し始める」
これが最大の弱点です。

なぜ Context が肥大化するのか

公式の対策メソッド

対策1: /compact — 手動コンテキスト圧縮

/compact                          # 標準圧縮
/compact keep only the plan and the diff   # 指定して圧縮
/compact focus on the CDK stack design    # テーマ指定圧縮

タイミングの目安: ツール呼び出しが 20〜30 回を超えたら実行

対策2: Sub-agent による分離（最重要）

実践コマンド:

# ファイル探索は Explore Sub-agent に任せる
Agent（Explore）を使って infra/ 配下の全スタックを調査して

# レビューは別 Sub-agent に
cdk-reviewer Sub-agent を起動して database-stack.ts をレビューして

対策3: CLAUDE.md の 200 行ルール

  • 200行を超えると遵守率が急低下する（公式ドキュメントの指摘）
  • 詳細ルールは @import で分割ファイルに委譲
  • 頻度の低いルールは Auto Memory に移す

対策4: Auto Memory の戦略的活用

~/.claude/projects/{project}/memory/
├── MEMORY.md          ← インデックス（最初の200行のみ読み込まれる）
├── user_profile.md    ← ユーザー技術背景
├── feedback.md        ← 過去のフィードバック
└── lessons.md         ← 失敗パターン学習

CLAUDE.md に書くべき vs Auto Memory に書くべき:

内容 CLAUDE.md Auto Memory
コーディング規約 ✅ ❌
ブランチ戦略 ✅ ❌
ユーザーの好み ❌ ✅
過去の失敗パターン ❌ ✅
プロジェクト一時情報 ❌ ✅

対策5: --bare フラグ — 最小構成起動

# hooks・skills・MCP・auto memory を無効化して起動
claude --bare "シンプルな質問"

# 特定 MCP だけ有効にして起動（Context 節約）
claude --model sonnet "CDK の質問"

対策6: Worktree 分離

# 独立した git worktree でサブエージェントを動かす
claude -w "この機能ブランチでテストを書いて"

Context 消費量の目安（実測ベース）

操作 概算 tokens
CLAUDE.md 読み込み（200行） ~5,000
Auto Memory 読み込み ~2,000
通常の会話 1往復 ~1,000〜3,000
ファイル読み込み（100行） ~2,000
CDK スタック 1ファイル ~3,000〜8,000
git diff（中規模） ~5,000〜15,000
MCP ツール呼び出し結果 ~1,000〜10,000

5. MCP を恐れずに使う戦略

「MCP を使うと Context が増えるのでは？」という懸念は半分正解・半分誤解です。

MCP の Context への影響

MCP の賢い使い方

❌ 悪い例: aws-docs でドキュメント全文を取得してコンテキストに詰め込む
✅ 良い例: aws-docs の read_sections で必要なセクションのみ取得

❌ 悪い例: メインセッションで大量の MCP 呼び出しを繰り返す
✅ 良い例: Explore Sub-agent に MCP 調査を委譲し、結果のサマリーだけ受け取る

Sub-agent + MCP の組み合わせパターン:

# Explore Sub-agent に MCP 調査を任せる
Explore Sub-agent を起動して、aws-docs で ECS タスクロールの
最小 IAM 権限を調べて、箇条書き10行以内でサマリーを返して

AWS MCP の選択基準

MCP 使うシーン Context コスト
aws-docs 最新 API リファレンス確認 中（セクション指定で小）
cdk cdk-nag ルール解説・CDK パターン 小
cfn CloudFormation テンプレート検証 中
github PR 作成・Issue 更新 小（操作系）

6. 実践ワークフロー：CDK 開発での使い方

CDK スタック開発の理想フロー

Context を節約しながら大規模 CDK プロジェクトを扱うコツ

# 1. セッション開始時は /compact で前回の不要情報を消す
/compact keep only the current task context

# 2. スタックごとに Sub-agent に探索させる
「Explore Sub-agent を使って infra/lib/stacks/ 配下のスタック一覧と
 各スタックの依存関係を 20 行以内で教えて」

# 3. 実装前に /compact
# 4. 実装後すぐ cdk-reviewer Sub-agent でレビュー
# 5. フィードバック対応後に /compact → 次のタスクへ

7. まとめ

AWS エンジニアのための Claude Code 実践チェックリスト

覚えておくべき 5 つのルール

# ルール 理由
1 CLAUDE.md は 200 行以下 超えるとルール遵守率が急落
2 探索は Sub-agent に任せる メインのコンテキストを保護
3 20〜30 ツール呼び出しで /compact コンテキスト溢れを防ぐ
4 MCP は Sub-agent 経由で使う 大量結果がコンテキストを汚染しない
5 Auto Memory で個人設定を外出し 毎回 CLAUDE.md で説明しなくて済む

ウィークポイントと回避策まとめ

弱点 症状 回避策
Context 肥大化 ルール無視・過去指示を忘れる /compact + Sub-agent 分離
CLAUDE.md 肥大化 ルール遵守率低下 200行ルール + @import 分割
MCP 結果の Context 消費 会話が遅くなる セクション指定 + Sub-agent 委譲
長期セッションの劣化 初期の品質を維持できない こまめな /compact + 新セッション
Autocompact のスラッシング ループ状態に陥る /compact keep only ... で明示指定

参考リンク（公式情報）

この記事は Claude Code (claude-sonnet-4-6) が公式ドキュメントを参照しながら自動生成しました。
最終確認: 2026-04-11

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?