1. Trae Remote-SSH 连接 orangepi 报 exit code 1001 是什么问题

Trae 通过 Remote-SSH 连接 orangepi 时抛出exit code: 1001，本质是远程主机上的 Trae Server 进程没能正常启动或写入工作目录。这个错误码本身不指向具体原因，它只是 Trae 在 SSH 通道建立后、尝试在远端拉起服务端组件失败时给出的统一退出信号。换句话说，SSH 能连上不代表 Trae 能连上，因为 Trae 还需要在远端家目录里创建~/.trae-server/并写入运行时文件。

适合遇到这个报错的开发者：用 Trae 远程开发 orangepi（RK3588、aarch64、Ubuntu 22.04 这类板子）、终端ssh orangepi@192.168.1.27正常但 Trae 卡在 "Setting up SSH Host" 然后弹 1001、或者之前能连突然连不上的人。我这次踩的坑是板子异常掉电后 eMMC 的 EXT4 文件系统元数据损坏，内核触发errors=remount-ro把根分区强制挂成只读，Trae Server 写不进去直接 1001。

排查这类问题要建立一条完整链路视角：本地 Trae 客户端 → SSH 认证 → 远端 shell 环境 → 远端家目录可写 → Trae Server 启动。任何一环断了都会以 1001 的形式暴露出来，所以不能只盯着 Trae 日志，得从 SSH 层一路往下验证。下面按"先定位、再修复、后配置"的顺序展开，同时把 TaoToken 作为统一 Key/API 通道的配置思路串进去，方便你在远端环境里也能直接调模型。

2. 连接前的环境确认与 TaoToken 统一 Key 通道准备

在动 Trae 之前，先把远端基础环境过一遍，这一步能排掉一大半 1001。用终端 SSH 登进 orangepi，逐条执行：

uname -m # 期望 aarch64 ldd --version | head -1 # 期望 glibc >= 2.28，实测 2.35 ls /usr/lib/aarch64-linux-gnu/libstdc++.so.6 # 存在即可 df -h ~ # 家目录可用空间，建议 >= 500MB touch ~/.write_test && echo OK && rm ~/.write_test

前三条是架构和依赖，Trae Server 是预编译二进制，aarch64 和 glibc 版本不匹配会直接启动失败。第四条空间不足时 server 解压会中断。第五条是本次的关键转折点——如果这里返回Read-only file system，那 1001 的根因基本就锁定了，跟 Trae 本身无关。

环境确认没问题后，把 TaoToken 的接入参数准备好。TaoToken 在这里的作用是给远端开发环境提供一个统一的 Key 和 API 通道，这样你在 orangepi 上跑脚本、调模型、做连通性测试时不用每个工具单独配一套凭证。先到控制台创建 API Key：

• 控制台入口：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
• API Key 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

拿到 Key 之后，记下三个核心参数，后面配置和验证都要用：

如果你打算在 orangepi 上长期做编码或 Agent 任务，可以了解下 Coding Plan，它把常用编码模型的调用额度打包，适合远程开发场景：

Coding Plan 入口：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

这一步的目标不是马上连 Trae，而是确保远端有一个可用的模型通道。因为 1001 修好之后，你大概率会立刻在远端跑验证请求，提前把 Key 备好能省一轮来回。

3. 可复制的 SSH 与 Trae 配置片段（含 TaoToken 参数）

先解决 SSH 侧的配置，让 Trae 走一个稳定的连接。编辑本地~/.ssh/config（Windows 在C:\Users\你的用户名\.ssh\config）：

Host orangepi HostName 192.168.1.27 User orangepi Port 22 ServerAliveInterval 30 ServerAliveCountMax 6 TCPKeepAlive yes

ServerAliveInterval这组参数很关键，orangepi 这类板子在网络抖动或负载高时容易静默断连，Trae 建 server 的过程中断一次就可能报 1001。加上心跳能显著降低偶发失败。

接着是远端 Trae Server 的目录约定。Trae 默认在远端家目录创建~/.trae-server/，如果这个目录残留了上次失败的半成品，也会导致新连接 1001。清理命令：

rm -rf ~/.trae-server ~/.vscode-server ~/.vscode-server-insiders

然后是 TaoToken 的配置片段。在 orangepi 上给需要调模型的工具写一份统一配置，以 JSON 形式放在项目或家目录下，比如~/.taotoken/config.json：

{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的实际Key", "model": "你的ModelID", "timeout": 60 }

如果你用的是支持settings.json的编辑器类工具，可以写成：

{ "taotoken.baseUrl": "https://taotoken.net/api", "taotoken.apiKey": "sk-你的实际Key", "taotoken.model": "你的ModelID" }

注意 Base URL 固定用https://taotoken.net/api，不要带任何查询参数。Key 和 Model ID 三件套必须齐全，缺一个在验证阶段就会报 401 或 model not found。

如果你在远端用 Claude Code 这类工具，配置思路一致，把 Base URL、Key、Model ID 填进对应位置即可，参考文档：

接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

配置写完先别急着连 Trae，下一节先做连通性验证，确认远端可写、模型通道可用，再回头连 Trae，这样 1001 如果还出现就能快速区分是 SSH 层还是 server 层的问题。

4. 分步验证请求与成功结果确认

验证分两层：先确认远端文件系统可写，再确认 TaoToken 通道可用。

第一层，文件系统可写验证。如果第 2 节touch返回了Read-only file system，先按下面修复：

# 1. 先挂只读保证一致性 sudo mount -o remount,ro / # 2. 修复文件系统，注意设备名按实际调整 sudo fsck.ext4 -y /dev/mmcblk1p2 # 3. fsck 要求重启 sudo reboot

重启后确认根分区恢复可写：

mount | grep mmcblk1p2 # 看到 rw 即恢复 touch ~/test && echo OK # 输出 OK 即可写

同时回看内核日志确认损坏原因，避免下次再犯：

dmesg | grep -iE "ext4.*error" # 典型输出：EXT4-fs error: block bitmap and bg descriptor inconsistent # Remounting filesystem read-only

第二层，TaoToken 通道验证。在 orangepi 上用 curl 直接打一次请求，确认 Key 和网络都通：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的实际Key" \ -H "Content-Type: application/json" \ -d '{ "model": "你的ModelID", "messages": [{"role": "user", "content": "ping"}] }'

成功时返回体里会有choices字段和模型回复内容。如果返回 401，说明 Key 不对或没带上；如果返回 model 相关错误，说明 Model ID 写错。这一步通了，说明远端不仅能写文件，还能正常访问模型通道。

两层都通过后，回到本地 Trae 重新连接 orangepi。连接过程中按Ctrl+Shift+U打开 OUTPUT 面板，下拉选 "Remote-SSH"，观察日志。正常流程会看到 server 下载、解压、启动，最后进入远端工作区。如果还报 1001，日志里通常会带更具体的信息，比如权限拒绝或磁盘满，按第 5 节对照处理。

5. 本篇常见错误排查对照表

把这次和以往遇到的 1001 相关报错整理成对照表，方便你按现象定位：

几个重点展开。local proxy failed这类报错通常是本地开了代理工具，Trae 的 SSH 隧道和代理冲突，关掉代理直连即可，TaoToken 的 API 地址本身可直接访问，不需要额外代理。reading choices是返回体里没有预期的choices字段，九成是 Model ID 写错或请求体格式不对，把 Model ID 和请求 JSON 对齐再试。

如果你在远端用 Claude Code 或类似工具，出现 OAuth 失败时，直接切到 API Key 模式，把 Base URL、Key、Model ID 三件套填全，比走 OAuth 更省事。CC Switch、Cline MCP、Codex 的auth.json这类配置，核心都是这三件套，缺一不可：

{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的实际Key", "model": "你的ModelID" }

排查顺序建议固定成：SSH 能连吗 → 架构依赖满足吗 → 空间够吗 → 家目录可写吗 → 清理残留 → 看 OUTPUT 日志。按这个顺序走，1001 基本都能定位到具体环节，不会在 Trae 本身打转。

6. 远端开发环境接入 TaoToken 的后续配置

1001 修好、Trae 连上之后，接下来把远端开发环境的模型通道固化下来，避免每次重配。核心还是那三件套：Base URL 用https://taotoken.net/api，Key 从控制台拿，Model ID 按任务选。

如果你主要在 orangepi 上做长期编码或 Agent 任务，Coding Plan 比按次调用更划算，额度打包后不用每次担心计费：

Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

想先在网页上验证模型是否可用，可以直接用模型对话入口试一条：

模型对话：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite

Key 管理和新建都在控制台完成：

API Keys：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

配置细节和不同工具的接入方式看文档：

接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

最后给 orangepi 加一条预防措施，避免再次异常掉电导致 EXT4 损坏、又绕回 1001：

# 正常关机，别直接拔电 sudo poweroff # 定期强制 fsck，开机即检查 sudo tune2fs -C 1 -c 1 /dev/mmcblk1p2 && sudo reboot

平时养成习惯，dmesg | grep -i ext4一旦看到 error 就尽早处理，别等到根分区被挂成只读、Trae 报 1001 才动手。把 SSH 心跳、家目录可写检查、TaoToken 三件套配置这三件事固定成连接前的例行检查，orangepi 上的远程开发就能稳定跑起来。