30초 요약
- 셸을 열 때마다 passphrase를 다시 묻는 것은 새 셸이 기존 ssh-agent를 찾지 못해서다. 소켓 경로를 고정해 agent 하나를 재사용하면 해결된다.
~/.bashrc에는SSH_AUTH_SOCK을$HOME/.ssh/agent.sock으로 고정하고,ssh-add -l이 종료 코드 2로 실패할 때만ssh-agent -a로 띄우는 몇 줄을 넣는다.~/.ssh/config에AddKeysToAgent yes를 두면 키를 처음 쓸 때 agent에 올라간다.
증상/목표
터미널을 새로 열고 git push나 ssh를 하면 키 passphrase를 또 물어본다. 지난 터미널에서 이미 입력했는데도 그렇다. 이 글의 목표는 로그인 뒤 처음 한 번만 입력하고, 이후 새 셸에서는 묻지 않게 만드는 것이다.
Linux와 WSL처럼 bash를 쓰는 환경을 기준으로 쓴다. 설정할 파일은 ~/.bashrc와 ~/.ssh/config 둘이다.
원인
ssh-agent는 시작할 때 Unix 도메인 소켓을 만들고 그 경로를 SSH_AUTH_SOCK 환경변수에 저장한다. ssh와 ssh-add는 이 변수로 agent를 찾는다.
환경변수는 셸마다 따로 갖는다. 새 셸에 SSH_AUTH_SOCK이 없으면 agent가 떠 있어도 찾지 못한다. 반대로 .bashrc에 eval "$(ssh-agent -s)"만 넣으면 셸을 열 때마다 agent가 새로 뜬다. 어느 쪽이든 키는 매번 처음부터 등록해야 한다.
러너에서 SSH_AUTH_SOCK 없이 ssh-add -l을 실행하면 아래 오류가 난다. 아래 해결 방법의 수정 전 상태다.
Could not open a connection to your authentication agent.해결 방법
1. ssh config에 AddKeysToAgent를 켠다
~/.ssh/config에 다음을 넣는다. 가장 간단한 방법이고, GitHub 문서도 같은 옵션을 안내한다.
Host github.com AddKeysToAgent yes IdentityFile ~/.ssh/id_ed25519AddKeysToAgent의 허용 값은 no(기본값), yes, confirm, ask, 그리고 시간 간격이다. yes면 파일에서 불러온 키와 passphrase가 기본 수명으로 agent에 추가된다.
모든 호스트에 적용하려면 Host *를 쓴다. 이 옵션은 agent가 떠 있어야 효과가 있으므로 다음 단계가 필요하다.
2. ~/.bashrc에서 agent를 하나만 띄운다
~/.bashrc 끝에 다음을 추가한다.
export SSH_AUTH_SOCK="$HOME/.ssh/agent.sock"ssh-add -l >/dev/null 2>&1if [ $? -eq 2 ]; then rm -f "$SSH_AUTH_SOCK" eval "$(ssh-agent -a "$SSH_AUTH_SOCK" -s)" >/dev/nullfissh-agent -a는 agent를 지정한 소켓 경로에 묶는다. 경로를 주지 않으면 임의 이름의 소켓이 만들어져 다른 셸이 찾을 수 없다. 최근 OpenSSH는 $HOME/.ssh/agent 아래에, 이전 버전은 /tmp 아래에 만든다(OpenSSH 10.1부터 /tmp에서 ~/.ssh/agent 아래로 옮겼다는 릴리스 노트가 있다). -s는 Bourne 셸용 환경변수 설정 명령을 출력하고, eval이 그것을 현재 셸에 적용한다.
ssh-add -l이 종료 코드 2를 돌려주면 agent에 연결하지 못했다는 뜻이다. 이때만 오래된 소켓 파일을 지우고 새로 띄운다. 키가 없는 agent는 종료 코드 1이므로 건드리지 않는다.
3. 키를 한 번 등록한다
새 셸을 열어 .bashrc를 읽게 한 다음, AddKeysToAgent yes를 켠 호스트에 한 번 접속하면 passphrase를 묻고 키가 올라간다. 접속하기 전에 미리 올리려면 ssh-add ~/.ssh/id_ed25519를 실행한다. 키 파일 이름이 다르면 그 이름으로 바꾼다.
이후 새로 여는 셸은 같은 소켓을 읽으므로 passphrase를 묻지 않는다.
macOS는 설정이 다르다. GitHub 문서는 AddKeysToAgent yes와 함께 UseKeychain yes를 두어 passphrase를 키체인에 저장하라고 안내한다. Bad configuration option: usekeychain 오류가 나면 IgnoreUnknown UseKeychain을 추가한다.
확인
verify 스크립트는 러너의 홈을 건드리지 않도록 임시 HOME을 만들고 passphrase가 있는 ed25519 키를 새로 만든다. 새 셸은 bash -c로 프로세스를 새로 띄워 흉내 냈고, passphrase 입력은 SSH_ASKPASS_REQUIRE=force로 대신했다.
확인한 것은 다음이다.
SSH_AUTH_SOCK없이ssh-add -l을 실행하면 위 오류로 실패한다.- 스니펫을 읽은 첫 번째 셸에서 키를 등록하면 고정한 경로에 소켓이 생긴다.
- 두 번째와 세 번째 셸에서
ssh-add -l이 같은 키 지문을 보여 주고, ssh-agent 프로세스는 하나뿐이다. ssh -G가addkeystoagent true를 보여 준다.
검증 범위: 스니펫의 agent 재사용과 키 등록은 실행으로 확인했다. AddKeysToAgent가 첫 접속 때 키를 올리는 동작은 접속할 서버가 없어 실행하지 않았고, 설정이 읽히는 것까지만 확인했다. 나머지는 OpenSSH 매뉴얼과 GitHub 문서로 대조했다. macOS의 UseKeychain도 GitHub 문서 대조다.
검증 환경 3항목
| OS | Ubuntu 26.04.1 |
|---|---|
| bash | 5.3.9 |
| 실행 날짜 | 2026-11-06 |
[PASS] OpenSSH 클라이언트가 설치돼 있다 [PASS] passphrase가 있는 ed25519 키를 만들었다 [PASS] 키 지문을 읽었다
[XFAIL] SSH_AUTH_SOCK 없이 ssh-add -l — 예상된 실패 재현됨 (/Could not open a connection to your authentication agent/)
> Could not open a connection to your authentication agent.[PASS] 첫 번째 셸에서 키를 agent에 등록했다 [PASS] 고정한 경로에 agent 소켓이 만들어졌다 [PASS] 두 번째 셸에서 passphrase 없이 같은 키가 보인다 [PASS] 세 번째 셸에서도 같은 키가 보인다 [PASS] 셸을 세 번 열었는데 ssh-agent는 하나뿐이다 Pseudo-terminal will not be allocated because stdin is not a terminal. [PASS] ssh -G가 addkeystoagent true를 보여 준다
주의
- 소켓을
$HOME/.ssh/agent.sock처럼 고정하면 agent가 로그인 사이에도 남을 수 있다. 소켓은 현재 사용자만 접근하지만, 매뉴얼은 root나 같은 사용자의 다른 프로세스가 악용할 수 있다고 설명한다. 오래 두고 싶지 않으면AddKeysToAgent에 시간 간격을 준다. rm -f "$SSH_AUTH_SOCK"는ssh-add -l이 종료 코드 2를 낼 때만 실행한다. 조건을 빼면 다른 셸이 쓰는 살아 있는 소켓까지 지워 agent가 둘로 갈라진다.
자주 묻는 질문
agent를 끄려면 어떻게 하나?
agent를 띄운 셸에서 ssh-agent -k를 실행한다. 이 명령은 SSH_AGENT_PID 환경변수가 가리키는 agent를 종료하는데, 그 변수는 eval로 agent를 띄운 셸에만 설정된다. 다른 셸에서는 소켓 파일을 쓰는 프로세스를 직접 찾아야 한다.
일정 시간 뒤에 키를 agent에서 빼려면?
AddKeysToAgent 4h처럼 시간 간격을 값으로 준다. 매뉴얼에 따르면 그 시간이 지나면 키가 agent에서 자동으로 제거된다. 형식은 sshd_config(5)의 TIME FORMATS 절을 따른다.
키를 쓸 때마다 확인을 받고 싶다면?
AddKeysToAgent confirm을 쓴다. ssh-add -c를 지정한 것과 같아서 키를 사용할 때마다 확인을 요청한다.