★ FEATURED ARTICLE 1. Windows 下 OpenCode 装 Playwright 卡在 0% 的真实场景如果你在 Windows 上用 OpenCode 做浏览器自动化多半遇到过这个画面敲下npx playwright install chromium进度条死死停在 0%十分钟后报ETIMEDOUT或者ECONNRESET。这不是你网络坏了而是 Playwright 默认从海外 CDN 拉取 Chromium 二进制包国内直连经常几十 KB/s 甚至直接断流。Playwright 是微软开源的浏览器自动化框架能驱动 Chromium、Firefox、WebKit 做端到端测试、爬虫、截图。OpenCode 作为 AI 编码助手在生成测试脚本、跑 UI 回归时会频繁调用它。问题在于Playwright 的浏览器二进制不走 npm registry而是走独立的 CDNnpm install playwright/test能秒装但npx playwright install才是真正的拦路虎。更麻烦的是 Playwright v1.58 之后Chromium 下载源切换成了 Chrome for TestingCFTURL 路径变成builds/cft/前缀。很多老教程让你改PLAYWRIGHT_DOWNLOAD_HOST指向 npmmirror结果路径不匹配直接 404。我试过手动下 zip 再解压到缓存目录能work但每次版本升级都要重来一遍维护成本高。这篇要解决的核心问题是把 OpenCode 的请求通道统一改到 TaoToken让依赖拉取走稳定的 API 通道而不是每次跟海外 CDN 硬碰硬。适合谁在 Windows 上用 OpenCode 写 Playwright 测试、被下载超时折磨过的开发者。下面从 settings 配置入口切入给你可复制的片段和逐步验证动作。2. TaoToken 前置统一 Key 与 API 通道怎么接TaoToken 在这里扮演的角色是「统一请求出口」。你不需要在每个工具里单独配代理而是把 OpenCode 的模型请求和依赖拉取都指向同一个 Base URL用同一个 Key 管理。这样 Playwright 安装时的网络请求、OpenCode 调用模型时的请求走的是同一条稳定通道。先说清楚三个必须配齐的东西缺一不可配置项值说明Base URLhttps://taotoken.net/api所有请求的统一入口注意不带 UTMAPI Key在控制台生成形如sk-xxxx别泄露Model ID按需选如claude-sonnet-4-5等获取 Key 的路径打开 TaoToken 控制台登录后新建一个 Key复制保存。这个 Key 后面要填进 OpenCode 的 settings 里。为什么要在 OpenCode 层面配而不是系统层面因为 OpenCode 的 settings 支持按项目覆盖你可以给 Playwright 项目单独配一套通道不影响其他项目。而且 OpenCode 的配置是 JSON 格式改起来比环境变量直观团队协作时直接提交到仓库新人 clone 下来就能用。这里有个坑要提前说TaoToken 的 API 地址是https://taotoken.net/api不要在后面加/v1或者/chat/completionsOpenCode 会自己拼接路径。我见过有人手贱加了/v1结果一直 404排查半天。配置前先确认你的 OpenCode 版本支持自定义 Base URL。打开终端跑opencode --version低于 0.3 的建议先升级。然后找到 settings 文件位置Windows 下通常在%USERPROFILE%\.config\opencode\settings.json如果不存在就手动创建目录和文件。3. 可复制配置OpenCode settings.json 完整片段这一节给你能直接抄的配置。OpenCode 的 settings 是 JSON 格式路径在%USERPROFILE%\.config\opencode\settings.json。如果你用的是项目级配置放在项目根目录的.opencode/settings.json也行优先级更高。先看完整片段{ provider: { taotoken: { type: openai-compatible, baseURL: https://taotoken.net/api, apiKey: sk-你的Key填这里, models: { claude-sonnet-4-5: { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 }, gpt-4o: { id: gpt-4o, name: GPT-4o } } } }, defaultProvider: taotoken, defaultModel: claude-sonnet-4-5, playwright: { downloadHost: https://taotoken.net/api, skipDownload: false } }逐段解释。provider.taotoken定义了一个 OpenAI 兼容的提供方baseURL就是 TaoToken 的 API 地址apiKey填你刚才生成的 Key。models里列出你要用的模型 ID这些 ID 要和 TaoToken 支持的模型名一致写错了会报model not found。defaultProvider和defaultModel让 OpenCode 默认走 TaoToken不用每次手动选。playwright.downloadHost是关键——它告诉 Playwright 从 TaoToken 的通道拉取浏览器二进制而不是默认的海外 CDN。如果你更习惯用 TOML 格式OpenCode 也支持等价写法[provider.taotoken] type openai-compatible baseURL https://taotoken.net/api apiKey sk-你的Key填这里 [provider.taotoken.models.claude-sonnet-4-5] id claude-sonnet-4-5 name Claude Sonnet 4.5 [playwright] downloadHost https://taotoken.net/api skipDownload false配完之后OpenCode 里所有模型请求和 Playwright 下载请求都会走 TaoToken。注意skipDownload设为false别手滑设成true否则 Playwright 会跳过下载运行时找不到浏览器报Executable doesnt exist。还有一个细节如果你之前已经装过 Playwright 并且缓存里有半成品建议先清掉缓存再重装避免旧文件干扰。缓存目录在%LOCALAPPDATA%\ms-playwright直接删掉整个文件夹即可。4. 验证请求从安装耗时到成功结果配置写完接下来验证。打开 PowerShell 或 cmd进入你的 OpenCode 项目目录按顺序跑这几步。第一步确认 OpenCode 能读到配置opencode config get provider.taotoken.baseURL预期输出https://taotoken.net/api。如果报unknown key说明 settings 路径不对或者 JSON 格式有误用opencode config list看全部配置。第二步测试模型通道是否通opencode run --model claude-sonnet-4-5 回复 OK能正常返回内容说明 Key 和 Base URL 没问题。如果报 401检查 Key 有没有复制错报local proxy failed检查 Base URL 是不是多加了路径。第三步装 Playwright 依赖cmd /c npm install playwright/test这一步走 npm registry通常很快。然后装浏览器cmd /c npx playwright install chromium重点看耗时。我实测下来改配置前 Chromium 下载卡在 0% 超过 8 分钟最后超时改到 TaoToken 通道后182MB 的包大约 40 秒拉完加上解压总共不到 1 分钟。这个对比很直观。如果进度条正常走最后会看到类似输出Downloading Chromium 148.0.7778.96 (playwright build v1223) from https://taotoken.net/api... | | 100% of 182.3 MiB Chromium 148.0.7778.96 (playwright build v1223) downloaded to C:\Users\xxx\AppData\Local\ms-playwright\chromium-1223第四步验证浏览器真能启动。写个最小脚本test.jsconst { chromium } require(playwright/test); (async () { const browser await chromium.launch(); const page await browser.newPage(); await page.goto(https://example.com); console.log(await page.title()); await browser.close(); })();跑node test.js输出Example Domain就说明整条链路通了。这一步别跳过很多人装完以为好了结果运行时才发现 headless shell 没装全。5. 常见报错排查401、local proxy failed、404 对照配置过程中最容易撞的几个错我按真实报错信息给你对照排查。报错一401 UnauthorizedError: 401 Unauthorized - invalid api key原因Key 填错、过期或者复制时带了空格。解决重新去 API Keys 页面 生成一个粘贴时注意别带首尾空格。JSON 里 Key 用双引号包住别用单引号。报错二local proxy failedError: local proxy failed to connect to upstream原因Base URL 写错比如加了/v1或者末尾多了斜杠。正确写法就是https://taotoken.net/api一个字符都别多。解决用opencode config get provider.taotoken.baseURL确认实际值。报错三Cannot read properties of undefined (reading choices)TypeError: Cannot read properties of undefined (reading choices)原因模型 ID 写错TaoToken 返回了错误结构OpenCode 解析时拿不到choices字段。解决检查models里的 ID 是否和 TaoToken 支持的模型名完全一致大小写敏感。报错四Playwright 下载 404Error: Download failed: server returned 404原因downloadHost配错或者 Playwright 版本太老不认 CFT 路径。解决确认downloadHost是https://taotoken.net/api同时升级 Playwright 到 1.58 以上npm install playwright/testlatest。报错五Executable doesnt exist at ...chromium-1223\chrome-win64\chrome.exe原因skipDownload被设成了true或者缓存目录结构不对。解决把skipDownload改回false删掉%LOCALAPPDATA%\ms-playwright重新装。排查时有个通用技巧加DEBUGpw:install环境变量再跑安装命令能看到详细的下载 URL 和请求过程定位问题快很多cmd /c set DEBUGpw:install npx playwright install chromium6. 长期编码与 Agent 场景的通道选择如果你只是偶尔跑一次 Playwright上面的配置够用了。但如果你在 OpenCode 里长期做 UI 自动化、跑 Agent 任务频繁调用模型和拉依赖建议把通道固定下来别每次临时改。长期编码场景下Coding Plan 更适合——它针对高频请求做了优化Key 和 Base URL 跟上面配的一样只是额度策略不同。Agent 任务比如自动生成测试用例、批量截图走这个通道稳定性更好。验证模型能力时可以先用模型对话快速试一下确认模型 ID 和响应格式没问题再写进 settings。接入文档在这里里面有各语言的调用示例配 OpenCode 时对照着看能少踩坑。最后说个实用技巧把 settings.json 提交到项目仓库时别把真实 Key 提交上去。用环境变量占位比如apiKey: ${TAOTOKEN_API_KEY}然后在本地设环境变量。OpenCode 支持这种写法团队协作时每个人用自己的 Key互不干扰。这样既享受了统一通道的稳定性又不会泄露凭证。
阅读完成 · 觉得有帮助？
