Claude CodeでTerraformコードを自動生成する実践ガイド【2026年版】

Claude CodeにTerraformコードを書かせてみたら「セキュリティグループが0.0.0.0/0で生成された」「apply後にState管理が壊れた」という声をよく聞きます。Claude Code×Terraformは強力ですが、CLAUDE.mdの設計が品質をほぼ決定します。実践的なCLAUDE.md設計・MCPサーバー設定・失敗回避まで一気に解説します。

Claude Code + Terraformで何ができるか？

Claude CodeはHCLコードを自然言語から生成し、fmt→validate→planまで自動実行できます。インフラエンジニアとしての実感では既存AWSのTerraform化（Import）が特に強力で、2〜3日の作業が数時間に短縮されました。

CLAUDE.mdの設計が品質を左右する

Claude Code×Terraformで最も重要なのがCLAUDE.mdの禁止事項定義です。ここを省くと、Claudeが訓練データの記憶だけでリソース引数を書き始め、古いAPI仕様や架空のパラメータが混入します。

CLAUDE.mdに必ず書く6セクション

CLAUDE.md 禁止事項セクションのサンプル

## 禁止事項
- terraform-registry MCPサーバーで確認せずにリソース引数を記述しない
- `terraform apply` を承認なしに実行しない
- security_group でポート 0.0.0.0/0 を使用しない（専用セクションで明示）
- IAMポリシーで `"Action": "*"` を使用しない
- 存在しない引数を使わない（必ずドキュメントを参照する）

実践：MCP設定とコード生成

.mcp.json設定（terraform-registry + aws-knowledge）

{
  "mcpServers": {
    "terraform-registry": {
      "command": "npx",
      "args": ["-y", "@hashicorp/mcp-server-terraform-registry"]
    },
    "aws-knowledge": {
      "command": "npx",
      "args": ["-y", "@aws/aws-knowledge-mcp-server"]
    }
  }
}

上記MCP設定後、「modules/vpc/を作成、terraform-registryで引数確認してから」のように自然言語で指示するとfmt→validate→planまで自動実行します。インフラエンジニア向けClaude Code活用ガイドも参照してください。

このMCP設定により、ClaudeはTerraform Registryの最新ドキュメントを参照してからコードを生成します。幻覚コードの発生率が大幅に低下します。

よくある失敗パターンと対策

まとめ：Claude Code × TerraformでIaC生産性を上げる3原則

• CLAUDE.mdの禁止事項を先に設計する（後付けは手遅れ）
• MCP（terraform-registry + aws-knowledge）を必ず設定して幻覚を防ぐ
• tflint/CheckovをDefinition of Doneに含めてセキュリティを自動担保する

全体の使いこなし方はClaude Code完全ガイドも参考にしてください。

よくある質問（FAQ）