1. Ubuntu 22.04 上 VS Code 与 Cursor 的 Remote SSH 免密登录与 X-Windows 转发实战Remote SSH 是 VS Code 和 Cursor 里最常用的远程开发方式配合 X-Windows 转发还能把远程 Ubuntu 22.04 上的图形界面比如 Gazebo、rviz2、Qt 窗口直接拉到本地显示。但很多人卡在三个地方每次连接都要输密码、X11 转发报Cant open display、以及编辑器里的模型请求通道没有统一管理。这篇就把这三件事串起来讲清楚从ssh-keygen免密、authorized_keys权限、X11Forwarding配置到把 VS Code / Cursor 的 settings 里的 endpoint 改到 TaoToken 统一 Key/API 通道一步步给可复制的配置。适合谁看正在用 Ubuntu 22.04 做 ROS2、嵌入式、图形化调试同时用 VS Code 或 Cursor 做远程开发的人。核心检索词就是 vscode cursor ubuntu remote ssh X-Windows 免密登录下面所有步骤都围绕它展开。先说结论免密登录靠 SSH 密钥对X11 转发靠服务端X11Forwarding yes加客户端ForwardX11Trusted编辑器里的模型通道靠改 settings 的 Base URL 和 API Key。三件事互不干扰但经常被混在一起排查所以分开做最省时间。2. 原问题与场景为什么 Remote SSH 总要输密码、X11 又连不上我最早遇到的问题是本地 VS Code 用 Remote SSH 连 Ubuntu 22.04明明已经ssh-copy-id过了命令行ssh userhost也能免密但 VS Code 里每次重连还是弹密码框。后来发现是 VS Code 的 Remote SSH 默认走的是它自己维护的~/.ssh/config解析逻辑如果IdentityFile没显式写或者私钥权限不对它就会回退到密码认证。另一个更烦的是 X-Windows。命令行里ssh -X userhost之后export DISPLAY:0能跑图形程序但 VS Code 自带的 terminal 里执行同样的命令Gazebo 就是起不来报Unable to init server: Could not connect: Connection refused。原因是 VS Code 的集成终端默认没有开 X11 转发它不会自动带上-X也不会帮你设置DISPLAY。还有一个隐藏坑Ubuntu 22.04 默认的 GDM 和 PAM 密码策略比较严新建用户时如果密码复杂度不够会直接拒绝导致你连测试账号都建不出来更别说配免密了。这块我在 excerpt 里看到有人改/etc/pam.d/common-password和/etc/security/pwquality.conf思路是对的但要注意改完 PAM 后别把自己锁在外面建议保留一个 root 会话再操作。场景串起来就是本地 Windows/macOS 上用 VS Code 或 Cursor远程 Ubuntu 22.04 跑 ROS2 Gazebo需要免密 SSH 登录 X11 图形转发 编辑器内模型请求走统一通道。下面按这个顺序给配置。3. TaoToken 前置把编辑器 settings 的 endpoint 改到统一通道在讲 SSH 之前先把编辑器里的模型通道配好因为后面验证远程会话时会用到。VS Code 和 Cursor 都支持在 settings 里改 API endpoint把请求指向 TaoToken 的统一 Key/API 通道这样本地和远程会话用的是同一套凭证不用在每个环境里重复配 Key。TaoToken 官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/apiVS Code 里如果你用的是 Continue、Cline 这类插件配置一般写在settings.json或插件自己的配置文件里。以 Continue 为例~/.continue/config.json里改apiBase和apiKey{ models: [ { title: TaoToken Claude, provider: openai, model: claude-sonnet-4-20250514, apiBase: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } ] }Cursor 的话在Settings - Models里把 OpenAI API Base 改成https://taotoken.net/apiAPI Key 填 TaoToken 的 KeyModel ID 填你要用的模型名。注意 Cursor 有些版本对自定义 Base URL 支持不完整如果改完不生效可以试着重启 Cursor 或者用Cmd/Ctrl Shift P执行Developer: Reload Window。Cline 的配置在 VS Code 设置里搜cline.apiProvider选OpenAI Compatible然后填 Base URL 和 Key。MCP 相关的配置如果用到也是在这个通道下走不要直连生产库。这里的关键是三件套要写全Base URL Key Model ID。少一个都会报 401 或者 model not found。我试过只填 Key 不填 Base URL结果请求还是打到默认的 OpenAI 地址直接 401。配好之后你可以在编辑器里发一条测试消息确认返回正常。这一步做完再去做 SSH 免密和 X11 转发后面验证远程会话时就能直接在远程终端里调模型接口不用来回切窗口。4. 可复制配置ssh-keygen 免密 authorized_keys 权限 X11Forwarding这一节是核心全部给可复制的命令和配置文件。4.1 本地生成密钥对本地机器Windows 用 PowerShellmacOS/Linux 用终端ssh-keygen -t ed25519 -C vscode-remote -f ~/.ssh/id_ed25519_taotoken一路回车不设 passphrase设了每次还要输违背免密初衷。生成两个文件id_ed25519_taotoken私钥和id_ed25519_taotoken.pub公钥。4.2 把公钥推到远程 Ubuntussh-copy-id -i ~/.ssh/id_ed25519_taotoken.pub user192.168.1.12如果ssh-copy-id不可用Windows 老版本手动追加cat ~/.ssh/id_ed25519_taotoken.pub | ssh user192.168.1.12 mkdir -p ~/.ssh chmod 700 ~/.ssh cat ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys4.3 远程端权限检查这是最容易出问题的地方。SSH 对权限极其敏感authorized_keys和.ssh目录权限不对免密直接失效而且不会给你明确报错只会回退到密码。chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys chmod 600 ~/.ssh/id_ed25519_taotoken chmod 644 ~/.ssh/id_ed25519_taotoken.pub家目录权限也要注意不能是 777chmod 755 ~4.4 本地 SSH config 显式指定 IdentityFileVS Code 和 Cursor 的 Remote SSH 都读~/.ssh/config所以在这里写清楚最稳Host ubuntu-ros2 HostName 192.168.1.12 User user IdentityFile ~/.ssh/id_ed25519_taotoken ForwardX11 yes ForwardX11Trusted yes ForwardAgent yes ServerAliveInterval 60 ServerAliveCountMax 3ForwardX11Trusted yes很关键不加的话有些图形程序会因为 X11 安全扩展被拒。4.5 远程端 sshd 开启 X11Forwarding编辑/etc/ssh/sshd_configsudo vim /etc/ssh/sshd_config确认或添加X11Forwarding yes X11DisplayOffset 10 X11UseLocalhost yes改完重启 sshdsudo systemctl restart sshd4.6 远程端安装 X11 相关包Ubuntu 22.04 最小安装可能没带 xauthsudo apt update sudo apt install -y xauth x11-appsx11-apps里有xeyes、xclock用来验证转发是否成功非常方便。4.7 VS Code / Cursor 的 Remote SSH 配置在 VS Code 里F1 - Remote-SSH: Open SSH Configuration File选~/.ssh/config确认上面的 Host 配置在。然后F1 - Remote-SSH: Connect to Host - ubuntu-ros2。第一次连会装 VS Code Server装完就不需要再输密码了。Cursor 同理它内置了 Remote SSH 插件操作路径一样。4.8 关闭 Ubuntu 自动熄屏可选但推荐远程开发时屏幕黑掉有时会影响 X11 会话Settings - Power - Screen Blank设为Never或者命令行gsettings set org.gnome.desktop.session idle-delay 05. 验证请求与成功结果DISPLAY 校验 模型接口测试配置做完必须验证。分两步X11 转发验证和模型接口验证。5.1 验证 SSH 免密本地终端ssh ubuntu-ros2 echo ok如果直接输出ok且没弹密码免密成功。如果还弹密码回到 4.3 检查权限或者用ssh -v ubuntu-ros2看详细日志重点看Offering public key和Authentication succeeded两行。5.2 验证 X11 转发在 VS Code 的集成终端里注意是集成终端不是本地终端echo $DISPLAY正常应该输出类似localhost:10.0。如果是空的说明 X11 转发没生效检查~/.ssh/config里的ForwardX11 yes和远程sshd_config的X11Forwarding yes。然后跑一个图形程序xeyes本地应该弹出一个跟着鼠标转的眼睛窗口。如果报Error: Cant open display: localhost:10.0多半是远程没装 xauth或者X11UseLocalhost配置冲突。再验证 Gazebo 或 rviz2export DISPLAYlocalhost:10.0 gazebo如果 Gazebo 窗口能起来说明 X11 转发完全打通。注意这里不需要ssh -X再切一层 shellVS Code 集成终端已经继承了转发通道。5.3 验证模型接口在远程终端里用 curl 测 TaoToken 通道curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoTokenKey返回模型列表 JSON 就说明通道正常。如果报 401检查 Key 是否复制完整如果报连接超时检查网络和 Base URL 是否写成了https://taotoken.net/api不要多加/v1具体路径以文档为准。然后在 VS Code 或 Cursor 里发一条测试消息确认编辑器内的模型请求也走通了。这样远程会话 图形转发 模型通道三件事就全部验证完毕。6. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给排查路径。401 Unauthorized最常见。原因有三个Key 没填、Key 填错、Base URL 没改。检查三件套是否写全。如果用的是 Cline注意它的 Key 字段有时候会被 UI 截断重新粘贴一次。local proxy failed这个报错通常出现在 VS Code Remote SSH 连接阶段不是模型接口的问题。原因是本地代理设置和 SSH 冲突。检查 VS Code 设置里http.proxy是否为空或者~/.ssh/config里有没有多余的ProxyCommand。如果本地开了系统代理把192.168.1.0/24加到代理例外里。reading choices 相关报错一般是模型返回格式和插件预期不一致。检查 Model ID 是否写对比如claude-sonnet-4-20250514不要写成claude-sonnet-4。如果插件报Cannot read property choices of undefined多半是接口返回了错误 JSON先用 curl 确认接口本身正常。OAuth 相关报错如果你用的是 Codex 或 Claude Code 这类需要 OAuth 的工具注意auth.json里的配置。Codex 的~/.codex/auth.json需要包含正确的 token 和 endpoint。如果报 OAuth token expired重新走一遍授权流程或者改用 API Key 模式。Claude Code 的配置在~/.claude/settings.jsonBase URL 指向 TaoToken 通道Key 填 TaoToken 的 Key。X11 相关报错Cant open display检查 DISPLAY 变量和 xauthX11 forwarding request failed on channel 0检查远程X11Forwarding和xauth是否安装Authorization required, but no authorization protocol specified加ForwardX11Trusted yes。权限相关报错Permissions 0644 for id_ed25519_taotoken are too open直接chmod 600Authentication refused: bad ownership or modes for directory检查家目录和.ssh权限。排查顺序建议先确认命令行ssh能免密再确认 VS Code Remote SSH 能连再确认 X11 能转发最后确认模型接口能通。一层一层来不要跳。7. 语义一致 CTA接入文档与 Coding Plan如果你在配 Remote SSH 或 X11 转发时卡在模型通道这一步可以直接看接入文档里面有各编辑器和插件的完整配置示例。需要生成新的 API Key 就去 API Keys 页面想先验证模型效果可以用模型对话页面直接测。长期做远程编码和 Agent 开发的Coding Plan 会更划算Key 和额度统一管理不用每个环境单独配。接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后补一个实用技巧把~/.ssh/config里的 Host 别名和 VS Code 的 Remote SSH 目标保持一致这样本地终端、VS Code、Cursor 三处用的是同一份配置改一处全生效。X11 转发验证用xeyes最快别一上来就开 Gazebo那个启动慢还容易掩盖问题。
