非エンジニア奮闘記
公開:
更新:
AI活用

【初心者向け】AIエージェント開発でよく出る用語まとめ（Git・npm・デプロイまで完全解説）

ポスト Threads

【初心者向け】AIエージェント開発でよく出る用語まとめ（Git・npm・デプロイまで完全解説）

AIエージェント（Claude CodeやGemini CLI）を使い始めると、突然「MCPサーバーを接続しますか？」「D1のマイグレーションが必要です」といった呪文が飛んできます。非エンジニアにとって、この「何言ってるか分からない」状態が一番の挫折ポイント。

実は、筆者も非エンジニアで、 「pushしたのに公開されず1時間悩みました」 という苦い経験があります。でも、全ての用語を理解する必要はありません。AIが今何をしているのか、その「流れ」さえ掴めば、恐怖心は消えます。

AIエージェント開発の基本フロー「4つのステップ」

AIエージェント開発では「commit（保存）→ push（送信）→ build（変換）→ deploy（公開）」の流れを理解することが重要である。

「よし、修正できた！」とAIが言ったのに、実際のサイトを見ても何も変わっていない。そんな経験はありませんか？

非エンジニアが最も混乱する「保存したのに反映されない！」という現象は、このステップのどこかで止まっていることが原因です。

[あなたのPC（ローカル）]
  ↓ ① commit（手元に履歴を保存）
[GitHub（クラウド）]
  ↓ ② push（クラウドへ送信）
[サーバー（CI/CD）]
  ↓ ③ build（公開用のデータに変換）
  ↓ ④ deploy（世界中に公開！）
[公開サイト]

料理に例えるなら、①タッパーに入れる、②冷蔵庫に運ぶ、③加熱調理する、④お皿に出す、という流れです。

特に ③build（ビルド） は、人間が書いたコードを「機械が読みやすい形」に最適化する工程です。具体的には、バラバラのファイルを一つにまとめたり（JSバンドル）、最新の書き方を古いブラウザでも動くように変換したり（トランスパイル）しています。

※サービスによっては、pushすると自動でbuild・deployまで行われる場合もあります。

「常に4段階ある」と覚えるのではなく、「今はどの段階まで進んだのかな？」とAIに確認するための地図として使ってみてください。

参考：Deployments Overview - Vercel / Builds - Vercel

「保存」と「送信」は別物！Gitの基本用語

Gitは変更履歴を管理するツールであり、commitは「ローカル履歴への保存」、pushは「リモートリポジトリ（クラウド等）への送信」を指す。これらはあくまで「記録」であり、実際にWebサイトとして公開する作業（deploy）とは明確に区別して管理される。

AIエージェントを使っていると、頻繁に「Git（ギット）」という言葉が出てきます。これは、ファイルの変更履歴を記録する「タイムマシン」のような仕組みです。

特に重要なのが、 commit と push の違いです。

  • commit（コミット）: 「今の状態をセーブ！」という作業。まだ自分のPCの中にあります。
  • push（プッシュ）: 「セーブデータをクラウド（リモートリポジトリ）に送信！」という作業。

GitHub（ギットハブ）は、この送信先となる「履歴付きのGoogleドライブ」のような場所です。AIが「pushしました」と言っても、それは「バックアップが終わりました」という意味。まだ本番サイトが書き換わった（公開された）わけではないので、安心して作業を続けられます。

参考：Recording Changes to the Repository - Git / Pushing commits to a remote repository - GitHub

開発環境の「土台」を作る用語：Homebrewとnpm

HomebrewはmacOS用のパッケージ管理ツールであり、npmはJavaScriptライブラリの管理ツールである。これらは「必要な道具を自動で揃えてくれる店員」のような存在だが、出所不明なパッケージには脆弱性が含まれるリスクもあるため、AIの指示内容を最低限確認する姿勢が重要である。

「コマンドが見つかりません。Homebrewでインストールしてください」

ターミナル（黒い画面）にこう表示されると、一気に難易度が上がった気がしますよね。でも、これらは単なる「道具箱」の名前です。

  • Homebrew（ホームブリュー）: Macに新しいソフトを入れるための道具箱
  • npm（エヌピーエム）: Webサイトを作るための部品（ライブラリ）を集めた道具箱

CursorやClaude Codeがこれらを使おうとするのは、作業に必要な「足場」を作ろうとしているだけです。あなたがDIYをするときに、AIが「トンカチと釘を買ってきますね」と言っているようなもの。

基本的にはAIに任せて大丈夫ですが、稀に古いツールや安全性が確認されていないツールを提案してくることもあります。不安なときは 「そのツールは有名？安全？」 と一言聞いてみるのが、AI時代の賢い付き合い方です。

参考：Homebrew / npm Security

AIと外部を繋ぐ魔法：MCP（Model Context Protocol）

MCP（Model Context Protocol）は、AIモデルがローカルファイルや外部ツールと安全に通信するための共通規格（プロトコル）である。MCP自体が機能を持つのではなく、接続された「MCPサーバー」を通じて、AIがファイル操作や外部データ取得などの実務を行えるようにする仕組みを指す。

最近、Claude Codeなどの最新ツールでよく耳にするようになったのが MCP です。

これは、AI専用の「共通規格（プロトコル）」、例えるなら「USB-Cポート」のようなものです。

これまでのAI（ChatGPTなど）は、ブラウザの中で会話するだけでした。しかし、MCPという「ポートに接続することで、AIはあなたのPC内のファイルを読み書きしたり、専用のツールを使って最新の情報を取得したりできるようになります。

「MCPサーバーを起動します」と言われたら、AIが「作業用のツールをポートに差し込みました」と報告しているのだと理解すればOKです。

参考：Introduction - Model Context Protocol / MCP Specification

よくある詰まりポイント

AIエージェントを使っていて「あれ？」となったときの、よくある原因と対策をまとめました。

  • pushしたのに反映されない → deploy（公開作業）が完了していない
  • npmエラー → 必要なパッケージが不足している
  • build失敗 → コードの変換エラー（環境の違いなど）

筆者も最初は「pushしたからもう公開されたはず！」と思い込み、1時間以上も古い画面をリロードし続けていました。実際には、サーバー側でbuildが終わっていなかっただけ。

AIは万能ではありません。指示を誤解したり、環境の違いで失敗したりすることもあります。でも、そのエラーメッセージこそが解決のヒント。そのままAIに投げ返せば、多くの場合、数秒で解決策を提示してくれます。

参考：Troubleshooting Builds - Vercel

Q. 非エンジニアでも「黒い画面（ターミナル）」を覚える必要はある？

結論から言うと、コマンドを暗記する必要は全くありません。

大切なのは、AIが何かコマンドを実行しようとしたときに、 「今のコマンドは何をしたの？」 と聞く勇気を持つことです。

AIエージェントは、あなたの指示を忠実に実行しようとする「優秀な新人エンジニア」ですが、時には間違った方向に突き進むこともあります。新人が何をしているか分からないまま放置するのは不安ですよね。だからこそ、分からない単語が出てきたらその場で質問する。

この「対話」を繰り返すことが、非エンジニアがAIを使いこなすための最短ルートです。

まとめ：AIエージェントは「優秀な新人」として接しよう

専門用語は、一つひとつを完璧に暗記しようとすると挫折します。

まずは「保存して、送信して、変換して、公開する」という 全体の流れ だけを頭に入れておきましょう。

AIエージェントは、あなたの創造性を形にするための強力なパートナーです。用語の壁を少しだけ低くして、AIと一緒に新しいものを作る楽しさを体験してみてください。

関連記事：[AIエージェントで実際にブログを開発する流れはこちら（準備中）]

目次