個人開発のためのGitHub最小限入門 リポジトリ作成からVercel連携まで

結論

個人開発でGitHubを使う目的は、コードのバックアップとVercelとの自動デプロイ連携の2つだ。操作は「変更を保存（git add + commit）→GitHubに送る（push）→Vercelが自動デプロイ」の流れで、この3ステップを覚えれば日常的な開発サイクルが回る。

GitHubアカウントの作成

github.comにアクセスし、「Sign up」からアカウントを作成する。メールアドレス・ユーザー名・パスワードを設定するだけだ。

ユーザー名はプロフィールURL（github.com/ユーザー名）になるため、自分の名前や開発者としての名前を設定するのがよい。後から変更できるが、リポジトリのURLも変わるため注意が必要だ。

Gitのインストールと初期設定

ターミナルでgitを使うには、Gitをインストールする必要がある。

macOS：Xcode Command Line Toolsを入れるとgitも含まれる。

xcode-select --install

確認：

git --version
# git version 2.x.x が表示されればOK

初期設定として、コミット時に表示する名前とメールアドレスを設定する。

git config --global user.name "あなたの名前"
git config --global user.email "your-email@example.com"

GitHubに登録したメールアドレスと同じにすると、GitHubプロフィールにコミットが紐づく。

リポジトリの作成

GitHub側で作成：

1. GitHubダッシュボードの右上「+」→「New repository」を選択
2. リポジトリ名を入力（例：my-media）
3. PublicかPrivateを選ぶ
4. 「Create repository」を押す

リポジトリが作成されると、ページに初期セットアップのコマンドが表示される。

ローカルプロジェクトをGitHubに接続する

既存のプロジェクト（Astroのプロジェクトなど）をGitHubのリポジトリに接続する手順だ。

# プロジェクトディレクトリに移動
cd my-project

# gitの初期化（まだgit initしていない場合）
git init

# 全ファイルをステージング
git add .

# 最初のコミット
git commit -m "初回コミット"

# GitHubのリポジトリと接続
git remote add origin https://github.com/ユーザー名/リポジトリ名.git

# GitHubにプッシュ
git push -u origin main

.gitignoreで機密情報の誤アップロードを防ぐ

.gitignoreは、Gitが無視するファイルを指定するファイルだ。機密情報・依存パッケージ・ビルドファイルをGitHubに上げないために必要だ。

プロジェクトのルートに.gitignoreを作成する：

# 環境変数（APIキーなど）— 絶対にアップロードしない
.env
.env.local
.env.production

# パッケージ（npm installで再生成できるため不要）
node_modules/

# ビルド成果物（ビルドで再生成できるため不要）
dist/
.astro/

# OS・エディタのメタファイル
.DS_Store
.vscode/

.envファイルをGitHubに上げることは、APIキー・データベースパスワードを全世界に公開することを意味する。.gitignoreに必ず含めることを徹底する。

日常の操作：変更→コミット→プッシュ

記事を追加したりコードを修正したりした後、GitHubに反映させる操作は3コマンドで完結する。

# 変更したファイルをステージング（全変更の場合）
git add .

# コミット（変更内容のメモを書く）
git commit -m "新記事を追加: AIセキュリティの基礎"

# GitHubにプッシュ
git push

git add：変更したファイルをコミットの準備状態にする
git commit：「この変更を保存する」という操作。メッセージは後から振り返るときの記録になる
git push：ローカルの変更をGitHubに送る

Vercelと連携している場合、pushした時点でVercelが自動でビルド・デプロイを開始する。

GitHub Desktopで操作する（コマンドライン不要）

コマンドラインに慣れていない場合は、GitHub Desktop（desktop.github.com）が使いやすい。

GitHub Desktopを開くと、変更されたファイルの一覧が表示される。確認した後、下部のコミットフォームにメッセージを入力して「Commit to main」を押すと、コミットが完了する。右上の「Push origin」でGitHubに送信できる。

よくあるミスとその対処

「Already up to date」と表示される：変更がない状態でpullを実行したときのメッセージ。問題ない。

「nothing to commit」：git addされていない変更がある、またはそもそも変更がない。git statusでファイルの状態を確認する。

プッシュ時に認証エラー：GitHubのパスワード認証は2021年に廃止されている。Personal Access Token（PAT）またはSSH鍵の設定が必要だ。GitHubの Settings → Developer settings → Personal access tokens で生成できる。

.envを誤ってコミットした場合：すぐにそのシークレットを無効化（APIキーの再発行等）する。gitのコミット履歴から削除するよりも、秘密を無効化する方が確実で速い。

Vercelとの連携設定についてはVercelの初期設定とGitHub連携・自動デプロイで詳しく解説している。Claude Codeからgit操作を行う方法はClaude Codeで個人開発を加速するでも触れている。

まとめ

個人開発でGitHubを使う基本操作は、「git add → git commit → git push」の3つだ。.gitignoreに.envとnode_modules/を必ず含めることで、機密情報の誤公開とpushサイズの肥大化を防げる。GitHub DesktopというGUIツールがあるため、コマンドラインに慣れていなくても始められる。Vercelと連携することで、プッシュ→自動デプロイの流れが完成する。