GitHubで初めてのリポジトリ作成!初期化からプッシュまでを徹底解説
これまでの記事でGitHubアカウントの作成とGitのインストールが完了し、いよいよGitHubを本格的に活用する準備が整いました。最初のステップとして、まずはあなたのコードを保管する「家」となるリポジトリを作成してみましょう。
この記事では、「リポジトリとは何か?」という基本的な概念から、GitHub上でリポジトリを作成する具体的な手順、そしてあなたのパソコン(ローカル環境)で作成したファイルを初めてGitHubにアップロード(プッシュ)するまでの一連の流れを、コマンドと共に丁寧に解説していきます。この流れは、今後の開発で何度も繰り返す基本動作なので、ぜひここでマスターしてください!
確認日とこのページの使い方
確認日: 2026年5月19日。GitHubに初めてローカルファイルをpushする人向けに、空のリポジトリ作成、git init、add、commit、remote、push、反映確認までを整理します。
このページは、Gitの全機能を覚えるためではなく、「今どこで止まっているか」を切り分けるための入口です。GitHubに上げるファイルと、公開サーバーに置くファイル、秘密情報を含むローカル専用ファイルは分けて考えてください。
このページで整理できること
- GitHub側に空のリポジトリを作るか、READMEありをcloneして始めるかを選ぶ
- 初回push前に、変更状態、ブランチ名、remote URL、秘密情報の混入を確認する
- pushできない時、認証、remote、ブランチ、READMEの有無のどこを見るか分ける
- AIやCodexに相談する時、貼ってよいコマンド結果と伏せる情報を整理する
先にゴール確認:初回pushはここまでできれば成功
初回pushで見るべきゴールは、GitHubの画面にファイルが出ることだけではありません。次の状態まで確認できれば、次回からの更新作業に進めます。
git statusで変更状態を確認できるgit addとgit commitで履歴を1つ作れるgit remote -vでGitHubのURLが登録されているgit push -u origin mainでGitHubへ反映できる- GitHubのリポジトリ画面で、追加したファイルを確認できる
Gitの導入やSSH接続がまだの場合は、先に
GitのインストールとGitHub接続を済ませてください。
addとcommitだけを先に理解したい場合は、git addとcommitの使い方が近道です。
注意:GitHubでREADMEを作った場合は手順が少し変わる
GitHub側で「Add a README file」にチェックを入れてリポジトリを作ると、GitHub側に先に1コミットある状態になります。
その場合、ローカルでgit initしてそのままpushすると、履歴が合わずに止まることがあります。
初心者は、最初はGitHub側でREADMEを作らず空のリポジトリにするか、既存リポジトリを使う場合は cloneしてから作業する方法を選ぶと安全です。
そもそもリポジトリとは?プロジェクトの「入れ物」です
リポジトリ(Repository)とは、直訳すると「貯蔵庫」や「保管場所」を意味します。プログラミングの世界では、あなたのプロジェクトに関連するすべてのファイル(HTML, CSS, JavaScript, 画像など)と、それらの**変更履歴(コミットログ)全体をまとめて保管しておくための「入れ物」**と考えてください。
リポジトリには、大きく分けて2種類あります。
- ローカルリポジトリ: あなたのパソコンの中に作られるリポジトリです。普段の作業はここで行います。
- リモートリポジトリ: GitHubのような、インターネット上のサーバーに作られるリポジトリです。チームメンバーとのコード共有や、個人のコードのバックアップ拠点として機能します。
基本的な開発の流れは、ローカルリポジトリで作業を進め、キリの良いところでセーブ(コミット)し、その変更内容をリモートリポジトリにアップロード(プッシュ)する、というサイクルになります。
GitHubでリモートリポジトリを作成する手順
まずは、GitHub上にコードの保管場所となるリモートリポジトリを作成しましょう。手順はとても簡単です。
ステップ1: 新規リポジトリ作成ページへ移動
GitHubにログインし、画面右上の「+」アイコンをクリックするか、ダッシュボードの左側にある「New」ボタンを押します。
[画像:GitHubダッシュボードの「New」ボタンが強調されている様子]
ステップ2: リポジトリの情報を入力
「Create a new repository」というページが表示されるので、必要な情報を入力していきます。
[画像:「Create a new repository」フォームの各項目を解説している様子]
- Repository name: リポジトリの名前です。プロジェクトの内容がわかる、簡潔な名前を英語で付けましょう。(例: `my-portfolio-site`)
- Description: リポジトリの簡単な説明です(任意)。どんなプロジェクトなのかを書いておくと、後から見返したときに分かりやすいです。
- Public / Private: 公開範囲を選びます。世界中の誰にでも見てもらいたい場合は「Public」、自分だけ、あるいは招待した人だけが見られるようにしたい場合は「Private」を選びます。練習用なら「Private」で良いでしょう。
- Initialize this repository with:: リポジトリ作成時に、自動で含めるファイルを選べます。
- Add a README file: プロジェクトの説明書となるファイルです。完全に初めてのpush練習では、いったんチェックを外して空のリポジトリにすると手順が単純です。READMEありで始めたい場合は、先にcloneしてから作業すると安全です。
- Add .gitignore: Gitの管理対象から外したいファイルを指定する設定ファイルです。今は「None」のままで構いません。
- Choose a license: ソースコードの利用許諾に関するライセンスを選びます。個人で使う分には、今は設定しなくても問題ありません。
ステップ3: リポジトリの作成
すべての入力が終わったら、「Create repository」ボタンをクリックします。これで、GitHub上にあなたの新しいリモートリポジトリが作成されました!
[画像:作成されたばかりの空のリポジトリのメインページ]
ローカルPCでプロジェクトを準備し、GitHubに接続する
次に、あなたのPC(ローカル)にプロジェクトを用意し、先ほど作成したリモートリポジトリに初めてのファイルをアップロードしてみましょう。
ステップ1: ローカルにプロジェクトフォルダを作成
まず、PCの好きな場所に作業用のフォルダを作成します。ここではターミナル(WindowsならGit Bash)を使って操作します。
mkdir my-first-repo
作成したフォルダに移動します。
cd my-first-repo
ステップ2: Gitリポジトリを初期化
このフォルダをGitの管理下に置くため、初期化コマンドを実行します。これにより、フォルダ内に`.git`という隠しフォルダが作成されます。
git init
ステップ3: アップロードするファイルを作成
テスト用に簡単なHTMLファイルを作成しましょう。
echo "Hello, GitHub!" > index.html
ステップ4: ファイルをコミット(セーブ)する
作成したファイルをGitに記録します。まず、`git add`でセーブ対象のファイルとして選択(ステージング)します。
git add index.html
次に、`git commit`でセーブポイントを作成します。
git commit -m "最初のHTMLファイルを追加"
ステップ5: リモートリポジトリと接続する
ローカルのリポジトリと、先ほどGitHub上に作成したリモートリポジトリを紐付けます。GitHubのリポジトリページに行き、「Code」ボタンからSSHのURLをコピーしてください。
[画像:GitHubの「Code」ボタンをクリックし、SSHのURLをコピーしている様子]
git remote add origin git@github.com:あなたのユーザー名/my-first-repo.git
ステップ6: GitHubにプッシュ(アップロード)する
いよいよ最終段階です。ローカルで作成したコミットを、リモートリポジトリにアップロードします。これを「プッシュ」と呼びます。
pushする前に、git statusとgit remote -vで状態を確認しておくと安心です。
また、現在のブランチ名がmainではなくmasterの場合は、コマンドのmain部分を自分のブランチ名に合わせます。
git status
git branch
git remote -v
git push -u origin main
確認:GitHub上でファイルが反映されているか見てみよう
プッシュが完了したら、ブラウザでGitHubのリポジトリページを再読み込みしてみてください。先ほど作成した`index.html`が表示されているはずです!ファイル名をクリックすれば、中身も確認できます。
[画像:GitHubリポジトリページにindex.htmlが追加され、ファイル一覧に表示されている様子]
おめでとうございます!これで、あなたはローカルのファイルをGitHubにアップロードするという、最も基本的で重要なワークフローをマスターしました。
初回pushできない時の確認順
エラーが出た時は、同じコマンドを何度も打つ前に、どこで止まっているかを分けます。特に初回pushでは、remote URL、ブランチ名、GitHub側のREADME、認証の4つを確認します。
| 見えている状態 | 先に確認すること | 次に見るページ |
|---|---|---|
origin がない、URLが違う |
git remote -v でGitHubの正しいURLが入っているか見る |
GitのインストールとGitHub接続 |
main でpushできない |
git branch で現在のブランチ名が main か master か見る |
Gitブランチの基本 |
| READMEありのGitHubリポジトリへpushできない | GitHub側に先にコミットがあるため、cloneから始めるか、履歴を取り込む必要がある | GitHubからcloneする方法 |
| 秘密情報をpushしそうで不安 | git status と .gitignore で、DB設定、APIキー、バックアップを除外する |
.gitignoreの使い方 |
最初のpushで秘密情報を入れないために
初回pushは、うっかり不要なファイルまで入れやすいタイミングです。Webサイト運営では、DB接続情報、FTP情報、APIキー、バックアップフォルダを先に除外します。
includes/db_config.local.php
.env
backup/
node_modules/
公開サーバーへ置くファイルと、GitHubへ置くファイルは同じではありません。本物のパスワードはサーバー側だけに置きます。
AIやCodexに相談する時のメモ
pushできない原因をAIに相談する時は、エラー全文、直前に打ったコマンド、git status、git branch、git remote -v の結果を貼ると整理しやすくなります。ただし、アクセストークン、秘密鍵、非公開リポジトリURLを貼る必要がある場合は伏せてください。
GitHubへの初回pushで止まっています。
やりたいこと:
作業環境:
直前に打ったコマンド:
表示されたエラー:
確認済み:
- git status:
- git branch:
- git remote -v:
- GitHub側でREADMEを作ったか:
- GitHub上にファイルが表示されているか:
秘密情報、アクセストークン、秘密鍵は貼っていません。
次に読むとつながるGit記事
- GitHubへpushする基本手順:2回目以降の更新反映を確認する
- git addとgit commitの使い方:履歴を分かりやすく残す
- .gitignoreの使い方:秘密情報や不要ファイルをGitHubに上げない
- GitHubからcloneする方法:READMEありの既存リポジトリから始める
- VS CodeでCodex作業前に確認すること:変更差分と秘密情報をエディタ上で確認する
GitHubへ上げた後に公開作業へ進む時
GitHubへのpushは、公開サーバーへアップロードしたこととは別です。Webサイトとして反映する時は、公開フォルダ、FTP/SFTP、差分、秘密情報、公開後の表示確認を分けてください。