基本操作

GitHubリポジトリとは

GitHubリポジトリの役割、入れるファイル、public/private、README、サイト管理での使い方を整理します。

このサイトはGitHub公式サイトではありません。GitHubの基本的な使い方や、Codex・ChatGPT時代のコード管理を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではGitHub公式情報も確認してください。

このページでわかること

リポジトリは「ファイル＋変更履歴」の箱だということ
普通のフォルダやクラウドストレージとの違い
1プロジェクト1リポジトリの原則
作成時に決めること（名前・公開範囲・README）

最初に結論

リポジトリは、ファイルとその変更履歴をまとめて入れる「箱」です。普通のフォルダとの違いは、中身をいつ・誰が・どう変えたかの記録が自動で残り、過去のどの時点にも戻れることです。Google DriveやDropboxとの違いは、「最新版の同期」ではなく「変更の意図と経緯の記録」が主目的である点です。1つのプロジェクト（1つのサイト、1つのアプリ）につき1つのリポジトリを作るのが基本です。

初心者向け説明

リポジトリ作成時に決めるのは3つです。①名前：URLの一部になるため英数字で簡潔に。②公開範囲：迷ったらprivate。③README：そのリポジトリが何なのかを書くファイルで、最初は1行でも構いません。複数サイトを運営する場合は「1サイト1リポジトリ」に分けると、AIに作業を任せる時も対象を取り違えにくくなります。逆に、無関係なファイル（家計簿も写真も何もかも）を1つのリポジトリに入れるのは、履歴が混線するのでおすすめしません。

このページの位置づけ

このページは、githubguide.jp の中で「リポジトリ理解の親ページ」として使います。GitHubを初めて触る人は、まずリポジトリが何を管理する場所なのかを押さえてから、README、branch、commit、Pull Request、public / private、秘密情報の注意へ進むと全体像をつかみやすくなります。

細かい操作手順をすべてこのページだけで覚える必要はありません。ここではリポジトリの考え方を整理し、詳しい内容は関連ページへ進めるようにしています。

GitHubリポジトリで最初に確認すること

GitHubリポジトリは、コードやHTMLファイルを置く場所であると同時に、変更履歴や差分を確認するための基本単位です。AIやCodexを使ってWebページやコードを修正する場合でも、まずはどのリポジトリで作業するのか、公開範囲は public なのか private なのか、秘密情報が含まれていないか、Pull Requestで確認する流れがあるかを見ておくと安全です。

リポジトリは作業単位として確認する
public / private の違いと公開範囲を確認する
privateでも秘密情報を入れてよいわけではない
Secrets、token、APIキーを通常ファイルへ書かない
Pull Requestで変更ファイルと差分を見る
Codex作業後はGitHubで確認し、GPTへ戻して次を整理する

GitHubリポジトリを使う時の読み順

リポジトリ全体を理解してから、公開範囲、秘密情報、Pull Request、Codex作業後の確認へ進むと迷いにくくなります。

向いている使い方

サイト・アプリ・制作物の置き場所と履歴管理を一元化する
プロジェクトごとに独立した作業空間を作る
AIに作業対象を明確に指定できる単位を作る

注意が必要な使い方

1つのリポジトリに無関係なプロジェクトを混ぜない
リポジトリ名に個人情報や機密的な名称を使わない
「リポジトリに入れた＝バックアップ完了」ではない（pushまで必要）

CodexやChatGPTと組み合わせる場合

CodexやClaude Codeへの指示では「どのリポジトリの、どのファイルか」を明確にするのが基本です。リポジトリがプロジェクトごとに分かれていれば、この指定が一言で済み、AIの作業範囲の事故も減ります。

秘密情報・APIキー・パスワード・個人情報の注意

APIキー、パスワード、秘密鍵、FTP資格情報、DB情報、メール設定、個人情報は、HTML、README、ログ、レポート、GitHubの差分に出さない前提で扱います。

FAQ

GitHubのリポジトリとは何ですか？

コードやファイルを管理し、変更履歴を残しながら作業するための場所です。README、branch、commit、Pull Request、Issueなどと組み合わせて使います。

GitHubのリポジトリはファイル置き場と何が違いますか？

単にファイルを置くだけでなく、いつ何を変更したかをcommitで記録し、branchで作業を分け、Pull Requestで確認できます。履歴や差分を見ながら作業できる点が大きな違いです。

GitHubのリポジトリには何を入れればいいですか？

コード、README、ドキュメント、公開してよい設定例などを入れます。ただし、APIキー、パスワード、秘密鍵、.env、DB接続情報、個人情報などは入れないようにします。

public repository と private repository はどう違いますか？

public は誰でも見られる公開リポジトリ、private は見られる人を限定するリポジトリです。ただし、private でも秘密情報を直接入れてよいわけではありません。

CodexでGitHubリポジトリを使う時に注意することは？

対象リポジトリ、branch、変更ファイル、SecretsやAPIキーの有無を確認します。作業後はdiffやPull Requestを見て、意図しない変更がないか確認しましょう。

リポジトリ理解を深めるページ

このカテゴリの親ハブ

関連ページをまとめて確認する場合は、初心者ハブから読み進められます。

GitHubのリポジトリとは何を管理する場所か

GitHubのリポジトリは、コードやファイルを置くだけの場所ではなく、変更履歴を管理しながら作業を進めるための場所です。README、branch、commit、Pull Request、Issueなどと組み合わせることで、何を変更したか、誰が確認したか、どの状態を公開するかを整理しやすくなります。

一人でHTMLや小さなコードを管理する場合でも、チームで開発する場合でも、リポジトリは「今どの状態なのか」「どこを変えたのか」「公開してよい内容なのか」を確認するための土台になります。Webサイト制作やCodexを使ったコード修正でも、対象リポジトリを間違えないことが大切です。

単なるアップロード先やサーバー全体のバックアップ置き場として使うと、DB、ログ、圧縮バックアップ、秘密情報まで混ざる危険があります。初めてリポジトリを作る時は、何を公開してよいか、どの情報を履歴に残してよいかを先に確認しておくと安全です。

単なるファイル置き場ではない理由

リポジトリでは、commitで変更履歴を残し、branchで作業を分け、Pull Requestで変更内容を確認し、Issueでやることや問題を整理できます。ファイルを置くだけではなく、変更前後の差分を見たり、必要に応じて元に戻す判断をしたりできる点が重要です。

要素	役割
README	リポジトリの目的、使い方、注意点を書く場所
branch	mainとは別に作業を分けるための枝
commit	何を変更したかを残す履歴の記録
Pull Request	変更内容を確認して取り込むための仕組み
Issue	やること、問題、相談を整理する場所
.gitignore	GitHubに入れたくないファイルを除外するための設定
Secrets	APIキーなどをコードへ直接書かずに扱うための考え方

public と private の違い

GitHubのリポジトリは、公開範囲によって public と private を選びます。public は誰でも見られる公開リポジトリ、private は見られる人を限定するリポジトリです。ただし、private にすれば何を入れても安全という意味ではありません。共有メンバー、権限、外部連携、トークンの扱いによっては、意図しない共有や漏えいにつながる可能性があります。

初めてリポジトリを作る前に確認すること

リポジトリ名はサイトや作業内容に合っているか
public / privateのどちらで作るべきか決めたか
READMEに目的や注意点を書けるか
.gitignoreで不要ファイルや秘密情報を除外できているか
APIキー、パスワード、秘密鍵、.env、DB情報を含めていないか
個人情報や顧客情報を含めていないか
いきなり本番用ファイルを公開していないか
変更後に差分を確認できる状態か

リポジトリに入れるものと入れないもの

入れてよいものの例

コード
README
ドキュメント
公開してよい設定例
公開してよいHTML / CSS / JavaScript
ライセンス情報

入れない方がよいものの例

APIキー
パスワード
秘密鍵
.env
DB接続情報
顧客情報や個人情報
証明書の秘密鍵
本番だけで使う認証情報

特にpublic repositoryでは誰でも見られる前提で確認し、private repositoryでも共有メンバーや権限、外部連携の影響を考えて扱います。

GitHubリポジトリとCodexの関係

CodexやAIを使ってコード修正を進める場合でも、リポジトリの意味を理解しておくと安全です。どのリポジトリを対象にするか、どのbranchで作業するか、差分をどう確認するかを決めてから作業すると、意図しない変更を減らしやすくなります。mainへ直接反映する前に、diffやPull Requestで確認する流れを作ることも大切です。

Codex側の関連ページ

CodexでGitHub作業を進める場合は、公開前確認や差分確認を別ページで整理しておくと安心です。

Codex CLI・IDE・モバイル関連ページ

CodexをChatGPT、GitHub、Copilot、安全確認の文脈で見るための周辺ページです。作業前に、対象ファイル、差分、秘密情報、公開前確認を分けて確認します。

GitHubは GPT → Codex → GitHub → GPT の流れで使うと分かりやすいです

GitHubリポジトリは、AI作業の結果を置くだけの場所ではありません。GPTで作業を整理し、Codexで修正し、GitHubで差分や履歴を確認し、GPTで次の作業を決める流れの中心になります。

private repository・公開範囲・秘密情報の確認

GitHubでCodex作業やサイト管理を進める時は、private/public、見える人、Secrets、APIキー、GitHub Desktopでの差分確認をセットで見ます。private repositoryでも機密情報をそのまま保存してよいわけではありません。

GitHub private repositoryとは？private/publicと安全確認の親ハブ機密情報保存の注意APIキーや.envを入れない考え方 GitHub DesktopとCodex差分確認とcommit前チェック

最初に決める3つ

リポジトリを作る時、後から変えにくいものがあります。先に決めてください。

誰の所有にするか — 個人か組織か。移動はできますが手間がかかります
公開範囲 — 後から公開へ切り替えると履歴ごと出ます
名前 — 変更できますが、共有済みのURLが変わります

1番目が最も影響します。個人のアカウントで作ったものは、その人が離れると扱いに困ります。仕事で使うものは、最初から組織の下に作ってください。

1つにまとめるか、分けるか

複数の作業をどう分けるかで迷った時の目安です。

まとめる — 同じ人が触る、同じタイミングで変わる、切り離すと動かない
分ける — 見せる相手が違う、更新の周期が違う、独立して動く

「見せる相手が違う」が最も強い理由です。権限は基本的にリポジトリ単位なので、一部だけ見せたい場合は分けるしかありません。あとから分けるのは手間なので、最初に判断してください。

作った後に整えること

作って終わりにせず、次を用意しておくと後が楽になります。

説明ファイル — 何のためのものか、どう使うか。数行で構いません
無視するファイルの指定 — 上げてはいけないものを最初に除外する
権限を渡す時の決め事 — いつまで、誰が外すか

2番目を最初にやってください。認証情報や設定ファイルを一度上げてしまうと、後から消しても履歴に残ります。作った直後に除外設定を入れるのが、最も確実な予防になります。

名前の付け方

後から変えられますが、共有済みのURLが変わるので最初に決めておくほうが楽です。

何のためのものか分かる語を入れる — 「test」「new」は数か月後に判断できません
短くする — 打つ機会が多くなります
記号を増やさない — 区切りは1種類に統一する

用途が変わったら名前も変えてください。中身と名前がずれたまま使い続けると、他の人が探せなくなります。

Search Console反応対応

GitHubリポジトリでまず見ること

GitHubリポジトリは、コードやファイルをまとめて管理する場所です。Webサイト制作やCodex作業では、どのファイルを変えたか、どこが変更されたか、公開してよい内容かを確認するために使います。

見ること	何のため？	関連ページ
リポジトリ名	何の作業場所か分かるようにする	リポジトリ名の決め方
public/private	公開範囲を決める	private/publicの違い
branch	作業場所を分ける	branch
Pull Request	変更を入れる前に確認する	Pull Request
Secrets	秘密情報を本文に出さず管理する	Secretsの注意
GitHub Desktop	画面で差分を確認する	GitHub Desktop

リポジトリ系ページの読み順

リポジトリを初めて作る名前、README、公開範囲の基本リポジトリの作り方作成前に決めることリポジトリ設定公開範囲、権限、削除注意 private repository非公開でも機密情報は入れない公開範囲誰が見られるかを確認機密情報保存の注意APIキーや.envの扱い GitHub DesktopとCodex差分確認とcommit前チェック

private repository は安全そのものではなく、公開範囲を制限できる設定です。Codex作業では、リポジトリを作業対象と差分確認の場所として使い、秘密情報や想定外の変更が混ざっていないか人間が確認します。

Settings確認

リポジトリ設定を見る

リポジトリを作った後は、Settingsで公開範囲、権限、branch、Secrets、Pages、Danger Zoneを確認します。Codex作業前にも、作業するbranch、公開範囲、秘密情報の扱いを見ておくと安全です。

Settings全体まず設定画面の全体像を見る公開範囲public/privateを確認 Secrets設定実値を公開しない Danger Zone基本触らない危険操作 Codex作業前チェック作業前に見る設定

GitHub Desktopで差分を見る流れへ戻る

Codex作業後は、報告書だけで判断せず、GitHub DesktopのChangesとDiffを確認してからcommitやpushを判断します。

GitHub Desktop親ページへ戻るリポジトリ親ハブへ戻る

AIガイド群の全体入口

GitHub、PR、Secrets、private repositoryを安全に扱うには、Codex、Copilot、HALの安全注意も関係します。AIガイド群全体の役割は、総合入口で確認できます。

このサイトはAIガイド群の一部です。公式サイト群ではなく、用途別に整理した非公式ガイド群です。

AIガイド群の総合入口を見る

GitHub Copilot・AI credits・CLI作業の確認導線

GitHubリポジトリは、AI作業の入口になるほど公開範囲とSecrets確認が重要になります。

GitHub CopilotのAI credits確認料金やusageだけでなくrepo作業前の確認へつなげます。GitHub Copilot CLIを使う前にrepo、branch、Secrets、PR確認を分けて見ます。GitHub Copilot作業後のPR確認diff、Secrets、sitemap、merge前確認を整理します。agentic codingをGitHubで使う前にAIエージェント的な作業のGitHub注意です。