1. 离线装 CC-Switch 报错，先别急着重装系统
Windows 上装 CC-Switch v3.16.3，很多人卡在同一个地方：双击 msi 之后进度条走到一半，弹出一句there is a problem with this windows installer package. a program run as part of the setup did not finish as expected。这句话翻译过来就是「安装包里的某个自定义动作没跑完」，它本身不告诉你到底哪一步挂了，所以第一次遇到会有点懵。
这个场景的典型特征是：机器可能没连外网，或者公司网络做了限制，而 CC-Switch 的 msi 在安装阶段会去检查并尝试拉取 WebView2 运行时。一旦这个下载动作失败，整个安装就会回滚，你看到的就是上面那句笼统的报错。CC-Switch 本身是一个「AI 编程工具总控台」，用来统一管理 Claude Code、Codex、Gemini CLI 这些工具的供应商配置，装不上就没法用它一键切换 endpoint。这篇就按「离线安装失败 → 看 msiexec 日志 → 补 WebView2 → 装完把 endpoint 指到 TaoToken」这条线走一遍，命令都能直接复制。
适合谁看：在 Windows 10/11 上装 CC-Switch 失败、手里只有离线安装包、又想把模型请求接到 TaoToken 的开发者。核心检索词就三个：CC-Switch 离线安装、msiexec 日志排查、WebView2 依赖。下面每一步我都会说清楚「为什么做」和「做完看到什么算成功」，而不是只丢一条命令。
先说结论方向，免得你中途放弃：绝大多数DownloadAndInvokeBootstrapper returned actual error code 1都是因为安装脚本想联网下 WebView2 但下不动。你只要提前把 WebView2 离线包装好，再回头装 CC-Switch，这个自定义动作检测到依赖已存在就会跳过下载，安装基本就过了。剩下的就是装完在 CC-Switch 里把供应商 endpoint 改成 TaoToken 的地址，验证一次请求通不通。
2. 用 msiexec 带日志安装，定位失败动作
图形界面双击安装最大的问题是「它不告诉你细节」。同样的 msi，换成命令行调用msiexec并打开详细日志，失败原因就会白纸黑字写进 log 文件。这一步是整个排查的地基，后面所有判断都基于这份日志。
先以管理员身份打开 PowerShell。为什么要管理员：安装要写C:\Program Files和注册表，权限不够会在WriteRegistryValues阶段被拦。然后执行下面这条命令，把路径换成你自己的 msi 实际位置和想放日志的位置：
Start-Process msiexec.exe -ArgumentList "/i `"C:\Users\你的用户名\Downloads\CC-Switch-v3.16.3-Windows.msi`" /l*v `"C:\Users\你的用户名\Desktop\install.log`" /norestart" -Wait -PassThru参数逐个解释一下，方便你按需改：/i表示安装；/l*v表示输出「最详细」级别的日志（v 是 verbose）；/norestart避免装完自动重启打断你；-Wait让 PowerShell 等安装结束再返回；-PassThru会把进程对象吐出来，方便你看退出码。跑完之后桌面会多一个install.log，通常几千到上万行，别从头读，用搜索。
打开日志，Ctrl + F先搜Return Value 3。MSI 的约定是：0 成功、1 警告、3 致命错误。找到Return Value 3之后，往上看 10 到 20 行，重点找Action start开头的行，它记录的是「哪个动作开始执行」。CC-Switch 这类基于 Tauri 的安装包，最常见的失败动作是CustomAction_CheckWebView2或者CustomAction DownloadAndInvokeBootstrapper。如果你看到的是后者，并且后面跟着returned actual error code 1，那基本可以确定：安装脚本尝试下载引导程序失败，原因通常是离线或安全软件拦截。
顺手再搜几个关键词交叉验证：搜Access Denied看是不是权限问题；搜Failed看有没有具体文件操作失败；搜Rollback找到回滚起点，回滚前那几行就是「罪魁祸首」。把Action start到Return Value 3之间那十几行留着，后面判断全靠它。这一步做完，你应该能明确说出「失败发生在哪个动作」，而不是只知道「装不上」。
3. 补 WebView2 依赖，再改 TaoToken 配置
定位到 WebView2 相关动作失败后，解决思路就清晰了：手动把 WebView2 运行时离线装好，让安装脚本的检测直接通过。CC-Switch 基于 Tauri 2 构建，Windows 上 Tauri 用 WebView2 来渲染界面，这是框架层面的硬依赖，没有替代品——你没法让一个已经编译好的程序换用别的内核。所以别想着绕过，直接装。
去微软官方页面下载Evergreen Standalone Installer的 x64 版本，文件名类似MicrosoftEdgeWebView2RuntimeInstallerX64.exe。注意区分三种包：Bootstrapper 是在线引导器（不适合离线）、Standalone 是完整离线包（选这个）、Fixed Version 是给开发者固定版本用的（普通用户别选）。下载后拷到目标机器，双击安装，装完可以在「控制面板 → 程序和功能」里确认存在Microsoft Edge WebView2 Runtime。装完 WebView2 再回头跑第 2 节那条 msiexec 命令，这次CustomAction_CheckWebView2应该会直接跳过下载。
如果还是失败，检查一下是不是有残留的msiexec.exe进程卡住。任务管理器 → 详细信息 → 找到所有msiexec.exe结束任务，再重装。实在不行，用便携版（Portable）绕过整个安装脚本，解压即用，功能一样。
装好 CC-Switch 之后，打开它，进入供应商（Provider）管理，新增或编辑一个供应商，把 endpoint 指向 TaoToken。CC-Switch 管理的是各个 AI 编程工具的配置文件，所以这里要填的是「工具能识别的配置格式」。以 Claude Code 为例，它读的是settings.json，核心三件套是 Base URL、API Key、Model ID。在 CC-Switch 里对应的字段大致是这样：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken API Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }如果你用的是 Codex，它读的是auth.json和config.toml，Base URL 同样填https://taotoken.net/api，Key 填你在 TaoToken 控制台生成的 API Key，Model ID 按你实际要用的模型填。CC-Switch 的好处就是这些文件你不用手动改，在界面里填一次，切换供应商时它帮你写回去。API Key 在 TaoToken 控制台的 API Keys 页面生成，接入细节可以对照官方接入文档。
4. 验证请求：确认 endpoint 真的通了
配置填完不算完，得验证一次请求确实走通了，否则你可能只是「看起来配好了」。最直接的验证方式是在 CC-Switch 里用它内置的连通性测试（如果有），或者直接跑一次真实的 CLI 调用。
以 Claude Code 为例，配置生效后，在终端里发一条最简单的请求：
claude -p "回复 ok 两个字"如果返回里出现正常的模型输出，说明 Base URL、Key、Model ID 三件套都对，请求已经打到 TaoToken 并正常返回。如果报 401，说明 Key 不对或没带上；如果报连接超时，说明 Base URL 写错或网络不通；如果报reading choices之类的解析错误，通常是返回体格式和客户端预期不一致，检查 Model ID 是否填了 TaoToken 支持的模型。
想更直观地看模型返回，可以打开 TaoToken 的模型对话页面，用同一个 Key 发一条消息，对比两边结果。这样能快速区分「是 CC-Switch 配置问题」还是「Key/额度问题」。验证通过后，你在 CC-Switch 里切换供应商，对应的工具配置文件会被自动改写，不用再手动动settings.json。
一个实用技巧：验证阶段先用一个便宜、响应快的模型跑通链路，确认没问题再换成你日常用的模型。这样即使出错，排查成本也低。另外，把 CC-Switch 的配置导出备份一份，换机器或重装时直接导入，省得重新填。
5. 常见报错对照：401、proxy failed、Return Value 3
装和配的过程中，报错就那么几类，对照着看能省很多时间。
Return Value 3出现在 install.log 里，且上方是CustomAction DownloadAndInvokeBootstrapper returned actual error code 1：这是安装阶段最典型的错，根因是安装脚本联网下载 WebView2 失败。解决就是第 3 节说的，提前离线装好 WebView2，或者直接用便携版。注意错误信息里那句not this may not be 100% accurate if translation happened inside sandbox只是提示错误码可能被中间层翻译过，不影响判断。
401 Unauthorized：请求打到了 TaoToken 但鉴权没过。检查 API Key 是否复制完整（有没有多余空格）、是否在 TaoToken 控制台里还有效、请求头里有没有正确带上。CC-Switch 写配置时如果字段名写错（比如把ANTHROPIC_AUTH_TOKEN写成别的），也会导致 Key 没带上。
local proxy failed或连接被拒：通常是 Base URL 写错，或者本机有安全软件拦截了出站请求。确认 Base URL 是https://taotoken.net/api，没有多余路径；临时关掉安全软件再试一次，能通就说明是拦截问题，把对应进程加白名单。
OAuth相关报错：如果你用的是需要 OAuth 的工具，注意 TaoToken 走的是 API Key 方式，不需要 OAuth 流程。出现 OAuth 报错说明工具还在走默认的官方登录逻辑，检查配置有没有真正生效——CC-Switch 改完配置后，有些工具需要重启才会重新读取。
reading choices或返回体解析失败：一般是 Model ID 填了 TaoToken 不支持的模型，或者返回格式和客户端预期不符。换成确认支持的 Model ID 再试。
排查顺序建议固定下来：先看 install.log 的Return Value 3定位安装问题，装好后用一条最小请求验证连通性，401 查 Key、超时查 URL、解析错查 Model ID。按这个顺序走，基本不会绕圈。
6. 把配置固化下来，下次直接复用
装好、配好、验证通过之后，做两件收尾的事，能让你后面省心。第一，在 CC-Switch 里把当前这套 TaoToken 配置保存成一个命名供应商，比如「TaoToken-Claude」，以后切换一键完成。第二，导出配置文件备份，重装系统或换机器时直接导入。
如果你长期用 Claude Code、Codex 这类工具做开发，或者要跑 Agent 任务，可以考虑用 TaoToken 的 Coding Plan，把常用模型的调用集中管理，配合 CC-Switch 的供应商切换，主供应商出问题时还能切备用。API Key 统一在控制台管理，接入方式对照接入文档，遇到模型选择问题可以去模型对话页面实测。
最后留一个我踩过的坑：离线环境装 CC-Switch，一定要把 WebView2 离线包和 CC-Switch 安装包放在同一个 U 盘里一起带过去，别到了目标机器才发现缺依赖又没法下载。装完先跑一条最小请求确认链路通，再去配那些复杂的 MCP 和提示词，顺序反了容易把「配置问题」误判成「安装问题」。
