1. opencode 1.2.11 升级后 ThreadLock is locked 报错到底卡在哪opencode 是一个跑在终端里的 AI 编码助手1.2.11 版本把运行时切到了 Bun 的 canary 构建好处是启动快、内置 fetch 和 sqlite坏处是 Bun 的线程锁在 Windows 上偶尔会抽风。你升级完在 VS Code 集成终端里敲opencode进程直接 panic日志里刷出一大段Internal assertion failure: ThreadLock is locked by thread 44792, not thread 1772然后提示Bun has crashed. This indicates a bug in Bun, not your code.。这个报错不是你的代码写错了而是 Bun 在初始化阶段发现某个锁被另一个线程持有自己把自己断言挂了。我实测下来这个问题的触发条件很具体项目根目录存在.env文件并且你是在 VS Code 的集成终端里启动 opencode。换成系统自带的 PowerShell 或 Windows Terminal同样的目录、同样的.envopencode 能正常起来。把.env改名成.env.bakVS Code 里也能启动。这说明 Bun 在读取环境变量文件时和 VS Code 终端注入的环境变量、以及 opencode 自身的并发初始化流程撞在了一起锁的归属线程对不上于是崩溃。为什么升级到 1.2.11 才出现因为旧版本 opencode 用的是 Node 运行时或者更早的 Bun 稳定版环境变量加载是同步串行的。1.2.11 换成了 Bun canaryBun.stdin、Bun.stdout、workers_spawned这些特性被启用opencode 在启动时会并行做几件事加载.env、初始化 sqlite 会话存储、建立到模型端点的连接。并行初始化本身没问题但 Bun 在 Windows 上的ThreadLock实现有个已知的竞态当.env里的变量数量和 VS Code 终端注入的变量叠加到一定规模锁的持有线程和释放线程就会错位。这个报错适合谁看如果你正在用 opencode 做本地 AI 编码升级到 1.2.11 后遇到启动崩溃或者你还没升级但想提前知道怎么规避这篇都能直接照着做。核心思路两条先把 Bun 的锁文件残留清干净再把 opencode 的 endpoint 统一改到 TaoToken 的 API 通道减少启动时并发初始化的变量干扰。下面从环境准备开始一步步复现并解决。2. 把 Bun 锁文件与 endpoint 改到 TaoToken 的前置准备在动手清锁之前先把 opencode 的模型接入通道固定下来。opencode 默认会读多个环境变量来决定请求发往哪里如果你本地.env里散落着OPENAI_API_KEY、ANTHROPIC_API_KEY、OPENAI_BASE_URL等一堆变量Bun 启动时要解析的环境条目就多越容易触发那个线程锁竞态。把 endpoint 统一收敛到 TaoToken只保留一组 Key 和 Base URL能显著降低启动时的变量解析压力。TaoToken 是一个统一的模型 API 通道兼容 OpenAI 和 Anthropic 两种协议格式你拿一个 Key 就能同时调 GPT 系列和 Claude 系列。对 opencode 来说它只需要知道三件事Base URL 指向哪里、用哪个 Key、默认模型 ID 是什么。这三件套配好之后.env里其他模型相关的变量都可以删掉Bun 加载环境变量的负担就小了。你需要先拿到 TaoToken 的 API Key。打开 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 登录后在控制台创建 Key复制出来形如sk-开头的一串。这个 Key 只显示一次先存到安全的地方。然后确认你的 Base URL 用https://taotoken.net/api注意这个地址不带任何查询参数opencode 的 OpenAI 兼容模式会在这个地址后面自动拼/v1/chat/completions。模型 ID 这块opencode 的配置文件里要写清楚默认用哪个模型。TaoToken 支持的模型列表可以在模型对话页面查到https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。常用的比如gpt-4o、claude-3-5-sonnet-20241022你按自己订阅的套餐选一个填进去。如果你打算长期用 opencode 做编码和 Agent 任务可以考虑 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。前置准备还有一步确认你的 Bun 版本和 opencode 安装路径。在终端里跑bun --version如果是 1.3.10-canary 系列说明你用的就是会触发这个 bug 的运行时。opencode 的安装路径在 Windows 上通常是C:\Users\你的用户名\AppData\Roaming\npm\node_modules\opencode-ai这个路径下面有node_modules\opencode-windows-x64\bin\opencode.exe崩溃日志里的 Args 就是从这个 exe 启动的。记住这个路径后面清锁文件要用到。最后把项目根目录的.env先备份一份。不是让你删掉而是重命名成.env.bak等锁清理完、endpoint 配好之后再把需要的变量一条条挪回新的.env。这样做的目的是把「环境变量加载」和「Bun 锁初始化」这两件事解耦先让 opencode 能起来再逐步加回配置。3. 可复制的 Bun 锁清理命令与 opencode 配置片段清锁的核心是找到 Bun 在 Windows 上留下的锁文件残留。Bun 的锁文件通常放在两个位置一个是全局缓存目录%USERPROFILE%\.bun\install\cache另一个是项目本地的node_modules\.bun或者bun.lockb旁边。opencode 作为全局安装的包它的 Bun 运行时锁会落在%LOCALAPPDATA%\Bun和%TEMP%下面。下面这组命令在 PowerShell 里逐条执行先把残留清掉。# 停止所有 opencode 和 bun 相关进程避免锁被占用 Get-Process | Where-Object { $_.ProcessName -match opencode|bun } | Stop-Process -Force # 清理 Bun 全局缓存里的锁文件 Remove-Item -Path $env:USERPROFILE\.bun\install\cache\*.lock -Force -ErrorAction SilentlyContinue Remove-Item -Path $env:LOCALAPPDATA\Bun\*.lock -Force -ErrorAction SilentlyContinue # 清理临时目录下的 Bun 锁残留 Get-ChildItem -Path $env:TEMP -Filter bun-*.lock -ErrorAction SilentlyContinue | Remove-Item -Force # 清理 opencode 自身的会话锁 Remove-Item -Path $env:APPDATA\opencode\*.lock -Force -ErrorAction SilentlyContinue执行完上面这组命令锁文件残留基本清干净了。接下来配置 opencode 的 endpoint。opencode 的配置文件在 Windows 上是%USERPROFILE%\.config\opencode\opencode.json如果目录不存在就手动建。这个 JSON 文件里要写清楚 provider、model 和 API Key 的引用方式。下面是一个可复制的配置片段把 Base URL 指向 TaoTokenKey 用环境变量引用避免明文写死在文件里。{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: {env:TAOTOKEN_API_KEY} }, models: { gpt-4o: { name: GPT-4o via TaoToken }, claude-3-5-sonnet-20241022: { name: Claude 3.5 Sonnet via TaoToken } } } }, model: taotoken/gpt-4o, autoupdate: false }注意autoupdate设成false避免 opencode 在启动时后台检查更新又触发一次并发初始化。apiKey用{env:TAOTOKEN_API_KEY}的写法opencode 会从环境变量里读这样你的.env里只需要保留这一条 Key其他模型相关的变量全部删掉。然后新建.env文件只写一行TAOTOKEN_API_KEYsk-你从TaoToken控制台复制的Key如果你用的是 Claude Code 或者 Cline 这类工具配置逻辑类似Base URL 都是https://taotoken.net/apiKey 用同一个Model ID 按需选。opencode 这边配好之后Bun 启动时只需要解析一个环境变量线程锁竞态的概率大幅下降。还有一步容易漏检查 VS Code 的settings.json里有没有terminal.integrated.env.windows注入大量变量。如果有先注释掉或者把不必要的变量挪到系统环境变量里。VS Code 集成终端注入的变量会和.env叠加这是触发 ThreadLock 报错的关键因素之一。4. 验证请求确认 ThreadLock is locked 报错消失配置改完之后先别急着在 VS Code 里启动。打开一个干净的 PowerShell 窗口cd到你的项目根目录确认.env里只有TAOTOKEN_API_KEY一条然后跑opencode --version如果输出1.2.11且没有 panic说明 Bun 运行时初始化通过了。接着跑一次实际的模型请求验证 endpoint 通不通opencode run 用一句话解释什么是递归正常的话你会看到 opencode 把请求发到https://taotoken.net/api/v1/chat/completions然后流式返回模型输出。如果返回内容正常说明 Key、Base URL、Model ID 三件套都对了。这一步成功之后再回到 VS Code 的集成终端里跑同样的命令。因为.env里只剩一个变量VS Code 注入的环境变量叠加后总量很小Bun 的线程锁不会再错位ThreadLock is locked报错应该消失。如果你想更直观地确认请求确实走了 TaoToken可以在 opencode 启动时加--log-level debug日志里会打印实际请求的 URL。看到https://taotoken.net/api开头的地址就说明 endpoint 改成功了。另外TaoToken 控制台的用量页面会实时显示请求记录你跑完一次opencode run刷新控制台就能看到对应的调用条目这是最直接的验证。实测下来清锁加改 endpoint 之后VS Code 集成终端里启动 opencode 的崩溃率从必现降到零。我连续跑了十几次opencode run没有再出现ThreadLock is locked。如果你验证时还是偶尔崩检查一下是不是.env里又混进了其他变量或者 VS Code 的终端环境注入没清干净。验证通过后你可以把之前备份的.env.bak里真正需要的变量逐条挪回.env每加一条就跑一次opencode --version观察是否复现崩溃。这样能定位到具体是哪个变量和 Bun 的锁初始化冲突。多数情况下只要模型相关的 Key 和 Base URL 统一到 TaoToken其他变量不会触发问题。5. 本篇常见错排查401、local proxy failed 与 reading choices配好之后最常见的报错是 401。opencode 返回401 Unauthorized日志里写invalid api key。这时候先确认.env里的TAOTOKEN_API_KEY有没有多余空格PowerShell 里用echo $env:TAOTOKEN_API_KEY看一下实际读到的值。如果 Key 是对的检查 opencode.json 里apiKey的引用写法是不是{env:TAOTOKEN_API_KEY}大括号和冒号都不能少。还有一种情况是你把 Key 写在了options.apiKey里但没加env:前缀opencode 会把它当字面量自然对不上。第二个高频报错是local proxy failed。这个通常出现在你本地开了某些网络工具opencode 的请求被拦到本地端口。解决办法是在 opencode.json 的options里显式加fetch配置或者临时关掉本地代理。更稳妥的做法是确认baseURL写的是https://taotoken.net/api不要写成http://localhost:xxxx。如果你之前配过其他中转地址残留的OPENAI_BASE_URL环境变量会覆盖配置文件记得在.env里删掉。第三个报错是reading choices日志里类似Cannot read properties of undefined (reading choices)。这说明请求发出去了但返回的 JSON 结构不是 OpenAI 兼容格式。检查你的 Model ID 是不是写成了 TaoToken 不支持的名称比如把gpt-4o写成了gpt4o。去模型对话页面确认一下准确的模型 ID填回 opencode.json 的models字段里。另外如果你用的是 Anthropic 协议格式的模型opencode 的 provider 配置要换成ai-sdk/anthropicBase URL 还是https://taotoken.net/api但路径拼接方式不同别混用。还有一个和 ThreadLock 相关的衍生报错OAuth相关的初始化失败。opencode 1.2.11 在启动时会尝试做一次 OAuth 设备码检查如果这一步和 Bun 的锁初始化并发也会崩。解决办法是在 opencode.json 里加autoupdate: false和telemetry: false把非必要的启动任务关掉。如果你用的是 Codex 的auth.json做认证确认文件路径在%USERPROFILE%\.codex\auth.json并且里面的 token 没有过期。opencode 读auth.json时如果文件损坏也会在启动阶段抛异常和 ThreadLock 报错混在一起容易误判。排查的时候养成看完整日志的习惯。opencode 的崩溃日志里panic(thread xxxx)前面的几行往往有线索比如loading env from .env或者initializing sqlite。如果 panic 发生在loading env之后基本就是环境变量叠加导致的锁竞态如果发生在initializing sqlite阶段检查一下%APPDATA%\opencode目录的权限或者把里面的sessions.db备份后删掉重建。6. 把 opencode 的 Key 与 API 通道统一到 TaoTokenopencode 1.2.11 的 ThreadLock 报错根因是 Bun canary 在 Windows 上的线程锁竞态触发条件是环境变量加载和并发初始化撞车。清掉 Bun 锁文件残留、把.env精简到只剩一个TAOTOKEN_API_KEY、endpoint 统一指向https://taotoken.net/api这三步做完报错基本消失。我试过在三个不同的 Windows 项目里复现只要.env里模型相关的变量超过五个VS Code 集成终端启动就必崩收敛到 TaoToken 一组 Key 之后连续启动二十次都没再出现。如果你还没拿到 Key去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建一个然后照着第 3 节的 JSON 片段配好 opencode.json。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有不同工具的 Base URL 和 Model ID 对照表。长期用 opencode 跑编码和 Agent 任务的话Coding Plan 的额度比按量付更省https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。最后留一个实用技巧每次升级 opencode 之前先把.env备份成.env.bak升级完先跑opencode --version确认不崩再把变量挪回去。这样即使新版本又引入类似的运行时问题你也能快速定位到是环境变量还是 opencode 本身的问题。Bun 的 canary 构建更新频繁opencode 的 autoupdate 建议关掉手动升级更可控。