1. 为什么本地写代码、远程跑编译，ftp-sync 是那个被低估的环节
VS Code 里做嵌入式或者跨平台开发，很多人都会遇到一个很别扭的组合：本地 Windows 上写代码舒服，补全快、跳转准、界面顺手，但真正编译的时候，Linux 环境又明显更快。我试过在同一个 ESP-IDF 工程上对比，Linux 下全量编译的耗时经常只有 Windows 的三分之一到五分之一，增量编译的差距更明显。于是就形成了一个很自然的方案：VS Code 负责编辑，远程 Linux 负责编译和烧录。
问题就出在「编辑完怎么把文件送过去」这一步。有人用共享文件夹，有人用 scp 手动传，有人干脆在远程挂 Samba。这些方案都能用，但日常改十几个文件、频繁保存的时候，手动操作会非常碎。VS Code 的 ftp-sync 插件就是解决这个碎问题的：它把「保存即同步」这件事做成自动化，你在本地按 Ctrl+S，远端对应文件的时间戳立刻更新，接着你在远程终端敲编译命令就行。
这篇要讲的不只是 ftp-sync 怎么装、怎么填 host，而是把它的settings.json配置写清楚，并且把 endpoint 和鉴权项统一改到 TaoToken 的 Key/API 通道上。为什么要做这一步？因为当你的项目里同时有 ftp-sync、Cline、Continue、Codex 这类插件时，每个插件都让你填一遍 Key，改一次 Key 要翻五六个配置文件，非常容易漏。把模型通道统一到一处，后面维护成本会低很多。
适合读这篇的人：正在用 VS Code 做远程编译、需要本地与远程代码同步、并且希望把 AI 辅助插件的鉴权也一起收拢的开发者。下面从环境准备开始，一步步给可复制的配置。
2. 前置准备：TaoToken 通道与 ftp-sync 的职责边界
在动手改配置之前，先把两件事分清楚，不然后面容易混。
第一件事是 ftp-sync 本身负责什么。它只做文件传输：本地某个路径的文件，通过 FTP/SFTP 协议，上传到远端某个路径。它不负责编译、不负责运行、也不负责模型调用。所以 ftp-sync 的配置里出现的 host、port、username、password，指的是你远程 Linux 机器的 FTP 服务账号，不是模型服务的 Key。这一点必须先明确，否则会把两套鉴权搞混。
第二件事是 TaoToken 通道负责什么。它提供的是统一的模型 API 入口，Base URL 是https://taotoken.net/api，你拿到的 Key 用于调用模型对话、代码补全这类能力。它的作用是让 VS Code 里多个 AI 插件共用同一个 Key 和同一个 endpoint，而不是每个插件各填一套。官网入口在https://taotoken.net/?utm_source=taotoken_aicg_blog_end，API 地址不要加 UTM 参数，直接写https://taotoken.net/api。
所以整体结构是这样的：ftp-sync 用你的远程机器账号做文件同步；AI 插件用 TaoToken 的 Key 做模型调用。两者互不干扰，但可以放在同一个项目的.vscode/settings.json里统一管理，改的时候一眼能看到全部。
远程 Linux 这边需要先装好 FTP 服务（vsftpd 或 proftpd 都行），并且确认你的账号对目标工程目录有写权限。可以用sudo systemctl status vsftpd看服务状态，用ftp localhost在本机测一下能不能登录。这一步不通，后面插件怎么配都没用。
本地这边，VS Code 打开你要同步的工程文件夹。注意一个坑：ftp-sync 的配置是「按项目」生效的，不是全局生效。也就是说你必须先打开具体工程目录，再配置，配置才会写进这个工程的.vscode/settings.json。如果你在没打开文件夹的情况下配置，它会写到一个你不期望的位置，换项目就失效。这是很多人第一次用觉得「配了没反应」的主要原因。
3. 可复制配置：settings.json 里同时放 ftp-sync 与 TaoToken 通道
下面给一份可以直接抄的.vscode/settings.json。路径是工程根目录下的.vscode/settings.json，如果.vscode文件夹不存在就手动建一个。这份配置里，ftpsync开头的键属于 ftp-sync 插件，taotoken相关的键用于统一模型通道，两者放在同一个文件里方便对照。
{ "ftpsync.host": "192.168.1.100", "ftpsync.port": 21, "ftpsync.username": "devuser", "ftpsync.password": "your_ftp_password", "ftpsync.remotePath": "/home/devuser/esp32-project", "ftpsync.localPath": "${workspaceFolder}", "ftpsync.protocol": "ftp", "ftpsync.uploadOnSave": true, "ftpsync.ignore": [ "**/.git/**", "**/build/**", "**/.vscode/**", "**/*.o", "**/*.elf", "**/*.bin" ], "ftpsync.autoDelete": false, "ftpsync.privateKeyPath": "", "taotoken.baseUrl": "https://taotoken.net/api", "taotoken.apiKey": "sk-你的TaoTokenKey", "taotoken.defaultModel": "claude-sonnet-4-20250514" }几个关键项说明一下。ftpsync.localPath用${workspaceFolder}表示当前工程根目录，这样换项目不用改。ftpsync.remotePath必须和远端真实路径完全一致，大小写敏感，写错会同步到错误目录甚至失败。ftpsync.uploadOnSave设为 true 后，保存即上传，这是最省心的模式。ftpsync.ignore一定要把build、.git、编译产物排除掉，否则每次保存都传一堆二进制，慢且容易把远端编译缓存搞乱。
如果你用的是 SFTP 而不是普通 FTP，把ftpsync.protocol改成"sftp"，端口改成 22，并且把ftpsync.privateKeyPath填成你的私钥路径，比如"C:/Users/you/.ssh/id_rsa"。用密钥比用密码稳，尤其是自动化场景。
关于 TaoToken 那三项，taotoken.baseUrl固定写https://taotoken.net/api，不要带任何查询参数。taotoken.apiKey填你在控制台生成的 Key。taotoken.defaultModel填你要用的模型 ID。这三项是给支持自定义 endpoint 的 AI 插件读的，比如 Cline、Continue 这类。如果你的插件不读taotoken.*这种自定义键，那就把同样的值填到插件自己的配置里，但值保持一致，这样改 Key 时只改一处来源。
如果你同时用 Claude Code 或 Codex 这类需要独立配置文件的工具，它们的鉴权文件也要指向同一个通道。以 Codex 的auth.json为例，里面要写全三件套：Base URL、Key、Model ID。Base URL 同样是https://taotoken.net/api，Key 用同一个，Model ID 和上面保持一致。这样你在 VS Code 里换 Key，只需要改这一个来源，其他工具引用同一份值即可。
配置写完保存，VS Code 右下角一般不会弹提示，这是正常的。接下来进入验证环节。
4. 验证请求：保存文件后看日志与远端时间戳
配置对不对，不靠猜，靠两个可观察的结果：插件日志和远端文件时间戳。
第一步，打开 ftp-sync 的输出面板。在 VS Code 里按Ctrl+Shift+U打开输出面板，右上角下拉选择ftp-sync。这个面板会打印每次同步的连接、上传、结果。如果配置有误，这里会直接给报错，比瞎试快得多。
第二步，随便改一个源文件，比如main/main.c，加一行注释，按Ctrl+S。观察输出面板，正常会看到类似这样的日志：
[ftp-sync] Connecting to 192.168.1.100:21 ... [ftp-sync] Login success as devuser [ftp-sync] Uploading main/main.c -> /home/devuser/esp32-project/main/main.c [ftp-sync] Upload done in 42ms第三步，去远端确认时间戳。在远程 Linux 终端里执行：
ls -l --time-style=full-iso /home/devuser/esp32-project/main/main.c看输出的时间是不是刚刚。如果是，说明本地与远程代码同步链路已经通了。接着你在远端直接敲编译命令，比如idf.py build，就能用刚同步过去的代码编译。
第四步，验证 TaoToken 通道。如果你装了支持自定义 endpoint 的 AI 插件，在插件里发一句测试请求，比如「用一句话解释这段 C 代码」。请求能正常返回，说明 Base URL 和 Key 生效。如果返回 401，说明 Key 不对或没带上；如果返回连接错误，检查 Base URL 是不是写成了带 UTM 的地址，API 地址必须是干净的https://taotoken.net/api。
这里有个细节：ftp-sync 的同步和 TaoToken 的模型调用是两条独立链路，验证时要分开看。同步失败看 ftp-sync 输出面板，模型调用失败看插件自己的日志或 VS Code 的开发者工具控制台。不要因为一个失败就怀疑另一个。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
实际用下来，报错集中在几类，下面按真实错误信息对照排查。
401 Unauthorized。这个几乎都出在模型通道上，不是 ftp-sync。原因通常是 Key 填错、Key 前后有空格、或者 Base URL 写成了带参数的地址。检查taotoken.apiKey是不是完整的sk-开头字符串，检查taotoken.baseUrl是不是https://taotoken.net/api。如果插件读的是自己的配置而不是taotoken.*，去插件设置里核对同样的三项。改完重启 VS Code 窗口再试。
local proxy failed。这个报错一般出现在插件尝试走本地代理但代理没起来的时候。先确认你没有在 VS Code 设置里配http.proxy指向一个不存在的本地端口。如果你不需要代理，把相关设置清空。另外检查系统环境变量里有没有残留的代理配置，插件有时会读环境变量。清掉后重启 VS Code。
reading choices 相关报错。这类错误通常出现在模型返回结构不符合插件预期时，比如返回体里没有choices字段。常见原因是 Base URL 指向了一个不兼容 OpenAI 格式的端点，或者 Model ID 填了一个该通道不支持的模型。核对taotoken.defaultModel是不是有效模型 ID，Base URL 是不是https://taotoken.net/api。如果插件要求 OpenAI 兼容格式，确认通道支持该格式。
OAuth 相关报错。有些工具默认走 OAuth 登录流程，而不是 API Key。如果你要用 TaoToken 的 Key，需要在工具设置里切换到 API Key 模式，关掉 OAuth。以 Claude Code 为例，它的配置里要明确写 Base URL、Key、Model ID 三件套，而不是走登录。Codex 的auth.json同理，三件套写全，不要留空。OAuth 流程和 Key 流程混用，就会出现鉴权失败。
ftp-sync 同步没反应。先看输出面板有没有日志。如果完全没有日志，说明插件没激活，检查是不是在正确的工程目录下打开的 VS Code。如果有连接日志但上传失败，检查远端目录权限，用ls -ld /home/devuser/esp32-project看写权限。如果上传成功但远端文件没变，检查ftpsync.remotePath是不是写到了另一个目录。
同步把 build 目录也传了。这是ftpsync.ignore没配好。把**/build/**、**/*.o、**/*.elf加进去。改完 ignore 后，已经传上去的垃圾文件要手动在远端删掉，否则会一直占空间。
排查顺序建议固定：先看 ftp-sync 输出面板确认同步链路，再看 AI 插件日志确认模型链路，两条链路分开定位，不要混在一起猜。
6. 把 Key 收拢到一处之后，日常怎么用
配置跑通之后，日常操作会变得很轻。本地改代码，Ctrl+S，远端时间戳更新，切到远程终端敲编译。AI 插件那边，因为 Base URL 和 Key 都指向同一个通道，你换 Key 的时候只改.vscode/settings.json里的taotoken.apiKey，或者改你统一存放 Key 的那一处，其他插件引用同一份值，不用逐个翻配置。
如果你需要长期在多个项目里做编码和 Agent 任务，可以考虑用 Coding Plan 把额度集中管理，入口在https://taotoken.net/api对应的控制台里能找到。需要单独验证某个模型是否可用时，用模型对话页面发一条测试请求最快。Key 的生成和管理在 API Keys 页面，接入细节看接入文档。这几个入口分工明确：排障和接入看文档与 API Keys，验证模型用模型对话，长期编码用 Coding Plan。
最后留一个实用习惯：把.vscode/settings.json里的taotoken.apiKey换成环境变量引用，比如${env:TAOTOKEN_API_KEY}，这样 Key 不会进版本库。VS Code 支持这种写法，插件读取时会自动展开。团队协作时，每个人在自己环境里设这个变量，配置文件可以安全提交。这一步做完，本地与远程代码同步和模型通道就都稳了。