MacでGitHubとSSH連携を設定する手順

目次

1. SSH鍵の作成
2. GitHubに公開鍵を登録する方法
3. ~/.ssh/config への設定
4. ~/.ssh/config を使った接続確認
5. ~/.ssh/configの設定あり・なしでのコマンド比較
6. Gitのユーザー名とメールをグローバル設定する方法
7. SSH接続の接続確認

環境

• Mac
• GitHub

SSH鍵の作成

Macで「SSH鍵のペア（公開鍵と秘密鍵）」を作成します。

ssh-keygen -t ed25519 -C "[e-mail]" -f ~/.ssh/id_ed25519_github_[アカウント名]

オプション	説明
-t ed25519	軽量でセキュアな鍵方式
-C	コメント
-f ~/.ssh/...	鍵ファイルの保存先と名前

生成されるファイル	説明
~/.ssh/id_ed25519_github_[アカウント名]	秘密鍵
~/.ssh/id_ed25519_github_[アカウント名].pub	公開鍵、GitHubに登録する鍵

GitHubに公開鍵を登録

作成した公開鍵をGitHubに登録します。

1. 公開鍵の内容をコピーします。

cat ~/.ssh/id_ed25519_github_[アカウント名].pub

2. GitHubの設定画面へ

1. GitHubにログイン
2. 右上のアイコン → Settings
3. 左メニューから SSH and GPG keys
4. New SSH key をクリック
5. 以下を入力：
   • Title：例）"MacBook SSH Key"
   • Key：先ほどコピーした公開鍵を貼り付け
6. Add SSH key をクリック

これで登録完了です！

~/.ssh/config への設定

SSH接続時に毎回秘密鍵ファイルを指定するのは手間です。
~/.ssh/config に設定を記述することで、簡略なホスト名（エイリアス）で接続できるようになります。
これにより、複数のSSH鍵を使い分けたり、接続コマンドを短くすることができます。

configファイル開きます。

nano ~/.ssh/config

configに記述します。

Host github-[アカウント名]
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_github_[アカウント名]

項目	説明
Host	ニックネーム（自由に付けられる）
HostName	実際に接続するホスト名（GitHubは github.com）
User	GitHubのSSH接続時は git 固定
IdentityFile	使用する秘密鍵ファイルのパス

Gitのユーザー名とメールをグローバル設定

git config --global user.name "Your Name"
git config --global user.email "[e-mail]"

オプション	設定される場所	影響する範囲
--global	~/.gitconfig	あなたのユーザー全体（全リポジトリ）
--local（省略時）	.git/config（各リポジトリ）	今いるリポジトリだけ

~/.ssh/config を使用した接続確認

ssh -T git@github-[アカウント名]

~/.ssh/configの設定の有無でのコマンド比較

状態	接続コマンド例
configなし	ssh -i ~/.ssh/id_ed25519_github_meat [e-mail]
configあり	ssh git@github-meat