コンテンツにスキップ

Git と GitHub の基本:ローカルから始めて GitHub につなげる

作ったコードを Cloudflare などのサービスに公開するとき、その間の ハブ として便利なのが GitHub。バイブコーディングで自分のコードを世に出すには、まず手元の Git とそれを置く GitHub の組み合わせを整えておくとよい。

本記事は Mac(MacBook など)ユーザー向けに書いているが、Windows でも同じ手順で進められる。Google アカウントを持っていることが前提(GitHub のアカウント作成で使う)。Claudeデスクトップアプリ(→ CDG)の Claude Code から進める前提で、Git の操作は Claude Code に頼んで進める(4-3 の gh のインストールは例外で、自分でターミナルを開いて入力する)。裏で動いている git のコマンドも添えるので、何が起きているかも一緒に覚えられる。GitHub の認証は gh コマンドのブラウザ認証で完結させる。

Windows の人へ: Mac と違うのは git・gh のインストール方法と、gh auth login を打つ場所だけ。先に Windowsでのセットアップ(WIN)で環境を整えてから戻ってくると、以降のコマンドはそのまま動く。ログインは、スタートメニューから開いたコマンドプロンプトで実行する(→ WIN 6-2)。

ローカルの Git のリポジトリ(フォルダ)の中にファイルと履歴がある。ファイルを編集し、コミットで履歴に記録する。履歴をプッシュで GitHub のリポジトリに送り、逆にプルで GitHub の最新を手元に取り込む。GitHub 側にあるのは履歴だけ

Git はファイルのバージョン管理ツールで、手元のパソコンで動く。1つのフォルダの中の変更を コミット(commit)という単位で記録していく。このフォルダ+履歴のセットを リポジトリ と呼ぶ。この記録が溜まると、3-6 で「過去のことも覚えているアシスタント」として使えるようになる。

補足: コミットについて ある時点のファイル群を、メッセージ(自分で書く説明)と一緒に保存したもの。ざっくり言えば「コメント付きのスナップショット」。作者・日時・前のコミットへの参照も持つので、コミットが鎖のように繋がって履歴になる。なお「コミット」は保存物(名詞)と、それを作る操作(動詞「コミットする」)の両方を指す。プッシュなども同様。

GitHub はそのリポジトリをネット上に置ける場所で、すべてのコミットが丸ごとクラウドに保存される。ローカルのコミットを GitHub に送ることを プッシュ(push)という。逆に、GitHub の最新を手元に取り込むことを プル(pull)という(→ 5-3)。

ポイントは Git 本体はローカルで完結する こと。GitHub は「クラウドのバックアップ&共有先」にすぎず、ローカルでコミットを重ねてからまとめてプッシュする二段構え。さらに GitHub のリポジトリは、Cloudflare との連携(後述)でそのままサイト公開にもつながる。

この記事で覚えたい用語は5つ: Git / GitHub / コミット(commit)/ リポジトリ / プッシュ(push)。ここまでで全部出そろっている。以降はこの5つを使って手を動かしていく。

「Claude Code でファイル作るだけじゃダメなの?」「Cloudflare にデプロイするだけなら GitHub いらないのでは?」とハンズオン参加者からよく聞かれる。Git/GitHub があると、Claude Code でのコーディングも Cloudflare へのデプロイも、その後の運用も楽になる。

茶トラのねこの4コマ。思い切って変更を頼める(巻き戻しの矢印の前でこぶしを上げる)、何を変えたか追える(虫めがねで履歴の一覧をのぞく)、バックアップ・移行・引き継ぎ(雲に預けた鍵付きの箱を、2匹のねこが手渡しする)、Cloudflare との相性(オレンジの雲からサイトの画面が公開される)

Git/GitHub を使う理由は4つ

  • 思い切って変更を頼める: コミットしておけば、AI に大胆な書き換えを頼んでも、動いていた状態にいつでも戻せる
  • 何を変えたか追える: どのファイルを、いつ、どう変えたかが履歴に残る。何を・なぜ変えたかもコミットメッセージとして残るので、AI に任せた変更でもあとから見直せる
  • バックアップ・移行・引き継ぎに強い: Cloudflare 側に残るのは公開成果物だけ。GitHub に push しておけば、Mac が壊れても取り直せる(clone)。別 PC や別セッション、クラウドで動く Claude Code とも GitHub 経由で同期でき(→ 5-3)、引き継ぎも GitHub と Cloudflare のアカウントを渡せば一式が移る
  • Cloudflare との相性がいい: GitHub と Cloudflare Pages を連携させる設定をしておけば、push するだけで本番に反映される。デプロイ履歴やロールバックも自動で残る

Git/GitHub は世界中の開発の標準ツールで、Claude Code 自体も Git を前提に作られている(差分レビュー、コミット用ボタン)。Webサイトを作らなくても使える。ブログ記事を書きためるフォルダ、家計簿をつけるフォルダなど、テキストで書いたものなら何でも管理できる。

そして日常で使うのは commit と push、それに GitHub の最新を取り込む pull の基本操作だけ。本記事はその最低限を体験する。全部覚える必要はないので、後は必要に応じて広げていける。

  1. Git のインストール確認と初期設定(2章)
  2. ローカルで git init → コミットを何回か体験 → やり直し・巻き戻し(3章)
  3. GitHub アカウント作成 + gh コマンドで GitHub につなげる(4章)
  4. 日々の運用:push と pull(5-1〜5-3)。一歩先として、ブランチ・プルリクエスト・コンフリクト(5-4〜5-6)
  5. 補足(6章)

まず、練習用のフォルダを作って Claude Code を起動する。以降は、このフォルダで同じセッションのまま進める。

新しく作った作業フォルダ ~/claude/git-test を Claudeデスクトップアプリで開く(→ SUP 1-1)。

~/claude はホームフォルダ(自分のユーザ名のフォルダ)の直下に作る claude フォルダのこと。~/claude の意味やホームフォルダの開き方・サイドバーへの固定方法は、ブラウザでアップロードして公開する記事で説明している。

Windows は Git が標準で入っていないので、WIN で Git for Windows・gh を入れてからこの先へ進む(導入済みなら読み飛ばしてよい)。以降のコマンドは Mac と共通。

macOS には Git が標準でほぼ入っている。入っているかを確かめてもらう。

プロンプト
Git が入っているか確認して

Claude Code が git --version を実行し、git version 2.x のようにバージョンが返ればOK。入っていない場合は、「Xcode Command Line Tools をインストールしますか?」という画面が出るので承認する。

2-2. 名前とメールアドレスを登録する

Section titled “2-2. 名前とメールアドレスを登録する”

Git はコミットのたびに「誰が記録したか」を残す。初回だけ、名前とメールアドレスを登録しておく。

プロンプト
このパソコンの Git に、名前とメールアドレスを登録して。
名前は Your Name、メールアドレスは [email protected] で。
このフォルダの Git 管理はまだ始めない。

「このパソコンの」は、フォルダごとではなく PC 全体の設定にするという意味。この設定は Git 管理を始める前でもできる。「まだ始めない」まで書くのは、Claude Code が気を回して先に Git 管理を始め、そのままコミットまで進むのを防ぐため。名前を登録する前にコミットすると、自分で選んでいない名前が記録に残る(下の「なぜ先にやるのか」)。

Your Name と [email protected] は自分のものに置き換える。名前は本名でなくてよい。メールアドレスは、このあと4章で作る GitHub アカウントに使う予定のもの(Google アカウントのアドレス)を入れておく。どちらもコミットの一部として GitHub 上で公開されるので、見られて困らないものにする。

Claude Code は、すでに設定が入っていないかを確かめてから登録し、結果を表で見せてくれる。裏では次のコマンドが動いている:

Terminal window
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

--global は、このパソコンのすべてのリポジトリ共通の設定にするという意味(一度やれば以降は不要)。

なぜ先にやるのか: 未設定のまま git commit すると、Windows では次のエラーが出てコミットできない。

*** Please tell me who you are.
fatal: unable to auto-detect email address (got 'you@DESKTOP-XXXXXXX.(none)')

Mac は止まらないが、代わりに [email protected] のような架空のアドレスで記録されてしまう。これでは GitHub に送っても自分のアカウントに紐づかない。どちらの環境でも、コミットを始める前に登録しておくのが正解。

Claude Code に「コミットして」と頼んだ場合は、このエラーが表に出ないことがある。 未設定だと気づいて、その場限りの名前とメールを自分で決めてコミットしてしまう(2026-09-18 に Windows の実機で確認)。止まらない代わりに、自分が選んでいない値が記録に残る。先に登録しておけば、この迷いがなくなる。

メールアドレスを公開したくない場合は、GitHub が用意する noreply アドレス(12345678+ユーザー名@users.noreply.github.com)を使う手もある(コミットメールアドレスを設定する)。アカウント作成後にしか分からないので、その場合は4章まで進んでから、Claude Code にメールアドレスの設定をし直してもらう。

2-3. 最初のブランチ名を main にする

Section titled “2-3. 最初のブランチ名を main にする”

git init でリポジトリを作ると、最初のブランチに名前が付く。この記事も GitHub も、その名前を main として進める(ブランチは 5-4 で扱う。ここでは「履歴の本線の名前」と思っておけばよい)。

プロンプト
このパソコンの Git で、最初のブランチ名を main にする設定をして。

Mac は最初から main になる設定なので、頼んでも何も変わらない。Windows で Git for Windows を既定のまま入れた場合は master になるので、ここでそろえておく。裏で動いているのは次のコマンド:

Terminal window
git config --global init.defaultBranch main

なぜ master ではなく main なのか:Git の最初のブランチは、長いあいだ master という名前だった。2020年、人種差別への抗議運動(Black Lives Matter)が世界に広がるなか、コンピュータの世界で使われてきた master/slave(主人と奴隷)という言い方を見直す動きが IT 業界で起きた。同年6月、Git プロジェクトも「この名前を不快に感じる人がいる」として、最初のブランチ名を変えられるようにすると表明した。7月の Git 2.28 でこの節の設定(init.defaultBranch)が入り、10月には GitHub が新しいリポジトリの名前を main に変えた。Git 本体の既定はいまも master のままで、Mac で main になるのは Apple が設定を入れているから。Git 自体も、将来の版(Git 3.0)で main に変える予定になっている。

3. ローカルで Git を動かしてみる

Section titled “3. ローカルで Git を動かしてみる”

ここからは Git だけ使ってローカルで「コミット → 差分 → 巻き戻し」の流れを体験する。GitHub はまだ使わない。

2章で開いた ~/claude/git-test のセッションのまま進める。セッションを閉じていたら、Claudeデスクトップアプリで左上の </> のアイコン(Code)→ 新規 → ~/claude/git-test を指定して開き直す(指定のしかたは2章の冒頭と同じ)。

リポジトリの説明用に README.md を作る。GitHub では README.md がリポジトリのトップページに自動で表示される慣習があり、最初に置くファイルの定番。Claude Code の入力欄に依頼する:

プロンプト
README.md を作って、内容は「# 私の最初のリポジトリ」だけにして。

右上に並ぶアイコンのうち、フォルダのアイコン(ファイル)を押すと、README.md が作られていることを確認できる(→ CDG 5-5)。

このフォルダを Git の管理下にする:

プロンプト
このフォルダを Git で管理して。
コミットはまだしないで

「コミットはまだしないで」を添えるのは、Claude Code が気を利かせて、最初のコミットまで一気に済ませてしまうことがあるため。この記事では1ステップずつ見ていきたい。裏で動いているのは git init。

これで .git/ という隠しフォルダができる。2章で「フォルダ+履歴のセットをリポジトリと呼ぶ」と書いた、その履歴の実体がこれ。コミットの中身も設定も、すべてここに入る。.git/ を消すと履歴も消える ので手を出さない。

3-4. 状態を確認してコミットする

Section titled “3-4. 状態を確認してコミットする”

状態を見る:

プロンプト
今の状態を見せて

README.md が「まだ Git に追跡されていない(untracked)」状態だと教えてくれる。

コミットする:

プロンプト
README.md をコミットして。
メッセージは「最初のコミット」で

コミットのメッセージは履歴に残る説明文。指定しなければ、Claude Code が変更内容から決めてくれる。裏では次のコマンドが順に動いている:

Terminal window
git status
git add README.md
git commit -m "最初のコミット"

git add がステージング。ステージングとは「次のコミットに含めるファイル」を選ぶ操作で、複数ファイルを編集して一部だけコミットしたいときに使う。git commit の -m の後ろがメッセージ。

まだコミットしていない変更があると、Claudeデスクトップアプリの画面に 変更をコミット のボタンが出ることがあり、ここからもコミットできる。

3-5. ファイルを編集してコミット

Section titled “3-5. ファイルを編集してコミット”

「小さく変える → コミット」を4回くり返して、履歴を溜めていく(あとの 3-6 で戻すのに使う)。

1回目:ファイルを増やして、2つまとめてコミット

Web ページの実体を追加する。ここでは、複数のファイルを1つのコミットにまとめる感覚をつかんでおく。

プロンプト
public/index.html として Hello World と表示するだけのシンプルなHTMLを作って。
README.md にもそのことを書いておいて

public/index.html が新しくでき、README.md も書き換わる。状態を見る:

プロンプト
今の状態を見せて

README.md が変更され(modified)、public/ がまだ追跡されていない(untracked)、の2つを教えてくれる。新しく作ったフォルダは、中のファイルを1つずつ並べず public/ とまとめて表示される。

2つまとめて1つのコミットにする:

プロンプト
README.md と public/index.html をまとめて1つのコミットにして

裏では次のコマンドが動いている:

Terminal window
git add README.md public/index.html
git commit -m "Hello World のページを追加"

git add はスペース区切りでファイルを並べられる。全部まとめてよければ git add . でもよい(. は「このフォルダ以下すべて」の意味)。

1コミット=1つのまとまり:ここでは「ページを足した」という1つの作業が public/index.html と README.md の2ファイルにまたがっている。こういうときはまとめて1コミットにする。逆に、関係のない変更が混ざっているときは git add で片方だけ選んで別々にコミットする。3-4 の「ステージングは次のコミットに含めるファイルを選ぶ操作」というのは、このためにある。

2回目:見た目を変えてコミット

ここからは Claude Code に任せる。

プロンプト
public/index.html を派手にして
プロンプト
コミットして

Claude Code が add → commit までまとめてやってくれる(コミットメッセージは変更内容から自動で決まる)。裏で動いているのは次と同じ:

Terminal window
git add public/index.html
git commit -m "見た目を派手にする"

3回目:川柳を足してコミット

プロンプト
Claude Code を題材にした川柳を1つ作って、README.md に足して

自分で直してもよい。右上のフォルダのアイコン(ファイル)で README.md をクリックし、右上の </> ボタンで編集モードにして書き足す → 保存。どちらでも結果は同じ。

プロンプト
コミット

4回目:タイトルに日付を足してコミット

プロンプト
README.md の1行目のタイトルに、今日の日付を足して
プロンプト
commit

コミットの頼み方は「コミットして」「コミット」「commit」などどれでも通じる。Claude Code が意図をくんで add → commit してくれる。

こうして 「小さく変える → コミット」をこまめに繰り返すと、履歴に細かく区切りができ、あとから「あの変更の前に戻す」がやりやすくなる。次の 3-6 で git log を見ると、コミットが増えているのが分かる。

3-6. 過去のことも覚えているアシスタント

Section titled “3-6. 過去のことも覚えているアシスタント”

ここまでで5つのコミットが溜まった。Git はそれを記録しているだけで、何も解釈してくれない。 読んで答えるのは Claude Code のほう。記録は Git、読み解きは AI という組み合わせにすると、「過去のことも覚えているアシスタント」に頼むように使える。

ここでは5つ頼んでみる。コマンドを正確に覚える必要はない。 「さっきの変更をなかったことにしたい」のように状況を言えば、Claude Code が適切なコマンドを選んで実行してくれる。

今日やったことをまとめてもらう

Section titled “今日やったことをまとめてもらう”

まず、履歴を読みやすい表で出してもらう:

プロンプト
変更履歴を表で見せて

コミット・日時・内容がこんな形で表に並ぶ。3-4 と 3-5 で作った5つのコミット(最初のコミット → Hello World のページ追加 → 見た目を派手に → 川柳追加 → 日付追加)がそのまま並んでいるのが分かる。

ここからがアシスタントらしいところ。表を読むのではなく、要約してもらう。

プロンプト
今日やったことを100文字ほどでまとめて

返ってくる要約は、履歴の刻み方で決まる。 3-5 で「小さく変える → コミット」を繰り返したので、「ページを作り、見た目を派手にして、川柳と日付を足した」のように中身のある文が返る。まとめて1回しかコミットしていなければ、「いろいろ変えた」しか出てこない。

コミットメッセージは Claude Code が変更内容から付けてくれるので、自分で書かなくても読める履歴になる。自分で決めたいときは「『川柳を追加』というメッセージでコミットして」のように頼めばよい。

参考までに、表や要約のもとになっている生の履歴も見ておく:

プロンプト
生の履歴を git log で見せて

コミットハッシュ・著者・日付・メッセージが時系列で並ぶ。

実行結果が折りたたまれて表示されることがある。先頭の三角アイコンや「Bash …」のような行をクリックすると、中身が開いて出力を確認できる。

間違って消したファイルを戻す

Section titled “間違って消したファイルを戻す”

いちど、本当に消してみる。Finder で README.md をゴミ箱に入れる。

プロンプト
間違って消しちゃった。
戻して

ファイル名を言わなくても戻る。 何が消えたかは、記録と今のフォルダを見比べれば分かるため。

戻るのは、コミットしてあるものだけ。 一度もコミットしていないファイルを消した場合、Git には記録がないので取り戻せない(ゴミ箱や Time Machine を当たることになる)。

ゴミ箱に入れた直後なら、ゴミ箱から戻すほうが早い。 Claude Code がそちらを勧めることもある。ここで Git を使うのは、ゴミ箱を空にしたあとでも、別のパソコンからでも、コミットしてあれば戻せるため。

裏で動くのは git restore README.md。

3-5 で足した川柳を、なかったことにしてみる。Claude Code にこう頼む:

プロンプト
README.md を、川柳を足す前のコミットの時点に戻して。
その後の変更も一緒に消えてよい。

戻す先を「川柳を足す前のコミット」という時点で指定している。その時点に戻すと、川柳のあとに足したタイトルの日付も消える。2行目は、それで合っていると先に伝えるための1行。

裏で動くのは git checkout <コミット> -- README.md。ファイルの中身だけをその時点に戻すコマンドで、コミットの履歴は何も変わらない。戻した中身はまだコミットされていないので、このまま残したければ「コミットして」と頼む。

言い方で結果が変わる(2026-11-01、Sonnet で3回ずつ試した)。「README.md を川柳を足す前の状態に戻して」だと、3回とも川柳の行だけを手で消し、日付は残った。「川柳の無い状態」と読んだのだと思われる。「README.md に川柳を足す前のコミットに戻して」だと中身は戻ったが、戻し方が回ごとに違い、1回はあとのコミットを履歴ごと消した。上のプロンプトは3回とも同じ戻し方になった。2行目を「その後の編集作業はなかったことにして」にすると、中身は戻ったが、3回とも「履歴ごと消すなら git reset --hard もできる」と返ってきた。

戻してみたものの、やっぱり前のほうがよかった、ということがある。

プロンプト
戻したのを取り消して

戻した中身はまだコミットしていないので、最後のコミットの中身に戻せば済む。川柳も日付も帰ってくる。裏で動くのは git checkout HEAD -- README.md。

ただし、コミットしていない変更はどうやっても戻せない。いま取り消した「戻した中身」も、コミットしていなければ記録には残らない。

戻す前に、そもそも何が変わったのかを見たいことがある。

プロンプト
派手にする前と今で、何が変わった?

行単位で「どこがどう変わったか」が出る。戻す前に、見るだけで用が足りることは多い。

裏で動くのは git diff。

  • git add したファイルをステージから外す
  • 直前のコミットメッセージや内容を直す
  • さっきの変更をなかったことにして、最後にコミットした状態に戻す

どれも状況を言えば通じる。「さっきのコミットメッセージが雑だったので書き直して」のように頼めばよい。

ローカルで作ったリポジトリを GitHub に置く。GitHub アカウントを作成し、gh コマンドで認証してからリポジトリを作る。

本サイトでは、GitHub への操作(リポジトリ作成・push など)をすべて gh コマンド(GitHub CLI)とターミナルの git で行う方針。注意が必要なのは、次の GitHub プラグイン。

  • プラグイン「Github」(左下のアイコン → 設定 → カスタマイズ → プラグイン)… GitHub 公式の MCP サーバ。Claude Code に GitHub API を直接操作するツールを足す。これが入っていると gh・ローカルの git を使わず API 経由でリポジトリを操作してしまい、手元のコミットと GitHub 側がズレて手順どおりに進まないことがある。本ハンズオンの間はオフにしておくこと
⚠️ GitHub の MCP プラグインはオフにする。設定 → カスタマイズ → プラグイン に GitHub 公式の Github(MCP サーバ)があり、インストールしていなければそのままでよい。すでに入れているなら、本ハンズオンの間は無効化(またはアンインストール)しておく。なお、コネクタの「GitHub連携」とは別物。そちらはオフにしなくてよい。

gh に統一する理由は2つ。1つは、MCP プラグインが GitHub API に直接コミットする方式で、本記事で体験する「ローカルでコミット → push」の流れ(→ 1-1)と噛み合わないため。もう1つは、gh とターミナルの git はどの環境でも通用する汎用的な方法で、将来 Codex など別の AI コーディングツールに乗り換えても操作の違いが最小限にとどまるため。MCP プラグインは便利だが、本サイトでは汎用的な gh ルートを優先する。

公式も gh 寄り/MCP はコスト・信頼性で不利: Anthropic 公式のベストプラクティスも、外部サービス連携は CLI ツールが最も文脈効率がよいとし、「GitHub を使うなら gh CLI を入れよ」と明記している(Claude Code Best practices)。実測の差も大きく、ある比較(Claude Sonnet 4・75回試行の ScaleKit ベンチマーク)では、CLI は MCP に対し 1操作あたりのトークンが 4〜32 分の1、成功率は 100% 対 72%、月1万操作あたりのコストは 約 $3.20 対 $55.20。GitHub MCP は最初の一手の前に 93 ツール・約 55,000 トークン分の定義を読み込む(その後、既定は 52 ツールへ削減)という指摘もある(gh と MCP の比較、MCP vs CLI vs REST)。※ いずれもツール検索などの最適化が入る前の数値で、差は縮まりつつある。gh に統一するのは、初心者がつまずきにくいだけでなく、コストと安定性の面でも理にかなっている。

⚠️ GitHubのサイトにアクセスしたら、最初にChromeの自動翻訳をオフにすること。機能名(例:Actions)が「行動」のように直訳されるなど、UI全体が直訳調になって読みづらいため。Chromeの右上の ︙(メニュー) → 翻訳 → 表示されたポップアップの ︙ → このサイトは翻訳しない。
  1. github.com を開き、右上の Sign up をクリック
    GitHub のトップページ。右上に Sign in と Sign up のボタンがある

    右上の Sign up

  2. Continue with Google で Google アカウントを選ぶ
    Sign up for GitHub の画面。一番上に Continue with Google のボタンがある

    Sign up for GitHub の画面の Continue with Google

  3. ユーザー名を設定して登録完了
    github-guide-2-1-c.jpg

    Create account

ユーザー名はURLに使われる(github.com/ユーザー名)。後から変更できるが、外部に共有したURLが変わってしまうので最初から決めておくとよい。

4-2. Git のメールアドレスが GitHub と一致しているか確認する

Section titled “4-2. Git のメールアドレスが GitHub と一致しているか確認する”

2-2 で登録したメールアドレスが、いま作成した GitHub アカウントのものと一致しているか確認する:

プロンプト
Git に登録したメールアドレスを見せて

同じならこの節はこれで終わり。違っていたら GitHub 側に合わせておく:

プロンプト
Git のメールアドレスを [email protected] に変えて

裏で動いているのは git config --global user.email(確認)と、git config --global user.email "[email protected]"(変更)。

合わせておくと、GitHub 上でコミットの作者表示が自分のアカウントに紐づく(プロフィールアイコンが出る、Contributions グラフに反映される、など)。

GitHub アカウントのメールアドレスは、GitHub ページの右上の丸いプロフィールアイコン → Settings で確認できる。Public profile の Public email や、左メニュー Emails にある「Primary email address」を見る。

ここで変更した場合、3章で作ったコミットには変更前のアドレスが残ったままになる。練習用リポジトリなので気にしなくてよい。

GitHub 公式の CLI ツール。gh コマンドで GitHub のリポジトリ作成や認証ができる。

この節は Claude Code に頼まず、自分でターミナルを開いて入力する。ターミナルは、Finder の アプリケーション → ユーティリティ にある ターミナル で開く。

Homebrew でインストール(Homebrew 自体のセットアップは Homebrew をセットアップする 参照)。Windows は公式サイトのインストーラで入れる(→ WIN 4章):

Terminal window
brew install gh

確認:

Terminal window
gh --version

gh version 2.x のように表示されればOK。

command not found: gh(や brew 自体が見つからない)と出る場合は、PATH やコマンドのキャッシュの問題のことが多い。新しいターミナルを開き直す・hash -r でキャッシュをクリアする、などで直る。詳しくは HBS 6. 補足 を参照。

GitHub へのログインは、Claude Code に頼まず、自分のターミナルで打つ。2026-10-19 のハンズオンでは、Claude Code に頼むと、権限やセキュリティの確認で止まる人が多かった。

ターミナルは、Cmd + スペース で「ターミナル」と検索して開く。開いた場所(フォルダ)はどこでもよい。

Terminal window
gh auth login

質問が順に出るので、矢印キーで選んでいく:

  • What account do you want to log into? → GitHub.com
  • What is your preferred protocol for Git operations on this host? → HTTPS
  • Authenticate Git with your GitHub credentials? → Enter(既定の Y のまま)
  • How would you like to authenticate GitHub CLI? → Login with a web browser

8桁のワンタイムコードが表示されるのでコピーしておき、Enter でブラウザを開いて貼り付ける。

gh auth login の対話プロンプト(GitHub.com / HTTPS / Login with a web browser)と、8桁のワンタイムコード・ブラウザを開く案内が表示されたターミナル画面

自分のターミナルで打ったときの gh auth login の画面

ブラウザで GitHub が開くので、Continue を押し、コードを貼り付けて承認する。

GitHub の Authorize your device 画面。8桁のコードの入力欄と Continue ボタン

コードを貼り付けて Continue

続く画面で Authorize github を押すと「Congratulations, you’re all set!」と出て、ターミナルにも「Logged in as (ユーザー名)」と出る。

複数の GitHub アカウントを使い分けている人へ: 承認前に「いまブラウザに表示されている GitHub アカウントは想定通りか」を確認する。デフォルトブラウザのアカウント混在で意図しないアカウントに認証されることがある。詳しくは 6-6. 複数の GitHub アカウントを持っているときの注意点 を参照。

4-5. ローカルのリポジトリと GitHub をつなげる

Section titled “4-5. ローカルのリポジトリと GitHub をつなげる”

~/claude/git-test にいる状態で、Claude Code にこう頼む:

プロンプト
GitHubに非公開のリポジトリ git-test を作って、今のフォルダの内容をpushして

これで GitHub 上にリポジトリが作られ、リモート(origin)が登録され、ここまでのコミットの push まで一気に完了する。認証(4-4 の gh auth login)さえ済んでいれば、リポジトリ作成からはチャットで頼める。

裏では次の gh コマンドが動いている。オプションの意味を知っておくと応用が利く:

Terminal window
gh repo create git-test --private --source=. --remote=origin --push
  • --private: 非公開リポジトリで作る(--public にすれば公開)
  • --source=.: カレントディレクトリを使う
  • --remote=origin: リモート名を origin で登録
  • --push: ここまで作ったコミットを GitHub に送る

補足: push で何が送られているか 送られるのは .git/(→ 3-3)に溜まったコミットと、そこに記録されたファイルの中身。フォルダをまるごとアップロードしているのではなく、GitHub 側がまだ持っていないコミットだけが渡る(ローカル固有の設定などは送られない)。GitHub のリポジトリページでファイル一覧が見えるのも、最新のコミットを展開して表示しているだけで、向こうに作業フォルダが置いてあるわけではない。そのため、Git に追跡させていないファイル(→ 6-3)は GitHub 上に存在しない。

5-1. コミットを GitHub に反映する

Section titled “5-1. コミットを GitHub に反映する”

4-5 で最初の push をしたとき、upstream(追跡先)も記録される。以降は Claude Code に「pushして」と頼むだけで、変更を GitHub に反映できる。コミットメッセージも変更内容から自動で書いてくれる:

プロンプト
pushして

裏ではこんなコマンドが動いている:

Terminal window
git add 変更したファイル
git commit -m "○○を修正"
git push

ターミナルから手で入力することもできるが、基本は「pushして」と頼むのが楽。

5-1 の要領で「変更 → push」を何回かやってみる。push の頼み方も「プッシュして」「push」などどれでも通じるし、編集と push を1つの依頼にまとめてもいい。

1回目:短文を足して push

プロンプト
カフェオレについて約200文字の短文をREADME.mdに足して
プロンプト
プッシュして

2回目:コピーを足して push

プロンプト
AI使う人でGitHub使ってないとやばい!的な煽りコピーを3つpublic/index.htmlに足して
プロンプト
push

3回目:編集と push をまとめて頼む

プロンプト
タコライスのレシピを約100文字でREADME.mdに書いてpush

3回目のように「書いて push」とまとめて頼めば、Claude Code が編集 → コミット → push まで通してやってくれる。push するたびに GitHub 側が最新になり、GitHub のリポジトリページを開くと README.md や public/index.html が更新されているのが分かる。

5-3. GitHub の最新を取り込む(pull)

Section titled “5-3. GitHub の最新を取り込む(pull)”

ここまでは「手元 → GitHub」の一方向だった。ところが、GitHub 側のほうが手元より新しくなることもある。

  • 別の Mac で作業して push した
  • GitHub の画面で直接ファイルを直した
  • クラウドで動く Claude Code に作業を頼んだ(結果は GitHub に push される)

そのままだと手元は古いまま。作業を始める前に GitHub の最新を手元に取り込む。これを pull(プル)という。

GitHub の画面で直して、手元に取り込んでみる

まず GitHub の画面で直して、GitHub 側を新しくする。

  1. GitHub で git-test のリポジトリページを開き、README の欄の右上にある鉛筆アイコン(Edit file)をクリック

GitHub のリポジトリページの README 欄。右上の鉛筆アイコンに Edit file のツールチップが出ている

README の欄の右上の鉛筆アイコン(Edit file)

  1. 末尾に「GitHub の画面から直接追記」と1行足す
  2. 右上の Commit changes… をクリック。出てきた画面で Commit directly to the main branch が選ばれているのを確かめて、Commit changes をクリック

Commit changes の画面の下部。Commit directly to the main branch が選ばれ、右下に Commit changes ボタンがある

上の Commit directly to the main branch のまま Commit changes

下の Create a new branch for this commit and start a pull request を選ぶと、ブランチとプルリクエスト(→ 5-5)の流れになる。ここでは上のまま。

次に、手元の Claude Code に頼む。

プロンプト
GitHub の最新を取り込んで

git pull を実行してよいか聞かれるので、一度だけ許可 をクリック。取り込んだ範囲と変わったファイルを教えてくれる。

「GitHub の最新を取り込んで」と頼んだあと、git pull の実行を許可するか聞く画面。拒否・常に許可・一度だけ許可のボタンが並ぶ

許可を聞かれたら 一度だけ許可

README.md を開くと、末尾に GitHub で足した1行が入っている。

裏ではこのコマンドが動いている:

Terminal window
git pull

pull は「GitHub の最新を取ってきて(fetch)、手元に合流させる(merge)」操作。

作業を始める前に「GitHub の最新を取り込んで」を習慣にする。 別の Mac やクラウドでも作業しているときはとくに。取り込まないまま同じ場所を直すと、5-6 のコンフリクトになる。

ここから 5-6 までは、最初のうちは読み飛ばしてよい。 基本的に main に直接コミットしていくやり方で困ることはない。しかし、「大きく変えてみたいけど、うまくいくか分からない」ときや、クラウドの Claude Code が作業用のブランチを作ってきたときなどに必要になるかも。

ブランチとは

本番(main)から分かれた作業の流れのこと。分かれた先で何をしても main は変更されずに安全なので、試してよければ main に合流させ、だめなら捨てればよい。

左から右へ続く main(本番)の線から、上に分かれたブランチが先で main に合流し、下に分かれたもう1本は途中で×になって捨てられる図。main の線は最後まで途切れない

main から分かれて試し、よければ合流、だめなら捨てる。どちらでも main は途切れない

ブランチは考え方で、実際に作ると1本ずつ名前が付く。実は main もブランチの1本で、最初からある本番用の名前。新しいブランチの名前は、頼めば Claude Code が中身に合わせて付けてくれる(試したときは flashy-heading、black-background だった)。自分で指定してもよい。

いまどのブランチにいるかは、Claudeデスクトップアプリのセッションレール(右上のいちばん左のアイコンで出す右の欄 → CDG 5-7)の 環境 に出る。

セッションレールの環境の欄。git-test のフォルダの下に、ブランチの印とブランチ名 claude/readme-worktre…ice-d60f53 が出ている

セッションレールの 環境 に、いまいるブランチが出る(画面は、このあと出てくるワークツリーで作業しているとき)

試して、採用する

プロンプト
ブランチを作って、index.html の見出しをもっと派手にする案を試して

public/index.html をブラウザで開いて見た目を確かめる(「index.html をブラウザで開いて」と頼んでもよい)。気に入ったら:

プロンプト
よさそうだから main に取り込んで、ブランチは消して

ブランチを main に取り込むことを マージ(merge、合流)と呼ぶ。次の 5-5 ではプルリクエストと一緒にマージが出てくるが、マージ自体はプルリクエストが無くてもできる。ここでやったのもマージ。

試して、やめる

プロンプト
ブランチを作って、index.html の背景を真っ黒にする案を試して
プロンプト
やっぱりやめて main に戻して、ブランチも消して

main に戻ると、黒い背景はなかったことになる。どちらも Git のコマンドを動かすので、許可を聞かれたら 一度だけ許可 をクリックする。

ブランチとワークツリーの違い

Claudeデスクトップアプリの入力欄の下のフォルダのボタンを押すと、メニューの下のほうに ブランチ(いまのブランチ名が出る)と、ワークツリー のスイッチが並んでいる。名前は似ているが別物。

入力欄の下の git-test のフォルダのボタンから開いたメニュー。最近使ったフォルダの一覧の下に、フォルダを開く…、ブランチ(main)、ワークツリーのスイッチが並ぶ

メニューの下のほうに ブランチ(いまは main)と、ワークツリー のスイッチがある

何か向いている場面
ブランチ作業の流れの名前。いつものフォルダの中で切り替える1つずつ試す
ワークツリー作業用に分けた一時的なフォルダ。ブランチごとに1つできる複数のセッションに同時に作業させる

スイッチをオンにして頼むと、git-test/.claude/worktrees/ の下に別のフォルダができ、claude/ で始まる名前のブランチで作業する(名前の付け方はクラウドの作業用ブランチと同じだが、こちらは手元で動く)。フォルダが別なので、同時に走らせてもお互いのファイルを上書きしない。ワークツリーは Git の機能なので、GitHub につないでいないリポジトリでも使える。いつもの git-test のファイルは変わらない。終わったら:

プロンプト
この変更をコミットして、main に取り込んで、ワークツリーを片付けて

最後の片付けでは、英語の注意書き(「Approve only if you trust it.」)付きで許可を聞かれる。フォルダを移動してから Git を動かすための注意で、自分のリポジトリなら 一度だけ許可 でよい。

最初はブランチだけで十分。ワークツリーは、複数のセッションを同時に走らせたくなったら使う。

5-5. 一歩先:プルリクエストを作ってマージする

Section titled “5-5. 一歩先:プルリクエストを作ってマージする”

ブランチの変更を main に合流させる前に、GitHub の画面で差分を確かめる仕組みが プルリクエスト(Pull Request、PR)。「このブランチを main に取り込んでください」という申し込みで、確かめて問題なければマージする(5-4 の「main に取り込んで」と同じ操作)。1人で使っていても、何をなぜ変えたかが GitHub に記録として残る。

クラウドの Claude Code は、作業すると claude/ で始まる作業用のブランチを作って GitHub に push する。そこから main に入れるときも、この流れになる。

ブランチを作る前に main を push しておく。 push していないコミットがある main からブランチを作ると、その分もプルリクエストに混ざる(試したときは Claude Code が自分から注意してくれた)。「GitHub の最新の main からブランチを作って」と頼んでもよい。

プロンプト
ブランチを作って、README に「ブランチの練習」という節を足して。
終わったら GitHub に push して、プルリクエストを作って

プルリクエストのリンク(ユーザー名/git-test#1 のような表示)が返ってくる。開くと:

  • Files changed タブ:変更の差分
  • ページ下の Merge pull request ボタン:マージ

GitHub のプルリクエストの画面。タイトルの下に Open、タブに Conversation・Commits・Checks・Files changed、下に No conflicts with base branch と Merge pull request ボタン

Claude Code が作ったプルリクエスト。本文に変更内容も書いてくれる

Files changed タブで差分を確かめたら:

プロンプト
プルリクエストをマージして、手元の main も最新にして

マージしてもブランチは残る(GitHub の画面にも Delete branch ボタンが出る)。続けて消しておく:

プロンプト
マージ済みのブランチを、手元と GitHub の両方から消して

GitHub の画面の Merge pull request を自分で押してもよい。その場合は、手元で「GitHub の最新を取り込んで」(→ 5-3)。

裏では、4章で入れた gh コマンドの gh pr create(作る)と gh pr merge(マージする)が動いている。

同じファイルの同じ行を、手元と GitHub で別々に書き換えると、どちらを残すか Git には決められない。これが コンフリクト(競合)。わざと起こして、解消してみる。

  1. 手元の Claude Code に頼む:
プロンプト
README の1行目の見出しを「私の最初のリポジトリ(手元で変更)」に変えてコミットして。
pushはまだしないで
  1. GitHub の画面で README.md の1行目を「# 私の最初のリポジトリ(GitHub で変更)」に変えて保存する(鉛筆アイコンで開いて Commit changes するまでの手順は 5-3 と同じ)
  2. 手元で取り込む:
プロンプト
GitHub の最新を取り込んで

Claude Code は取り込みの途中で止まり、ぶつかった2つの見出しを並べて「どちらを残すか選んでください」と聞いてくる。どちらかを勝手に選ぶことはない。

「GitHub の最新を取り込んで」への応答。README.md の1行目が競合して止まっていると伝え、手元と GitHub の見出しを並べて、どちらを残すか選んでくださいと聞いている

ぶつかった2つを並べて、どちらを残すか聞いてくる

プロンプト
どこがぶつかっているか教えて

元の見出し・手元の見出し・GitHub の見出しを並べて説明してくれる。このとき README.md の中には、こんな印が入っている:

<<<<<<< HEAD
# 私の最初のリポジトリ(手元で変更)
=======
# 私の最初のリポジトリ(GitHub で変更)
>>>>>>> a556760

<<<<<<< から ======= までが手元の版、======= から >>>>>>> までが GitHub の版(末尾の英数字はコミットの番号で、環境ごとに違う)。自分でファイルを開いてこれを見ても慌てなくてよい。どうするか決めたら:

プロンプト
両方の内容を残す形で直して、pushして

片方だけにするなら「手元の方を残して」「GitHub の方を残して」と頼む。

防ぎ方:作業を始める前に「GitHub の最新を取り込んで」(→ 5-3)。取り込んでから直せば、ぶつからない。

ハンズオンを進めるうえでは必須ではないが、知っておくと困らない話題をまとめる。

6-1. すでに GitHub にあるリポジトリを使う

Section titled “6-1. すでに GitHub にあるリポジトリを使う”

新しい Mac に替えた、別の Mac でも作業したい、他人が作ったリポジトリを使いたい、というときは、GitHub のリポジトリを手元にまるごと取ってくる。これを clone(クローン)という。

clone は「まだ無い作業フォルダを作る」操作。一方、Claude Code はフォルダを選んでその中で動く。そのため clone だけはターミナルで行う(Claudeデスクトップアプリのフォルダのボタンのメニューにも、clone の項目は無い)。

Terminal window
cd ~/claude
Terminal window
gh repo clone ユーザー名/リポジトリ名

~/claude/リポジトリ名 ができるので、Claudeデスクトップアプリでそのフォルダを選んで始める。gh repo clone は内部で git clone を呼ぶが、URL を自動補完してくれるので楽。

状況やること
GitHub にあるリポジトリを手元に初めて持ってくるターミナルで gh repo clone(この節)
すでに手元にあるリポジトリに、GitHub の最新を取り込む「GitHub の最新を取り込んで」と頼む(→ 5-3)

clone は新しいフォルダができる。pull はいつものフォルダの中で動く。

リポジトリを Public(公開)にしていると、ファイルの中身や変更履歴は誰でも閲覧できる状態になる。HTML + JavaScript + CSS だけのシンプルなアプリであれば大きな問題になることは少ないが、以下のようなケースでは Private(非公開)への変更がおすすめ。

  • 試行錯誤の履歴を見られたくない
  • 意図しないファイルを公開してしまうリスクを避けたい

変更方法:リポジトリの Settings → Danger Zone(ページ下部) → Change repository visibility

本記事の手順(4-5)では --private で作成しているので、初期状態から Private。Public/Private を後から切り替えたくなったときの参考までに。

6-3. アップしたくないファイルの設定

Section titled “6-3. アップしたくないファイルの設定”

.gitignoreギット イグノア は「GitHub にアップしたくないファイル」のリストを書いておくファイル。

対象の例:パスワード・API キー / node_modules(大量の依存ファイル)/ .DS_Store(macOS が自動生成する不要ファイル)

Claude Code に頼んで作る:

プロンプト
.DS_Store と node_modules を Git に入れないようにして

.gitignore が作られて、2つが書き込まれる(中身は .DS_Store と node_modules/ の2行)。Claude Code は、サブフォルダの中にある .DS_Store や node_modules も除外されることを確かめて、.gitignore 自体もコミットしてくれる。

うっかり秘密情報を公開してしまうのを防ぐ。プロジェクト作成時に設定しておくのが基本。
ただし、.gitignore は「まだ Git で管理していないファイル」を除外するためのもの。すでに追加済みのファイルは別途対処が必要なので、最初に設定しておくと混乱しにくい。
macOS では .DS_Store が頻繁に生成されるので、最初から除外しておくとよい(Windows なら Thumbs.db / desktop.ini が同様の自動生成ファイル)。

6-4. github.dev(ブラウザで VS Code)

Section titled “6-4. github.dev(ブラウザで VS Code)”

GitHub のリポジトリページで . キーを押すと、ブラウザの中に VS Code がそのまま立ち上がる。これが github.dev という公式機能で、完全無料・ログインだけで使える。

github.dev でリポジトリを開いたところ

github.dev でリポジトリを開いたところ

起動方法は2つ。

  • リポジトリページで . キーを押す(一番手軽)
  • URL の github.com を github.dev に書き換える

ブラウザ内でファイルを編集してそのままコミットまでできる。インストール不要・セットアップ不要。普段 Mac で作業しているけれど、ちょっと別の PC から md ファイルを修正したい、というときに便利。

リポジトリの Code ボタンから Codespaces を開く選択肢もあるが、それは別サービス(クラウド上の Linux 環境で VS Code を動かす、ターミナル付き、無料枠は月60時間まで)。github.dev とは URL も中身も異なる。

ただしターミナルは使えないので、git コマンドを実行する操作はできない。あくまで「ファイル編集とコミット」までの軽い用途。本格的な開発はローカル(Claude Code など)に戻ることになる。

元の GitHub のページ(github.com)に戻りたいときは、左下のステータスバーの GitHub 表示部分をクリックして リポジトリに進む を選ぶか、URL の github.dev を github.com に書き換える。

6-5. Claude × GitHub の連携機能とローカル開発

Section titled “6-5. Claude × GitHub の連携機能とローカル開発”

Claudeデスクトップアプリには、GitHub と連携する機能がいくつかある。大きく2種類に分かれる。

  • GitHub 連携(コネクタ)や GitHub Plugin:GitHub 上のリポジトリや Issue を読み書きする仕組み。手元のフォルダで開発する方法の代わりにはならない。本記事では使わず、gh コマンドで GitHub を操作する
  • Claude Code のクラウドセッション:入力欄の左下を ローカル から クラウド に切り替えると、Claude Code が GitHub のリポジトリをクラウドに取ってきて作業し、終わったら GitHub に push する。手元の Mac を閉じていても進む

クラウドセッションは、本記事の「手元で作業して push する」やり方とつながっている。クラウドで進んだ分は 5-3 の「GitHub の最新を取り込んで」で手元に持ってくる。 クラウドは claude/ で始まる作業用のブランチを作るので、main に入れるときは 5-5 のプルリクエストの流れになる(頼むときに「終わったら main に push して」と付ければ、main に直接入れることもできる)。クラウドセッションの始め方は本記事では扱わない。

6-6. 複数の GitHub アカウントを持っているときの注意点

Section titled “6-6. 複数の GitHub アカウントを持っているときの注意点”

仕事用・個人用と GitHub アカウントを使い分けている場合、gh auth login のブラウザ起動で意外と詰まりやすい。よくあるトラブルと対処を整理しておく。

デフォルトブラウザが GitHub を使ってるブラウザと違う

gh auth login は OS の既定ブラウザを開く。たとえば Mac で普段は Chrome で GitHub にログインしているのに、既定ブラウザが Safari のままだと、Safari が開いてしまう。Safari に GitHub のログイン状態がなければそこで改めてログイン要求が出るし、別アカウントで Safari にログインしていた場合は意図しないアカウントで承認してしまう。

対処:

  • ターミナルに表示される URL(https://github.com/login/device)を手動でコピーして、いつも使うブラウザに貼り付けて開く
  • もしくは OS の既定ブラウザを変更しておく(macOS は システム設定 → デスクトップとDock → デフォルトのWebブラウザ。Windows は既定のブラウザ設定から変更)

同じブラウザでもプロファイル違い・アカウント違い

Chrome のプロファイルを複数使い分けていて、それぞれで別の GitHub アカウントを使っている場合、gh auth login で開いた Chrome ウィンドウが想定したプロファイルではない、ということもある。気づかず承認すると、その後の gh repo create で意図しないアカウント側にリポジトリができてしまう。

対処:承認ボタンを押す前に、ブラウザ右上のプロファイル表示と GitHub の右上アカウントアイコンを確認する。

6-6-2. 状態確認とアカウント切替

Section titled “6-6-2. 状態確認とアカウント切替”

gh 自体は複数の GitHub アカウントを並行して保持できる。今どのアカウントが使われているかの確認も、切り替えも、Claude Code に頼める。

プロンプト
gh でログインしている GitHub アカウントと、今使っているのがどれかを見せて
プロンプト
GitHub のアカウントを yto に切り替えて

裏で動くコマンドは次のとおり(早見表として)。

コマンド動作
gh auth status認証済みアカウント一覧と現在のアクティブを確認
gh auth login新規アカウント追加
gh auth switch対話的にアクティブを切替
gh auth switch --user <username>ユーザー名指定で切替
gh auth logoutログアウト(複数あれば対話的に選ぶ)

例:tatsuwo-dayo がアクティブで、yto アカウントでリポジトリを作りたいとき:

プロンプト
GitHub のアカウントを yto に切り替えて、非公開のリポジトリ my-repo を作って。
終わったら tatsuwo-dayo に戻して

裏では次のコマンドが順に動く:

Terminal window
gh auth switch --user yto
gh repo create my-repo --private --clone
gh auth switch --user tatsuwo-dayo

gh auth switch は GitHub CLI v2.40(2023年末)で追加された比較的新しいコマンド。「unknown command」と言われたら brew upgrade gh(Windows は cli.github.com から新しい .msi を入れ直す)で更新する。

GitHub に push したファイルは、GitHub Pages でそのまま Web 公開できる。リポジトリの設定画面から数クリックで完了し、https://ユーザー名.github.io/リポジトリ名/ の形式で URL が発行される。

ただし、無料版(GitHub Free)では Public リポジトリでないと GitHub Pages を使えない。本記事の git-test は Private で作ったので、試すには Public に変更する(→ 6-2 の逆操作。Settings → Danger Zone → Change repository visibility)か、gh repo create --public で作った別のリポジトリを使う。

  1. リポジトリの Settings を開く
  2. 左メニューの Pages を選択
  3. Source を Deploy from a branch に設定
  4. Branch を main、Folder を / (root) にして Save
    github-guide-2-4-a.jpg

    Branch

  5. Pages設定画面の上部にURLが表示される(https://ユーザー名.github.io/git-test/)。反映まで数分かかるので、しばらく待ってからアクセスして確認する

注意点:

  • 最初に表示されるのは、公開フォルダの直下にある index.html。git-test で作った HTML は public/ の中なので拾われず、代わりに README.md の内容がレンダリングされて表示される。Deploy from a branch で選べる Folder は / (root) と /docs の2つだけなので(公式ドキュメント)、public/index.html をトップにしたいならファイルをリポジトリ直下か docs/ に移す。任意のフォルダを公開フォルダにしたい場合は GitHub Actions を使う(→ 公式ドキュメント)
    • このあたりは Cloudflare Pages のほうが素直で、public のような出力フォルダをそのまま指定できる(→ CGT)
  • あくまで静的サイト(HTML/CSS/JSなど)が対象。サーバー側の処理が必要なものは別途対応が必要
  • 公開をやめたいときは Settings → Pages の Source を None に戻す

ポートフォリオや静的なブログの公開によく使われる。本サイトのハンズオンで使う Cloudflare Pages(→ CGT)の GitHub 版にあたる機能で、push すると自動で公開内容も更新される。

本記事の流れでは gh auth login(→ 4-4)が git の認証(HTTPS)まで面倒を見てくれるので、SSH の設定は不要。すでに SSH で GitHub を使っている人や、SSH 接続にしたい人向けに手順をまとめておく。一度設定すれば、その後はパスワードなしで操作できる。

6-8-1. GitHub に登録されているメールアドレスを確認する

Section titled “6-8-1. GitHub に登録されているメールアドレスを確認する”

GitHub → 右上のアイコン → Settings → Emails

ここに表示されているメールアドレスを次のステップで使う。Google連携でGitHub登録した場合、GmailアドレスとGitHubに登録されているアドレスが異なる場合があるので必ず確認すること。

Terminal window
ssh-keygen -t ed25519 -C "確認したメールアドレス"

実行後は Enter を3回押すだけでOK。アスキーアートっぽいのも出てくるが問題なし。

すでに ~/.ssh/id_ed25519 がある場合は Overwrite (y/n)? と聞かれる。既存のキーをそのまま使うなら n(または Enter)で抜けて次に進む。新しく作り直したい場合のみ y(既存の鍵は失われるので、他で使っていないか確認すること)。

6-8-3. 公開鍵を GitHub に登録する

Section titled “6-8-3. 公開鍵を GitHub に登録する”

公開鍵をクリップボードにコピーする:

Terminal window
pbcopy < ~/.ssh/id_ed25519.pub

Windows(Git Bash)では pbcopy の代わりに clip < ~/.ssh/id_ed25519.pub を使う。

GitHub → Settings → SSH and GPG keys → New SSH key でフォームを開き、以下を入力して Add SSH key をクリック。

フィールド入力内容
Titleこの端末の識別名(例:MacBook Air)。何でもOK
Keyコピーした公開鍵をペースト
Terminal window

Hi ユーザー名! と表示されれば成功。

うまくいかない場合は、-v(verbose)を付けて詳細ログを取り、その内容を Claude Code に貼って原因を相談する。

Terminal window

失敗の原因は環境によって違う(過去に別アカウントを作っていた、SSHエージェントに鍵が読み込まれていない、会社ネットワークでポート22がブロックされている、など)。詳細ログを見れば多くの場合は原因が特定できる。

本番ファイルを直接変更せず、分かれた先で作業してから OK なら合流させる仕組み。頼み方で試す手順は 5-4 にある。

main
├── feature ブランチ(新機能を試す)
└── fix ブランチ(バグ修正用)

GitHub では、「このブランチの変更を main に取り込んでください」と依頼する仕組みを Pullプル Requestリクエスト(PR) と呼ぶ(→ 5-5)。現場では「プルリク」と略されることが多い。

最初のうちはブランチを作らず、main に直接コミットしていく方針で問題ない。チームでの開発や、クラウドの Claude Code を使い始めたタイミングで覚えれば十分。

同じファイルを複数人(または複数の Mac、Mac とクラウド)が別々に編集すると、どちらを正とするか Git には判断できなくなる。これがコンフリクト。わざと起こして解消する手順は 5-6 にある。

発生しやすいケース:

  • 複数人が同じファイルを編集した
  • 自宅の Mac と会社の Mac で作業した
  • GitHub の画面やクラウドの Claude Code と、手元の Mac を使い分けた

作業を始める前に「GitHub の最新を取り込んで」(→ 5-3)を習慣にすると防ぎやすい。

6-11. 作業メモをリポジトリに残す

Section titled “6-11. 作業メモをリポジトリに残す”

リポジトリに置けるのはコードだけではない。「なぜこの方式にしたのか」「何を調べたのか」も Markdown で一緒に置いておける。Claude Code は毎回ゼロから始まるので、経緯を残しておくと次のセッションでも読んでもらえる。GitHub 上ではそのまま Wiki のように読める(→ 作業メモと決定をリポジトリの中に残す)。

Git の操作は最初の「コミットの粒度感」さえつかめば、あとは必要な場面で必要なコマンドを増やしていけばよい。