CODE FOR NAGATO ・ AIスキルアップシリーズ

🌊 GitとClaude Codeのしくみ入門

AIに仕事を任せても迷子にならない。「ファイルの旅」を触って学ぶ教材(事務職の方向け)

なぜ「バージョン管理」を学ぶの?

AIチャットからAIエージェントへ。「作業を任せられるAI」を安心して使うためのカギが、この教材のテーマです。

ここでは、むずかしいコマンドは一切出てきません。「ファイルがどこで生まれて、どこを旅して、だれがOKを出して正式版になるのか」——その地図を頭に入れることがゴールです。

💬

ステップ1:AIチャットは「文章をくれる人」

ChatGPTやClaudeのチャットは、頼めば文章やファイルを1個作ってくれます。でも——

・できた文章は自分でコピペして、自分で適切な場所に保存し直す必要がある
・AIはあなたのPCの他のファイルのことを知らない
・毎回「新規作成」なので、昨日作ったファイルの続きを直してもらえない

🤖

ステップ2:AIエージェントは「作業してくれる人」

Claude CodeのようなAIエージェントは、ファイルを直接作り、正しい場所に置き、既存のファイルを読んで、続きから修正できます。つまり「文章をくれる人」から「作業者」に格上げされたのです。

頼み方も変わります。「文章を書いて」ではなく「このフォルダの案内文を直して」と、仕事そのものを任せられます。

😵

ステップ3:でも……何をやったか分からないと不安

作業者となったAIは、ファイルをもりもり作り、もりもり書き換えます。そのままだと「昨日と何が変わったの?」「どのファイルをいじったの?」が分からなくなり、怖くて任せられません

📚

ステップ4:そこで「バージョン管理」=Git

エンジニアの世界には、「いつ・だれが・どこを・なぜ変えたか」を全部記録するしくみが昔からあります。それが Git(ギット)。そしてGitの記録をインターネット上で見やすく共有できる場所が GitHub(ギットハブ) です。

AIの作業をぜんぶGitに記録させれば、変更の一覧を人間がチェックして「OK(承認)」を出すまで正式版にならない、という安全な流れが作れます。

🤝

ステップ5:Claude Code × GitHub = 安心して任せられる分業

Claude CodeはGitHubと連携して、作業のたびに専用の「作業レーン(ブランチ)」を作ってそこで作業します。終わったら「こう変えました、取り込んでいいですか?」という提案書(プルリクエスト)を出し、人間が中身を見てOKを出したら正式版に反映——ここまでが1セットです。

つまり「AIが作業し、人間が検品して承認する」という上司と部下のような分業が、しくみとして組み込まれているのです。

この教材の歩き方

上のタブを左から順にどうぞ。「3. 体験シミュレーター」がメインディッシュです。ボタンを押しながら、ファイルが旅する様子を実際に動かして確かめられます。

Gitのきほん:「セーブポイント」と考えよう

Gitの機能はたくさんありますが、事務職のみなさんに必要な考え方は4つだけです。

📸 ① コミット = セーブポイント

ゲームのセーブと同じで、「今の状態」にメモ(コミットメッセージ)を付けて丸ごと記録します。この記録1個をコミットと呼びます。

例:「開催日を追記」「誤字を修正」——後から見て分かるメモが大事。

🔍 ② 差分(さぶん)が見える

コミット同士を比べると、増えた行は緑、消えた行は赤で表示されます。文章が読めれば誰でも「何が変わったか」を検品できます。プログラムが読めなくても大丈夫。

🛤️ ③ ブランチ = 作業レーン

正式版(mainと呼ばれるレーン)を直接さわらず、横に作業用のレーンを作ってそこで編集します。失敗しても正式版は無傷。納得できたら合流(マージ)させます。

⏪ ④ いつでも戻れる

セーブポイントが残っているので、「昨日の状態に戻して」が一瞬でできます。「ファイル名_最終_v2_これが本当に最終.docx」を量産する日々とはお別れです。

🎮 やってみよう:セーブポイント体験

下のメモを自由に書き換えて「セーブポイントを作る」を押してみてください。履歴をクリックすると、その時点の内容をいつでも見られます。

用語ミニまとめ

リポジトリ
Gitで管理されるフォルダ一式+その全履歴。「書類箱」のイメージ。
コミット
メッセージ付きセーブポイント。
ブランチ
作業レーン。正式版レーンは「main」。
マージ
作業レーンの変更を正式版レーンに合流させること。

体験シミュレーター:ファイルの旅を動かしてみよう

登場する「場所」は3つ。同じリポジトリ(書類箱)のコピーが、それぞれの場所に存在できます。

ミッションは3本。1と2で基本の流れを覚えて、3で「Claude Codeを2つ同時に走らせたらぶつかった」という、実際によく起きる場面を体験します。ミッション3では左と右のパネルが「2つのClaude Codeセッション」に変わります。

💻 あなたのPC ローカル環境 GitHub Desktopで操作 ☁️ GitHub インターネット上の本部 正式版(main)の置き場 PRのレビュー・承認もここ 🤖 Claude Code リモート(クラウド)環境 AIが作業する仮想PC Push(送る) Clone / Pull(受け取る) Push(送る) Clone(複製)

ポイント:PC同士は直接つながらず、必ずGitHub(本部)を経由してファイルが行き来します。

Google Driveとつないだ時は、話が別

Claude CodeにGoogle Drive(やGmail・カレンダー)を接続すると、AIはDriveのファイルを直接、作成・読み取り・更新・削除します。GitHubを経由しません。

これは「MCP」という接続のしくみで、AIの手がDriveまで直接届いている状態です。便利ですが、GitHub経由の流れとは安全のしくみがまったく違うことを知っておきましょう。

☁️ GitHub経由(Gitのレール)

ファイルの変更は……

  • 🛤️ 作業レーン(ブランチ)の上で行われる
  • 📸 1つ1つがコミットとして記録される
  • 🔍 差分(緑と赤)で検品できる
  • 人間が承認(マージ)するまで正式版にならない
  • ⏪ いつでも過去の状態に戻せる

📁 Google Drive直接(MCP経由)

ファイルの変更は……

  • その場で即、本物のファイルに反映される
  • 📝 「何を変えたか」のメッセージは残らない
  • 🕐 Driveの「版の履歴」はあるが、差分もブランチも承認の関門もない
  • 👀 気づいた時には上書きされている、がありえる

くらべてみよう

GitHub経由(Git)Drive直接(MCP)
変更のタイミング承認してから反映即・その場で反映
変更の理由の記録コミットメッセージに残る残らない
検品(差分チェック)緑/赤の差分で一目瞭然前後を自力で見比べる
やり直し任意のセーブポイントへ版の履歴から手動復元
向いている用途大事な文書・サイト・継続的な仕事閲覧・検索・下書きの受け渡し

じゃあ、どう使い分ける?

「読むのはDrive直接でOK、大事なものを書き換えるならGitのレールに乗せる」が基本方針です。

  • 👌 「Driveの議事録を読んで要約して」→ 直接アクセスで問題なし
  • 👌 「アンケート結果を探して集計して」→ 問題なし(読むだけ)
  • ⚠️ 「Driveの規約ファイルを書き換えて」→ 即・本物が変わる。上書き前にコピーを取る、または一度Git管理のフォルダに持ってきて作業してもらう方が安全
合言葉:Gitのレールの上では「AIが提案 → 人間が承認」。レールの外(Drive直接)では「AIの操作 = 即・本番」。レールの外で書き込みを任せるときほど、指示は具体的に、対象は狭く。

Claude Code、リモートとローカルどっちで使う?

おすすめはまずリモート(クラウド)環境。理由はシンプルで、あなたのPCの中のファイルに一切さわれないからです。

リモート環境は、クラウド上に用意された「まっさらな仮想PC」。そこにGitHubからリポジトリを複製(Clone)して作業するので、影響範囲はそのリポジトリだけに閉じます。作業が終われば環境ごと消えても、成果はGitHubに残っています。

☁️ リモート環境が向いているとき(基本はこちら)

  • 🛡️ PCの他のファイルに影響させたくない(最大の利点)
  • 📄 GitHub上にあるもの(サイト・文書・資料)の修正
  • 🧹 環境構築が不要。PCが非力でも、スマホからでも指示できる
  • 🔀 複数の作業を同時に走らせたい(環境が分かれているので混ざらない)
  • 🔰 まだGitやAIエージェントに慣れていない

💻 ローカル環境を選ぶとき

  • 🗂️ PCの中にしかないファイルを整理・変換・一括処理してほしい
  • 🖨️ PCにつながった機器や、社内ネットワークでしか見られないものを扱う
  • ▶️ 作ったものを手元ですぐ動かして確認しながら進めたい
  • 🔌 PCに入れたツールやMCP接続(Drive等)と組み合わせたい
  • ※ローカルで使う時も、作業フォルダをGit管理にしておけば「提案→承認」のレールは同じように使えます。

迷ったらこのフローチャート

扱いたいファイルはどこにある?
GitHub上にある
PCの中にしかない
☁️ リモート環境でOK
💻 ローカル環境で(フォルダを限定して指示)
手元のPCで動かして確認しながら進めたい?
いいえ
はい
☁️ リモートのまま進めよう
💻 ローカル+Git管理で
安全のコツ(ローカルで使うとき):①作業用フォルダを決めて、その中だけで作業してもらう ②フォルダをGit管理(リポジトリ化)しておく ③「PC全体を整理して」のような広すぎるお願いをしない。

💭 あなたならどっち?

まとめ:今日持ち帰る5つのこと

  • 1️⃣ AIエージェントは「作業者」。だからこそ変更の記録(バージョン管理)が安心のカギ
  • 2️⃣ Gitはメッセージ付きセーブポイント(コミット)のしくみ。GitHubはその共有場所
  • 3️⃣ ファイルは Clone(複製)→ 編集 → Commit(記録)→ Push(送る)→ PR(提案)→ Merge(承認・合流)の順で旅をする。手元に最新を取り込むのがPull
  • 4️⃣ Claude Codeは作業ごとにブランチを作り、人間がPRを承認するまで正式版を変えない
  • 5️⃣ Google Drive直結(MCP)は即・本物に反映。読むのは気軽に、書き換えは慎重に
  • 6️⃣ 同じ行を2人(2セッション)が直すとコンフリクト。壊れたのではなくGitが止めてくれた合図。「どうしたいか」を決めるのが人間の仕事、直す作業はClaudeに任せてOK

✏️ 理解度チェック(全7問)

気軽にどうぞ。間違えても解説が出るだけです。

📖 用語集

Git(ギット)
ファイルの変更履歴を記録するしくみ(バージョン管理システム)。
GitHub(ギットハブ)
Gitの記録をインターネット上に置いて、見やすく共有・レビューできるサービス。
GitHub Desktop
Gitをボタン操作で使えるPCアプリ。コマンド不要。
リポジトリ
Gitで管理するフォルダ一式+全履歴。
Clone(クローン)
GitHub上のリポジトリを、履歴ごと自分の環境に複製すること。
Commit(コミット)
変更に メッセージを付けて記録すること。セーブポイント。
Push(プッシュ)
手元のコミットをGitHubへ送ること。
Pull(プル)
GitHub上の最新を手元に取り込むこと。
ブランチ
作業レーン。正式版レーンは main。
Pull Request(PR)
「この変更をmainに取り込んでください」という提案書。差分とコメントがセット。
Merge(マージ)
PRを承認して、変更を正式版に合流させること。
コンフリクト(衝突)
同じファイルの同じ行を、2つの作業レーンが別々に書き換えた状態。Gitがどちらを残すか決められず、合流を止めて人間に判断を求めている合図。エラーでも故障でもない。
取り込み(mainの最新を反映)
作業レーンに、先に更新されたmainの内容を持ってくること。コンフリクト解消はこの作業の一部で、Claude Codeに任せられる。
リモート環境
クラウド上の仮想PC。Claude Codeがそこで作業すれば手元のPCは無傷。
ローカル環境
自分のPCの中。PC内ファイルを扱えるぶん、影響範囲に注意。
MCP
AIを外部サービス(Google Drive等)に直接つなぐ接続のしくみ。

次の一歩

① GitHubのアカウントを作ってみる → ② GitHub Desktopを入れて、練習用リポジトリで今日の流れを本物で再現 → ③ Claude Codeのリモート環境に小さな修正を頼んで、PRを自分の目でレビューしてマージ。ここまでできたら、もう「AIと分業できる人」です。