こんにちは。現場の最前線でコードとインフラの狭間を走り抜けてきたエンジニアです。
GitHubを使い始めると、誰もが一度は遭遇する「Permission Denied (publickey)」。黒い画面に突き放されたようなエラーメッセージが出ると、心臓がキュッと鳴りますよね。でも安心してください。これはあなたが何か壊したわけではなく、「握手（認証）の作法が少しズレているだけ」なんです。
今日は、開発のスタート地点で躓かないための、GitHub認証トラブルシューティングの「極意」を伝授します。
—
1. GitHubは「信頼の交換」で動いている
GitHubは、あなたのPCとサーバーの間で「本当にあなた本人か？」を厳密にチェックします。その鍵となるのがSSH鍵（公開鍵と秘密鍵）です。
- 公開鍵（Public Key）: GitHub側に預ける「南京錠」。
- 秘密鍵（Private Key）: あなたのPCに隠し持つ「鍵」。
この二つがペアとして正しく認識されていないとき、GitHubは「誰だかわからないので通せません（Permission Denied）」と冷たく拒絶するのです。
—
2. 最初の「儀式」：SSH鍵のセットアップ
まだセットアップが終わっていない、あるいは不安な場合は、ここからやり直しましょう。ターミナル（またはコマンドプロンプト）を開いてください。
手順①：鍵の生成
-t ed25519 は現在推奨される最も強固で高速な暗号方式です
ssh-keygen -t ed25519 -C “your_email@example.com”
※すべてデフォルト（Enter連打）で進めてOKです。
手順②：GitHubに鍵を登録
生成された「公開鍵」の中身をコピーします。
macOS/Linuxの場合
cat ~/.ssh/id_ed25519.pub
表示された `ssh-ed25519 AAAA…` から始まる長い文字列をすべてコピーし、[GitHubの設定画面 (SSH and GPG keys)](https://github.com/settings/keys) に貼り付けてください。
—
3. 「Permission Denied」原因別トラブルシューティング
ここからは、エラーが発生した時に確認すべき「現場のチェックリスト」です。
ケースA：SSH鍵を読み込めていない（最も多い）
PC内に鍵はあるのに、SSHエージェントがそれを認識していないパターンです。
鍵がエージェントに追加されているか確認
ssh-add -l
もし何も出なければ、鍵を追加
ssh-add ~/.ssh/id_ed25519
ケースB：リモートURLのプロトコルが不適切
HTTPSでクローンしたリポジトリに対し、SSHで操作しようとしていませんか？
現在のURLを確認
git remote -v
HTTPS(https://github.com/…) となっていたらSSHに変更
git remote set-url origin git@github.com:ユーザー名/リポジトリ名.git
ケースC：複数のGitHubアカウントを使い分けている
仕事用と個人用で鍵を分けている場合、SSHの設定ファイルで「どの鍵を使うか」明示する必要があります。
~/.ssh/config ファイルを作成・編集
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519 # 使用する秘密鍵のパスを指定
—
4. 動作確認：疎通テスト（HelloWorld）
すべて設定したら、最後にGitHubと「握手」してみましょう。
ssh -T git@github.com
成功の証：
> `Hi [ユーザー名]! You’ve successfully authenticated, but GitHub does not provide shell access.`
このメッセージが出たら完璧です！「シェルアクセスは提供しないよ」とGitHubに言われますが、これは正常な動作。「認証は通った」という最高の合図です。
—
先輩エンジニアからのアドバイス
GitHubでの認証エラーは、一度解決してしまえば「二度と悩まない」種類の問題です。今は複雑に見えるかもしれませんが、これは「安全な開発環境を手に入れるための小さな投資」です。
もしエラーが出ても、焦らず `ssh -vT git@github.com` と打ち込んでみてください。`-v` オプションをつけると、GitHubとの通信ログが詳細に出力されます。どこで拒否されたのかが手に取るようにわかるはずです。
この「仕組みを理解してトラブルを紐解く力」こそが、将来的にどんなツールを使っても生き残れるエンジニアの素養です。さあ、エラーの壁を突破して、あなたのコードを世界へプッシュしましょう！応援しています。