树莓派 VS Code SSH 超时TaoToken https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 先创建一把 Key让本机 Codex 拿到对照能力再回头处理 Connection timed out 和 Permission denied。这篇不聊虚的主路径是树莓派端用 ifconfig 读出 wlan0 的 inet 地址VS Code 端把 pi192.168.0.7 存进 C:\Users\用户名.ssh\config密码还是默认的 raspberry中间每一步报错都贴给走 TaoToken 通道的 Codex 帮你逐条比对。四类常见翻车点——不在同一局域网、IP 抄错、密码大小写记反、插件搜成同名扩展、ufw 拦了 22 端口——都会单独拆开讲清楚。1. 先分清报错Connection timed out 和 Permission denied 是两种病1.1 超时意味着 TCP 都没握上手Remote - SSH 弹窗里的报错文本基本决定了你该往哪查。出现Connection timed out时客户端连 TCP 三次握手都没完成问题在网络层或宿主信息本身树莓派关机了、网线掉了、SSH 服务没起来或者最常见的那条——笔记本和树莓派不在同一个局域网。典型场景是前一天树莓派挂在客厅路由器上拿到了 192.168.0.7第二天你把笔记本连去了手机热点而树莓派还挂在原来的网段。两边路由表互不可见ping 都不通VS Code 当然只会给你一行超时。先在笔记本终端ping 192.168.0.7能通再谈下一步不通就别急着改.ssh/config改了也没用。另一种是路由器 DHCP 重新分配树莓派这次拿到的地址变成了 192.168.0.12你还照着旧笔记里的 192.168.0.7 去连。这种情况不会报错得很花哨就是安静地超时所以每次重连前重新读一遍树莓派自己的 IP比死记地址靠谱得多。1.2 密码错说明你已经摸到 sshd 门口了Permission denied完全是另一码事TCP 通了SSH 握手也走完了是服务端拒绝了你的身份认证。Raspbian 11 的官方镜像里默认用户是 pi默认密码是全小写的raspberry。写成Raspberry、raspberrypi、raspi都会失败而且连续错几次部分系统还会短暂延迟响应看着更像网络问题容易带偏排查方向。还有一种情况是用户名错了。有人刷镜像时在初始化里改了用户名或者用了第三方精简镜像默认用户不再是 pi这时候 VS Code 里写pi192.168.0.7服务端会直接拒绝。判断方法很简单在树莓派接上显示器和键盘本地登录whoami看一眼比在 VS Code 里反复猜快得多。注意Connection timed out和Permission denied的排查顺序不要颠倒。超时是「找不到人」拒绝是「找到了但不认你」两者的修复动作没有交集。2. 给本机 Codex 一条通道TaoToken 的 Key 不填进 SSH2.1 打开 TaoToken 创建 Key别和树莓派掺在一起这一步很容易想歪。API Key 和 Base URL 是给本机 Codex 这类编程工具用的不是给 VS Code 的 SSH 用的。.ssh/config里只需要主机名、用户名、端口三样东西任何 API Key 塞进去都是错误配置还会让你误以为是 Key 的问题。所以顺序是先打开 TaoToken 注册并创建一把 API Key然后在本地把 Codex 的通道指向https://taotoken.net/api末尾不要加/v1。这样 Codex 才有能力帮你做后面那些文本对照树莓派本身的 SSH 链路和这套凭证完全无关两部分各管各的。Key 用占位符表示就行配置文件里别贴真 Key更不要把 Key 提交进 Git。你要拿的是一把可用的凭证具体模型 ID 以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准不要凭记忆写一个带日期后缀的型号名。2.2 ~/.codex/config.toml 里 base_url 怎么写Codex 用的是 TOML 配置和 Claude Code 的环境变量不是一套东西别把ANTHROPIC_*那组变量套过来。Windows 下路径是C:\Users\你的用户名\.codex\config.tomlmacOS / Linux 下是~/.codex/config.toml。model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chatenv_key指的是环境变量名不是 Key 本身。Linux / macOS 里这样导出export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 里换成$env:TAOTOKEN_API_KEYYOUR_API_KEY配完先让 Codex 回一句普通问题确认通道可用。确认能答上来才进入第 3 节去折腾树莓派。这样后面无论报什么错你都能确定「不是通道的问题」省掉一轮来回。3. 树莓派这端ifconfig 里 wlan0 的 inet 到底怎么读3.1 找哪一行以及没有 wlan0 的两种情况在树莓派本地终端接显示器键鼠或者已经能用的 SSH 会话执行ifconfig。输出里会有一段冠以wlan0的块找到inet 192.168.x.x那一行这个地址就是你后面要填进 VS Code 的 HostName。lo下面的 127.0.0.1 是无回环eth0下面的是有线网卡地址两个都不是你要的。如果wlan0段整个不存在通常是无线网卡没被识别或者你刷的是 Lite 镜像还没配 WiFi。如果wlan0存在但只有inet6没有inet说明它没拿到 IPv4 地址检查一下/etc/wpa_supplicant/wpa_supplicant.conf里的 SSID 和密码是否写对改完sudo reboot重来。嫌 ifconfig 输出太长可以直接用hostname -I它会把所有非回环地址一行列出来第一个通常就是 wlan0 的地址抄起来更快。net-tools 包在部分新镜像里已经不预装了ip addr show wlan0是更现代的等价命令效果一样。3.2 sshd 已经启动但 22 端口被 ufw 拦着有个很典型的坑树莓派上sudo systemctl status ssh显示 active (running)服务明明开着VS Code 还是超时。原因往往是ufw防火墙默认拒绝入站22 端口没放行。sudo systemctl status ssh sudo systemctl start ssh sudo systemctl enable ssh sudo ufw status sudo ufw allow 22注意这些命令全部由你在树莓派自己的终端里执行。Codex 不连树莓派、不登录你的机器、也不替你敲ufw它只负责看你贴回去的输出文本。这是使用边界不是能力限制——把结果复制粘贴回来就已经够了。4. VS Code 这端Remote - SSH 扩展、pi192.168.0.7 与 .ssh/config4.1 插件搜不到先核对扩展 ID 和发布者在扩展市场搜remote ssh会出来一串名字近似的扩展有些是第三方改的装了不一定能连 4B。认准扩展 IDms-vscode-remote.remote-ssh发布者是 Microsoft。如果搜索结果为空先检查网络和扩展市场是否被公司代理拦了再试离线装 VSIX。另一种「搜不到」是搜错了词。有人搜 Remote-SSH 加空格、加连字符或者只搜 SSH结果翻了几页都没看见正主。先复制扩展 ID 到搜索框命中率最高。装完之后左侧活动栏会出现远程资源管理器图标这是判断装对了没有的直接标志。4.2 config 文件里写什么密码什么时候输装好扩展后按F1调出命令面板执行Remote-SSH: Connect to Host选Add New SSH Host输入pi192.168.0.7然后它会问你把配置存到哪选C:\Users\你的用户名\.ssh\config。这一步的选择会影响以后能不能直接点连别随手存到别处。保存后文件里大致长这样Host raspberry-pi HostName 192.168.0.7 User pi Port 22第一次连接会弹指纹确认输yes回车然后才提示输密码。密码就是raspberry全小写。整个流程里没有任何一步需要 API Key——如果你在这里看到了要填 Key 的地方说明打开的根本不是 SSH 配置界面。提示把 IP 换成Host raspberry-pi这个别名之后以后路由器重新分配地址你只需要改 config 里的一行命令面板里的记录不用动。5. 把 ifconfig 输出和报错原文丢给 Codex让它逐条比对5.1 一份可以照着填的提问模板Codex 的价值在这类排查里很直接它读文本、做对照不会因为你觉得「肯定没问题」而漏掉一行。把三样东西准备好——本机.ssh/config的完整内容、树莓派上hostname -I和ip addr show wlan0的输出、VS Code 弹窗里那段报错原文原样复制不要转述。提问可以写得具体一点告诉它你用的是树莓派 4B Raspbian 11笔记本和树莓派是否连同一个 WiFi然后让它按四个方向逐条核对下来——两边是否真在同一网段、HostName 是否等于 wlan0 的 inet、User 是否为 pi、密码是否写成全小写的 raspberry、扩展是否是ms-vscode-remote.remote-ssh。让 Codex 明确回答「哪一条不满足、依据是哪一行」而不是给一段笼统的建议。5.2 Codex 只做文本层对照命令还是你自己敲这里必须把边界说清楚Codex 不会去连你的树莓派不会替你在上面执行sudo ufw allow 22也不会自动改你的.ssh/config。它给的是判断和提示执行动作始终在你这端。树莓派是真实设备改动防火墙和服务状态需要你自己确认后果。反过来也一样如果排查走到「要不要重刷镜像」「要不要改树莓派主机名」这种有副作用的操作先让 Codex 把影响范围讲一遍再决定做不做。把ssh -v pi192.168.0.7的详细日志贴回去通常能让结论更精准——verbose 输出里会明确停在校验、认证还是连接哪一阶段。6. 状态栏出现 SSH: 192.168.0.7 之后做什么6.1 打开 /home/pi 下的 test.py 验一验连接成功的标志是 VS Code 左下角状态栏显示SSH: 192.168.0.7或者你起的别名。这时候按Ctrl ~打开的是树莓派的终端不是本机的pwd应该停在/home/pi。用资源管理器打开/home/pi目录新建或编辑test.py写几行打印语句在远程终端里python3 test.py跑一下确认文件确实落在树莓派上。如果这时候编辑器提示保存失败多半是目录权限问题检查一下ls -l的属主如果python3命令不存在说明镜像里没装解释器sudo apt install python3补上。这些都属于跑通之后的常规收尾和前面的连接超时不是一个层级的问题。6.2 顺手去控制台确认这次调用排查期间你让 Codex 读了不少配置和日志这些调用都走了 TaoToken 的通道。配置保存后先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错要长期用来读代码、写脚本可以打开 Coding Plan 看套餐是否够用Key 在 控制台 API Keys 里创建和轮换环境变量的完整对照可以翻 接入文档。回到树莓派这件事上最后留一个习惯每次连不上先ping再读 IP再确认密码大小写最后才去翻扩展和防火墙。顺序对了四类报错里绝大多数都能在五分钟内定位到具体那一行。