VSCode Remote-SSH无法调用本地ssh-agent，反复要求输入密码

问题概况 #

• 本地使用zsh作为默认shell，通过zsh的ssh-agent插件自动启动认证代理，~/.ssh/config已配置AddKeysToAgent yes
• 本地终端执行ssh user@remote输入密码后，ssh-agent可正常运行，后续ssh连接无需重复输入密码
• 使用VSCode Remote-SSH连接服务器时，会弹出两次密码提示框，调试日志显示VSCode无法找到认证代理
• 关键差异：关闭所有VSCode实例后，**命令行启动code**可正常调用ssh-agent，无密码提示；通过KDE KRunner启动VSCode则问题复现

核心原因推测 #

KRunner启动程序时不会继承终端会话的环境变量（尤其是SSH_AUTH_SOCK——ssh-agent的核心标识变量），而zsh插件启动的ssh-agent仅在终端会话中生效，导致KRunner启动的VSCode无法获取代理信息。

下一步排查与解决建议 #

1. 验证环境变量差异 #

• 打开终端，执行echo $SSH_AUTH_SOCK，记录输出的socket路径
• 通过KRunner启动VSCode，在VSCode内置终端中执行echo $SSH_AUTH_SOCK
• 对比两者输出：若KRunner启动的VSCode中该变量为空或路径不一致，即可确认环境变量未继承的问题

2. 让KRunner启动的程序继承ssh-agent环境变量 #

方法一：配置Plasma会话全局环境变量

• 创建/编辑~/.config/plasma-workspace/env/ssh-agent.sh文件，添加内容：

  if [ -z "$SSH_AUTH_SOCK" ] && [ -S "$XDG_RUNTIME_DIR/ssh-agent.socket" ]; then
      export SSH_AUTH_SOCK="$XDG_RUNTIME_DIR/ssh-agent.socket"
  fi
  

• 给文件添加执行权限：chmod +x ~/.config/plasma-workspace/env/ssh-agent.sh
• 注销并重新登录Plasma会话，之后用KRunner启动VSCode测试

方法二：修改VSCode启动器配置

• 找到VSCode的.desktop文件，通常路径为/usr/share/applications/code.desktop或~/.local/share/applications/code.desktop
• 编辑文件，找到Exec=code %F行，修改为：

  Exec=env SSH_AUTH_SOCK=$SSH_AUTH_SOCK code %F
  

• 若修改的是系统级文件，执行update-desktop-database生效；建议复制到用户目录下修改，避免系统更新覆盖

3. 替代方案：脱离zsh插件，全局启动ssh-agent #

• 编辑会话启动文件（如X11的~/.xinitrc，或Plasma对应的会话配置），添加以下命令：

  eval $(ssh-agent -s -a $XDG_RUNTIME_DIR/ssh-agent.socket)
  ssh-add ~/.ssh/your_private_key  # 替换为你的私钥路径
  

• 这样ssh-agent会在用户会话启动时就运行，所有程序（包括KRunner启动的VSCode）都能获取到代理环境变量

内容的提问来源于stack exchange，提问作者Sa'id Kharboutli