第2章 GitHubリポジトリを作る — プロジェクトの家を建てる
必須 この段階を進めるなら、必ず読んでください。一言まとめ: リポジトリ(Repository)は、プロジェクトのファイルとすべての変更履歴を置く場所です。GitHubにリポジトリを作ると、自分のコンピューターの外にも安全なコピーと、共同作業の場ができます。 公開・非公開はあとで無料でウェブに公開できるかに関わるので、作るときから決めておきます。
この章は、2026年11月1日に確認したGitHub公式ドキュメントをもとに書きました。GitHubの画面は英語表記で書いています。ステップ3でGitを使って「変更履歴」を残したことがあれば、その履歴をインターネットに置いておく段階だと考えてください。
GitとGitHub、リポジトリ
Gitは、ファイルの変更を追跡するバージョン管理システムです。[1] ステップ3でClaudeに「記録して」とお願いしたコミットが、Gitの記録です。
GitHubは、そのGitのプロジェクトをインターネットに置き、計画や共同作業のツールを加えたサービスです。[1:1] そしてリポジトリは、プロジェクトのコードとファイルをGitHubに置く場所です。ファイルを保管し、変わるたびにコミットで記録し、一緒に作業する場にもなります。[2]
よく出てくる言葉を先に知っておきましょう。
| 言葉 | 意味 |
|---|---|
| ブランチ(branch) | 基本のバージョンに影響を与えず、別に作業する枝分かれ |
| マージ(merge) | 1つの枝の変更を、別の枝に合わせること |
| リモート(remote) | 自分のコンピューターではなく、GitHubにあるリポジトリ |
| クローン(clone) | リポジトリを履歴ごと自分のコンピューターにダウンロードすること |
出典: GitHub公式ドキュメント(一部のみ抜粋)[3]
理解度チェック
Git と GitHub の関係として正しいものはどれでしょうか?
公開と非公開
リポジトリを作るとき、最初に決めるのが公開範囲です。
| 範囲 | 見られる人 |
|---|---|
| 公開(Public) | インターネットの誰でも |
| 非公開(Private) | 自分と、自分が共有した人 |
出典: GitHub公式ドキュメント[4]
このガイドでは、Public(公開)を選びます。この選択が第7章の公開(デプロイ)につながるからです。無料アカウントでは、公開リポジトリでのみGitHub Pages(無料のウェブ公開)を使えます。[5] GitHubの入門チュートリアルも、同じ理由でPublicを選ぶことになっています。[6]
公開リポジトリには代償があります。コード全体が誰にでも見えるので、弱点や機密情報を狙う人が出てくる危険が高まります。[7] そのため、公開リポジトリには、個人情報・パスワード・実名が入ったメモを入れません。 第9章で詳しく扱います。
あとで非公開に変えたら?(クリックして開く)
あとで変更することもできますが、代償があります。無料アカウントで公開リポジトリを非公開に変えると、公開していたPagesサイトが自動で取り下げられます。[8]
理解度チェック
無料アカウントで、あとから GitHub Pages に公開するには、リポジトリをどのように作ればよいでしょうか?
README・.gitignore・ライセンス
新しいリポジトリを作るとき、3つのファイルを一緒に入れられます。[9]
- README: 訪れた人が最初に見る説明書です。[10] どんなプロジェクトなのか、なぜ役に立つのか、どう始めるのかを書きます。チュートリアルではAdd READMEを選びます。最初のファイルであり、プロジェクトを説明する場所にもなるからです。[11]
- .gitignore: コミットするとき、Gitが無視するファイルを書いておくリストです。[12] パスワードが入った設定ファイルのように、アップロードしてはいけないものをここに書きます。注意点があります。すでにコミットしたファイルは、リストに書くだけでは無視されません。[13] そのため、最初から書いておくほうがいいでしょう。
- ライセンス: ほかの人があなたのコードで何をしてよいかを知らせます。必ず選ぶ必要はありません。[14] 選ばないと基本の著作権法が適用され、ほかの人はあなたのコードを複製・配布・改変できません。[14:1] 練習用のリポジトリなら、選ばなくてもかまいません。
ライセンスを選びたいなら(クリックして開く)
選ぶのが難しければ、GitHubはchoosealicense.comを勧めています。GitHubも、この案内は法的なアドバイスではないと明らかにしています。[15]
すでにGitの履歴があるフォルダをアップロードするとき(クリックして開く)
このガイドのように、新しいリポジトリを初めて作るときは気にしなくて大丈夫です。
すでにGitの履歴があるリポジトリを持ち込むときは、この3つを選ばないでください。GitHubに新しくできたファイルと、自分のフォルダの履歴が食い違うことがあります。すると、Gitはどちらを残せばいいかわからずに止まります。これをマージの競合(merge conflict)といいます。[16]
理解度チェック
.gitignore の説明として正しいものはどれでしょうか?
自分のコンピューターとつなぐ
GitHubのリポジトリを自分のコンピューターに持ってくることを、クローン(clone)と呼びます。クローンしたコピーは、GitHubの元のリポジトリとつながったままなので、自分が記録したものをもう一度アップロードできます。[17]
持ってくる方法はいくつかあります。
| 方法 | こんなとき |
|---|---|
| GitHub Desktop | 公式の入門チュートリアルのように、グラフィカルな画面で |
| Claude Codeにお願いする | ステップ3のように、言葉で任せたいとき |
出典: このガイドのまとめ(GitHub Desktopは公式チュートリアルの方法)[17:1]
Claude Codeには、このようにお願いできます。リポジトリのアドレスは、GitHubでリポジトリを開いたときにブラウザのアドレスバーに表示されるアドレス(例: https://github.com/自分のID/cafe-todo-board)を使います。
このGitHubリポジトリを ~/hello-ai-practice/todo-board フォルダにクローンして: <リポジトリのアドレス>すでにあるフォルダをアップロードすることもできます。 ステップ3の整理ツールのように、自分のコンピューターにあったフォルダもGitHubにアップロードできます。Gitで管理していなかったフォルダなら、先にGitリポジトリにします。[18] ただしこのガイドでは、やることボードを新しいリポジトリとして作ります。整理ツールにはメモの原本が入っているので、公開リポジトリにそのままアップロードするのは避けたほうが安全です。
理解度チェック
リポジトリを自分のパソコンに複製(clone)すると、どうなるでしょうか?
自分でやってみよう
- github.comに登録するか、ログインする(無料アカウントで大丈夫)。
- 右上の + → New repository で新しいリポジトリを作る。名前は
cafe-todo-board、公開範囲は Public、Add README を選ぶ。.gitignoreも一緒に入れられるなら入れる(リストは画面の案内に従う)。 - リポジトリの画面でREADMEが見えるか確認する。
- GitHub DesktopかClaude Codeで、リポジトリを
~/hello-ai-practice/todo-boardにクローンする。あとで自分のコンピューターの記録をGitHubにアップロードすることを、プッシュ(push)という(第4章で扱う)。プッシュするには、そのツールが自分のGitHubアカウントにログインしている必要がある。初めてアップロードするときにログイン画面が出たら、案内に従う。 - クローンしたフォルダをClaude Codeのアプリで開き、フォルダの中にREADME.mdがあるか確認する。
続きの課題: 第3章では、このリポジトリに何を作るかをClaudeにインタビューしてもらい、SPEC.mdにまとめます。
まとめ
- Gitは変更履歴を残す仕組み、GitHubはその履歴をインターネットに置いて共同作業する場所、リポジトリはプロジェクトの家である。
- 無料アカウントでは、公開リポジトリでのみGitHub Pagesを使える。公開リポジトリには個人情報を入れない。
- READMEは説明書、.gitignoreはアップロードしないもののリスト、ライセンスは使用の許可である。.gitignoreは最初から書く。
- クローンしたコピーは、GitHubとつながったまま残る。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Git | ギット | ファイルの変更を追跡するバージョン管理システム |
| GitHub | ギットハブ | Gitリポジトリをインターネットに置いて共同作業するサービス |
| README | リードミー | リポジトリの最初の説明書 |
| .gitignore | ギットイグノア | Gitが無視するファイルのリスト |
| Clone | クローン | リポジトリを履歴ごと自分のコンピューターにダウンロードすること(複製) |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第3章 企画と仕様
参考資料(18件)
GitHub公式ドキュメント、「What is GitHub?」。"Git is a version control system that tracks changes to files." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Creating a repository for your project on GitHub」。"It stores your files, tracks each change as a commit, and gives collaborators a shared place to work." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「About repositories」。"Branch | A parallel version of your code that is contained within the repository, but does not affect the primary or main branch." / "Merge | To take the changes from one branch and apply them to another." / "Remote | A repository stored on GitHub, not on your computer." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「About repositories」。"Public repositories are accessible to everyone on the internet." / "Private repositories are only accessible to you, people you explicitly share access with, and, for organization repositories, certain organization members." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「What is GitHub Pages?」。"GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Creating a repository for your project on GitHub」。"Use the Choose visibility dropdown menu to select Public so you can publish your software project to a live site later in this series." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「About repositories」。"Public repositories expose your codebase to everyone, increasing the risk that attackers might exploit vulnerabilities or access sensitive information." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Setting repository visibility」。"Any published GitHub Pages site will be automatically unpublished." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Creating a new repository」。"If you're importing an existing repository to GitHub, don't choose any of these options, as you may introduce a merge conflict." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「About the repository README file」。"A README is often the first item a visitor will see when visiting your repository." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Creating a repository for your project on GitHub」。"Select Add README. This gives your repository a starting file and a place to describe your software project." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Ignoring files」。"You can create a
.gitignorefile in your repository's root directory to tell Git which files and directories to ignore when you make a commit." docs.github.com (確認日 2026-11-01) ↩︎GitHub公式ドキュメント、「Ignoring files」。"If you want to ignore a file that is already checked in, you must untrack the file before you add a rule to ignore it." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Licensing a repository」。"A software license tells others what they can and can't do with your source code, so it's important to make an informed decision." / "However, without a license, the default copyright laws apply, meaning that you retain all rights to your source code and no one may reproduce, distribute, or create derivative works from your work." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Licensing a repository」。"We hope it helps, but please keep in mind that we’re not lawyers and that we make mistakes like everyone else." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Creating a new repository」。"If you're importing an existing repository to GitHub, don't choose any of these options, as you may introduce a merge conflict." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Connecting to your code locally」。"Cloning creates a copy of your repository on your computer that stays connected to the version on GitHub." docs.github.com (確認日 2026-11-01) ↩︎
GitHub公式ドキュメント、「Adding locally hosted code to GitHub」。"If your locally-hosted code isn't tracked by any VCS, the first step is to initialize a Git repository." docs.github.com (確認日 2026-11-01) ↩︎