Permission denied (publickey) とは、SSH の公開鍵の認証で、GitHub などのサーバーが差し出された鍵を受け入れず、接続を断った時に出るエラーです。
- エラーが出た時に、撃ち直し・
ssh -T -l git github.com・ssh -vT・鍵の登録の順に何を確かめるか IdentitiesOnly yesとGIT_SSH_COMMANDで、ssh が差し出す鍵を絞る書き方(OpenSSH と Git の公式の文書の範囲で)- 当社の AI の席が、登録済みの鍵で断続的に拒まれた記録と、HTTPS と gh の資格に逃がして確かめ直した手順(社の実測 2026-09-24・2026-11-04)
当社は開発の仕事の多くを AIエージェントの席に任せていて、席は 1 日に何度も GitHub へ fetch と push を撃ちます(社の実測 2026-11-04)。この頁は、その途中で Permission denied (publickey) が出た時に、何を見て、何をしなかったかの記録です。鍵は壊れていないのに拒まれる、という形を何度も踏みました。
エラーの意味:「鍵が無い」とは限らない
GitHub の文書は、Permission denied をサーバーが接続を却下したことを示すエラーとし、原因はいくつか考えられるとしています。挙げられている確かめ所は、sudo で git を撃っていないか(通常のユーザーで作った鍵が使われなくなる)、正しいサーバーにポート 22 で繋いでいるか、接続のユーザーが「git」か、使う鍵を持っているか、公開鍵がアカウントに登録されているか、です(GitHub Docs「Error: Permission denied (publickey)」2026-11-16 に確認)。
この並びを読むと「鍵が無いか、登録されていない」と読みたくなります。ただ当社では、鍵も登録もそろっているのに、同じ式が通ったり拒まれたりする形が続きました。1 回の Permission denied だけで「鍵が死んだ」と決めず、まず同じ式をもう一度撃つ、を最初の手にしています(社の実測 2026-09-24)。
確かめる順:撃ち直し、ssh -T、ssh -vT、鍵の登録
当社が席に撃たせている順です。上で答えが出たら、下へは進みません。
| 順 | 撃つ式・見る所 | 分かる事 |
|---|---|---|
1 | 落ちた git の式を、そのままもう一度撃つ | 通れば、鍵の欠けではなく断続的な拒否。当社では 5 回中 4 回通った(社の実測 2026-09-24) |
2 | ssh -T -l git github.com | 「Hi <ユーザー名>! You've successfully authenticated…」が出れば認証は通る。名前が自分か確かめる。終了コード 1 は想定どおり(GitHub Docs「SSH 接続をテストする」) |
3 | gh auth status などで、HTTPS の側の資格と同じユーザーか | 同じユーザーが返れば、権限が外れたのではない(社の実測 2026-09-24) |
4 | ssh-add -l | agent が何本の鍵を出すか。多ければ IdentitiesOnly で絞る候補。0 本や「Could not open a connection」でも通る機体はある(社の実測 2026-09-24・2026-11-04) |
5 | ssh -vT -l git github.com(鍵を名指しするなら -i) | どの鍵のファイルが見つかり( type -1 は見つからない)、どれを差し出したか(GitHub Docs「Error: Permission denied (publickey)」) |
6 | GitHub の Settings の SSH and GPG keys と、手元の鍵の指紋を見比べる | 公開鍵が登録されているか。見覚えのない鍵があればすぐ消す(GitHub Docs「Error: Permission denied (publickey)」) |
出典: GitHub Docs「Error: Permission denied (publickey)」「SSH 接続をテストする」(いずれも 2026-11-16 に確認)・社の実測 2026-09-24・2026-11-04。
順 2 の ssh -T は、GitHub がシェルを出さないので、認証に通っても終了コード 1 で終わります(GitHub Docs「SSH 接続をテストする」2026-11-16 に確認)。台本で rc を見て成否を決めると、通ったのに「失敗」と読みます。当社は出力に「Hi」と自分のユーザー名が在るかで読んでいます。この頁の -l git は、接続するユーザーを git にする指定で、GitHub の文書がユーザー名とホストを「@」でつないで書く形と同じ接続になります(OpenBSD ssh(1) の -l login_name・2026-11-16 に確認)。
IdentitiesOnly yes:agent が出す鍵を、書いた鍵だけに絞る
OpenSSH の ssh_config の文書では、IdentitiesOnly は、ssh-agent などがもっと多くの鍵を差し出せる場合でも、設定した鍵のファイル(既定のファイル、ssh_config に書いた物、コマンドで渡した物)だけを使わせる指定で、値は yes か no(既定は no)です。ssh-agent が多くの鍵を差し出す場面のための指定とされています(OpenBSD ssh_config(5)・2026-11-16 に確認)。
この頁では、ホームの下の .ssh を ${HOME}/.ssh と書きます。シェルでも、ssh_config の IdentityFile でも、環境変数として展開されます(OpenBSD ssh_config(5)・2026-11-16 に確認)。
同じ文書は IdentityFile について、既定を ${HOME}/.ssh/id_rsa・${HOME}/.ssh/id_ecdsa・${HOME}/.ssh/id_ed25519 などとし、IdentitiesOnly を付けない限り agent が持つ鍵も認証に使う、複数書けば順に試す、としています(同上)。agent に鍵が何本も入っていると、ssh はそれを順に差し出し、目当ての鍵の前にサーバー側に断られる事があります。
Host github.com
IdentityFile ${HOME}/.ssh/id_ed25519
IdentitiesOnly yes
当社の席が 2026-09-24 に踏んだ形では、IdentitiesOnly を付けた式が 3 回とも通りました。付けない同じ式は 5 回中 4 回通り、1 回落ちています(社の実測 2026-09-24)。
| 撃った式 | 結果 | 同じ時に見た事 |
|---|---|---|
git fetch(何も足さない) | 5 回中 通った 4・落ちた 1 | 落ちた 1 回が Permission denied (publickey) |
IdentitiesOnly を付けた式 | 3 回中 3 回通った | ― |
ssh -T -l git github.com | Hi <ユーザー名>! で通った | gh でも同じユーザーが返った |
ssh-add -l | 「Could not open a connection」(agent は動いていない) | それでも fetch は通るので、agent は原因ではなかった |
出典: 社の実測 2026-09-24。
この機体の ${HOME}/.ssh/config の Host github.com には、ServerAliveInterval 30 と ServerAliveCountMax 1000 だけが書かれていて、鍵の指定はありませんでした(社の実測 2026-09-24)。ServerAliveInterval は無通信で切られるのを防ぐ指定で、鍵の選び方には効きません。長い pre-push の間に接続が切れた話は git hooks の頁にまとめています。
GIT_SSH_COMMAND:その場の 1 回だけ、鍵を名指しする
Git の文書では、GIT_SSH か GIT_SSH_COMMAND を設定すると、git fetch と git push は remote に繋ぐ時に ssh の代わりにその命令を使います。GIT_SSH_COMMAND は GIT_SSH より優先され、シェルが解釈するので引数を足せます(Git「git」の Environment Variables・2026-11-16 に確認)。同じ文書は、普段の指定は個人の .ssh/config に書く方が楽だ、とも書いています。
当社は、${HOME}/.ssh/config を書き換える前に、その場で当たりを確かめる道具として使っています。
GIT_SSH_COMMAND='ssh -o IdentitiesOnly=yes -i ${HOME}/.ssh/id_ed25519' git fetch origin main
2026-09-24、別の席では、自動で保存する道具の中の git fetch -q origin main が rc=128 で落ちました。同じ作業木で上の式を撃つと rc=0 で通りました。鍵が無いのではなく、agent が複数の鍵を差し出して GitHub に弾かれていた形です。その席は GIT_SSH_COMMAND を export してから撃ち直して通しています(社の実測 2026-09-24)。
export は、そのシェルから撃つ git 全部に効きます。道具の中で撃たれる git にも効く一方、席を閉じれば消えるので、続けて要るなら ${HOME}/.ssh/config に書く方へ移します。
当社の記録:登録済みの鍵が、1 日に何度も断続的に拒まれた
2026-11-04 は、上の 2 つの手では片づかない形でした。
| 時間帯 | 機体 | 起きた事 | 確かめた事 |
|---|---|---|---|
18:3x〜18:4x | AI の席を動かす主の機体 | id_ed25519 が断続的に拒まれ、4 回中 1 回だけ通る | GitHub の公開鍵の一覧( /users/<ユーザー>/keys)で登録済み。ssh -vvv で 1 回は「Server accepts key」、他は「type 51」(認証の失敗)で拒否。HTTPS と gh の資格は通った。GitHub の status は Operational |
18 時台〜20 時台 | 主の機体と 2 台目の機体(複数の席) | 同じ型が 1 日で 4 件以上 | どれも ssh-agent の鍵は 0 本。 ${HOME}/.ssh/id_ed25519 を名指ししても拒まれる回があった。同じ機体の他の席は同じ時間帯に push できていた |
18:4x〜19:0x | 2 台目の機体 | 3 回の見回りで続けて、git fetch が初回だけ拒まれた | 5 秒後の撃ち直しで 3 回とも通った |
出典: 社の実測 2026-11-04。
この日は agent の鍵が 0 本で、鍵を名指ししても拒まれる回があったので、「agent が別の鍵を先に出している」という 09-24 の読みは当てはまりません。同じ機体でも席によって通る・通らないが分かれたので、鍵か経路が席の起動のしかたで違うのではないか、と疑っています。ただしこれは測っていません(社の実測 2026-11-04)。
2 台目の機体では、当座の手として、git fetch を「最大 3 回・5 秒おき」に撃ち直す式に替えました(社の実測 2026-11-04)。この日も、鍵を作り直す・回すことは解にしていません。登録済みの鍵が 4 回に 1 回は「Server accepts key」になる以上、鍵そのものは正しいからです。
迂回の手の比べ方:撃ち直し・鍵の絞り込み・HTTPS
当社が使った手と、使わなかった手を並べます。
| 手 | 効いた形 | 効かなかった形・注意 |
|---|---|---|
同じ式を撃ち直す(最大 3 回・5 秒おき) | 初回だけ拒まれる形。3 回とも 2 回目で通った(社の実測 2026-11-04) | 4 回に 1 回しか通らない日は、回数で押し切る手にならない |
${HOME}/.ssh/config に IdentitiesOnly yes | agent が複数の鍵を出す形(社の実測 2026-09-24) | agent の鍵が 0 本で、名指ししても拒まれた日(社の実測 2026-11-04) |
GIT_SSH_COMMAND で鍵を名指し | 道具の中の fetch が rc=128 で落ちた形。rc=0 で通った(社の実測 2026-09-24) | export したシェルの中でしか効かない |
HTTPS の URL と gh の資格 | SSH が断続的に拒まれた日でも通った(社の実測 2026-11-04) | gh にログインしている事が前提。remote を替えるかは別に決める |
鍵を作り直す・回す | 使っていない | 鍵が正しい事は ssh -T と「Server accepts key」で分かっていた。作り直すと登録の手間だけが増える |
出典: 社の実測 2026-09-24・2026-11-04。
HTTPS に逃がす時は、remote の設定を替えずに 1 回ずつ
2026-11-04、席の push と fetch を、HTTPS の URL(https://github.com/<owner>/<repo>.git)と gh の資格に替えて通しました。remote の設定そのものは変えず、撃つ時に URL と資格の手引きを渡しています(社の実測 2026-11-04)。
git -c credential.helper='!gh auth git-credential' \
fetch https://github.com/<owner>/<repo>.git main
GitHub CLI の文書では、gh auth setup-git は git が GitHub CLI を資格の手引き(credential helper)として使うように設定する命令で、--hostname で 1 つのホストに絞れます(GitHub CLI manual「gh auth setup-git」2026-11-16 に確認)。当社は機体の git の設定を書き換えず、上のように -c でその 1 回だけ渡す形を選びました。gh のほかの使い方は GitHub CLI の頁にまとめています。
通した後は、git ls-remote で、手元の先頭と GitHub の先頭が一致する事を確かめています(社の実測 2026-11-04)。SSH の不調が続くなら、機体の remote を HTTPS にそろえるかを別に決める、という扱いにしました。
自動で保存する道具の「差分なし」を、push できた証拠にしない
2026-11-04 には、自動で保存する道具が push に失敗しているのに「差分なし」と出し、push できていない事に気づきにくい形もありました(社の実測 2026-11-04)。Permission denied は道具の中で起きると、表の出力に出ない事があります。
当社は HTTPS で fetch、rebase、push の順に撃ち直し、その後に手元と GitHub の先頭の一致で確かめ直しました(社の実測 2026-11-04)。道具の「成功」や「差分なし」ではなく、git ls-remote の答えを着地の証拠にしています。
よくある質問
Permission denied (publickey) が出たら、まず何をすればいいですか?
同じ式をもう一度撃ちます。当社では同じ fetch が 5 回中 4 回通り、鍵の欠けではない形でした(社の実測 2026-09-24)。続けて落ちるなら ssh -T -l git github.com で「Hi」と自分のユーザー名が出るかを見て、出なければ GitHub の文書の順に鍵と登録を確かめます。
ssh -T -l git github.com は通るのに、git fetch が Permission denied になるのはなぜですか?
ssh が差し出す鍵の順や、git を撃った環境が違う可能性があります。当社では、agent が複数の鍵を出して弾かれていた形を、GIT_SSH_COMMAND='ssh -o IdentitiesOnly=yes -i ${HOME}/.ssh/id_ed25519' で通しました(社の実測 2026-09-24)。
IdentitiesOnly yes は何をする設定ですか?
ssh-agent などがほかの鍵を差し出せる場合でも、設定した鍵のファイルだけを使わせる指定です。既定は no で、agent が多くの鍵を出す場面のための指定とされています(OpenBSD ssh_config(5)・2026-11-16 に確認)。
GIT_SSH_COMMAND と ${HOME}/.ssh/config はどちらに書けばいいですか?
Git の文書は、普段の指定は個人の .ssh/config に書く方が楽だとしています(2026-11-16 に確認)。当社は、その場で当たりを確かめる時に GIT_SSH_COMMAND を使い、続けて要ると分かってから config に移しています。
Permission denied (publickey) が出たら、鍵を作り直すべきですか?
鍵が登録済みで、ssh -T や ssh -vvv の「Server accepts key」で一度でも通っているなら、鍵そのものは正しいと読めます。当社は断続的に拒まれた日も鍵を作り直さず、撃ち直しと HTTPS への迂回で通しました(社の実測 2026-11-04)。
出典
- GitHub Docs「Error: Permission denied (publickey)」https://docs.github.com/ja/authentication/troubleshooting-ssh/error-permission-denied-publickey (2026-11-16 に確認)
- GitHub Docs「SSH 接続をテストする」https://docs.github.com/ja/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection (2026-11-16 に確認)
- OpenBSD manual ssh_config(5)(IdentitiesOnly・IdentityFile)https://man.openbsd.org/ssh_config (2026-11-16 に確認)
- OpenBSD manual ssh(1)(-l login_name・-T・-v)https://man.openbsd.org/ssh.1 (2026-11-16 に確認)
- Git「git」Environment Variables(GIT_SSH・GIT_SSH_COMMAND)https://git-scm.com/docs/git (2026-11-16 に確認)
- GitHub CLI manual「gh auth setup-git」https://cli.github.com/manual/gh_auth_setup-git (2026-11-16 に確認)
- 社の実測 2026-09-24・2026-11-04(当社の AI の席が GitHub への fetch と push で踏んだ記録)