社内SEがClaude Codeを"マネージャー"にして、Terraformを推し活のたとえで解説してみた件
① 社内インフラの一部をTerraformで管理している社内SEが、Claude Codeと一緒に進める実務の流れを紹介します。
② plan・apply・state・module・環境分けを、SKE48の公演や研究生の仕組みと並べて整理しました。
③ Terraform初心者の方、Claude Codeの使いどころが気になる方、アイドルヲタクの方に向けて書いています。
平日は社内SEとして社内インフラの一部をTerraformで管理しているアイドルヲタクです。そして最近、平日の仕事にClaude Codeという相方が加わりました。
Terraformのコードの下書きも、`plan`の差分の確認も、いまはClaude Codeと一緒に進めています。アイドルでいえば、マネージャーが隣にいる状態です。ステージに立つのは自分ですが、段取りを先に見てくれる人がいるだけで、現場に入る前の気持ちがだいぶ楽になります。。
この記事では、Claude Codeと一緒に進めている実務の流れに沿って、Terraformの基本をアイドルのたとえで布教していきます。
こんな悩みに答える記事です
`plan`と`apply`の違いが、いまひとつピンとこない
`state`が何のためにあって、なぜ大事なのか分からない
開発用と本番用など、環境をどう分ければいいか迷う
Claude Codeに、実務でどこまで任せていいのか知りたい
専門用語だらけの解説だと、頭に入ってこない
それぞれ、後の章で順番に答えていきます。

なぜこの記事を書こうと思ったか
理由は、たいそうなものではありません。Terraformもアイドルの現場も知っていて、Terraformは実務で使いながら今も学び続けているからです。
勉強しながら、「アイドルのたとえで説明してくれる記事があったら読みたいな」と思いました。それなら自分で書いてみよう、というのがきっかけです。
Terraformが難しく感じる方にはアイドルのたとえで、アイドルに詳しくない方にはTerraformを通して、それぞれの世界をのぞいてもらえたら嬉しいです。
Terraformとは何か
Terraformは、インフラ(サーバーやネットワークなど)の構成をコードで定義し、そのコード通りの状態を自動で作ってくれるツールです。いわゆる「Infrastructure as Code(IaC)」と呼ばれる考え方の代表格にあたります。
社内SEの仕事で言えば、社内システムが動く基盤を手作業で設定画面からポチポチ組むのではなく、「こういう構成にしたい」という設計図をコードに書いておき、Terraformがその設計図どおりに組み立てたり直したりしてくれる、というイメージです。チケットの申し込みフォームに、毎回住所と名前を手入力するのをやめて、自動入力に任せるような話だと思ってください。
SKE48には栄にある劇場があり、そこで行われる公演には決まった演目があります。チームKⅡの「シアターの女神」公演やチームEの「RESET」公演のように、立ち位置も構成も台本として整理されていて、毎回なんとなくの感覚でステージに立つわけではありません。きちんと設計された形があるからこそ、何度公演を重ねても同じクオリティで届けられるのだと思います。コードとして残しておくというのは、この「設計された形を毎回きちんと再現する」という発想にとても近いものです。沼にハマると自然とこういう仕組みに目がいくようになるのかもしれません。

実務での基本的な使い方
コードでインフラを定義する
Terraformでは、`.tf` ファイルにインフラの構成を書きます。たとえば社内システム用のサーバーを1台作りたい場合、「このスペックで、このネットワークに、こういう設定で」という内容をコードとして記述します。
一度書いてしまえば、引き継ぐ相手にも共有できる設計図になります。口頭やExcelでの申し送りではなく、コードそのものが正しい情報源(Single Source of Truth)になってくれるのがありがたいところです。
ここ最近は、この`.tf`ファイルの下書きをClaude Codeに手伝ってもらうことが増えました。「このネットワーク構成でサーバーを1台追加したい」というざっくりした指示を出すと、たたき台のコードを書いてくれます。もちろん最終的な設定内容は自分で確認します。アイドルで言うなら、マネージャーが先に当日の段取りと立ち位置のメモを用意してくれて、本人はそれを見ながら最終確認だけすればいい、という状態に近いです。下準備の手間が減ると、確認そのものに集中できるのがありがたいところです。
これは、公演の立ち位置表や構成がきちんと台本として残されているのと似ています。記憶や言い伝えだけに頼ると、どこかで「あれ、ここの並びって前と違う気がする」というズレが生まれてしまいます。きちんと形に残しておく安心感は、現場でもインフラでも共通していると感じます。
`terraform plan` と `terraform apply`
実務で一番よく使うのがこの2つのコマンドです。
`terraform plan`:今のコードを適用したら何がどう変わるかを、実行前に確認するコマンド
`terraform apply`:実際にその変更をインフラに反映するコマンド
`plan`は、新公演やセットリストの発表を見て「次はこういう構成になるんだ」と事前に把握する時間に近いと思っています。物販の整理番号を事前に確認するような感覚にも似ています。そして`apply`は、実際に幕が上がり、その構成が本番のステージに反映される瞬間です。いきなり本番(現場)に突っ込むのではなく、まず`plan`で「これを適用したら何が増えて何が変わるか」を確認します。この一手間があるおかげで、思わぬ見落としに気づけることが多いです。
`apply`を実行すると「この内容で反映しますか」という確認が出て、`yes`と入力して初めて実行されます。チケットの申し込み確定ボタンの前に出る「本当に申し込みますか?」の画面で、一瞬手が止まる感覚とよく似ています。ちなみに`terraform destroy`というコマンドもあり、こちらは管理しているリソースをまとめて削除します。ヲタ卒を決意して部屋のグッズを全部手放す断捨離のようなもので、本番環境では絶対に打ちたくないコマンドです。
正直に書きますと、`plan`の結果を見て「あれ、思っていたのと違う」とひやりとすることが実務でも年に数回あります。社内の誰かが使っているシステムに影響する変更だと、なおさら緊張します。ただ、`plan`の時点なら、まだ落ち着いて確認して修正できます。この「本番前に立ち止まれる」仕組みには、何度助けられたか分かりません。
最近は、この`plan`の差分が長くて読みづらいときに、Claude Codeに「この差分で危なそうな変更はどこか」を聞くようにしています。ステージに上がる前に、マネージャーに「この段取り、抜けているところはない?」と確認してもらうような感覚です。一人で全部の差分を睨み続けるよりも気が楽で、最終判断は自分でするとしても、見落としを減らす相方がいるのは心強いです。
stateの管理:なぜ大事なのか
Terraformは「今どんな状態でインフラが構築されているか」を`state`というファイルで管理しています。このstateがあるからこそ、「前回はこうだったから、今回はここだけ変える」という差分管理ができます。
これは、SKE48がこれまで積み重ねてきた公演の記録や歴代の構成に近いものだと感じています。古参が強いのは、この積み重ねた記録を体で覚えているからだと思うのですが、stateもまさにそれです。これまでの記録があるから、次に何を変えるべきかを正しく判断できます。逆に、記録を雑に扱ったり、途中の経緯を欠かしたまま進めたりすると、今の状態と記録にズレが生じます。新規さんが一番混乱するのと同じことが、あとになって起きてしまいます。stateを手で書き換えるのは、参戦ノートを後から都合よく美化するようなもので、気づいた古参に静かに訂正される未来が待っています。
さらに、このstateを一人の手元にしか置いていないと、その人が不在の間は誰も状況を正しく把握できません。そのため、チームで触る基盤では、クラウド上の共有ストレージにstateを置く「リモートstate」という形が基本です。みんなが同じ記録を見ながら運用できる状態を、きちんと作っておくイメージです。
変数(variables)とモジュール(module)で使い回す
同じような構成を環境ごと(開発環境・本番環境など)に何度も書くのは非効率です。そこで、変更したい部分だけを`variable`として外に出し、共通部分は`module`としてまとめて使い回します。
SKE48には定番の公演の型があり、その型をベースにしながら、出演メンバーや日替わりの演出といった部分だけが入れ替わっていきます。単推し・箱推しに関係なく、共通する構成はしっかりまとめておき、必要な部分(担当の色やトレカの並び順くらいの違い)だけを調整する。この発想は、Terraformのmodule設計そのものだと感じています。ペンライトの本体は同じで、推しカラーだけを現場ごとに渡す、というのが`variable`の使い方に近いです。推し変をしても、基本の参戦セットはそのまま使い回せます。
ディレクトリ構成と運用ルール:環境はどう分ける?
実務では、環境ごと(dev/stg/prodなど)にディレクトリを分けたり、社内で触っていい範囲のルールを決めたりします。社内SEが一人で全部を見ていると、つい自分だけの判断で`apply`しがちです。それでは、自分が現場(有休)に出た瞬間に誰も状況を把握できなくなってしまいます。
SKE48にはチームS・チームKⅡ・チームEといったチーム制があり、それぞれの持ち場がきちんと整理されています。誰がどこを担当しているかが明確だからこそ、全体としてうまく回っているのだと思います。社内インフラの運用ルールも同じで、あらかじめ役割や触れる範囲を言語化しておくことが、結果的にチーム全体を助けます。
さらに、研究生はチームS・KⅡ・Eという枠組みの下に位置づけられていて、研究生公演を重ねたのちにチームへ昇格する流れがあります。これは、dev環境でしっかり動作確認をしてからprod環境に上げるのと、構造としてはよく似ています。研究生公演がdev、チーム昇格後の本公演がprodという対応で考えると、ヲタクとしても腑に落ちやすい気がしています。逆に、devで確認せずにいきなりprodへ`apply`するのは、研究生公演を経ないまま、いきなり本公演のセンターに立つようなものです。期待は大きいですが、準備が整っていないと、一番目立つ場所で事故が起きます。おすすめしません。
Claude Codeという相方について:どこまで任せていいのか
ここまでの話で触れたとおり、最近はTerraformのコードを書くとき、Claude Codeに下書きを手伝ってもらったり、`plan`の差分を一緒に確認してもらったりしています。最終的な判断は自分でしますが、一人で黙々と差分を睨み続けるよりも、誰かに「ここどう思う?」と聞きながら進められるのは、精神的にかなり楽です。
アイドルでいうところの、マネージャーのような存在に近いかもしれません。ステージに立つのは本人でも、スケジュールや段取りを一緒に見てくれる人がいるだけで、見落としは減ります。「この日、移動が詰まっていませんか」と先に指摘してもらえる感覚です。ただし、本番でパフォーマンスをするのは本人で、マネージャーが代わりにステージに立つわけではありません。コマンドを実行するのは自分、という責任の所在も、ステージと同じです。実務のコードレビューも、構造としては同じことだと感じています。
さいごに
Terraformの基本は、ざっくり言うと「設計図をコードにして、適用前に確認して、状態を記録しながら、共通部分は使い回す」という考え方に尽きます。Claude Codeのような相方を使うようになっても、この基本の流れ自体は変わりません。
書いていて気づいたのですが、自分がTerraformに沼れている理由は、技術力そのものよりも「積み重ねてきた記録を大切にし、再現性にこだわる」という、推し活で自然と培われた古参気質の方が先にあったのかもしれません。少し意外な気づきですが、こうして仕事にも活きているのだとしたら、とてもありがたいことです。
Terraformを触っている方も、Claude Codeを仕事で試している方も、推し活と仕事を両立している方も、よければコメントで教えてください。「自分ならこうたとえる」というご意見も大歓迎です。気に入っていただけたら、いいねやフォローで教えてもらえると励みになります。次はもう少し踏み込んだ運用の工夫についても書いてみようと思います。