1. 从一次 C 盘爆满说起opencode 的 pagefile.sys 与 git ls-files 异常如果你在 Windows 上跑过 opencode又恰好把工作目录留在了默认的用户主目录那你可能已经踩过这个坑C 盘空间在几个小时内被吃掉几十甚至上百 GB任务管理器里物理内存和提交内存双双逼近上限而罪魁祸首不是模型推理本身而是两个挂着不走的 git.exe 进程以及被它们撑大的C:\pagefile.sys。这个问题的核心链路其实不复杂opencode 的全局快照机制会把当前工作目录当成项目根如果这个目录是C:\Users\你的用户名它就会在~\.local\share\opencode\snapshot\global\下建一个裸仓库然后用git ls-files --others --exclude-standard --work-tree C:\Users\你的用户名去扫描整个主目录。主目录里通常有 AppData、scoop、.conda、各种缓存和工具目录几十万个文件git ls-files会在内存里堆出一份巨型文件清单单个进程提交内存能到 60 GB 以上。Windows 为了满足这个内存需求会把系统自动管理的页面文件一路扩到接近上限运行期间不会自动缩回于是 C 盘空间就这么消失了。更麻烦的是这些 git 进程的父进程可能已经退出它们变成孤儿进程继续挂着跑几个小时都不结束。opencode 本身没有超时机制、没有环检测、没有深度上限日志里也看不到正在扫描 N 个文件这类提示UI 只有加载中。等你发现的时候pagefile.sys已经膨胀到 90 GB 以上系统内存提交用到 99%。这篇内容要解决的就是这个场景怎么用 TaoToken 统一 Key 把 opencode 的模型接入配置好同时用git ls-files和pagefile.sys检查命令定位空间占用来源最后给出可执行的清理动作。适合已经在 Windows 上用 opencode、或者准备用但不想重蹈覆辙的人。2. 前置准备TaoToken 统一 Key 与 opencode 的接入位置在动手排查之前先把模型接入这条线理顺。opencode 支持通过配置文件接入不同的模型提供方TaoToken 在这里的作用是提供一个统一的 API Key 和兼容的接口地址让你不用在多个模型平台之间来回切换 Key。对于需要跑测试、对比不同模型输出的人来说一个套餐、一个 Key 能接不同模型省掉很多配置成本。你需要先拿到 TaoToken 的 API Key。打开 API Keys 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建 Key 之后接口地址用https://taotoken.net/api注意这个地址后面不加 UTM 参数直接作为 base URL 填进配置。opencode 的配置文件通常放在用户目录下的.config\opencode\config.tomlWindows 下路径是C:\Users\你的用户名\.config\opencode\config.toml。如果你之前没建过这个文件手动创建目录和文件即可。这里要提醒一句配置文件和快照目录都在用户主目录下所以如果你在主目录直接启动 opencode它扫描的范围会覆盖这些配置本身。建议把 opencode 的工作目录固定到一个专门的项目文件夹比如D:\projects\demo不要用默认的 CMD 目录。3. 可复制配置config.toml 骨架与 TaoToken Key 填写下面是一份可以直接复制的config.toml骨架。重点是provider段里的 base URL 和 API Key 引用方式以及把模型指向 TaoToken 的兼容接口。# C:\Users\你的用户名\.config\opencode\config.toml # 全局模型设置 model taotoken/claude-sonnet small_model taotoken/claude-haiku # 提供方配置 [provider.taotoken] name TaoToken baseURL https://taotoken.net/api apiKey {env:TAOTOKEN_API_KEY} # 模型列表按需增删 [provider.taotoken.models.claude-sonnet] name Claude Sonnet [provider.taotoken.models.claude-haiku] name Claude Haiku [provider.taotoken.models.gpt-5] name GPT-5 # 关闭自动快照避免在主目录生成裸仓库 [snapshot] enabled false几个关键点说明。第一apiKey用{env:TAOTOKEN_API_KEY}从环境变量读取不要把 Key 明文写进配置文件尤其是这个文件本身就在被扫描的主目录里。第二baseURL填https://taotoken.net/api不要带任何查询参数。第三[snapshot]段把enabled设为false这是从源头切断全局快照把主目录当工作区这条链路的关键动作。如果你确实需要快照功能至少确保 opencode 的工作目录不是用户主目录。设置环境变量的命令在 PowerShell 里执行[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key, User)设置完需要重开终端才生效。验证环境变量是否读到echo $env:TAOTOKEN_API_KEY如果输出是你的 Key说明配置就绪。接下来启动 opencode 时务必先cd到项目目录cd D:\projects\demo opencode不要在C:\Users\你的用户名下直接敲opencode。CMD 的默认目录就是用户目录这是很多人中招的直接原因。4. 验证请求与空间排查git ls-files 与 pagefile.sys 检查命令配置好之后先验证模型请求能不能通。在 opencode 里发一条简单消息或者直接用 curl 测接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: ping}] }返回里有正常的choices字段就说明 Key 和接口都通了。如果返回 401检查 Key 是否设置正确返回 404检查 base URL 有没有多写路径。模型通了之后重点转向空间排查。先看pagefile.sys当前大小Get-Item C:\pagefile.sys -Force | Select-Object Name, {NameSizeGB;Expression{[math]::Round($_.Length/1GB,2)}}正常情况这个文件在几 GB 到十几 GB 之间。如果看到 80 GB、90 GB 甚至更大基本可以确认是页面文件被异常撑大了。再看系统内存提交情况Get-Counter \Memory\Committed Bytes -SampleInterval 1 -MaxSamples 1提交内存接近上限说明有进程在大量申请内存。接着找可疑的 git 进程Get-Process git -ErrorAction SilentlyContinue | Select-Object Id, StartTime, {NameCommitGB;Expression{[math]::Round($_.PagedMemorySize64/1GB,2)}}, Path如果看到 git 进程的CommitGB是几十 GB而且StartTime是几个小时前父进程已经不在那就是孤儿进程。进一步确认它执行的命令可以用 WMI 查命令行Get-CimInstance Win32_Process -Filter Namegit.exe | Select-Object ProcessId, CommandLine如果命令行里出现git ls-files --others --exclude-standard --work-tree C:\Users\你的用户名并且仓库指向opencode\snapshot\global那就完全对上了。这时候再检查快照目录占了多少Get-ChildItem $env:USERPROFILE\.local\share\opencode\snapshot -Recurse -Force -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum | Select-Object {NameTotalGB;Expression{[math]::Round($_.Sum/1GB,2)}}实测下来这个目录里可能有多个快照仓库合计几十 GB。这些就是事故的直接残留物。5. 本篇常见错排查孤儿进程、快照残留与 .git 误判第一个常见错误是只删了C:\Users\你的用户名\.git就以为万事大吉。删掉主目录的.git确实能挡住一类工具——那些在当前目录往上找.git、找到就把整个目录树当项目扫描的 IDE 和桌面版工具。但 opencode 的全局快照机制不用主目录的.git它自己在snapshot\global下建裸仓库用--work-tree强行把主目录当工作区。所以删.git挡不住 opencode 这条链路必须同时关掉快照或者换工作目录。第二个错误是发现 git 进程后直接杀但没检查页面文件。杀掉孤儿 git 进程后内存提交会降下来但pagefile.sys不会立刻缩回。Windows 的自动管理页面文件在运行期间只扩不缩需要重启才能把空间拿回来。所以清理动作的顺序是先杀进程再删快照残留最后重启。第三个错误是忽略了 Temp 目录。页面文件膨胀期间系统和其他程序会产生大量临时文件。杀完进程后顺手清一下Get-ChildItem $env:TEMP -Recurse -Force -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum | Select-Object {NameTempGB;Expression{[math]::Round($_.Sum/1GB,2)}}如果这个数字很大可以清理掉。清理命令Remove-Item $env:TEMP\* -Recurse -Force -ErrorAction SilentlyContinue第四个错误是没检查git ls-files是否还在跑。有些情况下父进程退出后子进程会继续挂着。用前面的Get-CimInstance命令再确认一遍确保没有残留的git ls-files进程。如果还有用Stop-Process -Id PID -Force结束掉。第五个错误是配置里没关快照但工作目录又设成了主目录。这种情况下即使这次清理干净了下次启动 opencode 还会复发。所以[snapshot] enabled false这一行要么加上要么确保每次都在专门的项目目录启动。6. 清理动作与后续接入建议确认问题之后清理动作按顺序来。先结束孤儿 git 进程Get-CimInstance Win32_Process -Filter Namegit.exe | Where-Object { $_.CommandLine -like *ls-files* } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force }然后删除 opencode 的快照残留Remove-Item $env:USERPROFILE\.local\share\opencode\snapshot -Recurse -Force -ErrorAction SilentlyContinue这一步会丢掉 opencode 的历史撤销点但对功能无损反正这些快照本来就不该指向主目录。接着清理 TempRemove-Item $env:TEMP\* -Recurse -Force -ErrorAction SilentlyContinue最后重启系统让pagefile.sys缩回正常大小。重启后再用前面的Get-Item命令确认页面文件大小应该回到几 GB 到十几 GB 的范围。后续使用 opencode 时记住三条第一永远在专门的项目目录启动不要用默认的 CMD 目录第二配置文件里关掉快照或者至少确认快照不会把主目录当工作区第三定期用git ls-files相关的进程检查命令扫一眼发现异常进程及时处理。如果你需要长期跑编码任务或者 Agent 工作流可以考虑用 Coding Plan 来管理模型调用和额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite需要对比不同模型输出、做测试验证的可以直接在模型对话页面切换https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite接入文档里有更完整的 provider 配置说明和兼容接口细节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite整个排查过程里最关键的一步其实是把工作目录和快照机制管住。opencode 本身不是不能用但它的默认行为在 Windows 用户目录下会触发git ls-files对几十万文件的扫描进而通过页面文件吃掉 C 盘空间。把配置里的快照关掉、把启动目录固定到项目文件夹这个坑就能绕过去。