発生した問題

GitHub で複数アカウントを使い分けている際、git push -u origin main コマンドを実行したところ、以下のような認証エラーが発生しました。

Permission to ○○○/repository.git denied to △△△

これは、意図したアカウント（○○○）ではなく、別のアカウント（△△△）で認証が試行されたことを示しています。

根本原因

SSH 設定ファイル（~/.ssh/config）では正しく複数アカウントの設定を行っていましたが、SSH エージェントに意図したアカウントの鍵が登録されていなかったため、デフォルトの鍵または別アカウント用の鍵が使用されていました。

問題の診断方法

SSH 接続テスト
```
$ ssh -T github-account-a

Hi △△△! You've successfully authenticated, but GitHub does not provide shell access.
```
→ 期待していたアカウント（○○○）ではなく、別のアカウント（△△△）として認証されていることが判明

SSH 設定の確認

$ cat ~/.ssh/config
Host github-account-a
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_github_account_a
  IdentitiesOnly yes

→ 設定自体は正しく行われていました

SSH エージェントの状態確認
```
$ ssh-add -l
```
アカウントAの鍵が表示されていない

解決手順

SSH エージェントに正しい鍵を追加

$ ssh-add ~/.ssh/id_ed25519_github_account_a

Identity added: ~/.ssh/id_ed25519_github_account_a

認証状態の再確認

$ ssh -T github-account-a

Hi ○○○! You've successfully authenticated, but GitHub does not provide shell access.

→ 正しいアカウント（○○○）での認証が確認できました

Git コマンドの再実行

$ git push -u origin main
# 正常にプッシュ成功

恒久的な対策

1. 自動鍵登録の設定

シェルの起動スクリプト（.bashrc、.zshrc など）に以下を追加：

# GitHub アカウント用の SSH 鍵を自動追加
# -q: 静かに実行、2>/dev/null: エラーメッセージを非表示
ssh-add -q ~/.ssh/id_ed25519_github_account_a 2>/dev/null
ssh-add -q ~/.ssh/id_rsa_github_account_b 2>/dev/null

2. SSH 設定の最適化

~/.ssh/config ファイルに以下の設定を追加：

Host *
  AddKeysToAgent yes
  UseKeychain yes  # macOSの場合のみ

3. 作業前の認証確認習慣化

重要な操作の前に認証状態を確認する習慣をつける：

$ ssh -T github-account-a  # アカウントAの認証確認
$ ssh -T github-account-b  # アカウントBの認証確認

トラブルシューティングのポイント

SSH エージェントの状態は一時的: システム再起動やログアウトでリセットされることがあります
複数アカウント使用時の注意点: 意図したアカウントで認証されているか常に確認が必要です
エラーメッセージの読み方: Permission denied to [username] の部分で、どのアカウントとして認証されようとしているかがわかります

まとめ

Git と SSH を使った複数アカウント管理では、SSH 設定だけでなく SSH エージェントの状態も重要です。認証エラーが発生した場合は、まず ssh -T コマンドで現在の認証状態を確認し、必要に応じて ssh-add で適切な鍵をエージェントに追加しましょう。