1. 安装 Microsoft Edge WebView2 反复弹窗，到底卡在哪
如果你在 Windows 上装 Microsoft Edge WebView2 Runtime，双击安装包后弹出一个错误框，提示“无法创建临时目录”或者直接甩出退出代码 2147748098，那这篇记录大概率能帮你省下几个小时。这个报错最迷惑的地方在于：磁盘空间明明够，管理员权限也给了，甚至换了好几个下载源，弹窗还是那个弹窗。我试过在一台做过精简优化的系统上折腾这个，文件删了、注册表清了、命令行也跑了，最后才发现问题根本不在“安装包”本身，而在 winget 的安装源和注册表里残留的 Edge 更新拦截策略这两处。
WebView2 是什么？简单说，它是微软给 Windows 应用嵌入网页能力的一个运行时组件，很多桌面客户端（比如某些代码工具、CC-switch 这类壳应用）启动时依赖它来渲染界面。如果系统里没有或者版本损坏，应用就会在右下角托盘留个小图标，然后弹窗告诉你缺 WebView2。适合谁看？适合在 Windows 上部署开发工具、被这个弹窗卡住、又不想重装系统的同学。下面我按“先定位、再清理、后验证”的顺序，把可复制的 winget 命令、注册表路径和清理步骤都列出来，最后附上 TaoToken 统一 Key/API 通道在 settings.json 里的配置骨架，方便你在装好 WebView2 之后顺手把模型通道也接上。
2. 先搞清楚 winget 装 WebView2 为什么会失败
很多人第一反应是winget install Microsoft.EdgeWebView2Runtime，这条命令本身没错，但它有两个隐藏前提：一是 winget 的源能正常解析到最新版，二是系统里没有阻止 Edge 组件更新的组策略。一旦注册表里被写过“禁止 Edge 更新”的策略，安装程序检测到就会直接退出，退出代码 2147748098（十六进制 0x80040902）就是这么来的。
你可以先用下面这条命令确认 winget 能不能识别到这个包：
winget search Microsoft.EdgeWebView2Runtime如果能看到版本号，说明源没问题；如果搜索都搜不到，那要先修 winget 源。确认能搜到之后，再执行安装：
winget install --id Microsoft.EdgeWebView2Runtime --accept-package-agreements --accept-source-agreements实测下来，如果系统注册表干净，这条命令能直接装好。但如果报 2147748098，就别在 winget 上反复试了，问题在注册表。
3. TaoToken 前置：把模型通道先配好
在排查 WebView2 的过程中，我习惯把模型调用通道也一起理清楚，因为很多壳应用装好 WebView2 之后第一件事就是读 settings.json 里的 API 配置。TaoToken 在这里的作用是提供一个统一的 Key 和 API 入口，你不用在多个模型供应商之间来回切换 Key。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 地址后面不加 UTM 参数。
你需要先去控制台拿一个 Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，然后在 API Keys 页面生成密钥： https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到 Key 之后，在项目根目录的 settings.json 里写一个配置骨架，大概长这样：
{ "api_base": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model": "claude-sonnet-4-20250514", "timeout": 60 }这个骨架不是让你照抄，而是让你知道字段该放哪。如果你用的是 Claude Code 这类工具，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有更细的字段说明。想先验证模型通不通，可以直接用模型对话页面测一下： https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。长期跑编码任务的话，Coding Plan 更划算： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。
4. 可复制配置：注册表清理与 winget 重装
这一步是核心。先以管理员身份打开 CMD，然后按顺序执行下面的注册表删除命令。如果提示“找不到指定的注册表项”，说明该项本来就不存在，直接跳过执行下一条。
reg delete "HKLM\SOFTWARE\Policies\Microsoft\EdgeUpdate" /f reg delete "HKLM\SOFTWARE\Microsoft\EdgeUpdate" /f reg delete "HKLM\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate" /f这三条分别对应组策略里的 Edge 更新拦截、64 位注册表残留、32 位兼容残留。删完之后，重启一下 Windows Installer 服务，因为有时候负责安装的底层服务挂起了：
net stop msiServer net start msiServer如果服务名报错，可以换成msiserver小写再试一次。服务重启后，再跑一次 winget 安装：
winget install --id Microsoft.EdgeWebView2Runtime --accept-package-agreements --accept-source-agreements如果这次还是 2147748098，说明 winget 这条路暂时走不通，需要换离线安装包。去微软官方下载 Evergreen Standalone Installer，文件大概 150MB 左右，下载后重命名为webview.exe，放到 C 盘根目录。
5. 验证请求：离线安装包加临时目录劫持
离线安装包直接双击可能还是会弹“无法创建临时目录”，这时候用局部环境变量劫持的办法。先创建一个新的临时文件夹：
mkdir C:\TempX然后在当前 CMD 窗口里把 TEMP 和 TMP 指向这个新文件夹，注意这只对当前窗口有效，不会影响系统全局设置：
set TEMP=C:\TempX set TMP=C:\TempX接着在同一个 CMD 窗口里运行安装包：
C:\webview.exe如果这一步还是弹窗，那基本可以判断是安全软件在拦截解压行为。我最后成功的做法是：在某个盘里新建一个Temp文件夹，把安装包放进去，然后右键“以管理员身份运行”，就装好了。装完之后验证一下，打开之前报错的那个应用，看右下角托盘图标是否正常，弹窗是否消失。也可以用命令行确认 WebView2 是否注册成功：
Get-ItemProperty "HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" | Select-Object pv如果能看到版本号，说明运行时已经就位。
6. 本篇常见错排查
第一个坑是 winget 报 2147748098 就反复重试。这个错误码指向的是注册表策略，不是网络问题，重试一百次也没用，必须先清注册表。
第二个坑是只删文件不删注册表。很多人去C:\Program Files (x86)\Microsoft\Temp和EdgeCore目录下删文件夹，删完 winget 还是报同样的错，因为拦截策略在注册表里，文件层面清理干净也没用。
第三个坑是临时目录权限。如果C:\TempX创建后安装程序还是说无法创建临时目录，检查一下这个文件夹的安全属性，确保当前用户有完全控制权限。实在不行就换一个盘符创建 Temp 文件夹，把安装包放进去再右键管理员运行。
第四个坑是安全软件拦截。如果注册表清了、临时目录也换了，安装程序依然闪退，那大概率是安全软件在拦截解压。可以临时退出安全软件再装，装完再开回来。
第五个坑是 settings.json 里 API 地址写错。TaoToken 的 API 地址是https://taotoken.net/api，不要在后面加 UTM 参数，也不要在末尾多加斜杠。Key 从 API Keys 页面拿，别把控制台地址当 API 地址填进去。
7. 装好之后顺手把通道接上
WebView2 装好只是第一步，壳应用能正常渲染界面之后，接下来就是模型调用能不能通。如果你在 settings.json 里用的是 TaoToken 的统一通道，建议先用模型对话页面发一条测试消息，确认 Key 和 API 地址都对。地址是 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。确认能通之后，再回到你的编码工具里跑实际任务。长期做编码或者 Agent 任务的话，Coding Plan 的入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，比按量计费更适合高频调用。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到字段对不上就去翻一下。整个流程走下来，WebView2 弹窗消失，模型通道也通了，剩下的就是正常干活。
